@motherbase/client 1.0.1 → 1.0.2

package/dist/storage.d.ts

@@ -1,29 +1,55 @@
 import type { HttpClient } from './http.js';
-import type { FileObject, FileVisibility } from './types.js';
-import type { UploadInput } from './profile.js';
-interface UploadOptions {
+import type { FileObject, FileVisibility, MotherbaseResponse, UploadInput } from './types.js';
+export interface UploadOptions {
+    /** Object visibility. Defaults to the backend's default (private). */
     visibility?: FileVisibility;
-    bucket?: string;
+    /** Passed through to the backend as the content type hint. */
+    contentType?: string;
+    upsert?: boolean;
 }
-interface PresignParams {
-    filename: string;
-    mime?: string;
-    visibility?: FileVisibility;
-    bucket?: string;
+export interface UploadResult {
+    /** Stable object key. In this backend the key equals the created file id. */
+    path: string;
+    /** The created file's id (identical to `path`). */
+    id: string;
+    /** `bucket/id` convenience path. */
+    fullPath: string;
+}
+/**
+ * Supabase-compatible storage bucket handle. Maps onto the authenticated
+ * `/api/files` endpoints. NOTE: in this backend an object's identity is the
+ * server-issued file **id**, so the Supabase `path` argument to `download`,
+ * `remove`, `getPublicUrl` and `createSignedUrl` is the id returned by `upload`.
+ */
+export declare class StorageBucket {
+    private readonly http;
+    private readonly baseUrl;
+    private readonly bucket;
+    constructor(http: HttpClient, baseUrl: string, bucket: string);
+    upload(path: string, file: UploadInput, options?: UploadOptions): Promise<MotherbaseResponse<UploadResult>>;
+    download(path: string): Promise<MotherbaseResponse<Blob>>;
+    remove(paths: string[]): Promise<MotherbaseResponse<FileObject[]>>;
+    /**
+     * Not supported: the backend exposes no per-bucket object listing endpoint.
+     * Returns an error rather than throwing, for drop-in compatibility.
+     */
+    list(_prefix?: string): Promise<MotherbaseResponse<FileObject[]>>;
+    /** Synchronous public URL (Supabase parity). Serves through the public bucket endpoint. */
+    getPublicUrl(path: string): {
+        data: {
+            publicUrl: string;
+        };
+    };
+    /** A (possibly signed) download URL for the object. */
+    createSignedUrl(path: string, _expiresIn?: number): Promise<MotherbaseResponse<{
+        signedUrl: string;
+    }>>;
 }
-export declare class StorageModule {
+/** Supabase-compatible storage client: `client.storage.from(bucket)`. */
+export declare class StorageClient {
     private readonly http;
-    constructor(http: HttpClient);
-    /** Multipart upload through the API (field name: "file"). */
-    upload(file: UploadInput, options?: UploadOptions): Promise<FileObject>;
-    /** Request a presigned PUT URL for direct-to-storage upload (S3 driver). */
-    presign(params: PresignParams): Promise<{
-        url: string;
-        [k: string]: unknown;
-    }>;
-    /** Get a (possibly signed) download URL for a stored file. */
-    getUrl(id: string): Promise<string>;
-    remove(id: string): Promise<unknown>;
+    private readonly baseUrl;
+    constructor(http: HttpClient, baseUrl: string);
+    from(bucket: string): StorageBucket;
 }
-export {};
 //# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,UAAU,aAAa;IACrB,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,aAAa;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,6DAA6D;IAC7D,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAS3E,4EAA4E;IAC5E,OAAO,CAAC,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAI9E,8DAA8D;IACxD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKzC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAGrC"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9F,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B,8DAA8D;IAC9D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;IACb,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,qBAAa,aAAa;IAEtB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM;IAG3B,MAAM,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC;IAoBtC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC;IASzD,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,kBAAkB,CAAC,UAAU,EAAE,CAAC,CAAC;IAWxE;;;OAGG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,UAAU,EAAE,CAAC,CAAC;IAOvE,2FAA2F;IAC3F,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE;YAAE,SAAS,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE;IAS3D,uDAAuD;IACjD,eAAe,CACnB,IAAI,EAAE,MAAM,EACZ,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,kBAAkB,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAQtD;AAED,yEAAyE;AACzE,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;IAAc,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAA1C,IAAI,EAAE,UAAU,EAAmB,OAAO,EAAE,MAAM;IAE/E,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;CAGpC"}

package/dist/storage.js

@@ -1,31 +1,94 @@
-export class StorageModule {
-    constructor(http) {
+import { toError } from './http.js';
+/**
+ * Supabase-compatible storage bucket handle. Maps onto the authenticated
+ * `/api/files` endpoints. NOTE: in this backend an object's identity is the
+ * server-issued file **id**, so the Supabase `path` argument to `download`,
+ * `remove`, `getPublicUrl` and `createSignedUrl` is the id returned by `upload`.
+ */
+export class StorageBucket {
+    constructor(http, baseUrl, bucket) {
         this.http = http;
+        this.baseUrl = baseUrl;
+        this.bucket = bucket;
     }
-    /** Multipart upload through the API (field name: "file"). */
-    upload(file, options = {}) {
-        const form = new FormData();
-        if (typeof Blob !== 'undefined' && file instanceof Blob)
-            form.append('file', file);
-        else
-            form.append('file', file);
-        if (options.visibility)
-            form.append('visibility', options.visibility);
-        if (options.bucket)
-            form.append('bucket', options.bucket);
-        return this.http.request('/api/files/', { method: 'POST', form });
-    }
-    /** Request a presigned PUT URL for direct-to-storage upload (S3 driver). */
-    presign(params) {
-        return this.http.request('/api/files/presign', { method: 'POST', body: params });
-    }
-    /** Get a (possibly signed) download URL for a stored file. */
-    async getUrl(id) {
-        const res = await this.http.request(`/api/files/${id}/url`);
-        return res.url;
-    }
-    remove(id) {
-        return this.http.request(`/api/files/${id}`, { method: 'DELETE' });
+    async upload(path, file, options = {}) {
+        try {
+            const form = new FormData();
+            if (typeof Blob !== 'undefined' && file instanceof Blob) {
+                form.append('file', file, path);
+            }
+            else {
+                form.append('file', file);
+            }
+            if (options.visibility)
+                form.append('visibility', options.visibility);
+            form.append('bucket', this.bucket);
+            const created = await this.http.request('/api/files/', { method: 'POST', form });
+            return {
+                data: { path: created.id, id: created.id, fullPath: `${this.bucket}/${created.id}` },
+                error: null,
+            };
+        }
+        catch (err) {
+            return { data: null, error: toError(err) };
+        }
+    }
+    async download(path) {
+        try {
+            const res = await this.http.requestRaw(`/api/files/${encodeURIComponent(path)}/raw`);
+            return { data: await res.blob(), error: null };
+        }
+        catch (err) {
+            return { data: null, error: toError(err) };
+        }
+    }
+    async remove(paths) {
+        try {
+            const removed = await Promise.all(paths.map(p => this.http.request(`/api/files/${encodeURIComponent(p)}`, { method: 'DELETE' })));
+            return { data: removed, error: null };
+        }
+        catch (err) {
+            return { data: null, error: toError(err) };
+        }
+    }
+    /**
+     * Not supported: the backend exposes no per-bucket object listing endpoint.
+     * Returns an error rather than throwing, for drop-in compatibility.
+     */
+    async list(_prefix) {
+        return {
+            data: null,
+            error: { message: 'storage.list is not supported by the Motherbase backend' },
+        };
+    }
+    /** Synchronous public URL (Supabase parity). Serves through the public bucket endpoint. */
+    getPublicUrl(path) {
+        const base = this.baseUrl.replace(/\/$/, '');
+        return {
+            data: {
+                publicUrl: `${base}/api/storage/${encodeURIComponent(this.bucket)}/files/${encodeURIComponent(path)}`,
+            },
+        };
+    }
+    /** A (possibly signed) download URL for the object. */
+    async createSignedUrl(path, _expiresIn) {
+        try {
+            const res = await this.http.request(`/api/files/${encodeURIComponent(path)}/url`);
+            return { data: { signedUrl: res.url }, error: null };
+        }
+        catch (err) {
+            return { data: null, error: toError(err) };
+        }
+    }
+}
+/** Supabase-compatible storage client: `client.storage.from(bucket)`. */
+export class StorageClient {
+    constructor(http, baseUrl) {
+        this.http = http;
+        this.baseUrl = baseUrl;
+    }
+    from(bucket) {
+        return new StorageBucket(this.http, this.baseUrl, bucket);
     }
 }
 //# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAgBA,MAAM,OAAO,aAAa;IACxB,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,6DAA6D;IAC7D,MAAM,CAAC,IAAiB,EAAE,UAAyB,EAAE;QACnD,MAAM,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC5B,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,YAAY,IAAI;YAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;;YAC9E,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,IAAuB,CAAC,CAAC;QAClD,IAAI,OAAO,CAAC,UAAU;YAAE,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;QACtE,IAAI,OAAO,CAAC,MAAM;YAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QAC1D,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAa,aAAa,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IAChF,CAAC;IAED,4EAA4E;IAC5E,OAAO,CAAC,MAAqB;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,8DAA8D;IAC9D,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAAkB,cAAc,EAAE,MAAM,CAAC,CAAC;QAC7E,OAAO,GAAG,CAAC,GAAG,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrE,CAAC;CACF"}
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -1,5 +1,5 @@
-/** Shared types for the Motherbase client SDK. */
-/** The envelope every API endpoint wraps its payload in. */
+/** Shared types for the Motherbase client SDK (Supabase-js compatible surface). */
+/** The envelope non-REST API endpoints (auth, storage, edge) wrap their payload in. */
 export interface ApiEnvelope<T = unknown> {
     status: 0 | 1;
     message: string;
@@ -14,12 +14,17 @@ export interface User {
     role?: string;
     [key: string]: unknown;
 }
-/** Token pair issued by login/register/refresh. */
+/**
+ * The bearer token issued by sign-up / sign-in. With Better Auth this is the
+ * session token; there is no separate refresh token (a session is valid until
+ * it expires, after which the user re-authenticates). `refreshToken` is kept
+ * optional for backwards source-compat and is unused.
+ */
 export interface Tokens {
     accessToken: string;
-    refreshToken: string;
+    refreshToken?: string;
 }
-/** The locally-held session: tokens plus the user they belong to. */
+/** The locally-held session: the bearer token plus the user it belongs to. */
 export interface Session extends Tokens {
     user: User;
 }
@@ -34,7 +39,29 @@ export interface FileObject {
     [key: string]: unknown;
 }
 export type FileVisibility = 'public' | 'private';
-export type DevicePlatform = 'ios' | 'android' | 'web';
+/** A file-ish value accepted by multipart uploads (browser File/Blob or RN asset). */
+export type UploadInput = Blob | {
+    uri: string;
+    name?: string;
+    type?: string;
+};
+/**
+ * The uniform result envelope every data/auth/storage call resolves to.
+ * `error` is `null` on success; `data` is `null` on failure. Never throws for
+ * expected API errors — only for programmer misuse.
+ */
+export interface MotherbaseResponse<T> {
+    data: T | null;
+    error: MotherbaseError | null;
+}
+/** Supabase-shaped error object. */
+export interface MotherbaseError {
+    message: string;
+    /** HTTP status code, when the failure came from an HTTP response. */
+    status?: number;
+    /** Backend/app error code, when present. */
+    code?: string;
+}
 /**
  * Persists the session between runs. Implementations must be synchronous-or-async
  * tolerant: every method may return a value or a promise of it.
@@ -50,7 +77,18 @@ export interface ClientOptions {
     autoRefresh?: boolean;
     /** Override the fetch implementation (for SSR or tests). */
     fetch?: typeof fetch;
+    /** Extra headers merged into every request (e.g. a custom `apikey`). */
+    headers?: Record<string, string>;
+    /**
+     * Inject a socket.io factory for realtime (tests / custom transports).
+     * When omitted, `socket.io-client` is imported lazily at connect time.
+     */
+    realtimeIoFactory?: (url: string, opts: Record<string, unknown>) => import('./realtime.js').SocketLike;
 }
+/** Supabase-compatible auth change events emitted by `onAuthStateChange`. */
+export type AuthChangeEvent = 'SIGNED_IN' | 'SIGNED_OUT' | 'TOKEN_REFRESHED';
+export type AuthChangeListener = (event: AuthChangeEvent, session: Session | null) => void;
+/** Internal event names used by the session store. */
 export type AuthEvent = 'signIn' | 'signOut' | 'tokenRefreshed';
 export type AuthListener = (event: AuthEvent, session: Session | null) => void;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAElD,4DAA4D;AAC5D,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,6EAA6E;AAC7E,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,mDAAmD;AACnD,MAAM,WAAW,MAAM;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qEAAqE;AACrE,MAAM,WAAW,OAAQ,SAAQ,MAAM;IACrC,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,CAAC;AAClD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,SAAS,GAAG,KAAK,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,GAAG,IAAI,OAAO,GAAG,IAAI,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;IAChD,GAAG,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpD;AAED,MAAM,WAAW,aAAa;IAC5B,sEAAsE;IACtE,OAAO,CAAC,EAAE,qBAAqB,CAAC;IAChC,sEAAsE;IACtE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,4DAA4D;IAC5D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,gBAAgB,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -1,3 +1,3 @@
-/** Shared types for the Motherbase client SDK. */
+/** Shared types for the Motherbase client SDK (Supabase-js compatible surface). */
 export {};
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,kDAAkD"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,mFAAmF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@motherbase/client",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "Typed client SDK for Motherbase, the open source self-hosted backend platform.",
   "type": "module",
   "main": "./dist/index.js",