xtrawl 0.1.0

package/dist/pool/cooldown.js

@@ -0,0 +1,38 @@
+export function parseRateLimitReset(headers) {
+    const raw = headers["x-rate-limit-reset"] ?? headers["X-Rate-Limit-Reset"];
+    const value = raw ? Number(raw) : NaN;
+    if (!Number.isFinite(value))
+        return undefined;
+    return value < 10_000_000_000 ? value * 1_000 : value;
+}
+export function parseRateLimitRemaining(headers) {
+    const raw = headers["x-rate-limit-remaining"] ?? headers["X-Rate-Limit-Remaining"];
+    if (raw === undefined)
+        return undefined;
+    const value = Number(raw);
+    return Number.isFinite(value) ? value : undefined;
+}
+export function effectiveStatus(status, headers) {
+    const remaining = parseRateLimitRemaining(headers);
+    return status === 200 && remaining !== undefined && remaining <= 0 ? 429 : status;
+}
+export function computeCooldown(category, status, now, options) {
+    if (status === 200)
+        return { status: "healthy", availableUntil: 0 };
+    if (category === "auth" || status === 401 || status === 403)
+        return {
+            status: "unusable",
+            availableUntil: now + options.authMs,
+            lastErrorCode: status,
+            reason: "authentication_failed",
+        };
+    const reset = options.resetAt ?? now + (category === "transient" ? options.transientMs : options.defaultMs);
+    const jitter = Math.round(Math.random() * Math.max(0, options.jitterMs ?? 0));
+    return {
+        status: "cooling_down",
+        availableUntil: reset + jitter,
+        lastErrorCode: status,
+        reason: category ?? "remote_error",
+    };
+}
+//# sourceMappingURL=cooldown.js.map

package/dist/pool/cooldown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cooldown.js","sourceRoot":"","sources":["../../src/pool/cooldown.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,mBAAmB,CAAC,OAAyC;IAC3E,MAAM,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAC,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACtC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,OAAO,KAAK,GAAG,cAAc,CAAC,CAAC,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAyC;IAC/E,MAAM,GAAG,GAAG,OAAO,CAAC,wBAAwB,CAAC,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACnF,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAC1B,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,OAAyC;IACvF,MAAM,SAAS,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACnD,OAAO,MAAM,KAAK,GAAG,IAAI,SAAS,KAAK,SAAS,IAAI,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;AACpF,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,QAAmC,EACnC,MAAc,EACd,GAAW,EACX,OAMC;IAED,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;IACpE,IAAI,QAAQ,KAAK,MAAM,IAAI,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG;QACzD,OAAO;YACL,MAAM,EAAE,UAAU;YAClB,cAAc,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM;YACpC,aAAa,EAAE,MAAM;YACrB,MAAM,EAAE,uBAAuB;SAChC,CAAC;IACJ,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,IAAI,GAAG,GAAG,CAAC,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC5G,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,CAAC;IAC9E,OAAO;QACL,MAAM,EAAE,cAAc;QACtB,cAAc,EAAE,KAAK,GAAG,MAAM;QAC9B,aAAa,EAAE,MAAM;QACrB,MAAM,EAAE,QAAQ,IAAI,cAAc;KACnC,CAAC;AACJ,CAAC"}

package/dist/pool/limiter.d.ts

@@ -0,0 +1,11 @@
+export declare class TokenBucketLimiter {
+    private readonly requestsPerMinute;
+    private readonly minDelayMs;
+    private readonly clock;
+    private readonly sleeper;
+    private nextAllowedAt;
+    constructor(requestsPerMinute: number, minDelayMs: number, clock?: () => number, sleeper?: (ms: number) => Promise<void>);
+    acquire(): Promise<void>;
+}
+export declare function sleep(ms: number): Promise<void>;
+//# sourceMappingURL=limiter.d.ts.map

package/dist/pool/limiter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"limiter.d.ts","sourceRoot":"","sources":["../../src/pool/limiter.ts"],"names":[],"mappings":"AAAA,qBAAa,kBAAkB;IAI3B,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAN1B,OAAO,CAAC,aAAa,CAAK;gBAGP,iBAAiB,EAAE,MAAM,EACzB,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,MAAM,MAAiB,EAC9B,OAAO,GAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAS;IAGpD,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAOtC;AAED,wBAAsB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrD"}

