@hyperserve/hyperserve-js 0.1.0

package/dist/react-native.cjs

@@ -0,0 +1,97 @@
+'use strict';
+
+// src/errors.ts
+var HyperserveError = class extends Error {
+  constructor(message, statusCode) {
+    super(message);
+    this.statusCode = statusCode;
+    this.name = "HyperserveError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var HyperserveUploadError = class extends HyperserveError {
+  constructor(message, uploadStatus) {
+    super(message);
+    this.uploadStatus = uploadStatus;
+    this.name = "HyperserveUploadError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var HyperserveTimeoutError = class extends HyperserveError {
+  constructor(message = "Request timed out") {
+    super(message);
+    this.name = "HyperserveTimeoutError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+
+// src/storage.ts
+async function putToStorage(uploadUrl, contentType, body, onProgress) {
+  if (onProgress !== void 0 && typeof XMLHttpRequest !== "undefined" && !(body instanceof ReadableStream)) {
+    return putWithXhr(uploadUrl, contentType, body, onProgress);
+  }
+  return putWithFetch(uploadUrl, contentType, body);
+}
+function putWithFetch(uploadUrl, contentType, body) {
+  return fetch(uploadUrl, {
+    method: "PUT",
+    headers: { "Content-Type": contentType },
+    // duplex is required for ReadableStream bodies in some runtimes (Node 18)
+    ...body instanceof ReadableStream ? { duplex: "half" } : {},
+    body
+  }).then((response) => {
+    if (!response.ok) {
+      throw new HyperserveUploadError(
+        `Storage PUT failed with status ${response.status}`,
+        response.status
+      );
+    }
+  });
+}
+function putWithXhr(uploadUrl, contentType, body, onProgress) {
+  return new Promise((resolve, reject) => {
+    const xhr = new XMLHttpRequest();
+    xhr.open("PUT", uploadUrl);
+    xhr.setRequestHeader("Content-Type", contentType);
+    xhr.upload.addEventListener("progress", (event) => {
+      if (event.lengthComputable) {
+        onProgress(Math.round(event.loaded / event.total * 100));
+      }
+    });
+    xhr.addEventListener("load", () => {
+      if (xhr.status >= 200 && xhr.status < 300) {
+        onProgress(100);
+        resolve();
+      } else {
+        reject(
+          new HyperserveUploadError(`Storage PUT failed with status ${xhr.status}`, xhr.status)
+        );
+      }
+    });
+    xhr.addEventListener("timeout", () => {
+      reject(new HyperserveTimeoutError("Storage PUT timed out"));
+    });
+    xhr.addEventListener("error", () => {
+      reject(new HyperserveUploadError("Storage PUT failed due to a network error"));
+    });
+    xhr.send(body);
+  });
+}
+
+// src/react-native.ts
+async function putVideoToStorage(options) {
+  const { uploadUrl, contentType, uri, onProgress } = options;
+  const localResponse = await fetch(uri);
+  if (!localResponse.ok) {
+    throw new HyperserveUploadError(`Failed to read local file: ${uri}`);
+  }
+  const blob = await localResponse.blob();
+  return putToStorage(uploadUrl, contentType, blob, onProgress);
+}
+
+exports.HyperserveError = HyperserveError;
+exports.HyperserveTimeoutError = HyperserveTimeoutError;
+exports.HyperserveUploadError = HyperserveUploadError;
+exports.putVideoToStorage = putVideoToStorage;
+//# sourceMappingURL=react-native.cjs.map
+//# sourceMappingURL=react-native.cjs.map

package/dist/react-native.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/storage.ts","../src/react-native.ts"],"names":[],"mappings":"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","file":"react-native.cjs","sourcesContent":["/**\n * Base class for all Hyperserve SDK errors.\n */\nexport class HyperserveError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly statusCode?: number,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"HyperserveError\";\n\t\t// Maintain proper prototype chain in transpiled environments\n\t\tObject.setPrototypeOf(this, new.target.prototype);\n\t}\n}\n\n/**\n * The Hyperserve API returned a 4xx response.\n * Typically indicates a validation problem: unsupported file format,\n * file too large, invalid resolutions, video not in expected state, etc.\n */\nexport class HyperserveValidationError extends HyperserveError {\n\tconstructor(\n\t\tmessage: string,\n\t\tstatusCode: number,\n\t\tpublic readonly detail?: unknown,\n\t) {\n\t\tsuper(message, statusCode);\n\t\tthis.name = \"HyperserveValidationError\";\n\t\tObject.setPrototypeOf(this, new.target.prototype);\n\t}\n}\n\n/**\n * The Hyperserve API returned a 404 response.\n */\nexport class HyperserveNotFoundError extends HyperserveError {\n\tconstructor(message = \"Resource not found\") {\n\t\tsuper(message, 404);\n\t\tthis.name = \"HyperserveNotFoundError\";\n\t\tObject.setPrototypeOf(this, new.target.prototype);\n\t}\n}\n\n/**\n * The Hyperserve API returned a 5xx response.\n */\nexport class HyperserveApiError extends HyperserveError {\n\tconstructor(message: string, statusCode: number) {\n\t\tsuper(message, statusCode);\n\t\tthis.name = \"HyperserveApiError\";\n\t\tObject.setPrototypeOf(this, new.target.prototype);\n\t}\n}\n\n/**\n * The storage PUT request failed.\n */\nexport class HyperserveUploadError extends HyperserveError {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly uploadStatus?: number,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"HyperserveUploadError\";\n\t\tObject.setPrototypeOf(this, new.target.prototype);\n\t}\n}\n\n/**\n * A request exceeded the configured timeoutMs.\n */\nexport class HyperserveTimeoutError extends HyperserveError {\n\tconstructor(message = \"Request timed out\") {\n\t\tsuper(message);\n\t\tthis.name = \"HyperserveTimeoutError\";\n\t\tObject.setPrototypeOf(this, new.target.prototype);\n\t}\n}\n","import { HyperserveTimeoutError, HyperserveUploadError } from \"./errors.js\";\n\n/**\n * PUT a file to a presigned S3 URL.\n * Used internally by uploadVideo (server) and exported as putVideoToStorage (browser).\n *\n * When onProgress is provided, uses XMLHttpRequest for upload progress events.\n * Falls back to fetch otherwise.\n */\nexport async function putToStorage(\n\tuploadUrl: string,\n\tcontentType: string,\n\tbody: Blob | ReadableStream,\n\tonProgress?: (percent: number) => void,\n): Promise<void> {\n\t// XHR is used for progress reporting but does not support ReadableStream bodies.\n\t// Fall back to fetch (no progress) when the body is a stream.\n\tif (\n\t\tonProgress !== undefined &&\n\t\ttypeof XMLHttpRequest !== \"undefined\" &&\n\t\t!(body instanceof ReadableStream)\n\t) {\n\t\treturn putWithXhr(uploadUrl, contentType, body, onProgress);\n\t}\n\treturn putWithFetch(uploadUrl, contentType, body);\n}\n\nfunction putWithFetch(\n\tuploadUrl: string,\n\tcontentType: string,\n\tbody: Blob | ReadableStream,\n): Promise<void> {\n\treturn fetch(uploadUrl, {\n\t\tmethod: \"PUT\",\n\t\theaders: { \"Content-Type\": contentType },\n\t\t// duplex is required for ReadableStream bodies in some runtimes (Node 18)\n\t\t...(body instanceof ReadableStream ? { duplex: \"half\" } : {}),\n\t\tbody: body as BodyInit,\n\t}).then((response) => {\n\t\tif (!response.ok) {\n\t\t\tthrow new HyperserveUploadError(\n\t\t\t\t`Storage PUT failed with status ${response.status}`,\n\t\t\t\tresponse.status,\n\t\t\t);\n\t\t}\n\t});\n}\n\nfunction putWithXhr(\n\tuploadUrl: string,\n\tcontentType: string,\n\tbody: Blob,\n\tonProgress: (percent: number) => void,\n): Promise<void> {\n\treturn new Promise((resolve, reject) => {\n\t\tconst xhr = new XMLHttpRequest();\n\n\t\txhr.open(\"PUT\", uploadUrl);\n\t\txhr.setRequestHeader(\"Content-Type\", contentType);\n\n\t\txhr.upload.addEventListener(\"progress\", (event) => {\n\t\t\tif (event.lengthComputable) {\n\t\t\t\tonProgress(Math.round((event.loaded / event.total) * 100));\n\t\t\t}\n\t\t});\n\n\t\txhr.addEventListener(\"load\", () => {\n\t\t\tif (xhr.status >= 200 && xhr.status < 300) {\n\t\t\t\tonProgress(100);\n\t\t\t\tresolve();\n\t\t\t} else {\n\t\t\t\treject(\n\t\t\t\t\tnew HyperserveUploadError(`Storage PUT failed with status ${xhr.status}`, xhr.status),\n\t\t\t\t);\n\t\t\t}\n\t\t});\n\n\t\txhr.addEventListener(\"timeout\", () => {\n\t\t\treject(new HyperserveTimeoutError(\"Storage PUT timed out\"));\n\t\t});\n\n\t\txhr.addEventListener(\"error\", () => {\n\t\t\treject(new HyperserveUploadError(\"Storage PUT failed due to a network error\"));\n\t\t});\n\n\t\txhr.send(body);\n\t});\n}\n","/**\n * React Native utilities for the Hyperserve SDK.\n *\n * Import from '@hyperserve/hyperserve-js/react-native' — this entry point contains no\n * API key logic and is safe to bundle into your React Native app.\n *\n * Usage:\n *   import { putVideoToStorage } from '@hyperserve/hyperserve-js/react-native';\n *\n *   // uri comes from expo-image-picker, react-native-image-picker, etc.\n *   await putVideoToStorage({ uploadUrl, contentType, uri: asset.uri, onProgress });\n *\n * Note: your backend (not this utility) should hold the API key and call\n * createVideo / completeUpload on your app's behalf.\n */\n\nimport { HyperserveError, HyperserveTimeoutError, HyperserveUploadError } from \"./errors.js\";\n\nexport type { PutVideoToStorageRNOptions, VideoResolution, VideoStatus } from \"./types.js\";\nexport { HyperserveError, HyperserveTimeoutError, HyperserveUploadError };\n\nimport { putToStorage } from \"./storage.js\";\nimport type { PutVideoToStorageRNOptions } from \"./types.js\";\n\n/**\n * PUT a video file to the presigned storage URL obtained from your backend.\n * Accepts a local file URI from a React Native video/image picker.\n * No API key required — this call goes directly to storage, not to the Hyperserve API.\n *\n * @example\n * const { uploadUrl, contentType } = await fetch('https://your-api.com/create-upload', {\n *   method: 'POST',\n *   body: JSON.stringify({ filename: asset.fileName, fileSizeBytes: asset.fileSize }),\n * }).then(r => r.json());\n *\n * await putVideoToStorage({ uploadUrl, contentType, uri: asset.uri, onProgress: (p) => setProgress(p) });\n *\n * await fetch('https://your-api.com/complete-upload', {\n *   method: 'POST',\n *   body: JSON.stringify({ videoId }),\n * });\n */\nexport async function putVideoToStorage(options: PutVideoToStorageRNOptions): Promise<void> {\n\tconst { uploadUrl, contentType, uri, onProgress } = options;\n\n\t// Fetch the local file URI to obtain a Blob. React Native's fetch implementation\n\t// supports file:// URIs, allowing us to read local files from the device.\n\tconst localResponse = await fetch(uri);\n\tif (!localResponse.ok) {\n\t\tthrow new HyperserveUploadError(`Failed to read local file: ${uri}`);\n\t}\n\tconst blob = await localResponse.blob();\n\n\treturn putToStorage(uploadUrl, contentType, blob, onProgress);\n}\n"]}

package/dist/react-native.d.cts

@@ -0,0 +1,40 @@
+import { j as PutVideoToStorageRNOptions } from './errors-C89laaKB.cjs';
+export { e as HyperserveError, g as HyperserveTimeoutError, h as HyperserveUploadError, k as VideoResolution, m as VideoStatus } from './errors-C89laaKB.cjs';
+
+/**
+ * React Native utilities for the Hyperserve SDK.
+ *
+ * Import from '@hyperserve/hyperserve-js/react-native' — this entry point contains no
+ * API key logic and is safe to bundle into your React Native app.
+ *
+ * Usage:
+ *   import { putVideoToStorage } from '@hyperserve/hyperserve-js/react-native';
+ *
+ *   // uri comes from expo-image-picker, react-native-image-picker, etc.
+ *   await putVideoToStorage({ uploadUrl, contentType, uri: asset.uri, onProgress });
+ *
+ * Note: your backend (not this utility) should hold the API key and call
+ * createVideo / completeUpload on your app's behalf.
+ */
+
+/**
+ * PUT a video file to the presigned storage URL obtained from your backend.
+ * Accepts a local file URI from a React Native video/image picker.
+ * No API key required — this call goes directly to storage, not to the Hyperserve API.
+ *
+ * @example
+ * const { uploadUrl, contentType } = await fetch('https://your-api.com/create-upload', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ filename: asset.fileName, fileSizeBytes: asset.fileSize }),
+ * }).then(r => r.json());
+ *
+ * await putVideoToStorage({ uploadUrl, contentType, uri: asset.uri, onProgress: (p) => setProgress(p) });
+ *
+ * await fetch('https://your-api.com/complete-upload', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ videoId }),
+ * });
+ */
+declare function putVideoToStorage(options: PutVideoToStorageRNOptions): Promise<void>;
+
+export { PutVideoToStorageRNOptions, putVideoToStorage };

package/dist/react-native.d.ts

@@ -0,0 +1,40 @@
+import { j as PutVideoToStorageRNOptions } from './errors-C89laaKB.js';
+export { e as HyperserveError, g as HyperserveTimeoutError, h as HyperserveUploadError, k as VideoResolution, m as VideoStatus } from './errors-C89laaKB.js';
+
+/**
+ * React Native utilities for the Hyperserve SDK.
+ *
+ * Import from '@hyperserve/hyperserve-js/react-native' — this entry point contains no
+ * API key logic and is safe to bundle into your React Native app.
+ *
+ * Usage:
+ *   import { putVideoToStorage } from '@hyperserve/hyperserve-js/react-native';
+ *
+ *   // uri comes from expo-image-picker, react-native-image-picker, etc.
+ *   await putVideoToStorage({ uploadUrl, contentType, uri: asset.uri, onProgress });
+ *
+ * Note: your backend (not this utility) should hold the API key and call
+ * createVideo / completeUpload on your app's behalf.
+ */
+
+/**
+ * PUT a video file to the presigned storage URL obtained from your backend.
+ * Accepts a local file URI from a React Native video/image picker.
+ * No API key required — this call goes directly to storage, not to the Hyperserve API.
+ *
+ * @example
+ * const { uploadUrl, contentType } = await fetch('https://your-api.com/create-upload', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ filename: asset.fileName, fileSizeBytes: asset.fileSize }),
+ * }).then(r => r.json());
+ *
+ * await putVideoToStorage({ uploadUrl, contentType, uri: asset.uri, onProgress: (p) => setProgress(p) });
+ *
+ * await fetch('https://your-api.com/complete-upload', {
+ *   method: 'POST',
+ *   body: JSON.stringify({ videoId }),
+ * });
+ */
+declare function putVideoToStorage(options: PutVideoToStorageRNOptions): Promise<void>;
+
+export { PutVideoToStorageRNOptions, putVideoToStorage };

package/dist/react-native.js

@@ -0,0 +1,92 @@
+// src/errors.ts
+var HyperserveError = class extends Error {
+  constructor(message, statusCode) {
+    super(message);
+    this.statusCode = statusCode;
+    this.name = "HyperserveError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var HyperserveUploadError = class extends HyperserveError {
+  constructor(message, uploadStatus) {
+    super(message);
+    this.uploadStatus = uploadStatus;
+    this.name = "HyperserveUploadError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var HyperserveTimeoutError = class extends HyperserveError {
+  constructor(message = "Request timed out") {
+    super(message);
+    this.name = "HyperserveTimeoutError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+
+// src/storage.ts
+async function putToStorage(uploadUrl, contentType, body, onProgress) {
+  if (onProgress !== void 0 && typeof XMLHttpRequest !== "undefined" && !(body instanceof ReadableStream)) {
+    return putWithXhr(uploadUrl, contentType, body, onProgress);
+  }
+  return putWithFetch(uploadUrl, contentType, body);
+}
+function putWithFetch(uploadUrl, contentType, body) {
+  return fetch(uploadUrl, {
+    method: "PUT",
+    headers: { "Content-Type": contentType },
+    // duplex is required for ReadableStream bodies in some runtimes (Node 18)
+    ...body instanceof ReadableStream ? { duplex: "half" } : {},
+    body
+  }).then((response) => {
+    if (!response.ok) {
+      throw new HyperserveUploadError(
+        `Storage PUT failed with status ${response.status}`,
+        response.status
+      );
+    }
+  });
+}
+function putWithXhr(uploadUrl, contentType, body, onProgress) {
+  return new Promise((resolve, reject) => {
+    const xhr = new XMLHttpRequest();
+    xhr.open("PUT", uploadUrl);
+    xhr.setRequestHeader("Content-Type", contentType);
+    xhr.upload.addEventListener("progress", (event) => {
+      if (event.lengthComputable) {
+        onProgress(Math.round(event.loaded / event.total * 100));
+      }
+    });
+    xhr.addEventListener("load", () => {
+      if (xhr.status >= 200 && xhr.status < 300) {
+        onProgress(100);
+        resolve();
+      } else {
+        reject(
+          new HyperserveUploadError(`Storage PUT failed with status ${xhr.status}`, xhr.status)
+        );
+      }
+    });
+    xhr.addEventListener("timeout", () => {
+      reject(new HyperserveTimeoutError("Storage PUT timed out"));
+    });
+    xhr.addEventListener("error", () => {
+      reject(new HyperserveUploadError("Storage PUT failed due to a network error"));
+    });
+    xhr.send(body);
+  });
+}
+
+// src/react-native.ts
+async function putVideoToStorage(options) {
+  const { uploadUrl, contentType, uri, onProgress } = options;
+  const localResponse = await fetch(uri);
+  if (!localResponse.ok) {
+    throw new HyperserveUploadError(`Failed to read local file: ${uri}`);
+  }
+  const blob = await localResponse.blob();
+  return putToStorage(uploadUrl, contentType, blob, onProgress);
+}
+
+export { HyperserveError, HyperserveTimeoutError, HyperserveUploadError, putVideoToStorage };
+//# sourceMappingURL=react-native.js.map
+//# sourceMappingURL=react-native.js.map

package/dist/react-native.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/storage.ts","../src/react-native.ts"],"names":[],"mappings":"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","file":"react-native.js","sourcesContent":["/**\n * Base class for all Hyperserve SDK errors.\n */\nexport class HyperserveError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly statusCode?: number,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"HyperserveError\";\n\t\t// Maintain proper prototype chain in transpiled environments\n\t\tObject.setPrototypeOf(this, new.target.prototype);\n\t}\n}\n\n/**\n * The Hyperserve API returned a 4xx response.\n * Typically indicates a validation problem: unsupported file format,\n * file too large, invalid resolutions, video not in expected state, etc.\n */\nexport class HyperserveValidationError extends HyperserveError {\n\tconstructor(\n\t\tmessage: string,\n\t\tstatusCode: number,\n\t\tpublic readonly detail?: unknown,\n\t) {\n\t\tsuper(message, statusCode);\n\t\tthis.name = \"HyperserveValidationError\";\n\t\tObject.setPrototypeOf(this, new.target.prototype);\n\t}\n}\n\n/**\n * The Hyperserve API returned a 404 response.\n */\nexport class HyperserveNotFoundError extends HyperserveError {\n\tconstructor(message = \"Resource not found\") {\n\t\tsuper(message, 404);\n\t\tthis.name = \"HyperserveNotFoundError\";\n\t\tObject.setPrototypeOf(this, new.target.prototype);\n\t}\n}\n\n/**\n * The Hyperserve API returned a 5xx response.\n */\nexport class HyperserveApiError extends HyperserveError {\n\tconstructor(message: string, statusCode: number) {\n\t\tsuper(message, statusCode);\n\t\tthis.name = \"HyperserveApiError\";\n\t\tObject.setPrototypeOf(this, new.target.prototype);\n\t}\n}\n\n/**\n * The storage PUT request failed.\n */\nexport class HyperserveUploadError extends HyperserveError {\n\tconstructor(\n\t\tmessage: string,\n\t\tpublic readonly uploadStatus?: number,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"HyperserveUploadError\";\n\t\tObject.setPrototypeOf(this, new.target.prototype);\n\t}\n}\n\n/**\n * A request exceeded the configured timeoutMs.\n */\nexport class HyperserveTimeoutError extends HyperserveError {\n\tconstructor(message = \"Request timed out\") {\n\t\tsuper(message);\n\t\tthis.name = \"HyperserveTimeoutError\";\n\t\tObject.setPrototypeOf(this, new.target.prototype);\n\t}\n}\n","import { HyperserveTimeoutError, HyperserveUploadError } from \"./errors.js\";\n\n/**\n * PUT a file to a presigned S3 URL.\n * Used internally by uploadVideo (server) and exported as putVideoToStorage (browser).\n *\n * When onProgress is provided, uses XMLHttpRequest for upload progress events.\n * Falls back to fetch otherwise.\n */\nexport async function putToStorage(\n\tuploadUrl: string,\n\tcontentType: string,\n\tbody: Blob | ReadableStream,\n\tonProgress?: (percent: number) => void,\n): Promise<void> {\n\t// XHR is used for progress reporting but does not support ReadableStream bodies.\n\t// Fall back to fetch (no progress) when the body is a stream.\n\tif (\n\t\tonProgress !== undefined &&\n\t\ttypeof XMLHttpRequest !== \"undefined\" &&\n\t\t!(body instanceof ReadableStream)\n\t) {\n\t\treturn putWithXhr(uploadUrl, contentType, body, onProgress);\n\t}\n\treturn putWithFetch(uploadUrl, contentType, body);\n}\n\nfunction putWithFetch(\n\tuploadUrl: string,\n\tcontentType: string,\n\tbody: Blob | ReadableStream,\n): Promise<void> {\n\treturn fetch(uploadUrl, {\n\t\tmethod: \"PUT\",\n\t\theaders: { \"Content-Type\": contentType },\n\t\t// duplex is required for ReadableStream bodies in some runtimes (Node 18)\n\t\t...(body instanceof ReadableStream ? { duplex: \"half\" } : {}),\n\t\tbody: body as BodyInit,\n\t}).then((response) => {\n\t\tif (!response.ok) {\n\t\t\tthrow new HyperserveUploadError(\n\t\t\t\t`Storage PUT failed with status ${response.status}`,\n\t\t\t\tresponse.status,\n\t\t\t);\n\t\t}\n\t});\n}\n\nfunction putWithXhr(\n\tuploadUrl: string,\n\tcontentType: string,\n\tbody: Blob,\n\tonProgress: (percent: number) => void,\n): Promise<void> {\n\treturn new Promise((resolve, reject) => {\n\t\tconst xhr = new XMLHttpRequest();\n\n\t\txhr.open(\"PUT\", uploadUrl);\n\t\txhr.setRequestHeader(\"Content-Type\", contentType);\n\n\t\txhr.upload.addEventListener(\"progress\", (event) => {\n\t\t\tif (event.lengthComputable) {\n\t\t\t\tonProgress(Math.round((event.loaded / event.total) * 100));\n\t\t\t}\n\t\t});\n\n\t\txhr.addEventListener(\"load\", () => {\n\t\t\tif (xhr.status >= 200 && xhr.status < 300) {\n\t\t\t\tonProgress(100);\n\t\t\t\tresolve();\n\t\t\t} else {\n\t\t\t\treject(\n\t\t\t\t\tnew HyperserveUploadError(`Storage PUT failed with status ${xhr.status}`, xhr.status),\n\t\t\t\t);\n\t\t\t}\n\t\t});\n\n\t\txhr.addEventListener(\"timeout\", () => {\n\t\t\treject(new HyperserveTimeoutError(\"Storage PUT timed out\"));\n\t\t});\n\n\t\txhr.addEventListener(\"error\", () => {\n\t\t\treject(new HyperserveUploadError(\"Storage PUT failed due to a network error\"));\n\t\t});\n\n\t\txhr.send(body);\n\t});\n}\n","/**\n * React Native utilities for the Hyperserve SDK.\n *\n * Import from '@hyperserve/hyperserve-js/react-native' — this entry point contains no\n * API key logic and is safe to bundle into your React Native app.\n *\n * Usage:\n *   import { putVideoToStorage } from '@hyperserve/hyperserve-js/react-native';\n *\n *   // uri comes from expo-image-picker, react-native-image-picker, etc.\n *   await putVideoToStorage({ uploadUrl, contentType, uri: asset.uri, onProgress });\n *\n * Note: your backend (not this utility) should hold the API key and call\n * createVideo / completeUpload on your app's behalf.\n */\n\nimport { HyperserveError, HyperserveTimeoutError, HyperserveUploadError } from \"./errors.js\";\n\nexport type { PutVideoToStorageRNOptions, VideoResolution, VideoStatus } from \"./types.js\";\nexport { HyperserveError, HyperserveTimeoutError, HyperserveUploadError };\n\nimport { putToStorage } from \"./storage.js\";\nimport type { PutVideoToStorageRNOptions } from \"./types.js\";\n\n/**\n * PUT a video file to the presigned storage URL obtained from your backend.\n * Accepts a local file URI from a React Native video/image picker.\n * No API key required — this call goes directly to storage, not to the Hyperserve API.\n *\n * @example\n * const { uploadUrl, contentType } = await fetch('https://your-api.com/create-upload', {\n *   method: 'POST',\n *   body: JSON.stringify({ filename: asset.fileName, fileSizeBytes: asset.fileSize }),\n * }).then(r => r.json());\n *\n * await putVideoToStorage({ uploadUrl, contentType, uri: asset.uri, onProgress: (p) => setProgress(p) });\n *\n * await fetch('https://your-api.com/complete-upload', {\n *   method: 'POST',\n *   body: JSON.stringify({ videoId }),\n * });\n */\nexport async function putVideoToStorage(options: PutVideoToStorageRNOptions): Promise<void> {\n\tconst { uploadUrl, contentType, uri, onProgress } = options;\n\n\t// Fetch the local file URI to obtain a Blob. React Native's fetch implementation\n\t// supports file:// URIs, allowing us to read local files from the device.\n\tconst localResponse = await fetch(uri);\n\tif (!localResponse.ok) {\n\t\tthrow new HyperserveUploadError(`Failed to read local file: ${uri}`);\n\t}\n\tconst blob = await localResponse.blob();\n\n\treturn putToStorage(uploadUrl, contentType, blob, onProgress);\n}\n"]}

package/package.json

@@ -0,0 +1,89 @@
+{
+	"name": "@hyperserve/hyperserve-js",
+	"version": "0.1.0",
+	"description": "TypeScript SDK for the Hyperserve video infrastructure API",
+	"license": "MIT",
+	"author": "Ryan Trann <admin@hyperserve.io>",
+	"homepage": "https://hyperserve.io",
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/hyper-serve/hyperserve-js"
+	},
+	"bugs": {
+		"url": "https://github.com/hyper-serve/hyperserve-js/issues"
+	},
+	"type": "module",
+	"exports": {
+		".": {
+			"import": {
+				"types": "./dist/index.d.ts",
+				"default": "./dist/index.js"
+			},
+			"require": {
+				"types": "./dist/index.d.cts",
+				"default": "./dist/index.cjs"
+			}
+		},
+		"./browser": {
+			"import": {
+				"types": "./dist/browser.d.ts",
+				"default": "./dist/browser.js"
+			},
+			"require": {
+				"types": "./dist/browser.d.cts",
+				"default": "./dist/browser.cjs"
+			}
+		},
+		"./react-native": {
+			"react-native": "./dist/react-native.js",
+			"import": {
+				"types": "./dist/react-native.d.ts",
+				"default": "./dist/react-native.js"
+			},
+			"require": {
+				"types": "./dist/react-native.d.cts",
+				"default": "./dist/react-native.cjs"
+			}
+		}
+	},
+	"sideEffects": false,
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"files": [
+		"dist"
+	],
+	"scripts": {
+		"build": "tsup",
+		"dev": "tsup --watch",
+		"typecheck": "tsc --noEmit",
+		"lint": "biome lint ./src",
+		"lint:fix": "biome lint --write ./src",
+		"format": "biome format ./src",
+		"format:write": "biome format --write ./src",
+		"check": "biome check ./src",
+		"check:write": "biome check --write ./src",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"prepublishOnly": "npm run build && npm run typecheck",
+		"prepare": "husky"
+	},
+	"devDependencies": {
+		"@biomejs/biome": "^2.4.9",
+		"@types/node": "^22.0.0",
+		"husky": "^9.1.7",
+		"tsup": "^8.5.1",
+		"typescript": "^6.0.2",
+		"vitest": "^4.1.2"
+	},
+	"engines": {
+		"node": ">=18"
+	},
+	"keywords": [
+		"hyperserve",
+		"video",
+		"sdk",
+		"upload",
+		"transcoding"
+	]
+}