xtrawl 0.1.0

package/dist/domain/errors.d.ts

@@ -0,0 +1,61 @@
+export type ErrorCategory = "auth" | "rate_limit" | "network" | "proxy" | "transient" | "runtime";
+export interface ErrorDiagnostics {
+    readonly statusCode?: number;
+    readonly category?: ErrorCategory;
+    readonly account?: string;
+    readonly endpoint?: string;
+    readonly [key: string]: unknown;
+}
+export declare class XTrawlError extends Error {
+    readonly code: string;
+    readonly diagnostics: Readonly<ErrorDiagnostics>;
+    constructor(code: string, message: string, diagnostics?: ErrorDiagnostics);
+}
+export declare class ConfigError extends XTrawlError {
+    constructor(message: string);
+}
+export declare class ManifestError extends XTrawlError {
+    constructor(message: string);
+}
+export declare class AccountPoolExhausted extends XTrawlError {
+    constructor(message?: string, diagnostics?: ErrorDiagnostics);
+}
+export declare class EngineError extends XTrawlError {
+    constructor(message: string, diagnostics?: ErrorDiagnostics);
+}
+export declare class RunFailed extends EngineError {
+    constructor(message: string, diagnostics?: ErrorDiagnostics);
+}
+export declare class NetworkError extends RunFailed {
+    constructor(message: string, diagnostics?: ErrorDiagnostics);
+}
+export declare class ProxyError extends RunFailed {
+    constructor(message: string, diagnostics?: ErrorDiagnostics);
+}
+export declare class RateLimitError extends RunFailed {
+    constructor(message: string, diagnostics?: ErrorDiagnostics);
+}
+export declare class AuthError extends RunFailed {
+    constructor(message: string, diagnostics?: ErrorDiagnostics);
+}
+export declare class ResumeError extends XTrawlError {
+    constructor(message: string);
+}
+export declare class AccountSessionBuildError extends XTrawlError {
+    readonly statusCode: number;
+    readonly category: ErrorCategory;
+    constructor(code: string, reason: string, options?: {
+        readonly statusCode?: number;
+        readonly category?: ErrorCategory;
+    });
+}
+export declare class AccountSessionAuthError extends AccountSessionBuildError {
+    constructor(code: string, reason: string);
+}
+export declare class AccountSessionRuntimeError extends AccountSessionBuildError {
+    constructor(code: string, reason: string);
+}
+export declare class AccountSessionTransientError extends AccountSessionBuildError {
+    constructor(code: string, reason: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/domain/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/domain/errors.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;AAElG,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC;AAED,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,WAAW,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;gBAErC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,GAAE,gBAAqB;CAMrF;AAED,qBAAa,WAAY,SAAQ,WAAW;gBACvB,OAAO,EAAE,MAAM;CAGnC;AAED,qBAAa,aAAc,SAAQ,WAAW;gBACzB,OAAO,EAAE,MAAM;CAGnC;AAED,qBAAa,oBAAqB,SAAQ,WAAW;gBAChC,OAAO,SAAsC,EAAE,WAAW,GAAE,gBAAqB;CAGrG;AAED,qBAAa,WAAY,SAAQ,WAAW;gBACvB,OAAO,EAAE,MAAM,EAAE,WAAW,GAAE,gBAAqB;CAGvE;AAED,qBAAa,SAAU,SAAQ,WAAW;gBACrB,OAAO,EAAE,MAAM,EAAE,WAAW,GAAE,gBAAqB;CAIvE;AAED,qBAAa,YAAa,SAAQ,SAAS;gBACtB,OAAO,EAAE,MAAM,EAAE,WAAW,GAAE,gBAAqB;CAGvE;AAED,qBAAa,UAAW,SAAQ,SAAS;gBACpB,OAAO,EAAE,MAAM,EAAE,WAAW,GAAE,gBAAqB;CAGvE;AAED,qBAAa,cAAe,SAAQ,SAAS;gBACxB,OAAO,EAAE,MAAM,EAAE,WAAW,GAAE,gBAAqB;CAGvE;AAED,qBAAa,SAAU,SAAQ,SAAS;gBACnB,OAAO,EAAE,MAAM,EAAE,WAAW,GAAE,gBAAqB;CAGvE;AAED,qBAAa,WAAY,SAAQ,WAAW;gBACvB,OAAO,EAAE,MAAM;CAGnC;AAED,qBAAa,wBAAyB,SAAQ,WAAW;IACvD,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,QAAQ,EAAE,aAAa,CAAC;gBAGtC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;QAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAA;KAAO;CASpF;AAED,qBAAa,uBAAwB,SAAQ,wBAAwB;gBAChD,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAGhD;AAED,qBAAa,0BAA2B,SAAQ,wBAAwB;gBACnD,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAGhD;AAED,qBAAa,4BAA6B,SAAQ,wBAAwB;gBACrD,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAGhD"}

package/dist/domain/errors.js

@@ -0,0 +1,89 @@
+export class XTrawlError extends Error {
+    code;
+    diagnostics;
+    constructor(code, message, diagnostics = {}) {
+        super(message);
+        this.name = new.target.name;
+        this.code = code;
+        this.diagnostics = diagnostics;
+    }
+}
+export class ConfigError extends XTrawlError {
+    constructor(message) {
+        super("config_error", message);
+    }
+}
+export class ManifestError extends XTrawlError {
+    constructor(message) {
+        super("manifest_error", message);
+    }
+}
+export class AccountPoolExhausted extends XTrawlError {
+    constructor(message = "No eligible account is available.", diagnostics = {}) {
+        super("account_pool_exhausted", message, diagnostics);
+    }
+}
+export class EngineError extends XTrawlError {
+    constructor(message, diagnostics = {}) {
+        super("engine_error", message, diagnostics);
+    }
+}
+export class RunFailed extends EngineError {
+    constructor(message, diagnostics = {}) {
+        super(message, diagnostics);
+        this.name = new.target.name;
+    }
+}
+export class NetworkError extends RunFailed {
+    constructor(message, diagnostics = {}) {
+        super(message, { ...diagnostics, category: "network" });
+    }
+}
+export class ProxyError extends RunFailed {
+    constructor(message, diagnostics = {}) {
+        super(message, { ...diagnostics, category: "proxy" });
+    }
+}
+export class RateLimitError extends RunFailed {
+    constructor(message, diagnostics = {}) {
+        super(message, { ...diagnostics, category: "rate_limit" });
+    }
+}
+export class AuthError extends RunFailed {
+    constructor(message, diagnostics = {}) {
+        super(message, { ...diagnostics, category: "auth" });
+    }
+}
+export class ResumeError extends XTrawlError {
+    constructor(message) {
+        super("resume_error", message);
+    }
+}
+export class AccountSessionBuildError extends XTrawlError {
+    statusCode;
+    category;
+    constructor(code, reason, options = {}) {
+        super(code, `${code}:${reason}`, {
+            statusCode: options.statusCode ?? 599,
+            category: options.category ?? "transient",
+        });
+        this.statusCode = options.statusCode ?? 599;
+        this.category = options.category ?? "transient";
+    }
+}
+export class AccountSessionAuthError extends AccountSessionBuildError {
+    constructor(code, reason) {
+        super(code, reason, { statusCode: 401, category: "auth" });
+    }
+}
+export class AccountSessionRuntimeError extends AccountSessionBuildError {
+    constructor(code, reason) {
+        super(code, reason, { statusCode: 500, category: "runtime" });
+    }
+}
+export class AccountSessionTransientError extends AccountSessionBuildError {
+    constructor(code, reason) {
+        super(code, reason, { statusCode: 599, category: "transient" });
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/domain/errors.js.map

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

package/dist/domain/http.d.ts

@@ -0,0 +1,36 @@
+import type { CookieMap, ProxySettings } from "./accounts.js";
+export interface HttpResponse {
+    readonly status: number;
+    readonly headers: Readonly<Record<string, string>>;
+    text(): Promise<string>;
+    json(): Promise<unknown>;
+}
+export interface HttpSession {
+    readonly cookies: CookieMap;
+    get(url: string, options?: HttpRequestOptions): Promise<HttpResponse>;
+    post?(url: string, options?: HttpRequestOptions): Promise<HttpResponse>;
+    close(): Promise<void>;
+}
+export interface HttpRequestOptions {
+    readonly query?: Readonly<Record<string, string>>;
+    readonly headers?: Readonly<Record<string, string>>;
+    readonly body?: unknown;
+    readonly timeoutMs?: number;
+    readonly redirect?: "follow" | "error" | "manual";
+}
+export interface SessionFactoryOptions {
+    readonly cookies: CookieMap;
+    readonly proxy?: string | ProxySettings;
+    readonly bearerToken?: string;
+    readonly userAgent?: string;
+    readonly impersonate?: string;
+    readonly httpMode?: "auto" | "async" | "sync";
+}
+export type SessionFactory = (options: SessionFactoryOptions) => HttpSession;
+export interface GraphqlResponse {
+    readonly data: unknown | null;
+    readonly status: number;
+    readonly headers: Readonly<Record<string, string>>;
+    readonly snippet: string;
+}
+//# sourceMappingURL=http.d.ts.map

package/dist/domain/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/domain/http.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9D,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IACxB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACtE,IAAI,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IACxE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAC;CACnD;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;CAC/C;AAED,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,qBAAqB,KAAK,WAAW,CAAC;AAE7E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACnD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B"}

package/dist/domain/http.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=http.js.map

package/dist/domain/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../../src/domain/http.ts"],"names":[],"mappings":""}

package/dist/domain/manifest.d.ts

@@ -0,0 +1,23 @@
+export type FeatureFlags = Readonly<Record<string, boolean>>;
+export type FieldToggles = Readonly<Record<string, boolean>>;
+export interface ManifestPayload {
+    readonly version: string;
+    readonly queryIds: Readonly<Record<string, string>>;
+    readonly endpoints: Readonly<Record<string, string>>;
+    readonly features?: FeatureFlags;
+    readonly operationFeatures?: Readonly<Record<string, FeatureFlags>>;
+    readonly operationFieldToggles?: Readonly<Record<string, FieldToggles>>;
+    readonly timeoutSeconds?: number;
+}
+export interface Manifest {
+    readonly version: string;
+    readonly queryIds: Readonly<Record<string, string>>;
+    readonly endpoints: Readonly<Record<string, string>>;
+    readonly features: FeatureFlags;
+    readonly operationFeatures: Readonly<Record<string, FeatureFlags>>;
+    readonly operationFieldToggles: Readonly<Record<string, FieldToggles>>;
+    readonly timeoutSeconds: number;
+    featuresFor(operation: string): FeatureFlags;
+    fieldTogglesFor(operation: string): FieldToggles;
+}
+//# sourceMappingURL=manifest.d.ts.map

package/dist/domain/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/domain/manifest.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAC7D,MAAM,MAAM,YAAY,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;AAE7D,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACjC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IACpE,QAAQ,CAAC,qBAAqB,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IACxE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACpD,QAAQ,CAAC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;IAChC,QAAQ,CAAC,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IACnE,QAAQ,CAAC,qBAAqB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;IACvE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAAC;IAC7C,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,CAAC;CAClD"}

package/dist/domain/manifest.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=manifest.js.map

package/dist/domain/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/domain/manifest.ts"],"names":[],"mappings":""}

package/dist/domain/records.d.ts

@@ -0,0 +1,67 @@
+export interface TweetUser {
+    readonly screenName?: string;
+    readonly name?: string;
+}
+export interface TweetMedia {
+    readonly imageLinks: readonly string[];
+}
+export interface TweetRecord {
+    readonly tweetId: string;
+    readonly user: TweetUser;
+    readonly timestamp?: string;
+    readonly text?: string;
+    readonly embeddedText?: string;
+    readonly comments: number;
+    readonly likes: number;
+    readonly retweets: number;
+    readonly media: TweetMedia;
+    readonly tweetUrl?: string;
+    readonly raw?: Readonly<Record<string, unknown>>;
+}
+export interface RunStats {
+    readonly tweetsCount: number;
+    readonly tasksTotal: number;
+    readonly tasksDone: number;
+    readonly tasksFailed: number;
+    readonly retries: number;
+}
+export interface SearchResult {
+    readonly tweets: readonly TweetRecord[];
+    readonly stats: RunStats;
+}
+export interface ProfileRecord {
+    readonly input: {
+        readonly raw?: string;
+        readonly source?: string;
+    };
+    readonly userId?: string;
+    readonly username?: string;
+    readonly name?: string;
+    readonly description?: string;
+    readonly location?: string;
+    readonly createdAt?: string;
+    readonly followersCount: number;
+    readonly followingCount: number;
+    readonly statusesCount: number;
+    readonly favouritesCount: number;
+    readonly mediaCount: number;
+    readonly listedCount: number;
+    readonly verified: boolean;
+    readonly blueVerified: boolean;
+    readonly protected: boolean;
+    readonly profileImageUrl?: string;
+    readonly profileBannerUrl?: string;
+    readonly url?: string;
+    readonly raw?: Readonly<Record<string, unknown>>;
+}
+export interface FollowRecord extends Omit<ProfileRecord, "input"> {
+    readonly type: "followers" | "following" | "verified_followers";
+    readonly target: {
+        readonly raw?: string;
+        readonly source?: string;
+        readonly userId?: string;
+        readonly username?: string;
+        readonly profileUrl?: string;
+    };
+}
+//# sourceMappingURL=records.d.ts.map

package/dist/domain/records.d.ts.map

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

package/dist/domain/records.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=records.js.map

package/dist/domain/records.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"records.js","sourceRoot":"","sources":["../../src/domain/records.ts"],"names":[],"mappings":""}

package/dist/domain/requests.d.ts

@@ -0,0 +1,87 @@
+export type TweetType = "all" | "originals_only" | "replies_only" | "retweets_only" | "exclude_replies" | "exclude_retweets";
+export type FollowType = "followers" | "following" | "verified_followers";
+export interface SearchRequest {
+    readonly since?: string;
+    readonly until?: string;
+    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 limit?: number;
+    readonly displayType?: "Top" | "Latest";
+    readonly resume?: boolean;
+    readonly save?: boolean;
+    readonly saveFormat?: "csv" | "json" | "both";
+    readonly saveDir?: string;
+    readonly saveName?: string;
+    readonly maxEmptyPages?: number;
+}
+export interface TargetInput {
+    readonly raw?: string;
+    readonly username?: string;
+    readonly profileUrl?: string;
+    readonly userId?: string;
+    readonly source?: string;
+}
+export interface UserInfoRequest {
+    readonly save?: boolean;
+    readonly saveFormat?: "csv" | "json" | "both";
+    readonly saveDir?: string;
+    readonly saveName?: string;
+}
+export interface ProfileTimelineRequest {
+    readonly targets: readonly TargetInput[];
+    readonly limit?: number;
+    readonly perProfileLimit?: number;
+    readonly maxPagesPerProfile?: number;
+    readonly resume?: boolean;
+    readonly initialCursors?: Readonly<Record<string, string>>;
+    readonly cursorHandoff?: boolean;
+    readonly maxAccountSwitches?: number;
+    readonly allowAnonymous?: boolean;
+    readonly maxEmptyPages?: number;
+    readonly save?: boolean;
+    readonly saveFormat?: "csv" | "json" | "both";
+    readonly saveDir?: string;
+    readonly saveName?: string;
+}
+export interface FollowsRequest {
+    readonly targets: readonly TargetInput[];
+    readonly followType: FollowType;
+    readonly limit?: number;
+    readonly perProfileLimit?: number;
+    readonly maxPagesPerProfile?: number;
+    readonly resume?: boolean;
+    readonly initialCursors?: Readonly<Record<string, string>>;
+    readonly cursorHandoff?: boolean;
+    readonly maxAccountSwitches?: number;
+    readonly maxEmptyPages?: number;
+    readonly rawJson?: boolean;
+    readonly save?: boolean;
+    readonly saveFormat?: "csv" | "json" | "both";
+    readonly saveDir?: string;
+    readonly saveName?: string;
+}
+//# sourceMappingURL=requests.d.ts.map

package/dist/domain/requests.d.ts.map

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

package/dist/domain/requests.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=requests.js.map

package/dist/domain/requests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requests.js","sourceRoot":"","sources":["../../src/domain/requests.ts"],"names":[],"mappings":""}

package/dist/engine/api-engine.d.ts

@@ -0,0 +1,25 @@
+import type { ClientConfig } from "../config/types.js";
+import type { HttpSession } from "../domain/http.js";
+import type { FollowType, ProfileTimelineRequest, SearchRequest, TargetInput } from "../domain/requests.js";
+import type { TweetRecord } from "../domain/records.js";
+import type { FollowPage, TweetPage } from "./extractors.js";
+import type { ManifestProvider } from "../manifest/provider.js";
+import type { GraphqlTransport } from "../transport/graphql.js";
+export declare class ApiEngine {
+    private readonly config;
+    private readonly manifests;
+    private readonly transport;
+    constructor(config: ClientConfig, manifests: ManifestProvider, transport: GraphqlTransport);
+    search(session: HttpSession, request: SearchRequest, cursor?: string): Promise<TweetPage>;
+    lookupUser(session: HttpSession, username: string): Promise<Record<string, unknown>>;
+    profilePage(session: HttpSession, userId: string, request: ProfileTimelineRequest, cursor?: string): Promise<TweetPage>;
+    followsPage(session: HttpSession, userId: string, type: FollowType, cursor?: string): Promise<FollowPage>;
+    tweetResult(session: HttpSession, tweetId: string): Promise<TweetRecord | undefined>;
+    private graphql;
+    resolveTarget(session: HttpSession, target: TargetInput): Promise<{
+        readonly username: string;
+        readonly userId: string;
+        readonly raw: Record<string, unknown>;
+    }>;
+}
+//# sourceMappingURL=api-engine.d.ts.map

package/dist/engine/api-engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-engine.d.ts","sourceRoot":"","sources":["../../src/engine/api-engine.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAmB,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEtE,OAAO,KAAK,EAAE,UAAU,EAAE,sBAAsB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC5G,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAQ7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAYhE,qBAAa,SAAS;IAElB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAFT,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,gBAAgB,EAC3B,SAAS,EAAE,gBAAgB;IAGjC,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAWzF,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAapF,WAAW,CACtB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,sBAAsB,EAC/B,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,SAAS,CAAC;IAWR,WAAW,CACtB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,UAAU,EAChB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,CAAC;IAiBT,WAAW,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC;YAWnF,OAAO;IA2BR,aAAa,CACxB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;CAW1G"}

package/dist/engine/api-engine.js

@@ -0,0 +1,98 @@
+import { extractFollows, extractProfileTweets, extractSearchTweets, extractTweetResult, extractUserResult, } from "./extractors.js";
+import { buildFollowsParams, buildProfileTimelineParams, buildSearchParams, buildTweetResultParams, buildUserLookupParams, endpointFor, OPERATION, } from "../query/builder.js";
+import { NetworkError } from "../domain/errors.js";
+export class ApiEngine {
+    config;
+    manifests;
+    transport;
+    constructor(config, manifests, transport) {
+        this.config = config;
+        this.manifests = manifests;
+        this.transport = transport;
+    }
+    async search(session, request, cursor) {
+        const response = await this.graphql(session, OPERATION.search, (manifest) => buildSearchParams(request, manifest, cursor, this.config.apiPageSize));
+        if (response.status !== 200 || !response.data)
+            throw new NetworkError(`Search request returned status ${response.status}.`, {
+                statusCode: response.status,
+            });
+        return extractSearchTweets(response.data);
+    }
+    async lookupUser(session, username) {
+        const response = await this.graphql(session, OPERATION.userLookup, (manifest) => buildUserLookupParams(username, manifest));
+        if (response.status !== 200 || !response.data)
+            throw new NetworkError(`User lookup returned status ${response.status}.`, {
+                statusCode: response.status,
+            });
+        const user = extractUserResult(response.data);
+        if (!user)
+            throw new NetworkError(`User ${username} was not found.`, { statusCode: 404 });
+        return user;
+    }
+    async profilePage(session, userId, request, cursor) {
+        const response = await this.graphql(session, OPERATION.profileTimeline, (manifest) => buildProfileTimelineParams(userId, request, manifest, cursor, this.config.apiPageSize));
+        if (response.status !== 200 || !response.data)
+            throw new NetworkError(`Profile timeline returned status ${response.status}.`, {
+                statusCode: response.status,
+            });
+        return extractProfileTweets(response.data);
+    }
+    async followsPage(session, userId, type, cursor) {
+        const operation = type === "followers"
+            ? OPERATION.followers
+            : type === "verified_followers"
+                ? OPERATION.verifiedFollowers
+                : OPERATION.following;
+        const response = await this.graphql(session, operation, (manifest) => buildFollowsParams(userId, operation, manifest, cursor, this.config.apiPageSize));
+        if (response.status !== 200 || !response.data)
+            throw new NetworkError(`Relationship request returned status ${response.status}.`, {
+                statusCode: response.status,
+            });
+        return extractFollows(response.data);
+    }
+    async tweetResult(session, tweetId) {
+        const response = await this.graphql(session, OPERATION.tweetResult, (manifest) => buildTweetResultParams(tweetId, manifest));
+        if (response.status !== 200 || !response.data)
+            throw new NetworkError(`Tweet lookup returned status ${response.status}.`, {
+                statusCode: response.status,
+            });
+        return extractTweetResult(response.data);
+    }
+    async graphql(session, operation, buildParams) {
+        const send = (manifest) => this.transport.get(session, endpointFor(manifest, operation), buildParams(manifest), manifest.timeoutSeconds * 1_000);
+        const manifest = await this.manifests.getManifest();
+        try {
+            return await send(manifest);
+        }
+        catch (error) {
+            if (!isOperationMismatch(error))
+                throw error;
+            let refreshed;
+            try {
+                refreshed = await this.manifests.refreshLive(session.cookies.auth_token);
+            }
+            catch {
+                throw error;
+            }
+            return send(refreshed);
+        }
+    }
+    async resolveTarget(session, target) {
+        const username = target.username?.replace(/^@/u, "") ?? target.profileUrl?.split("/").filter(Boolean).pop();
+        if (target.userId && !username)
+            return { username: target.userId, userId: target.userId, raw: {} };
+        if (!username)
+            throw new NetworkError("Target has no resolvable username or user ID.", { statusCode: 400 });
+        const raw = target.userId ? {} : await this.lookupUser(session, username);
+        const userId = target.userId ?? String(raw.rest_id ?? raw.id ?? "");
+        if (!userId)
+            throw new NetworkError(`Target ${username} has no user id.`, { statusCode: 404 });
+        return { username, userId, raw };
+    }
+}
+function isOperationMismatch(error) {
+    if (!(error instanceof NetworkError))
+        return false;
+    return error.diagnostics.statusCode === 404 || error.diagnostics.statusCode === 422;
+}
+//# sourceMappingURL=api-engine.js.map

package/dist/engine/api-engine.js.map

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

package/dist/engine/extractors.d.ts

@@ -0,0 +1,27 @@
+import type { FollowRecord, ProfileRecord, TweetRecord } from "../domain/records.js";
+export interface TweetPage {
+    readonly tweets: readonly TweetRecord[];
+    readonly cursor?: string;
+}
+export interface FollowPage {
+    readonly users: readonly Record<string, unknown>[];
+    readonly cursor?: string;
+}
+export declare function extractUserResult(payload: unknown): Record<string, unknown> | undefined;
+export declare function mapProfile(user: Record<string, unknown>, target: {
+    readonly raw?: string;
+    readonly source?: string;
+}, fallbackUsername?: string): ProfileRecord;
+export declare function mapFollow(user: Record<string, unknown>, target: {
+    readonly raw?: string;
+    readonly source?: string;
+    readonly userId?: string;
+    readonly username?: string;
+    readonly profileUrl?: string;
+}, type: FollowRecord["type"], includeRaw?: boolean): FollowRecord;
+export declare function extractSearchTweets(payload: unknown): TweetPage;
+export declare function extractProfileTweets(payload: unknown): TweetPage;
+export declare function extractTweetResult(payload: unknown): TweetRecord | undefined;
+export declare function extractFollows(payload: unknown): FollowPage;
+export declare function normalizeUser(user: Record<string, unknown>, fallbackUsername?: string): Omit<ProfileRecord, "input" | "raw">;
+//# sourceMappingURL=extractors.d.ts.map

package/dist/engine/extractors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractors.d.ts","sourceRoot":"","sources":["../../src/engine/extractors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGrF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACnD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAKvF;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAC3D,gBAAgB,CAAC,EAAE,MAAM,GACxB,aAAa,CAUf;AAED,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,MAAM,EAAE;IACN,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,EACD,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,EAC1B,UAAU,UAAQ,GACjB,YAAY,CAad;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAO/D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAQhE;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,CAM5E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAmB3D;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,gBAAgB,CAAC,EAAE,MAAM,GACxB,IAAI,CAAC,aAAa,EAAE,OAAO,GAAG,KAAK,CAAC,CAkDtC"}