package/dist/pool/limiter.js

@@ -0,0 +1,27 @@
+export class TokenBucketLimiter {
+    requestsPerMinute;
+    minDelayMs;
+    clock;
+    sleeper;
+    nextAllowedAt = 0;
+    constructor(requestsPerMinute, minDelayMs, clock = Date.now, sleeper = sleep) {
+        this.requestsPerMinute = requestsPerMinute;
+        this.minDelayMs = minDelayMs;
+        this.clock = clock;
+        this.sleeper = sleeper;
+    }
+    async acquire() {
+        const interval = Math.max(this.minDelayMs, 60_000 / Math.max(1, this.requestsPerMinute));
+        const now = this.clock();
+        const wait = Math.max(0, this.nextAllowedAt - now);
+        if (wait > 0)
+            await this.sleeper(wait);
+        this.nextAllowedAt = Math.max(this.nextAllowedAt, this.clock()) + interval;
+    }
+}
+export async function sleep(ms) {
+    if (ms <= 0)
+        return;
+    await new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=limiter.js.map

package/dist/pool/limiter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"limiter.js","sourceRoot":"","sources":["../../src/pool/limiter.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,kBAAkB;IAIV;IACA;IACA;IACA;IANX,aAAa,GAAG,CAAC,CAAC;IAE1B,YACmB,iBAAyB,EACzB,UAAkB,EAClB,QAAsB,IAAI,CAAC,GAAG,EAC9B,UAAyC,KAAK;QAH9C,sBAAiB,GAAjB,iBAAiB,CAAQ;QACzB,eAAU,GAAV,UAAU,CAAQ;QAClB,UAAK,GAAL,KAAK,CAAyB;QAC9B,YAAO,GAAP,OAAO,CAAuC;IAC9D,CAAC;IAEG,KAAK,CAAC,OAAO;QAClB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;QACzF,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,aAAa,GAAG,GAAG,CAAC,CAAC;QACnD,IAAI,IAAI,GAAG,CAAC;YAAE,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,QAAQ,CAAC;IAC7E,CAAC;CACF;AAED,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,EAAU;IACpC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO;IACpB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/query/builder.d.ts

@@ -0,0 +1,19 @@
+import type { Manifest } from "../domain/manifest.js";
+import type { ProfileTimelineRequest, SearchRequest, TargetInput } from "../domain/requests.js";
+export declare const OPERATION: {
+    readonly search: "search_timeline";
+    readonly userLookup: "user_lookup_screen_name";
+    readonly profileTimeline: "profile_timeline";
+    readonly followers: "followers";
+    readonly following: "following";
+    readonly verifiedFollowers: "verified_followers";
+    readonly tweetResult: "tweet_result";
+};
+export declare function endpointFor(manifest: Manifest, operation: string): string;
+export declare function buildSearchParams(request: SearchRequest, manifest: Manifest, cursor?: string, pageSize?: number): Record<string, string>;
+export declare function buildUserLookupParams(username: string, manifest: Manifest): Record<string, string>;
+export declare function buildProfileTimelineParams(userId: string, _request: ProfileTimelineRequest, manifest: Manifest, cursor?: string, pageSize?: number): Record<string, string>;
+export declare function buildFollowsParams(userId: string, operation: string, manifest: Manifest, cursor?: string, pageSize?: number): Record<string, string>;
+export declare function buildTweetResultParams(tweetId: string, manifest: Manifest): Record<string, string>;
+export declare function targetUsername(target: TargetInput): string | undefined;
+//# sourceMappingURL=builder.d.ts.map

package/dist/query/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../src/query/builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,KAAK,EAAE,sBAAsB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGhG,eAAO,MAAM,SAAS;;;;;;;;CAQZ,CAAC;AAEX,wBAAgB,WAAW,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAKzE;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,SAAK,GACZ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAexB;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQlG;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,sBAAsB,EAChC,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,SAAK,GACZ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAexB;AAED,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,QAAQ,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,SAAK,GACZ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAqBxB;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAalG;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CActE"}

package/dist/query/builder.js

@@ -0,0 +1,110 @@
+import { buildEffectiveQuery, normalizeSearch } from "./normalize.js";
+export const OPERATION = {
+    search: "search_timeline",
+    userLookup: "user_lookup_screen_name",
+    profileTimeline: "profile_timeline",
+    followers: "followers",
+    following: "following",
+    verifiedFollowers: "verified_followers",
+    tweetResult: "tweet_result",
+};
+export function endpointFor(manifest, operation) {
+    const id = manifest.queryIds[operation];
+    const endpoint = manifest.endpoints[operation];
+    if (!id || !endpoint)
+        throw new Error(`Manifest does not define operation ${operation}`);
+    return endpoint.includes("{query_id}") ? endpoint.replace("{query_id}", id) : endpoint;
+}
+export function buildSearchParams(request, manifest, cursor, pageSize = 20) {
+    const normalized = normalizeSearch(request).value;
+    const rawQuery = buildEffectiveQuery(normalized) || "from:elonmusk";
+    const variables = {
+        rawQuery,
+        count: Math.max(1, Math.min(pageSize, 100)),
+        querySource: "typed_query",
+        product: (request.displayType ?? "Top").toLowerCase() === "latest" ? "Latest" : "Top",
+        withGrokTranslatedBio: false,
+        ...(cursor ? { cursor } : {}),
+    };
+    return {
+        variables: JSON.stringify(variables),
+        features: JSON.stringify(manifest.featuresFor(OPERATION.search)),
+    };
+}
+export function buildUserLookupParams(username, manifest) {
+    return {
+        variables: JSON.stringify({ screen_name: username, withGrokTranslatedBio: false }),
+        features: JSON.stringify(manifest.featuresFor(OPERATION.userLookup)),
+        ...(Object.keys(manifest.fieldTogglesFor(OPERATION.userLookup)).length > 0
+            ? { fieldToggles: JSON.stringify(manifest.fieldTogglesFor(OPERATION.userLookup)) }
+            : {}),
+    };
+}
+export function buildProfileTimelineParams(userId, _request, manifest, cursor, pageSize = 20) {
+    return {
+        variables: JSON.stringify({
+            userId,
+            count: Math.max(1, Math.min(pageSize, 100)),
+            includePromotedContent: true,
+            withQuickPromoteEligibilityTweetFields: true,
+            withVoice: true,
+            ...(cursor ? { cursor } : {}),
+        }),
+        features: JSON.stringify(manifest.featuresFor(OPERATION.profileTimeline)),
+        ...(Object.keys(manifest.fieldTogglesFor(OPERATION.profileTimeline)).length > 0
+            ? { fieldToggles: JSON.stringify(manifest.fieldTogglesFor(OPERATION.profileTimeline)) }
+            : {}),
+    };
+}
+export function buildFollowsParams(userId, operation, manifest, cursor, pageSize = 20) {
+    const features = {
+        ...manifest.featuresFor(operation),
+        tweetypie_unmention_optimization_enabled: true,
+        responsive_web_twitter_blue_verified_badge_is_enabled: true,
+        vibe_api_enabled: false,
+        responsive_web_graphql_exclude_directive_enabled: true,
+    };
+    return {
+        variables: JSON.stringify({
+            userId,
+            count: Math.max(1, Math.min(pageSize, 100)),
+            includePromotedContent: false,
+            withGrokTranslatedBio: false,
+            ...(cursor ? { cursor } : {}),
+        }),
+        features: JSON.stringify(features),
+        ...(Object.keys(manifest.fieldTogglesFor(operation)).length > 0
+            ? { fieldToggles: JSON.stringify(manifest.fieldTogglesFor(operation)) }
+            : {}),
+    };
+}
+export function buildTweetResultParams(tweetId, manifest) {
+    return {
+        variables: JSON.stringify({
+            tweetId,
+            withCommunity: false,
+            includePromotedContent: false,
+            withVoice: false,
+        }),
+        features: JSON.stringify(manifest.featuresFor(OPERATION.tweetResult)),
+        ...(Object.keys(manifest.fieldTogglesFor(OPERATION.tweetResult)).length > 0
+            ? { fieldToggles: JSON.stringify(manifest.fieldTogglesFor(OPERATION.tweetResult)) }
+            : {}),
+    };
+}
+export function targetUsername(target) {
+    if (target.username?.trim())
+        return target.username.trim().replace(/^@/u, "");
+    if (target.profileUrl?.trim()) {
+        try {
+            const url = new URL(target.profileUrl.includes("://") ? target.profileUrl : `https://${target.profileUrl}`);
+            const parts = url.pathname.split("/").filter(Boolean);
+            return parts.length === 1 ? parts[0] : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=builder.js.map

package/dist/query/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../src/query/builder.ts"],"names":[],"mappings":"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"}

package/dist/query/hash.d.ts

@@ -0,0 +1,2 @@
+export declare function queryHash(value: unknown): string;
+//# sourceMappingURL=hash.d.ts.map

package/dist/query/hash.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.d.ts","sourceRoot":"","sources":["../../src/query/hash.ts"],"names":[],"mappings":"AAGA,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEhD"}

package/dist/query/hash.js

@@ -0,0 +1,6 @@
+import { createHash } from "node:crypto";
+import { stableJson } from "../utils/fingerprint.js";
+export function queryHash(value) {
+    return createHash("sha256").update(stableJson(value)).digest("hex");
+}
+//# sourceMappingURL=hash.js.map

package/dist/query/hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hash.js","sourceRoot":"","sources":["../../src/query/hash.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACtE,CAAC"}

package/dist/query/normalize.d.ts

@@ -0,0 +1,39 @@
+import type { SearchRequest, TweetType } from "../domain/requests.js";
+export interface NormalizedSearch {
+    readonly searchQuery: string;
+    readonly allWords: readonly string[];
+    readonly anyWords: readonly string[];
+    readonly exactPhrases: readonly string[];
+    readonly excludeWords: readonly string[];
+    readonly hashtagsAny: readonly string[];
+    readonly hashtagsExclude: readonly string[];
+    readonly fromUsers: readonly string[];
+    readonly toUsers: readonly string[];
+    readonly mentioningUsers: readonly string[];
+    readonly tweetType: TweetType;
+    readonly verifiedOnly: boolean;
+    readonly blueVerifiedOnly: boolean;
+    readonly hasImages: boolean;
+    readonly hasVideos: boolean;
+    readonly hasLinks: boolean;
+    readonly hasMentions: boolean;
+    readonly hasHashtags: boolean;
+    readonly minLikes: number;
+    readonly minReplies: number;
+    readonly minRetweets: number;
+    readonly place: string;
+    readonly geocode: string;
+    readonly near: string;
+    readonly within: string;
+    readonly lang: string;
+    readonly since: string;
+    readonly until: string;
+    readonly displayType: string;
+}
+export declare function normalizeSearch(input?: SearchRequest | Record<string, unknown>): {
+    readonly value: NormalizedSearch;
+    readonly warnings: readonly string[];
+    readonly errors: readonly string[];
+};
+export declare function buildEffectiveQuery(value: NormalizedSearch): string;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/query/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/query/normalize.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGtE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAWD,wBAAgB,eAAe,CAAC,KAAK,GAAE,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG;IACpF,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;CACpC,CA+EA;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CA2DnE"}

package/dist/query/normalize.js

@@ -0,0 +1,176 @@
+import { asBoolean, asInteger, asString, asStringList } from "../utils/guards.js";
+const VALID_TWEET_TYPES = new Set([
+    "all",
+    "originals_only",
+    "replies_only",
+    "retweets_only",
+    "exclude_replies",
+    "exclude_retweets",
+]);
+export function normalizeSearch(input = {}) {
+    const raw = input;
+    const warnings = [];
+    const aliases = {
+        query: "searchQuery",
+        words: "anyWords",
+        from_account: "fromUsers",
+        to_account: "toUsers",
+        mention_account: "mentioningUsers",
+        hashtag: "hashtagsAny",
+        minlikes: "minLikes",
+        minreplies: "minReplies",
+        minretweets: "minRetweets",
+        verified: "verifiedOnly",
+        blue_verified: "blueVerifiedOnly",
+        images: "hasImages",
+        videos: "hasVideos",
+        links: "hasLinks",
+    };
+    const coerced = { ...raw };
+    for (const [legacy, canonical] of Object.entries(aliases)) {
+        if (!(legacy in raw))
+            continue;
+        warnings.push(`Input key '${legacy}' is deprecated; use '${canonical}'.`);
+        if (!(canonical in raw))
+            coerced[canonical] = raw[legacy];
+    }
+    const normalizedList = (key) => unique(asStringList(coerced[key]).flatMap((item) => key === "allWords" || key === "anyWords" ? item.split("//") : [item]));
+    const handles = (key) => unique(normalizedList(key)
+        .map((item) => item.replace(/^@/u, ""))
+        .filter((item) => /^[A-Za-z0-9_]{1,15}$/u.test(item)));
+    const hashtags = (key) => unique(normalizedList(key).map((item) => (item.startsWith("#") || item.startsWith("$") ? item : `#${item}`)));
+    const tweetTypeValue = asString(coerced.tweetType) ?? "all";
+    const tweetType = VALID_TWEET_TYPES.has(tweetTypeValue) ? tweetTypeValue : "all";
+    const errors = VALID_TWEET_TYPES.has(tweetTypeValue) ? [] : [`Invalid tweetType: ${tweetTypeValue}`];
+    return {
+        value: {
+            searchQuery: asString(coerced.searchQuery) ?? "",
+            allWords: normalizedList("allWords"),
+            anyWords: normalizedList("anyWords"),
+            exactPhrases: normalizedList("exactPhrases"),
+            excludeWords: normalizedList("excludeWords"),
+            hashtagsAny: hashtags("hashtagsAny"),
+            hashtagsExclude: hashtags("hashtagsExclude"),
+            fromUsers: handles("fromUsers"),
+            toUsers: handles("toUsers"),
+            mentioningUsers: handles("mentioningUsers"),
+            tweetType,
+            verifiedOnly: asBoolean(coerced.verifiedOnly),
+            blueVerifiedOnly: asBoolean(coerced.blueVerifiedOnly),
+            hasImages: asBoolean(coerced.hasImages),
+            hasVideos: asBoolean(coerced.hasVideos),
+            hasLinks: asBoolean(coerced.hasLinks),
+            hasMentions: asBoolean(coerced.hasMentions),
+            hasHashtags: asBoolean(coerced.hasHashtags),
+            minLikes: Math.max(0, asInteger(coerced.minLikes)),
+            minReplies: Math.max(0, asInteger(coerced.minReplies)),
+            minRetweets: Math.max(0, asInteger(coerced.minRetweets)),
+            place: asString(coerced.place) ?? "",
+            geocode: asString(coerced.geocode) ?? "",
+            near: asString(coerced.near) ?? "",
+            within: asString(coerced.within) ?? "",
+            lang: asString(coerced.lang) ?? "",
+            since: asString(coerced.since) ?? "",
+            until: asString(coerced.until) ?? "",
+            displayType: asString(coerced.displayType) ?? "Top",
+        },
+        warnings,
+        errors,
+    };
+}
+export function buildEffectiveQuery(value) {
+    const parts = [];
+    if (value.searchQuery)
+        parts.push(value.searchQuery);
+    if (value.allWords.length)
+        parts.push(`(${value.allWords.map(formatTerm).join(" AND ")})`);
+    if (value.anyWords.length)
+        parts.push(`(${value.anyWords.map(formatTerm).join(" OR ")})`);
+    if (value.exactPhrases.length)
+        parts.push(`(${value.exactPhrases.map(formatTerm).join(" AND ")})`);
+    for (const term of value.excludeWords)
+        parts.push(`-${formatTerm(term)}`);
+    if (value.hashtagsAny.length)
+        parts.push(`(${value.hashtagsAny.join(" OR ")})`);
+    for (const tag of value.hashtagsExclude)
+        parts.push(`-${tag}`);
+    if (!hasOperator(value.searchQuery, "from") && value.fromUsers.length)
+        parts.push(operatorGroup("from", value.fromUsers));
+    if (!hasOperator(value.searchQuery, "to") && value.toUsers.length)
+        parts.push(operatorGroup("to", value.toUsers));
+    if (value.mentioningUsers.length)
+        parts.push(value.mentioningUsers.length === 1
+            ? `@${value.mentioningUsers[0]}`
+            : `(${value.mentioningUsers.map((user) => `@${user}`).join(" OR ")})`);
+    if (value.lang && !hasOperator(value.searchQuery, "lang"))
+        parts.push(`lang:${value.lang}`);
+    if (!hasFilterOperator(value.searchQuery)) {
+        const filters = {
+            originals_only: ["-filter:replies", "-filter:retweets"],
+            replies_only: ["filter:replies"],
+            retweets_only: ["filter:retweets"],
+            exclude_replies: ["-filter:replies"],
+            exclude_retweets: ["-filter:retweets"],
+        };
+        parts.push(...(filters[value.tweetType] ?? []));
+        for (const [field, filter] of [
+            ["verifiedOnly", "verified"],
+            ["blueVerifiedOnly", "blue_verified"],
+            ["hasImages", "images"],
+            ["hasVideos", "videos"],
+            ["hasLinks", "links"],
+            ["hasMentions", "mentions"],
+            ["hasHashtags", "hashtags"],
+        ])
+            if (value[field])
+                parts.push(`filter:${filter}`);
+    }
+    if (!hasMinOperator(value.searchQuery)) {
+        if (value.minLikes > 0)
+            parts.push(`min_faves:${value.minLikes}`);
+        if (value.minReplies > 0)
+            parts.push(`min_replies:${value.minReplies}`);
+        if (value.minRetweets > 0)
+            parts.push(`min_retweets:${value.minRetweets}`);
+    }
+    if (value.since && !hasOperator(value.searchQuery, "since"))
+        parts.push(`since:${stripUtc(value.since)}`);
+    if (value.until && !hasOperator(value.searchQuery, "until"))
+        parts.push(`until:${stripUtc(value.until)}`);
+    if (!["place", "geocode", "near", "within"].some((operator) => hasOperator(value.searchQuery, operator))) {
+        if (value.place)
+            parts.push(`place:${value.place}`);
+        else if (value.geocode)
+            parts.push(`geocode:${value.geocode}`);
+        else if (value.near)
+            parts.push(`near:${value.near}`, ...(value.within ? [`within:${value.within}`] : []));
+        else if (value.within)
+            parts.push(`within:${value.within}`);
+    }
+    return parts.filter(Boolean).join(" ").trim();
+}
+function formatTerm(value) {
+    if (value.startsWith('"') && value.endsWith('"'))
+        return value;
+    return /\s/u.test(value) ? `"${value}"` : value;
+}
+function operatorGroup(name, values) {
+    const items = values.map((value) => `${name}:${value}`);
+    return items.length === 1 ? items[0] : `(${items.join(" OR ")})`;
+}
+function hasOperator(query, name) {
+    return new RegExp(`(?<![A-Za-z0-9_])${name}:`, "iu").test(query);
+}
+function hasFilterOperator(query) {
+    return /(?<![A-Za-z0-9_])-?filter:[a-z_]+\b/iu.test(query);
+}
+function hasMinOperator(query) {
+    return /(?<![A-Za-z0-9_])min_[a-z_]+:/iu.test(query);
+}
+function stripUtc(value) {
+    return value.endsWith("_UTC") ? value.slice(0, -4) : value;
+}
+function unique(values) {
+    return [...new Set(values.filter(Boolean))];
+}
+//# sourceMappingURL=normalize.js.map

package/dist/query/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/query/normalize.ts"],"names":[],"mappings":"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"}

package/dist/query/targets.d.ts

@@ -0,0 +1,11 @@
+import type { TargetInput } from "../domain/requests.js";
+export interface NormalizedTargets {
+    readonly targets: readonly TargetInput[];
+    readonly skipped: readonly {
+        readonly raw: string;
+        readonly reason: string;
+    }[];
+}
+export declare function normalizeTargets(values: readonly (string | TargetInput)[]): NormalizedTargets;
+export declare function targetFromString(value: string): TargetInput | undefined;
+//# sourceMappingURL=targets.d.ts.map

package/dist/query/targets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.d.ts","sourceRoot":"","sources":["../../src/query/targets.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AA2BzD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,CAAC;IACzC,QAAQ,CAAC,OAAO,EAAE,SAAS;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAChF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,GAAG,WAAW,CAAC,EAAE,GAAG,iBAAiB,CAmB7F;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAQvE"}

package/dist/query/targets.js

@@ -0,0 +1,96 @@
+const HANDLE = /^[A-Za-z0-9_]{1,15}$/u;
+const USER_ID = /^\d+$/u;
+const PROFILE_HOSTS = new Set([
+    "x.com",
+    "www.x.com",
+    "m.x.com",
+    "mobile.x.com",
+    "twitter.com",
+    "www.twitter.com",
+    "m.twitter.com",
+    "mobile.twitter.com",
+]);
+const RESERVED_PATHS = new Set([
+    "home",
+    "explore",
+    "search",
+    "notifications",
+    "messages",
+    "compose",
+    "settings",
+    "i",
+    "login",
+    "signup",
+]);
+export function normalizeTargets(values) {
+    const targets = [];
+    const skipped = [];
+    const seen = new Set();
+    for (const value of values) {
+        const parsed = typeof value === "string" ? targetFromString(value) : normalizeObjectTarget(value);
+        if (!parsed) {
+            skipped.push({ raw: typeof value === "string" ? value : (value.raw ?? ""), reason: "invalid_target" });
+            continue;
+        }
+        const key = parsed.userId ? `id:${parsed.userId}` : `username:${parsed.username?.toLowerCase()}`;
+        if (seen.has(key)) {
+            skipped.push({ raw: parsed.raw ?? "", reason: "duplicate" });
+            continue;
+        }
+        seen.add(key);
+        targets.push(parsed);
+    }
+    return { targets, skipped };
+}
+export function targetFromString(value) {
+    const raw = value.trim();
+    if (!raw)
+        return undefined;
+    if (USER_ID.test(raw))
+        return { raw, source: "input", userId: raw };
+    const handle = raw.replace(/^@/u, "");
+    if (HANDLE.test(handle) && !RESERVED_PATHS.has(handle.toLowerCase()))
+        return { raw, source: "input", username: handle };
+    return targetFromProfileUrl(raw);
+}
+function normalizeObjectTarget(value) {
+    if (value.userId?.trim() && USER_ID.test(value.userId.trim()))
+        return { ...value, userId: value.userId.trim() };
+    if (value.username?.trim()) {
+        const username = value.username.trim().replace(/^@/u, "");
+        return HANDLE.test(username) && !RESERVED_PATHS.has(username.toLowerCase())
+            ? { ...value, username }
+            : undefined;
+    }
+    if (value.profileUrl?.trim()) {
+        const parsed = targetFromProfileUrl(value.profileUrl);
+        return parsed ? { ...parsed, ...value, username: parsed.username, userId: parsed.userId } : undefined;
+    }
+    if (value.raw?.trim())
+        return targetFromString(value.raw);
+    return undefined;
+}
+function targetFromProfileUrl(value) {
+    try {
+        const url = new URL(value.includes("://") ? value : `https://${value}`);
+        if (!PROFILE_HOSTS.has(url.hostname.toLowerCase()))
+            return undefined;
+        const parts = url.pathname.split("/").filter(Boolean);
+        if (parts.length === 3 && parts[0]?.toLowerCase() === "i" && parts[1]?.toLowerCase() === "user") {
+            const userId = parts[2];
+            return userId && USER_ID.test(userId)
+                ? { raw: value, source: "profile_url", userId, profileUrl: `https://x.com/i/user/${userId}` }
+                : undefined;
+        }
+        if (parts.length !== 1)
+            return undefined;
+        const username = parts[0]?.replace(/^@/u, "");
+        if (!username || !HANDLE.test(username) || RESERVED_PATHS.has(username.toLowerCase()))
+            return undefined;
+        return { raw: value, source: "profile_url", username, profileUrl: `https://x.com/${username}` };
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=targets.js.map

package/dist/query/targets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"targets.js","sourceRoot":"","sources":["../../src/query/targets.ts"],"names":[],"mappings":"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"}

package/dist/runner/index.d.ts

@@ -0,0 +1,4 @@
+export { ExecutionRunner } from "./runner.js";
+export { TaskQueue } from "./task-queue.js";
+export { withRetry } from "./retry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/runner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runner/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC"}

package/dist/runner/index.js

@@ -0,0 +1,4 @@
+export { ExecutionRunner } from "./runner.js";
+export { TaskQueue } from "./task-queue.js";
+export { withRetry } from "./retry.js";
+//# sourceMappingURL=index.js.map