@rebalworks/transfer-react 0.1.1

package/LICENSE

@@ -0,0 +1,8 @@
+rebalTransfer — Proprietary Software License
+Copyright (c) 2026 rebalworks CO., LTD. All Rights Reserved.
+
+This package is proprietary and confidential. Unauthorized copying,
+modification, distribution, or use of this software, via any medium, is
+strictly prohibited without prior written permission from rebalworks CO., LTD.
+
+For licensing inquiries, contact: byhaejin@f-m.kr

package/README.md

@@ -0,0 +1,72 @@
+# @rebalworks/transfer-react
+
+React hooks for rebalTransfer uploads.
+
+Use this package when a React or Next.js screen needs file upload state without
+building its own transfer orchestration.
+
+## Install
+
+```bash
+npm install @rebalworks/transfer-react
+```
+
+## Hooks
+
+| Hook | Purpose |
+| --- | --- |
+| `useTransferUpload` | Starts an upload and exposes progress, completion, abort, and error state. |
+| `useStorageProfiles` | Loads the storage profiles configured on the rebalTransfer server. |
+
+## Upload Example
+
+```tsx
+'use client';
+
+import { useTransferUpload } from '@rebalworks/transfer-react';
+
+export function UploadField() {
+  const upload = useTransferUpload({
+    apiBase: 'https://transfer.example.com/api/v1/sessions',
+    storageProfile: 'google-drive-main',
+  });
+
+  return (
+    <>
+      <input
+        type="file"
+        onChange={(event) => {
+          const file = event.currentTarget.files?.[0];
+          if (file) upload.upload(file);
+        }}
+      />
+
+      <progress value={upload.progress?.percent ?? 0} max={100} />
+
+      <button type="button" onClick={() => void upload.abort()}>
+        Cancel
+      </button>
+    </>
+  );
+}
+```
+
+## Storage Profiles
+
+```tsx
+import { useStorageProfiles } from '@rebalworks/transfer-react';
+
+const { profiles, loading, error, reload } = useStorageProfiles({
+  apiRoot: 'https://transfer.example.com/api/v1',
+});
+```
+
+## Package Contents
+
+The npm package contains minified JavaScript, public TypeScript declarations,
+README, LICENSE, and package metadata only. It does not include source maps,
+test files, or original TypeScript sources.
+
+## License
+
+Proprietary. See `LICENSE`.

package/dist/index.cjs

