@kmlckj/licos-platform-sdk 0.2.0 → 0.3.0

package/README.md

@@ -20,6 +20,7 @@ await download(uploaded.download_url, '/tmp/report-downloaded.pdf');
 - 默认走同源相对地址；也可以显式传 `baseUrl`
 - 上传支持 `File` / `Blob` / `ArrayBuffer` / TypedArray / `{ data, fileName, contentType }`
 - `download(url)` 返回 `Blob`
+- TypeScript 前端可显式导入浏览器入口 `@kmlckj/licos-platform-sdk/browser`，拿到浏览器专用类型
 
 ```js
 import { uploadUser, download } from '@kmlckj/licos-platform-sdk';
@@ -30,3 +31,13 @@ const uploaded = await uploadUser(fileInput.files[0], {
 
 const blob = await download(uploaded.download_url);
 ```
+
+```ts
+import { uploadUser, download } from '@kmlckj/licos-platform-sdk/browser';
+
+const uploaded = await uploadUser(fileInput.files![0], {
+  token: userJwt,
+});
+
+const blob = await download(uploaded.download_url);
+```

package/package.json

@@ -1,18 +1,33 @@
 {
   "name": "@kmlckj/licos-platform-sdk",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "LICOS platform SDK for storage upload, download, and preview in browser and Node runtimes",
   "author": "kmlckj",
   "type": "module",
   "main": "./src/index.js",
   "browser": "./src/browser.js",
   "types": "./src/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "browser": [
+        "src/browser.d.ts"
+      ]
+    }
+  },
   "exports": {
     ".": {
+      "browser": {
+        "types": "./src/browser.d.ts",
+        "default": "./src/browser.js"
+      },
       "types": "./src/index.d.ts",
-      "browser": "./src/browser.js",
       "import": "./src/index.js",
       "default": "./src/index.js"
+    },
+    "./browser": {
+      "types": "./src/browser.d.ts",
+      "import": "./src/browser.js",
+      "default": "./src/browser.js"
     }
   },
   "files": [

package/src/browser.d.ts

@@ -0,0 +1,82 @@
+export interface UploadResult {
+  bucket: string;
+  object_key: string;
+  file_name: string;
+  content_type: string;
+  size_bytes: number;
+  preview_url: string;
+  download_url: string;
+}
+
+export interface BlobLike {
+  arrayBuffer(): Promise<ArrayBuffer>;
+  readonly size?: number;
+  readonly type?: string;
+  readonly name?: string;
+}
+
+export interface UploadBinaryDescriptor {
+  data?: ArrayBuffer | ArrayBufferView | BlobLike;
+  file?: ArrayBuffer | ArrayBufferView | BlobLike;
+  fileName?: string;
+  contentType?: string;
+}
+
+export type UploadSource =
+  | ArrayBuffer
+  | ArrayBufferView
+  | BlobLike
+  | UploadBinaryDescriptor;
+
+export interface StorageClientOptions {
+  baseUrl?: string;
+  token?: string;
+  userId?: string;
+  projectId?: string;
+  fetch?: typeof fetch;
+  headers?: HeadersInit;
+  credentials?: RequestCredentials;
+}
+
+export interface UploadProjectOptions extends StorageClientOptions {
+  userId?: string;
+  projectId?: string;
+}
+
+export class PlatformSdkError extends Error {
+  status?: number;
+  code?: number;
+  details?: unknown;
+}
+
+export class ConfigurationError extends PlatformSdkError {}
+export class ApiError extends PlatformSdkError {}
+
+export class StorageClient {
+  constructor(options?: StorageClientOptions);
+  previewUrl(bucket: string, objectKey: string): string;
+  downloadUrl(bucket: string, objectKey: string): string;
+  uploadUser(file: UploadSource): Promise<UploadResult>;
+  uploadProject(file: UploadSource, options?: UploadProjectOptions): Promise<UploadResult>;
+  download(url: string): Promise<Blob>;
+}
+
+export function previewUrl(
+  bucket: string,
+  objectKey: string,
+  options?: StorageClientOptions,
+): string;
+export function downloadUrl(
+  bucket: string,
+  objectKey: string,
+  options?: StorageClientOptions,
+): string;
+export function uploadUser(
+  file: UploadSource,
+  options?: StorageClientOptions,
+): Promise<UploadResult>;
+export function uploadProject(
+  file: UploadSource,
+  options?: UploadProjectOptions,
+): Promise<UploadResult>;
+export function download(url: string, options?: StorageClientOptions): Promise<Blob>;