@suphark/files-client 0.0.0-stage → 0.3.0

package/dist/upload-D79TA4qU.d.ts

@@ -0,0 +1,76 @@
+import { Problem, FileAssetDto, UploadTicket } from '@pi/files-contracts';
+
+/** error จาก Pi Files API (problem+json) หรือจาก storage/network ระหว่างอัปโหลด */
+declare class PiFilesError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly problem?: Problem | undefined;
+    constructor(status: number, code: string, message: string, problem?: Problem | undefined);
+}
+interface HttpOptions {
+    baseUrl: string;
+    /** API key ของแอป (server เท่านั้น) */
+    appKey?: string;
+    /** access token ของผู้ใช้ (Pi Auth JWT) — ใช้แทน appKey เมื่อต้องการ user-context */
+    getUserToken?: () => Promise<string | null> | string | null;
+    fetch?: typeof fetch;
+    /** ส่ง cookie ของ Pi Files เอง (browser ภายใน files.suphark.com) */
+    credentials?: RequestCredentials;
+}
+
+/**
+ * ตัวอัปโหลด bytes ตาม ticket — ใช้ได้ทั้ง browser (XHR เพื่อ progress) และ node (fetch)
+ * ผู้เรียกต้องมี `api` ที่คุยกับ Pi Files (parts/complete) — SDK core หรือ endpoint proxy ของ consumer
+ */
+interface UploadApi {
+    partUrls(uploadId: string, partNumbers: number[]): Promise<{
+        parts: {
+            partNumber: number;
+            url: string;
+            method?: "PUT" | "POST";
+            headers?: Record<string, string>;
+        }[];
+    }>;
+    complete(uploadId: string, parts?: {
+        partNumber: number;
+        etag: string;
+    }[]): Promise<FileAssetDto>;
+    abort(uploadId: string): Promise<void>;
+}
+interface UploadProgress {
+    loaded: number;
+    total: number;
+    fraction: number;
+}
+interface PerformUploadOptions {
+    onProgress?: (p: UploadProgress) => void;
+    signal?: AbortSignal;
+    concurrency?: number;
+    /** part ที่อัปโหลดเสร็จแล้ว (resume) */
+    completedParts?: {
+        partNumber: number;
+        etag: string;
+    }[];
+    onPartDone?: (part: {
+        partNumber: number;
+        etag: string;
+    }) => void;
+}
+type UploadSource = Blob | Uint8Array | ArrayBuffer;
+/**
+ * ส่ง bytes ไป storage ด้วย XHR (progress) เมื่ออยู่ใน browser, fetch เมื่อไม่มี XHR
+ * etag: header ETag (S3/R2) หรือ JSON body { etag } (part ของ Vercel Blob ที่ส่งด้วย POST)
+ */
+declare function putBytes(url: string, body: Blob, headers: Record<string, string>, onProgress: (loaded: number) => void, signal?: AbortSignal, method?: "PUT" | "POST"): Promise<{
+    etag: string | null;
+}>;
+declare function performUpload(api: UploadApi, ticket: UploadTicket, source: UploadSource, mimeType: string, options?: PerformUploadOptions): Promise<FileAssetDto>;
+/** fingerprint ของไฟล์สำหรับ resume (ชื่อ+ขนาด+lastModified) */
+declare function fileFingerprint(file: {
+    name: string;
+    size: number;
+    lastModified?: number;
+}): string;
+
+export { PiFilesError as P, putBytes as d, fileFingerprint as f, performUpload as p };
+export type { HttpOptions as H, UploadProgress as U, UploadApi as a, UploadSource as b, PerformUploadOptions as c };

package/package.json

@@ -1,6 +1,77 @@
 {
   "name": "@suphark/files-client",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.3.0",
+  "private": false,
+  "type": "module",
+  "description": "Pi Files SDK: presigned/multipart upload, content proxy for Next.js route handlers, React upload hook, file references",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./next": {
+      "types": "./dist/next/index.d.ts",
+      "import": "./dist/next/index.js",
+      "default": "./dist/next/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js",
+      "default": "./dist/react/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --passWithNoTests",
+    "prepack": "pnpm run build"
+  },
+  "peerDependencies": {
+    "next": ">=15",
+    "react": ">=19"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    },
+    "react": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@pi/config": "workspace:*",
+    "@pi/files-contracts": "workspace:*",
+    "@types/node": "^26.6.5",
+    "@types/react": "^19.2.18",
+    "next": "^16.4.2",
+    "react": "^19.3.1",
+    "tsup": "^9.0.0",
+    "typescript": "^6.0.3",
+    "vitest": "^5.0.5",
+    "zod": "^4.6.7"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/suphark/files",
+    "directory": "packages/files-client"
+  },
+  "keywords": [
+    "files",
+    "upload",
+    "r2",
+    "nextjs",
+    "pi-files"
+  ],
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  }
+}