@@ -0,0 +1 @@
+'use strict';var react=require('react'),transferSdk=require('@rebalworks/transfer-sdk');var V={profiles:[],loading:false};function K(n={}){let{apiRoot:r,authToken:p,enabled:T=true}=n,l=react.useRef(null),f=react.useRef(true),[E,S]=react.useState(V),g=react.useCallback(async()=>{l.current?.abort();let u=new AbortController;l.current=u,S(a=>({...a,loading:true,error:void 0}));try{let a=await transferSdk.listStorageProfiles({...r!==void 0?{apiRoot:r}:{},...p!==void 0?{authToken:p}:{},signal:u.signal}),d=a.find(t=>t.defaultProfile);return f.current&&l.current===u&&S({profiles:a,...d!==void 0?{defaultProfile:d}:{},loading:!1}),a}catch(a){let d=j(a);throw f.current&&l.current===u&&S(t=>({...t,loading:false,error:d})),d}},[r,p]);return react.useEffect(()=>(f.current=true,T&&g(),()=>{f.current=false,l.current?.abort();}),[T,g]),{...E,reload:g}}function j(n){return n instanceof Error?n:new Error(String(n))}var x={phase:"idle"};function Q(n={}){let{abortOnUnmount:r=false,apiBase:p,authToken:T,chunkSize:l,forceMainThread:f,retries:E,resumeSessionId:S,sha256:g,signal:u,storageProfile:a,workerPoolSize:d}=n,t=react.useRef(true),i=react.useRef(null),U=react.useRef(null),[y,h]=react.useState(x),s=react.useCallback(()=>{U.current?.(),U.current=null;},[]),z=react.useCallback((P,v={})=>{s();let k=W(P,{apiBase:p,authToken:T,chunkSize:l,forceMainThread:f,retries:E,resumeSessionId:S,sha256:g,signal:u,storageProfile:a,workerPoolSize:d,...v}),o=transferSdk.createTransferSession(k);i.current=o,h({phase:k.sha256===void 0&&!k.forceMainThread?"hashing":"uploading"});let H=[o.on("sha256:progress",e=>{m({phase:e.percent>=100?"uploading":"hashing",sha256Progress:e});}),o.on("progress",e=>{m({phase:"uploading",progress:e});}),o.on("chunk:done",e=>{m({phase:"uploading",lastChunk:e});}),o.on("session:complete",e=>{D(e);}),o.on("session:error",e=>{C(e.error,e.cancelled);})];return U.current=()=>{for(let e of H)e();},o.sessionId.then(e=>m({sessionId:e})).catch(e=>C(I(e),w(e))),o.done.then(e=>{m({phase:"completed",session:e});}).catch(e=>C(I(e),w(e))),o;function m(e){!t.current||i.current!==o||h(c=>({...c,...e,error:e.phase==="error"?e.error:c.error}));}function D(e){!t.current||i.current!==o||(s(),h(c=>({...c,phase:"completed",session:e.session,error:void 0})));}function C(e,c){!t.current||i.current!==o||(s(),h(N=>({...N,phase:c?"aborted":"error",error:c?void 0:e})));}},[p,T,l,s,f,E,S,g,u,a,d]),A=react.useCallback(async()=>{let P=i.current;P!==null&&(await P.abort(),t.current&&i.current===P&&(s(),h(v=>({...v,phase:"aborted",error:void 0}))));},[s]),M=react.useCallback(()=>{s(),i.current=null,h(x);},[s]);return react.useEffect(()=>(t.current=true,()=>{t.current=false,s(),r&&i.current?.abort();}),[r,s]),{...y,uploading:y.phase==="hashing"||y.phase==="uploading",completed:y.phase==="completed",aborted:y.phase==="aborted",upload:z,abort:A,reset:M,handle:i.current}}function W(n,r){return {file:n,...r.apiBase!==void 0?{apiBase:r.apiBase}:{},...r.authToken!==void 0?{authToken:r.authToken}:{},...r.chunkSize!==void 0?{chunkSize:r.chunkSize}:{},...r.forceMainThread!==void 0?{forceMainThread:r.forceMainThread}:{},...r.retries!==void 0?{retries:r.retries}:{},...r.resumeSessionId!==void 0?{resumeSessionId:r.resumeSessionId}:{},...r.sha256!==void 0?{sha256:r.sha256}:{},...r.signal!==void 0?{signal:r.signal}:{},...r.storageProfile!==void 0?{storageProfile:r.storageProfile}:{},...r.workerPoolSize!==void 0?{workerPoolSize:r.workerPoolSize}:{}}}function I(n){return n instanceof Error?n:new Error(String(n))}function w(n){return n instanceof DOMException&&n.name==="AbortError"}var ne="0.1.1";Object.defineProperty(exports,"CORE_VERSION",{enumerable:true,get:function(){return transferSdk.VERSION}});exports.REACT_SDK_VERSION=ne;exports.useStorageProfiles=K;exports.useTransferUpload=Q;

package/dist/index.d.cts

@@ -0,0 +1,47 @@
+import { StorageProfile, CreateTransferSessionOptions, ProgressEvent, Sha256ProgressEvent, ChunkDoneEvent, TransferSession, TransferSessionHandle } from '@rebalworks/transfer-sdk';
+export { VERSION as CORE_VERSION, ChunkDoneEvent, CreateTransferSessionOptions, ProgressEvent, SessionCompleteEvent, SessionErrorEvent, Sha256ProgressEvent, StorageProfile, TransferSession, TransferSessionHandle } from '@rebalworks/transfer-sdk';
+
+interface UseStorageProfilesOptions {
+    readonly apiRoot?: string | undefined;
+    readonly authToken?: string | undefined;
+    readonly enabled?: boolean | undefined;
+}
+interface StorageProfilesState {
+    readonly profiles: readonly StorageProfile[];
+    readonly defaultProfile?: StorageProfile | undefined;
+    readonly loading: boolean;
+    readonly error?: Error | undefined;
+}
+interface UseStorageProfilesResult extends StorageProfilesState {
+    readonly reload: () => Promise<readonly StorageProfile[]>;
+}
+declare function useStorageProfiles(options?: UseStorageProfilesOptions): UseStorageProfilesResult;
+
+type TransferUploadPhase = 'idle' | 'hashing' | 'uploading' | 'completed' | 'aborted' | 'error';
+type TransferUploadConfig = Omit<CreateTransferSessionOptions, 'file'> & {
+    readonly abortOnUnmount?: boolean | undefined;
+};
+type TransferUploadOverrides = Partial<Omit<CreateTransferSessionOptions, 'file'>>;
+interface TransferUploadState {
+    readonly phase: TransferUploadPhase;
+    readonly progress?: ProgressEvent | undefined;
+    readonly sha256Progress?: Sha256ProgressEvent | undefined;
+    readonly lastChunk?: ChunkDoneEvent | undefined;
+    readonly session?: TransferSession | undefined;
+    readonly sessionId?: string | undefined;
+    readonly error?: Error | undefined;
+}
+interface UseTransferUploadResult extends TransferUploadState {
+    readonly uploading: boolean;
+    readonly completed: boolean;
+    readonly aborted: boolean;
+    readonly upload: (file: File, overrides?: TransferUploadOverrides) => TransferSessionHandle;
+    readonly abort: () => Promise<void>;
+    readonly reset: () => void;
+    readonly handle: TransferSessionHandle | null;
+}
+declare function useTransferUpload(config?: TransferUploadConfig): UseTransferUploadResult;
+
+declare const REACT_SDK_VERSION = "0.1.1";
+
+export { REACT_SDK_VERSION, type StorageProfilesState, type TransferUploadConfig, type TransferUploadOverrides, type TransferUploadPhase, type TransferUploadState, type UseStorageProfilesOptions, type UseStorageProfilesResult, type UseTransferUploadResult, useStorageProfiles, useTransferUpload };

