@motherbase/client 2.2.1 → 2.2.4

package/dist/storage/bucket.js

@@ -0,0 +1,294 @@
+import { contractPath, HTTP_ROUTES } from "@motherbase/contracts";
+import { settle, toError, withoutTrailingSlash } from "../http/utils.js";
+import { UUID, uploadBlob, RENDER_ROUTE, encodeKey, transformQuery } from "./utils.js";
+export class StorageBucket {
+    constructor(http, baseUrl, bucket, 
+    /** Used only by `uploadToSignedUrl`, which PUTs straight to object storage. */
+    fetchImpl) {
+        this.http = http;
+        this.baseUrl = baseUrl;
+        this.bucket = bucket;
+        this.fetchImpl = fetchImpl;
+    }
+    /**
+     * Route for one object. A bare uuid is treated as a file id (the pre-path
+     * addressing form, which existing callers have stored); anything else is a
+     * key inside this bucket.
+     */
+    objectPath(pathOrId, kind) {
+        if (UUID.test(pathOrId)) {
+            if (kind === 'object-info') {
+                throw new Error('info() addresses objects by path. Pass the key you uploaded under, not a file id.');
+            }
+            return contractPath.file(pathOrId, kind === 'object-url' ? 'url' : 'raw');
+        }
+        return `${HTTP_ROUTES.files}/${kind}/${encodeURIComponent(this.bucket)}/${encodeKey(pathOrId)}`;
+    }
+    /**
+     * Store a file at `path` in this bucket. `upsert: true` replaces an object
+     * already stored there.
+     * @example client.storage.from('avatars').upload(`${userId}/me.png`, file, { contentType: 'image/png' })
+     */
+    upload(path, file, options = {}) {
+        return settle(async () => {
+            const form = new FormData();
+            const body = uploadBlob(file, options.contentType);
+            if (body) {
+                form.append('file', body, path);
+            }
+            else {
+                form.append('file', file);
+            }
+            if (options.visibility)
+                form.append('visibility', options.visibility);
+            form.append('bucket', this.bucket);
+            form.append('path', path);
+            if (options.upsert)
+                form.append('upsert', 'true');
+            const created = await this.http.request(`${HTTP_ROUTES.files}/`, { method: 'POST', form });
+            return { path, id: created.file.id, fullPath: `${this.bucket}/${path}` };
+        });
+    }
+    /**
+     * Upload several objects, a few at a time, reporting progress per file.
+     *
+     * Uploading a folder is the common case and `Promise.all` is the common
+     * mistake: a hundred parallel multipart posts saturate the connection, and
+     * the server rate limiter answers 429 to the tail of them. Four at a time
+     * finishes sooner in practice and fails less.
+     *
+     * One failing file does not cancel the rest. The result reports every entry
+     * in the order it was given, each with its own error or `null`, so the caller
+     * can retry exactly what failed.
+     *
+     * ponytail: progress is per file, not per byte. Byte-level progress needs
+     * XMLHttpRequest, which does not exist outside a browser; if a progress bar
+     * has to move within one large file, that is the upgrade path.
+     */
+    async uploadMany(files, options = {}) {
+        const total = files.length;
+        const requestedConcurrency = options.concurrency ?? 4;
+        if (!Number.isSafeInteger(requestedConcurrency) || requestedConcurrency < 1) {
+            return { data: null, error: { message: 'concurrency must be a positive integer.' } };
+        }
+        const concurrency = Math.min(requestedConcurrency, total || 1);
+        const results = new Array(total);
+        let next = 0;
+        let completed = 0;
+        // A shared cursor rather than fixed slices: one slow file would otherwise
+        // hold up its whole slice while other workers sit idle.
+        const worker = async () => {
+            for (;;) {
+                const index = next++;
+                if (index >= total)
+                    return;
+                const entry = files[index];
+                const { data, error } = await this.upload(entry.path, entry.file, entry.options);
+                results[index] = { path: entry.path, data: data ?? null, error: error?.message ?? null };
+                completed += 1;
+                options.onProgress?.({ completed, total, path: entry.path, error: error?.message ?? null });
+            }
+        };
+        await Promise.all(Array.from({ length: concurrency }, worker));
+        return { data: results, error: null };
+    }
+    /** The object's bytes. With `transform`, a resized image from the render endpoint instead. */
+    download(path, options = {}) {
+        return settle(async () => {
+            const route = options.transform
+                ? `${RENDER_ROUTE}/authenticated/${encodeURIComponent(this.bucket)}/${encodeKey(path)}?${transformQuery(options.transform)}`
+                : this.objectPath(path, 'object');
+            const res = await this.http.requestRaw(route);
+            return res.blob();
+        });
+    }
+    /** Delete these objects. One result per path, in the same order. */
+    remove(paths) {
+        return settle(() => Promise.all(paths.map(p => this.http.request(
+        // A file id deletes through the id route, unlike objectPath's `raw`.
+        UUID.test(p) ? contractPath.file(p) : this.objectPath(p, 'object'), { method: 'DELETE' }))));
+    }
+    /** Objects under a prefix, in the Supabase response shape. */
+    list(prefix = '', options = {}) {
+        return settle(async () => {
+            const query = new URLSearchParams();
+            if (prefix)
+                query.set('prefix', prefix);
+            if (options.limit !== undefined)
+                query.set('limit', String(options.limit));
+            if (options.offset !== undefined)
+                query.set('offset', String(options.offset));
+            if (options.search)
+                query.set('search', options.search);
+            if (options.sortBy?.column)
+                query.set('sortColumn', options.sortBy.column);
+            if (options.sortBy?.order)
+                query.set('sortOrder', options.sortBy.order);
+            const suffix = query.toString() ? `?${query}` : '';
+            const res = await this.http.request(`${HTTP_ROUTES.files}/list/${encodeURIComponent(this.bucket)}${suffix}`);
+            return res.objects;
+        });
+    }
+    /**
+     * Synchronous public URL (Supabase parity). Serves through the public bucket
+     * endpoint, or through the render endpoint when `transform` is given.
+     */
+    getPublicUrl(path, options = {}) {
+        const base = withoutTrailingSlash(this.baseUrl);
+        const publicUrl = options.transform
+            ? `${base}${RENDER_ROUTE}/public/${encodeURIComponent(this.bucket)}/${encodeKey(path)}?${transformQuery(options.transform)}`
+            : `${base}${contractPath.publicFile(this.bucket, path)}`;
+        return { data: { publicUrl } };
+    }
+    /**
+     * A download URL for the object, valid for `expiresIn` seconds (default 3600,
+     * maximum 7 days: the AWS SigV4 ceiling; anything outside that is a `400`).
+     *
+     * `expiresAt` reports when the URL actually stops working, and is `null` when
+     * nothing expires: a public object's URL is permanent, and a private object on
+     * the `local` storage driver resolves to the authenticated streaming endpoint,
+     * which is bound to the session rather than to a clock and so cannot be handed
+     * to a third party at all. Check it rather than assuming `expiresIn` applied,
+     * that assumption is exactly what this used to get wrong, silently.
+     */
+    async createSignedUrl(path, expiresIn, options = {}) {
+        if (options.transform && UUID.test(path)) {
+            return { data: null, error: { message: 'Transforms address objects by path. Pass the key you uploaded under, not a file id.' } };
+        }
+        return settle(async () => {
+            // With a transform the server signs a render URL, which always expires,
+            // whatever the driver: an S3 presign cannot carry a resize.
+            const query = new URLSearchParams(options.transform ? transformQuery(options.transform) : '');
+            if (expiresIn !== undefined)
+                query.set('expiresIn', String(expiresIn));
+            const suffix = query.toString() ? `?${query}` : '';
+            const res = await this.http.request(`${this.objectPath(path, 'object-url')}${suffix}`);
+            return { signedUrl: res.url, expiresAt: res.expiresAt ?? null };
+        });
+    }
+    /**
+     * Sign several objects in one call.
+     *
+     * There is no batch endpoint behind this: it signs each key and reports per
+     * entry, exactly as supabase-js does, so one missing object yields one entry
+     * with an `error` rather than failing the whole batch.
+     */
+    async createSignedUrls(paths, expiresIn) {
+        const results = await Promise.all(paths.map(async (path) => {
+            const { data, error } = await this.createSignedUrl(path, expiresIn);
+            return { path, signedUrl: data?.signedUrl ?? null, error: error?.message ?? null };
+        }));
+        return { data: results, error: null };
+    }
+    /**
+     * Replace the object at `path`. In supabase-js `update` is `upload` with
+     * upsert forced on, and the same is true here.
+     */
+    async update(path, file, options = {}) {
+        return this.upload(path, file, { ...options, upsert: true });
+    }
+    /** Copy an object to another key in this bucket. */
+    async copy(from, to, options = {}) {
+        return this.transfer('copy', from, to, options);
+    }
+    /** Move an object to another key in this bucket (copy, then delete the source). */
+    async move(from, to, options = {}) {
+        return this.transfer('move', from, to, options);
+    }
+    transfer(action, from, to, options) {
+        return settle(async () => {
+            const res = await this.http.request(`${HTTP_ROUTES.files}/${action}`, { method: 'POST', body: { bucket: this.bucket, from, to, upsert: options.upsert === true } });
+            return { path: res.fullPath ?? `${this.bucket}/${to}` };
+        });
+    }
+    /** One object's metadata, without downloading it. */
+    info(path) {
+        return settle(() => this.http.request(this.objectPath(path, 'object-info')));
+    }
+    /**
+     * Whether an object exists and this caller can read it.
+     *
+     * A 404 is the answer `false`, not a failure. Anything else (a 403, a network
+     * error) is reported as an error rather than as "no": treating an
+     * authorization failure as absence is how a UI ends up offering to create
+     * something that is already there.
+     */
+    async exists(path) {
+        const { data, error } = await this.info(path);
+        if (data)
+            return { data: true, error: null };
+        if (error?.status === 404)
+            return { data: false, error: null };
+        return { data: null, error: error ?? { message: 'Unknown storage error' } };
+    }
+    /**
+     * Mint a URL the browser can PUT the bytes to directly, skipping this server.
+     *
+     * Unlike supabase-js this needs the file's `size` and content type up front:
+     * the upload is reserved against the bucket quota and the signature is bound
+     * to that exact length, which is what stops a signed URL from becoming an
+     * unbounded write. Pair it with `uploadToSignedUrl`.
+     *
+     * Requires the S3 driver; the local driver has no presigned uploads.
+     */
+    createSignedUploadUrl(path, options) {
+        return settle(async () => {
+            const res = await this.http.request(`${HTTP_ROUTES.files}/presign`, {
+                method: 'POST',
+                body: {
+                    bucket: this.bucket,
+                    path,
+                    size: options.size,
+                    mime: options.contentType,
+                    visibility: options.visibility,
+                },
+            });
+            // supabase-js's `token` is opaque to the caller and is handed straight
+            // back to uploadToSignedUrl, so it carries what finalisation needs.
+            const token = JSON.stringify({ url: res.uploadUrl, id: res.file.id, finalizeToken: res.finalizeToken, contentType: options.contentType, path, bucket: this.bucket });
+            return { signedUrl: res.uploadUrl, token, path };
+        });
+    }
+    /**
+     * Upload to a URL from `createSignedUploadUrl`: PUT the bytes to storage,
+     * then tell the server the object landed. The finalise step is what makes the
+     * row readable, so a PUT that succeeds and a finalise that fails leaves the
+     * reservation to expire rather than a half-visible object.
+     */
+    async uploadToSignedUrl(path, token, file, options = {}) {
+        let parsed;
+        try {
+            const value = JSON.parse(token);
+            if (!value || typeof value !== 'object' || typeof value.url !== 'string' || typeof value.id !== 'string' || !value.id
+                || !['http:', 'https:'].includes(new URL(value.url).protocol)
+                || (value.path !== undefined && value.path !== path)
+                || (value.bucket !== undefined && value.bucket !== this.bucket)
+                || (value.contentType !== undefined && typeof value.contentType !== 'string')
+                || (value.finalizeToken !== undefined && typeof value.finalizeToken !== 'string'))
+                throw new Error('Invalid upload token');
+            parsed = value;
+        }
+        catch {
+            return { data: null, error: { message: 'Invalid upload token. Use the token from createSignedUploadUrl().' } };
+        }
+        try {
+            const body = uploadBlob(file, options.contentType ?? parsed.contentType);
+            if (!body)
+                throw new Error('Signed uploads require a Blob, ArrayBuffer or typed array.');
+            const put = await this.fetchImpl(parsed.url, {
+                method: 'PUT',
+                body,
+                headers: { 'Content-Type': body.type || 'application/octet-stream' },
+            });
+            if (!put.ok) {
+                return { data: null, error: { message: `Upload failed with status ${put.status}`, status: put.status } };
+            }
+            await this.http.request(`${contractPath.file(parsed.id)}/finalize`, { method: 'POST', body: { token: parsed.finalizeToken } });
+            return { data: { path, id: parsed.id, fullPath: `${this.bucket}/${path}` }, error: null };
+        }
+        catch (err) {
+            return { data: null, error: toError(err) };
+        }
+    }
+}
+//# sourceMappingURL=bucket.js.map

