Move to TypeScript

.github/workflows/ci.yml

@@ -17,8 +17,6 @@ jobs:
             suite: 'browserstack'
           - desc: 'Puppeteer'
             suite: 'puppeteer'
-          - desc: 'Types'
-            suite: 'types'
           - desc: 'Node.js 18'
             suite: 'node'
             node: 18

.gitignore

@@ -1,7 +1,7 @@
 .vscode/settings.json
 node_modules
 demos/reactnative/.expo
-lib.es5
+lib.cjs
 lib.esm
 dist
 .DS_Store

biome.json

@@ -84,6 +84,10 @@
     {
       "include": ["demos/browser/**", "demos/cordova/**"],
       "javascript": { "globals": ["tus", "Camera"] }
+    },
+    {
+      "include": ["tsconfig*.json"],
+      "json": { "parser": { "allowComments": true } }
     }
   ]
 }

lib/browser/fileReader.ts

@@ -0,0 +1,58 @@
+import { isReactNativeFile, isReactNativePlatform } from './isReactNative.js'
+import uriToBlob from './uriToBlob.js'
+
+import type { FileReader, FileSource, UploadInput } from '../options.js'
+import BlobFileSource from './sources/BlobFileSource.js'
+import StreamFileSource from './sources/StreamFileSource.js'
+
+function isWebStream(input: UploadInput): input is Pick<ReadableStreamDefaultReader, 'read'> {
+  return 'read' in input && typeof input.read === 'function'
+}
+
+// TODO: Make sure that we support ArrayBuffers, TypedArrays, DataViews and Blobs
+export default class BrowserFileReader implements FileReader {
+  async openFile(input: UploadInput, chunkSize: number): Promise<FileSource> {
+    // In React Native, when user selects a file, instead of a File or Blob,
+    // you usually get a file object {} with a uri property that contains
+    // a local path to the file. We use XMLHttpRequest to fetch
+    // the file blob, before uploading with tus.
+    if (isReactNativeFile(input)) {
+      if (!isReactNativePlatform()) {
+        throw new Error('tus: file objects with `uri` property is only supported in React Native')
+      }
+
+      try {
+        const blob = await uriToBlob(input.uri)
+        return new BlobFileSource(blob)
+      } catch (err) {
+        throw new Error(
+          `tus: cannot fetch \`file.uri\` as Blob, make sure the uri is correct and accessible. ${err}`,
+        )
+      }
+    }
+
+    // File is a subtype of Blob, so we can check for Blob here.
+    if (input instanceof Blob) {
+      return Promise.resolve(new BlobFileSource(input))
+    }
+
+    if (isWebStream(input)) {
+      chunkSize = Number(chunkSize)
+      if (!Number.isFinite(chunkSize)) {
+        return Promise.reject(
+          new Error(
+            'cannot create source for stream without a finite value for the `chunkSize` option',
+          ),
+        )
+      }
+
+      return Promise.resolve(new StreamFileSource(input))
+    }
+
+    return Promise.reject(
+      new Error(
+        'source object may only be an instance of File, Blob, or Reader in this environment',
+      ),
+    )
+  }
+}

lib/browser/fileSignature.ts

@@ -0,0 +1,42 @@
+import type { ReactNativeFile, UploadInput, UploadOptions } from '../options.js'
+import { isReactNativeFile, isReactNativePlatform } from './isReactNative.js'
+
+/**
+ * Generate a fingerprint for a file which will be used the store the endpoint
+ */
+export default function fingerprint(file: UploadInput, options: UploadOptions) {
+  if (isReactNativePlatform() && isReactNativeFile(file)) {
+    return Promise.resolve(reactNativeFingerprint(file, options))
+  }
+
+  if (file instanceof Blob) {
+    return Promise.resolve(
+      //@ts-expect-error TODO: We have to check the input type here
+      // This can be fixed by moving the fingerprint function to the FileReader class
+      ['tus-br', file.name, file.type, file.size, file.lastModified, options.endpoint].join('-'),
+    )
+  }
+
+  return Promise.resolve(null)
+}
+
+function reactNativeFingerprint(file: ReactNativeFile, options: UploadOptions): string {
+  const exifHash = file.exif ? hashCode(JSON.stringify(file.exif)) : 'noexif'
+  return ['tus-rn', file.name || 'noname', file.size || 'nosize', exifHash, options.endpoint].join(
+    '/',
+  )
+}
+
+function hashCode(str: string): number {
+  // from https://stackoverflow.com/a/8831937/151666
+  let hash = 0
+  if (str.length === 0) {
+    return hash
+  }
+  for (let i = 0; i < str.length; i++) {
+    const char = str.charCodeAt(i)
+    hash = (hash << 5) - hash + char
+    hash &= hash // Convert to 32bit integer
+  }
+  return hash
+}