@postfetch/core 0.2.0

package/README.md

@@ -0,0 +1,20 @@
+# @postfetch/core
+
+Zero-dependency typed core that turns Instagram, TikTok and YouTube post URLs into media files. Part of [postfetch](https://github.com/chelokot/postfetch).
+
+```ts
+import { postfetch, download, archive, toResponse, PostfetchError } from "@postfetch/core";
+
+const result = await postfetch("https://vt.tiktok.com/ZSxpHvCUM/");
+for (const item of result.items) {
+  console.log(item.kind, item.mime, item.url);
+}
+```
+
+`postfetch(url, options?)` detects the platform and resolves its media into a typed `PostfetchResult` (URLs plus the headers needed to fetch them). It performs no side effects beyond the lookup — `download`, `archive` and `toResponse` turn the result into bytes or an HTTP `Response`.
+
+- `PostfetchOptions` — `{ fetch?: typeof fetch; preferredWidth?: number }`. Inject `fetch` to unit-test resolvers offline.
+- Every request rotates a consistent browser/app fingerprint, so a fixed user-agent never gets the whole fleet blocked.
+- No runtime dependencies, no `ffmpeg` / `yt-dlp`, no cookies.
+
+See the [root README](https://github.com/chelokot/postfetch#readme) for the full API table, supported inputs and the fingerprint design.

package/dist/download.d.ts

@@ -0,0 +1,12 @@
+import { type MediaItem, type PostfetchResult } from "./internal";
+export type DownloadOptions = {
+    fetch?: typeof fetch;
+};
+export type Archive = {
+    bytes: Uint8Array;
+    filename: string;
+    mime: "application/zip";
+};
+export declare function download(item: MediaItem, options?: DownloadOptions): Promise<Response>;
+export declare function archive(result: PostfetchResult, options?: DownloadOptions): Promise<Archive>;
+export declare function toResponse(result: PostfetchResult, options?: DownloadOptions): Promise<Response>;

package/dist/facebook.d.ts

@@ -0,0 +1,2 @@
+import { type ResolveContext, type PostfetchResult } from "./internal";
+export declare function resolveFacebook(input: ResolveContext): Promise<PostfetchResult>;

package/dist/fingerprint.d.ts

@@ -0,0 +1,11 @@
+export type BrowserFingerprint = {
+    acceptLanguage: string;
+    secChUa: string;
+    secChUaPlatform: string;
+    userAgent: string;
+};
+export declare function browserFingerprint(): BrowserFingerprint;
+export declare function navigationHeaders(): Record<string, string>;
+export declare function browserUserAgent(): string;
+export declare function firefoxUserAgent(): string;
+export declare function instagramAppUserAgent(): string;

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { postfetch, detect, type PostfetchOptions } from "./postfetch";
+export { download, archive, toResponse, type Archive, type DownloadOptions } from "./download";
+export { PostfetchError } from "./internal";
+export type { MediaItem, MediaKind, Platform, PostfetchResult } from "./internal";