@koolbase/core 10.0.1 → 10.1.0

package/dist/cjs/analytics.js

@@ -29,6 +29,11 @@ class KoolbaseAnalytics {
         (0, platform_js_1.getPlatform)().lifecycle.onBackground(() => { this.flush(); });
         // Periodic flush
         this.flushTimer = setInterval(() => this.flush(), FLUSH_INTERVAL_MS);
+        // A browser keeps the page alive regardless; Node counts this timer as
+        // work and will not exit while it is pending. Without unref, any script
+        // that initializes the SDK — a CLI, a test runner, an SSR build step —
+        // hangs after its last line. unref exists only on Node's timer object.
+        this.flushTimer.unref?.();
         // Auto track app_open
         this.track('app_open');
         this.initialized = true;

package/dist/cjs/realtime.js

@@ -176,10 +176,13 @@ class KoolbaseRealtime {
             return;
         const delay = Math.min(3000 * Math.pow(2, this.reconnectAttempts), 60000);
         this.reconnectAttempts += 1;
+        // Same reason as the analytics flush: a pending reconnect must not be
+        // the thing that keeps a Node process alive.
         this.reconnectTimer = setTimeout(() => {
             this.reconnectTimer = null;
             void this.connect();
         }, delay);
+        this.reconnectTimer.unref?.();
     }
     disconnect() {
         if (this.reconnectTimer) {

package/dist/cjs/storage.js

@@ -88,7 +88,14 @@ class KoolbaseStorage {
      */
     async upload(options) {
         const overwrite = options.overwrite ?? false;
-        const contentType = options.file.type;
+        // A Blob (browser File included) knows its own type; the React Native
+        // URI form carries it alongside. Falling back to octet-stream keeps a
+        // typeless Blob from presigning with an empty content type, which R2
+        // then refuses at PUT.
+        const isBlob = typeof Blob !== 'undefined' && options.file instanceof Blob;
+        const contentType = isBlob
+            ? options.file.type || 'application/octet-stream'
+            : options.file.type;
         // ─── Step 1: Get presigned upload URL ───
         const urlRes = await fetch(`${this.config.baseUrl}/v1/sdk/storage/upload-url`, {
             method: 'POST',
@@ -108,10 +115,15 @@ class KoolbaseStorage {
         }
         const { upload_url } = (await urlRes.json());
         // ─── Step 2: Upload directly to R2 ───
-        // RN's fetch resolves local file URIs and Blob bodies on a raw PUT.
         // R2 presigned URLs expect raw binary, NOT multipart/form-data.
-        const fileResp = await fetch(options.file.uri);
-        const fileBlob = await fileResp.blob();
+        //
+        // A browser hands us the bytes already: a File from an input is a Blob,
+        // and fetching its .uri would be fetching undefined. React Native hands
+        // us a local URI, and its fetch resolves that into a Blob — which is why
+        // the two hosts differ here and nowhere else in this method.
+        const fileBlob = isBlob
+            ? options.file
+            : await (await fetch(options.file.uri)).blob();
         const fileSize = fileBlob.size;
         const uploadRes = await fetch(upload_url, {
             method: 'PUT',

package/dist/cjs/types.d.ts

@@ -214,7 +214,16 @@ export interface SemanticSearchResult {
 export interface UploadOptions {
     bucket: string;
     path: string;
-    file: {
+    /**
+     * The bytes to upload, in whichever form the host produces them.
+     *
+     * A browser gives you a `File` from an `<input type="file">` or a `Blob`
+     * you built; pass it directly. React Native gives you a local URI from an
+     * image picker or the file system; pass `{ uri, name, type }` and the SDK
+     * resolves it. A Blob already carries its own content type, so `type` is
+     * only needed for the URI form.
+     */
+    file: Blob | {
         uri: string;
         name: string;
         type: string;

package/dist/esm/analytics.js

@@ -26,6 +26,11 @@ export class KoolbaseAnalytics {
         getPlatform().lifecycle.onBackground(() => { this.flush(); });
         // Periodic flush
         this.flushTimer = setInterval(() => this.flush(), FLUSH_INTERVAL_MS);
+        // A browser keeps the page alive regardless; Node counts this timer as
+        // work and will not exit while it is pending. Without unref, any script
+        // that initializes the SDK — a CLI, a test runner, an SSR build step —
+        // hangs after its last line. unref exists only on Node's timer object.
+        this.flushTimer.unref?.();
         // Auto track app_open
         this.track('app_open');
         this.initialized = true;

package/dist/esm/realtime.js

@@ -173,10 +173,13 @@ export class KoolbaseRealtime {
             return;
         const delay = Math.min(3000 * Math.pow(2, this.reconnectAttempts), 60000);
         this.reconnectAttempts += 1;
+        // Same reason as the analytics flush: a pending reconnect must not be
+        // the thing that keeps a Node process alive.
         this.reconnectTimer = setTimeout(() => {
             this.reconnectTimer = null;
             void this.connect();
         }, delay);
+        this.reconnectTimer.unref?.();
     }
     disconnect() {
         if (this.reconnectTimer) {

package/dist/esm/storage.js

@@ -85,7 +85,14 @@ export class KoolbaseStorage {
      */
     async upload(options) {
         const overwrite = options.overwrite ?? false;
-        const contentType = options.file.type;
+        // A Blob (browser File included) knows its own type; the React Native
+        // URI form carries it alongside. Falling back to octet-stream keeps a
+        // typeless Blob from presigning with an empty content type, which R2
+        // then refuses at PUT.
+        const isBlob = typeof Blob !== 'undefined' && options.file instanceof Blob;
+        const contentType = isBlob
+            ? options.file.type || 'application/octet-stream'
+            : options.file.type;
         // ─── Step 1: Get presigned upload URL ───
         const urlRes = await fetch(`${this.config.baseUrl}/v1/sdk/storage/upload-url`, {
             method: 'POST',
@@ -105,10 +112,15 @@ export class KoolbaseStorage {
         }
         const { upload_url } = (await urlRes.json());
         // ─── Step 2: Upload directly to R2 ───
-        // RN's fetch resolves local file URIs and Blob bodies on a raw PUT.
         // R2 presigned URLs expect raw binary, NOT multipart/form-data.
-        const fileResp = await fetch(options.file.uri);
-        const fileBlob = await fileResp.blob();
+        //
+        // A browser hands us the bytes already: a File from an input is a Blob,
+        // and fetching its .uri would be fetching undefined. React Native hands
+        // us a local URI, and its fetch resolves that into a Blob — which is why
+        // the two hosts differ here and nowhere else in this method.
+        const fileBlob = isBlob
+            ? options.file
+            : await (await fetch(options.file.uri)).blob();
         const fileSize = fileBlob.size;
         const uploadRes = await fetch(upload_url, {
             method: 'PUT',

package/dist/esm/types.d.ts

@@ -214,7 +214,16 @@ export interface SemanticSearchResult {
 export interface UploadOptions {
     bucket: string;
     path: string;
-    file: {
+    /**
+     * The bytes to upload, in whichever form the host produces them.
+     *
+     * A browser gives you a `File` from an `<input type="file">` or a `Blob`
+     * you built; pass it directly. React Native gives you a local URI from an
+     * image picker or the file system; pass `{ uri, name, type }` and the SDK
+     * resolves it. A Blob already carries its own content type, so `type` is
+     * only needed for the URI form.
+     */
+    file: Blob | {
         uri: string;
         name: string;
         type: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@koolbase/core",
-  "version": "10.0.1",
+  "version": "10.1.0",
   "description": "Koolbase SDK core \u2014 shared behaviour behind @koolbase/react-native and @koolbase/js. Install one of those, not this.",
   "main": "./dist/cjs/index.js",
   "types": "./dist/esm/index.d.ts",