package/dist/index.d.ts

@@ -0,0 +1,47 @@
+import { StorageProfile, CreateTransferSessionOptions, ProgressEvent, Sha256ProgressEvent, ChunkDoneEvent, TransferSession, TransferSessionHandle } from '@rebalworks/transfer-sdk';
+export { VERSION as CORE_VERSION, ChunkDoneEvent, CreateTransferSessionOptions, ProgressEvent, SessionCompleteEvent, SessionErrorEvent, Sha256ProgressEvent, StorageProfile, TransferSession, TransferSessionHandle } from '@rebalworks/transfer-sdk';
+
+interface UseStorageProfilesOptions {
+    readonly apiRoot?: string | undefined;
+    readonly authToken?: string | undefined;
+    readonly enabled?: boolean | undefined;
+}
+interface StorageProfilesState {
+    readonly profiles: readonly StorageProfile[];
+    readonly defaultProfile?: StorageProfile | undefined;
+    readonly loading: boolean;
+    readonly error?: Error | undefined;
+}
+interface UseStorageProfilesResult extends StorageProfilesState {
+    readonly reload: () => Promise<readonly StorageProfile[]>;
+}
+declare function useStorageProfiles(options?: UseStorageProfilesOptions): UseStorageProfilesResult;
+
+type TransferUploadPhase = 'idle' | 'hashing' | 'uploading' | 'completed' | 'aborted' | 'error';
+type TransferUploadConfig = Omit<CreateTransferSessionOptions, 'file'> & {
+    readonly abortOnUnmount?: boolean | undefined;
+};
+type TransferUploadOverrides = Partial<Omit<CreateTransferSessionOptions, 'file'>>;
+interface TransferUploadState {
+    readonly phase: TransferUploadPhase;
+    readonly progress?: ProgressEvent | undefined;
+    readonly sha256Progress?: Sha256ProgressEvent | undefined;
+    readonly lastChunk?: ChunkDoneEvent | undefined;
+    readonly session?: TransferSession | undefined;
+    readonly sessionId?: string | undefined;
+    readonly error?: Error | undefined;
+}
+interface UseTransferUploadResult extends TransferUploadState {
+    readonly uploading: boolean;
+    readonly completed: boolean;
+    readonly aborted: boolean;
+    readonly upload: (file: File, overrides?: TransferUploadOverrides) => TransferSessionHandle;
+    readonly abort: () => Promise<void>;
+    readonly reset: () => void;
+    readonly handle: TransferSessionHandle | null;
+}
+declare function useTransferUpload(config?: TransferUploadConfig): UseTransferUploadResult;
+
+declare const REACT_SDK_VERSION = "0.1.1";
+
+export { REACT_SDK_VERSION, type StorageProfilesState, type TransferUploadConfig, type TransferUploadOverrides, type TransferUploadPhase, type TransferUploadState, type UseStorageProfilesOptions, type UseStorageProfilesResult, type UseTransferUploadResult, useStorageProfiles, useTransferUpload };

package/dist/index.js