package/dist/storage/bucket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bucket.js","sourceRoot":"","sources":["../../src/storage/bucket.ts"],"names":[],"mappings":"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"}

package/dist/storage/index.d.ts

@@ -0,0 +1,45 @@
+import { HttpClient } from "../http/index.js";
+import { MotherbaseResponse } from "../types.js";
+import { StorageBucket } from "./bucket.js";
+import { BucketInfo, BucketOptions } from "./types.js";
+/** Supabase-compatible storage client: `client.storage.from(bucket)`. */
+export declare class StorageClient {
+    private readonly http;
+    private readonly baseUrl;
+    private readonly fetchImpl;
+    constructor(http: HttpClient, baseUrl: string, fetchImpl: typeof fetch);
+    /** The files of one bucket: upload, download, list, sign URLs. */
+    from(bucket: string): StorageBucket;
+    /**
+     * Bucket administration, supabase-js shaped.
+     *
+     * Every method here needs a SECRET project API key, which is the same rule
+     * Supabase applies (bucket administration is a service-role operation). With
+     * a publishable key they resolve with a 401 error, so keep them in server
+     * code and setup scripts, never in a browser bundle.
+     */
+    listBuckets(): Promise<MotherbaseResponse<BucketInfo[]>>;
+    /** One bucket's settings. Secret key only. */
+    getBucket(id: string): Promise<MotherbaseResponse<BucketInfo>>;
+    /** Create a bucket, private unless `public: true`. Secret key only. */
+    createBucket(id: string, options?: BucketOptions): Promise<MotherbaseResponse<BucketInfo>>;
+    /** Change a bucket's visibility, size limit or allowed file types. Secret key only. */
+    updateBucket(id: string, options: BucketOptions): Promise<MotherbaseResponse<BucketInfo>>;
+    /** Delete every object in the bucket, keeping the bucket itself. */
+    emptyBucket(id: string): Promise<MotherbaseResponse<{
+        emptied: boolean;
+        removed: number;
+    }>>;
+    /**
+     * Delete the bucket. A bucket that still holds objects is a `409` unless
+     * `force` is set, which queues a background deletion of its contents: an
+     * accidental `deleteBucket` must not be able to destroy a project's files in
+     * one unqualified call.
+     */
+    deleteBucket(id: string, options?: {
+        force?: boolean;
+    }): Promise<MotherbaseResponse<{
+        deleted: boolean;
+    }>>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAKvD,yEAAyE;AACzE,qBAAa,aAAa;IAElB,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAFT,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,OAAO,KAAK;IAG5C,kEAAkE;IAClE,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa;IAInC;;;;;;;OAOG;IACH,WAAW,IAAI,OAAO,CAAC,kBAAkB,CAAC,UAAU,EAAE,CAAC,CAAC;IAIxD,8CAA8C;IAC9C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAI9D,uEAAuE;IACvE,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAK9F,uFAAuF;IACvF,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;IAIzF,oEAAoE;IACpE,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAI3F;;;;;OAKG;IACH,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAO,GAAG,OAAO,CAAC,kBAAkB,CAAC;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CAIjH"}

package/dist/storage/index.js

@@ -0,0 +1,55 @@
+import { settle } from "../http/utils.js";
+import { StorageBucket } from "./bucket.js";
+import { BUCKET_ROUTE, bucketBody } from "./utils.js";
+const bucketPath = (id) => `${BUCKET_ROUTE}/${encodeURIComponent(id)}`;
+/** Supabase-compatible storage client: `client.storage.from(bucket)`. */
+export class StorageClient {
+    constructor(http, baseUrl, fetchImpl) {
+        this.http = http;
+        this.baseUrl = baseUrl;
+        this.fetchImpl = fetchImpl;
+    }
+    /** The files of one bucket: upload, download, list, sign URLs. */
+    from(bucket) {
+        return new StorageBucket(this.http, this.baseUrl, bucket, this.fetchImpl);
+    }
+    /**
+     * Bucket administration, supabase-js shaped.
+     *
+     * Every method here needs a SECRET project API key, which is the same rule
+     * Supabase applies (bucket administration is a service-role operation). With
+     * a publishable key they resolve with a 401 error, so keep them in server
+     * code and setup scripts, never in a browser bundle.
+     */
+    listBuckets() {
+        return settle(async () => (await this.http.request(BUCKET_ROUTE)).buckets);
+    }
+    /** One bucket's settings. Secret key only. */
+    getBucket(id) {
+        return settle(() => this.http.request(bucketPath(id)));
+    }
+    /** Create a bucket, private unless `public: true`. Secret key only. */
+    createBucket(id, options = {}) {
+        const body = { id, ...bucketBody(options), public: options.public === true };
+        return settle(() => this.http.request(BUCKET_ROUTE, { method: 'POST', body }));
+    }
+    /** Change a bucket's visibility, size limit or allowed file types. Secret key only. */
+    updateBucket(id, options) {
+        return settle(() => this.http.request(bucketPath(id), { method: 'PUT', body: bucketBody(options) }));
+    }
+    /** Delete every object in the bucket, keeping the bucket itself. */
+    emptyBucket(id) {
+        return settle(() => this.http.request(`${bucketPath(id)}/empty`, { method: 'POST' }));
+    }
+    /**
+     * Delete the bucket. A bucket that still holds objects is a `409` unless
+     * `force` is set, which queues a background deletion of its contents: an
+     * accidental `deleteBucket` must not be able to destroy a project's files in
+     * one unqualified call.
+     */
+    deleteBucket(id, options = {}) {
+        const query = options.force ? '?force=true' : '';
+        return settle(() => this.http.request(`${bucketPath(id)}${query}`, { method: 'DELETE' }));
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEtD,MAAM,UAAU,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,GAAG,YAAY,IAAI,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;AAE/E,yEAAyE;AACzE,MAAM,OAAO,aAAa;IACtB,YACqB,IAAgB,EAChB,OAAe,EACf,SAAuB;QAFvB,SAAI,GAAJ,IAAI,CAAY;QAChB,YAAO,GAAP,OAAO,CAAQ;QACf,cAAS,GAAT,SAAS,CAAc;IACxC,CAAC;IAEL,kEAAkE;IAClE,IAAI,CAAC,MAAc;QACf,OAAO,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;IAC9E,CAAC;IAED;;;;;;;OAOG;IACH,WAAW;QACP,OAAO,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAA4B,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IAC1G,CAAC;IAED,8CAA8C;IAC9C,SAAS,CAAC,EAAU;QAChB,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAa,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACvE,CAAC;IAED,uEAAuE;IACvE,YAAY,CAAC,EAAU,EAAE,UAAyB,EAAE;QAChD,MAAM,IAAI,GAAG,EAAE,EAAE,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;QAC7E,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAa,YAAY,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/F,CAAC;IAED,uFAAuF;IACvF,YAAY,CAAC,EAAU,EAAE,OAAsB;QAC3C,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAa,UAAU,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IACrH,CAAC;IAED,oEAAoE;IACpE,WAAW,CAAC,EAAU;QAClB,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAwC,GAAG,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IACjI,CAAC;IAED;;;;;OAKG;IACH,YAAY,CAAC,EAAU,EAAE,UAA+B,EAAE;QACtD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,OAAO,MAAM,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAuB,GAAG,UAAU,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;IACpH,CAAC;CACJ"}

package/dist/storage/types.d.ts

@@ -0,0 +1,131 @@
+import type { StorageRemoveContract, StorageUploadContract } from '@motherbase/contracts';
+export type FileVisibility = 'public' | 'private';
+/** Lifecycle of a stored object: `ready` unless a presigned upload is pending. */
+export type FileStatus = 'pending' | 'ready' | 'expired';
+/**
+ * A row of the storage table, as `POST /api/files/` returns it.
+ *
+ * This is the upload shape, not the `list()` shape: `list()` answers in the
+ * supabase-js `FileObject` form, which is a different set of fields under
+ * different names. Conflating the two is what the old `[key: string]: unknown`
+ * hid, and `file.filename` (a field the server never sent) type-checked.
+ */
+export interface StoredFile {
+    id: string;
+    /** Bucket slug. */
+    bucket: string;
+    /** Object key inside the bucket, including any prefix. */
+    key: string;
+    mime?: string | null;
+    size: number;
+    visibility: FileVisibility;
+    status: FileStatus;
+    /** Set for public objects and for drivers that store an absolute URL. */
+    url?: string | null;
+    ownerId?: string | null;
+    bucketId?: string | null;
+    /** Deadline of a presigned upload that has not been finalised. */
+    uploadExpiresAt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * One object as `list()` returns it: the supabase-js `FileObject` shape, which
+ * is what code ported from Supabase reads (`obj.name`, `obj.metadata.size`).
+ */
+export interface FileObject {
+    /** Key relative to the bucket. */
+    name: string;
+    id: string;
+    created_at: string | null;
+    updated_at: string | null;
+    last_accessed_at: string | null;
+    metadata: {
+        size: number;
+        mimetype: string | null;
+        cacheControl: string | null;
+    };
+}
+/** Exact payload returned by `POST /api/files/`. */
+export type StorageUploadResponse = StorageUploadContract<StoredFile>;
+/** Exact payload returned by `DELETE /api/files/:id`. */
+export type StorageRemoveResponse = StorageRemoveContract;
+/** A file-ish value accepted by multipart uploads (browser File/Blob or RN asset). */
+export type UploadInput = Blob | ArrayBuffer | ArrayBufferView | {
+    uri: string;
+    name?: string;
+    type?: string;
+};
+export interface UploadOptions {
+    /** Object visibility. Defaults to the backend's default (private). */
+    visibility?: FileVisibility;
+    /** Content type stored with the object. Overrides what the file itself declares. */
+    contentType?: string;
+    upsert?: boolean;
+}
+export interface UploadResult {
+    /** The object key, exactly as passed to `upload`. */
+    path: string;
+    /** The server-issued file id. Still accepted anywhere a path is. */
+    id: string;
+    /** `bucket/key`. */
+    fullPath: string;
+}
+/** A bucket, in the supabase-js shape. `id` is the slug. */
+export interface BucketInfo {
+    id: string;
+    name: string;
+    owner: string;
+    public: boolean;
+    /** Largest object the bucket accepts, in bytes. `null` defers to the project limit. */
+    file_size_limit: number | null;
+    /** MIME allowlist (`image/*` wildcards allowed). `null` accepts any type. */
+    allowed_mime_types: string[] | null;
+    created_at: string | null;
+    updated_at: string | null;
+}
+/** supabase-js `createBucket` / `updateBucket` options. */
+export interface BucketOptions {
+    public?: boolean;
+    name?: string;
+    /** Bytes, or a string with a unit: `'20MB'`, `'1GB'`. `null` removes the limit. */
+    fileSizeLimit?: number | string | null;
+    /** `['image/*', 'application/pdf']`. `null` or `[]` accepts any type. */
+    allowedMimeTypes?: string[] | null;
+}
+/** One object's metadata, in the supabase-js `info()` shape. */
+export interface ObjectInfo {
+    name: string;
+    id: string;
+    version: string | null;
+    bucket_id: string;
+    created_at: string | null;
+    updated_at: string | null;
+    last_accessed_at: string | null;
+    size: number;
+    content_type: string | null;
+    cache_control: string | null;
+    metadata: Record<string, unknown>;
+}
+/**
+ * supabase-js image transform options. Served by `/storage/v1/render/image`,
+ * resized with the same limits Supabase applies (1 to 2500 px, quality 20 to
+ * 100). Without `format` the server answers WebP to clients that accept it.
+ */
+export interface TransformOptions {
+    width?: number;
+    height?: number;
+    resize?: 'cover' | 'contain' | 'fill';
+    quality?: number;
+    format?: 'origin' | 'webp' | 'avif';
+}
+export interface ListOptions {
+    limit?: number;
+    offset?: number;
+    search?: string;
+    sortBy?: {
+        column?: 'name' | 'created_at' | 'updated_at';
+        order?: 'asc' | 'desc';
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/storage/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/storage/types.ts"],"names":[],"mappings":"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"}

package/dist/storage/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/storage/types.js.map

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

package/dist/storage/utils.d.ts

@@ -0,0 +1,27 @@
+import { BucketOptions, TransformOptions, UploadInput } from "./types.js";
+/** The wire shape of BucketOptions: the snake_case keys Supabase's API uses. */
+export declare function bucketBody(options: BucketOptions): {
+    name: string | undefined;
+    public: boolean | undefined;
+    file_size_limit: string | number | null | undefined;
+    allowed_mime_types: string[] | null | undefined;
+};
+/** Bucket administration lives one level up from an object route. */
+export declare const BUCKET_ROUTE: string;
+export declare const RENDER_ROUTE: string;
+/** `?width=…` for a transform, in the key order the server signs. */
+export declare function transformQuery(transform: TransformOptions): string;
+export declare const encodeKey: (path: string) => string;
+/**
+ * Supabase-compatible storage bucket handle over the authenticated
+ * `/api/files` endpoints.
+ *
+ * Objects are addressed by path: `upload('123/pic.png')` then
+ * `download('123/pic.png')`. The server-issued file id still works everywhere a
+ * path does, because that is what every caller written before path addressing
+ * has stored.
+ */
+export declare const UUID: RegExp;
+/** Preserve a typed-array view's boundaries (including Node Buffer slices). */
+export declare function uploadBlob(file: UploadInput, contentType?: string): Blob | undefined;
+//# sourceMappingURL=utils.d.ts.map

package/dist/storage/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/storage/utils.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE1E,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,OAAO,EAAE,aAAa;;;;;EAOhD;AAED,qEAAqE;AACrE,eAAO,MAAM,YAAY,QAAgC,CAAC;AAE1D,eAAO,MAAM,YAAY,QAA0C,CAAC;AAEpE,qEAAqE;AACrE,wBAAgB,cAAc,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAMlE;AAED,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,WAAsD,CAAC;AAE7F;;;;;;;;GAQG;AACH,eAAO,MAAM,IAAI,QAAoE,CAAC;AAEtF,+EAA+E;AAC/E,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAOpF"}

package/dist/storage/utils.js

@@ -0,0 +1,43 @@
+import { HTTP_ROUTES } from "@motherbase/contracts";
+/** The wire shape of BucketOptions: the snake_case keys Supabase's API uses. */
+export function bucketBody(options) {
+    return {
+        name: options.name,
+        public: options.public,
+        file_size_limit: options.fileSizeLimit,
+        allowed_mime_types: options.allowedMimeTypes,
+    };
+}
+/** Bucket administration lives one level up from an object route. */
+export const BUCKET_ROUTE = `${HTTP_ROUTES.files}/bucket`;
+export const RENDER_ROUTE = `${HTTP_ROUTES.storageV1}/render/image`;
+/** `?width=…` for a transform, in the key order the server signs. */
+export function transformQuery(transform) {
+    const query = new URLSearchParams();
+    for (const key of ['width', 'height', 'resize', 'quality', 'format']) {
+        if (transform[key] !== undefined)
+            query.set(key, String(transform[key]));
+    }
+    return query.toString();
+}
+export const encodeKey = (path) => path.split('/').map(encodeURIComponent).join('/');
+/**
+ * Supabase-compatible storage bucket handle over the authenticated
+ * `/api/files` endpoints.
+ *
+ * Objects are addressed by path: `upload('123/pic.png')` then
+ * `download('123/pic.png')`. The server-issued file id still works everywhere a
+ * path does, because that is what every caller written before path addressing
+ * has stored.
+ */
+export const UUID = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/** Preserve a typed-array view's boundaries (including Node Buffer slices). */
+export function uploadBlob(file, contentType) {
+    if (typeof Blob !== 'undefined' && file instanceof Blob) {
+        return contentType ? file.slice(0, file.size, contentType) : file;
+    }
+    const bytes = file instanceof ArrayBuffer ? file
+        : ArrayBuffer.isView(file) ? new Uint8Array(file.buffer, file.byteOffset, file.byteLength).slice() : undefined;
+    return bytes === undefined ? undefined : new Blob([bytes], { type: contentType || 'application/octet-stream' });
+}
+//# sourceMappingURL=utils.js.map