@@ -0,0 +1 @@
+import {useRef,useState,useCallback,useEffect}from'react';import {listStorageProfiles,createTransferSession}from'@rebalworks/transfer-sdk';export{VERSION as CORE_VERSION}from'@rebalworks/transfer-sdk';var V={profiles:[],loading:false};function K(n={}){let{apiRoot:r,authToken:p,enabled:T=true}=n,l=useRef(null),f=useRef(true),[E,S]=useState(V),g=useCallback(async()=>{l.current?.abort();let u=new AbortController;l.current=u,S(a=>({...a,loading:true,error:void 0}));try{let a=await listStorageProfiles({...r!==void 0?{apiRoot:r}:{},...p!==void 0?{authToken:p}:{},signal:u.signal}),d=a.find(t=>t.defaultProfile);return f.current&&l.current===u&&S({profiles:a,...d!==void 0?{defaultProfile:d}:{},loading:!1}),a}catch(a){let d=j(a);throw f.current&&l.current===u&&S(t=>({...t,loading:false,error:d})),d}},[r,p]);return useEffect(()=>(f.current=true,T&&g(),()=>{f.current=false,l.current?.abort();}),[T,g]),{...E,reload:g}}function j(n){return n instanceof Error?n:new Error(String(n))}var x={phase:"idle"};function Q(n={}){let{abortOnUnmount:r=false,apiBase:p,authToken:T,chunkSize:l,forceMainThread:f,retries:E,resumeSessionId:S,sha256:g,signal:u,storageProfile:a,workerPoolSize:d}=n,t=useRef(true),i=useRef(null),U=useRef(null),[y,h]=useState(x),s=useCallback(()=>{U.current?.(),U.current=null;},[]),z=useCallback((P,v={})=>{s();let k=W(P,{apiBase:p,authToken:T,chunkSize:l,forceMainThread:f,retries:E,resumeSessionId:S,sha256:g,signal:u,storageProfile:a,workerPoolSize:d,...v}),o=createTransferSession(k);i.current=o,h({phase:k.sha256===void 0&&!k.forceMainThread?"hashing":"uploading"});let H=[o.on("sha256:progress",e=>{m({phase:e.percent>=100?"uploading":"hashing",sha256Progress:e});}),o.on("progress",e=>{m({phase:"uploading",progress:e});}),o.on("chunk:done",e=>{m({phase:"uploading",lastChunk:e});}),o.on("session:complete",e=>{D(e);}),o.on("session:error",e=>{C(e.error,e.cancelled);})];return U.current=()=>{for(let e of H)e();},o.sessionId.then(e=>m({sessionId:e})).catch(e=>C(I(e),w(e))),o.done.then(e=>{m({phase:"completed",session:e});}).catch(e=>C(I(e),w(e))),o;function m(e){!t.current||i.current!==o||h(c=>({...c,...e,error:e.phase==="error"?e.error:c.error}));}function D(e){!t.current||i.current!==o||(s(),h(c=>({...c,phase:"completed",session:e.session,error:void 0})));}function C(e,c){!t.current||i.current!==o||(s(),h(N=>({...N,phase:c?"aborted":"error",error:c?void 0:e})));}},[p,T,l,s,f,E,S,g,u,a,d]),A=useCallback(async()=>{let P=i.current;P!==null&&(await P.abort(),t.current&&i.current===P&&(s(),h(v=>({...v,phase:"aborted",error:void 0}))));},[s]),M=useCallback(()=>{s(),i.current=null,h(x);},[s]);return useEffect(()=>(t.current=true,()=>{t.current=false,s(),r&&i.current?.abort();}),[r,s]),{...y,uploading:y.phase==="hashing"||y.phase==="uploading",completed:y.phase==="completed",aborted:y.phase==="aborted",upload:z,abort:A,reset:M,handle:i.current}}function W(n,r){return {file:n,...r.apiBase!==void 0?{apiBase:r.apiBase}:{},...r.authToken!==void 0?{authToken:r.authToken}:{},...r.chunkSize!==void 0?{chunkSize:r.chunkSize}:{},...r.forceMainThread!==void 0?{forceMainThread:r.forceMainThread}:{},...r.retries!==void 0?{retries:r.retries}:{},...r.resumeSessionId!==void 0?{resumeSessionId:r.resumeSessionId}:{},...r.sha256!==void 0?{sha256:r.sha256}:{},...r.signal!==void 0?{signal:r.signal}:{},...r.storageProfile!==void 0?{storageProfile:r.storageProfile}:{},...r.workerPoolSize!==void 0?{workerPoolSize:r.workerPoolSize}:{}}}function I(n){return n instanceof Error?n:new Error(String(n))}function w(n){return n instanceof DOMException&&n.name==="AbortError"}var ne="0.1.1";export{ne as REACT_SDK_VERSION,K as useStorageProfiles,Q as useTransferUpload};

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@rebalworks/transfer-react",
+  "version": "0.1.1",
+  "description": "React hooks for rebalTransfer uploads",
+  "license": "SEE LICENSE IN LICENSE",
+  "private": false,
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "lint": "echo 'lint not configured'",
+    "test": "pnpm build && node --test test/*.test.mjs",
+    "clean": "rimraf dist"
+  },
+  "dependencies": {
+    "@rebalworks/transfer-sdk": "workspace:*"
+  },
+  "peerDependencies": {
+    "react": ">=18"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.0",
+    "react": ">=18",
+    "rimraf": "^6.0.0",
+    "tsup": "^8.3.0",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}