@mitway/sdk 0.3.0 → 0.4.0

package/dist/index.d.cts

@@ -548,6 +548,18 @@ declare class HttpClient {
     private computeRetryDelay;
     private handleRequest;
     request<T>(method: string, path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Low-level fetch helper for binary bodies (uploads) and streamed responses
+     * (downloads). Applies the current Bearer token (user session → anon key
+     * fallback) plus any configured default headers, resolves `path` against
+     * `baseUrl`, and returns the raw `Response` — it does NOT unwrap the
+     * `{ data, error }` envelope, so the caller is responsible for status
+     * checking and parsing.
+     *
+     * Used by the storage module for object upload/download paths where the
+     * body or response is not JSON.
+     */
+    rawFetch(path: string, init?: RequestInit): Promise<Response>;
     get<T>(path: string, options?: RequestOptions): Promise<T>;
     post<T>(path: string, body?: any, options?: RequestOptions): Promise<T>;
     put<T>(path: string, body?: any, options?: RequestOptions): Promise<T>;
@@ -718,6 +730,136 @@ declare class Database {
     getUrl(): string;
 }
 
+/**
+ * Storage types — kept in sync manually with the MITWAY-BaaS shared-schemas
+ * definitions at
+ * `MITWAY-BaaS/packages/shared-schemas/src/storage.schema.ts`.
+ *
+ * All SDK-facing fields are camelCase. The wire format is snake_case; the
+ * storage module maps between the two.
+ */
+interface StorageBucket {
+    id: string;
+    name: string;
+    public: boolean;
+    fileSizeLimitBytes: number | null;
+    allowedMimeTypes: string[] | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface StorageObject {
+    id: string;
+    bucket: string;
+    key: string;
+    size: number;
+    mimeType: string | null;
+    etag: string;
+    cacheControl: string | null;
+    contentDisposition: string | null;
+    uploadedBy: string | null;
+    uploadedAt: string;
+    updatedAt: string;
+}
+interface StorageConfig {
+    defaultFileSizeLimitBytes: number;
+    maxFileSizeLimitBytes: number;
+    tenantStorageQuotaBytes: number;
+    reservedSpaceBytes: number;
+    signedUrlDefaultTtlSec: number;
+    signedUrlMaxTtlSec: number;
+}
+interface CreateBucketOptions {
+    public?: boolean;
+    fileSizeLimitBytes?: number | null;
+    allowedMimeTypes?: string[] | null;
+}
+interface UpdateBucketOptions {
+    public?: boolean;
+    fileSizeLimitBytes?: number | null;
+    allowedMimeTypes?: string[] | null;
+}
+interface UploadOptions {
+    contentType?: string;
+    cacheControl?: string;
+    contentDisposition?: string;
+    /** Defaults to false (POST, fails on duplicate). If true, uses PUT (upsert). */
+    upsert?: boolean;
+    abortSignal?: AbortSignal;
+}
+interface DownloadOptions {
+    range?: {
+        start: number;
+        end: number;
+    };
+    abortSignal?: AbortSignal;
+}
+interface ListOptions {
+    prefix?: string;
+    limit?: number;
+    startAfter?: string;
+}
+interface SignedUrlOptions {
+    expiresIn?: number;
+}
+interface SignedUrlResult {
+    url: string;
+    token: string;
+    expiresAt: string;
+}
+type UploadBody = Blob | ArrayBuffer | ArrayBufferView | ReadableStream<Uint8Array> | string;
+
+/**
+ * Storage module — thin wrapper over the /api/storage/* REST endpoints
+ * exposed by MITWAY-BaaS.
+ *
+ * Surface mirrors what coding agents expect from a Supabase-style storage
+ * SDK but routes through the Mitway backend (no direct S3 calls). Binary
+ * upload/download uses `HttpClient.rawFetch`; JSON operations use the
+ * standard typed `request<T>` path.
+ */
+
+type StorageResult<T> = {
+    data: T | null;
+    error: MitwayBaasError | null;
+};
+declare class StorageBucketClient {
+    private readonly http;
+    private readonly bucketName;
+    constructor(http: HttpClient, bucketName: string);
+    private bucketBase;
+    private objectPath;
+    upload(key: string, body: UploadBody, opts?: UploadOptions): Promise<StorageResult<StorageObject>>;
+    download(key: string, opts?: DownloadOptions): Promise<StorageResult<Blob>>;
+    getStream(key: string, opts?: DownloadOptions): Promise<StorageResult<ReadableStream<Uint8Array>>>;
+    remove(keys: string[]): Promise<StorageResult<{
+        removed: string[];
+    }>>;
+    list(opts?: ListOptions): Promise<StorageResult<StorageObject[]>>;
+    copy(fromKey: string, toKey: string, toBucket?: string): Promise<StorageResult<StorageObject>>;
+    move(fromKey: string, toKey: string, toBucket?: string): Promise<StorageResult<StorageObject>>;
+    createSignedUrl(key: string, opts?: SignedUrlOptions): Promise<StorageResult<SignedUrlResult>>;
+    getPublicUrl(key: string): {
+        data: {
+            url: string;
+        };
+    };
+}
+declare class Storage {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Scope subsequent operations to a single bucket. */
+    from(bucketName: string): StorageBucketClient;
+    listBuckets(): Promise<StorageResult<StorageBucket[]>>;
+    getBucket(name: string): Promise<StorageResult<StorageBucket>>;
+    createBucket(name: string, opts?: CreateBucketOptions): Promise<StorageResult<StorageBucket>>;
+    updateBucket(name: string, opts: UpdateBucketOptions): Promise<StorageResult<StorageBucket>>;
+    deleteBucket(name: string): Promise<StorageResult<null>>;
+    emptyBucket(name: string): Promise<StorageResult<{
+        removed: number;
+    }>>;
+    getConfig(): Promise<StorageResult<StorageConfig>>;
+}
+
 /**
  * MITWAY-BaaS SDK client.
  *
@@ -751,6 +893,7 @@ declare class MitwayBaasClient {
     readonly auth: Auth;
     readonly database: Database;
     readonly realtime: Realtime;
+    readonly storage: Storage;
     constructor(config?: MitwayBaasConfig);
     /**
      * Escape hatch for callers that need to make custom requests against the
@@ -791,4 +934,4 @@ declare class MitwayBaasClient {
  */
 declare function createClient(config: MitwayBaasConfig): MitwayBaasClient;
 
-export { type ApiError, Auth, type AuthRefreshResponse, type AuthResponse, type AuthResult, type AuthSession, type BroadcastFilter, type BroadcastPayload, type ChannelOptions, type ChannelStatus, type ChannelStatusCallback, Database, HttpClient, Logger, MitwayBaasClient, type MitwayBaasConfig, MitwayBaasError, type PostgresChangesDeletePayload, type PostgresChangesEventSelector, type PostgresChangesFilter, type PostgresChangesInsertPayload, type PostgresChangesPayload, type PostgresChangesUpdatePayload, type PresenceEventSelector, type PresenceFilter, type PresenceJoinPayload, type PresenceLeavePayload, type PresencePayload, type PresenceState, type PresenceSyncPayload, Realtime, RealtimeChannel, type RealtimeMessageMeta, type RealtimeOptions, type SignInRequest, type SignUpRequest, TokenManager, type User, createClient, MitwayBaasClient as default };
+export { type ApiError, Auth, type AuthRefreshResponse, type AuthResponse, type AuthResult, type AuthSession, type BroadcastFilter, type BroadcastPayload, type ChannelOptions, type ChannelStatus, type ChannelStatusCallback, type CreateBucketOptions, Database, type DownloadOptions, HttpClient, type ListOptions, Logger, MitwayBaasClient, type MitwayBaasConfig, MitwayBaasError, type PostgresChangesDeletePayload, type PostgresChangesEventSelector, type PostgresChangesFilter, type PostgresChangesInsertPayload, type PostgresChangesPayload, type PostgresChangesUpdatePayload, type PresenceEventSelector, type PresenceFilter, type PresenceJoinPayload, type PresenceLeavePayload, type PresencePayload, type PresenceState, type PresenceSyncPayload, Realtime, RealtimeChannel, type RealtimeMessageMeta, type RealtimeOptions, type SignInRequest, type SignUpRequest, type SignedUrlOptions, type SignedUrlResult, Storage, type StorageBucket, StorageBucketClient, type StorageConfig, type StorageObject, type StorageResult, TokenManager, type UpdateBucketOptions, type UploadBody, type UploadOptions, type User, createClient, MitwayBaasClient as default };

package/dist/index.d.ts

@@ -548,6 +548,18 @@ declare class HttpClient {
     private computeRetryDelay;
     private handleRequest;
     request<T>(method: string, path: string, options?: RequestOptions): Promise<T>;
+    /**
+     * Low-level fetch helper for binary bodies (uploads) and streamed responses
+     * (downloads). Applies the current Bearer token (user session → anon key
+     * fallback) plus any configured default headers, resolves `path` against
+     * `baseUrl`, and returns the raw `Response` — it does NOT unwrap the
+     * `{ data, error }` envelope, so the caller is responsible for status
+     * checking and parsing.
+     *
+     * Used by the storage module for object upload/download paths where the
+     * body or response is not JSON.
+     */
+    rawFetch(path: string, init?: RequestInit): Promise<Response>;
     get<T>(path: string, options?: RequestOptions): Promise<T>;
     post<T>(path: string, body?: any, options?: RequestOptions): Promise<T>;
     put<T>(path: string, body?: any, options?: RequestOptions): Promise<T>;
@@ -718,6 +730,136 @@ declare class Database {
     getUrl(): string;
 }
 
+/**
+ * Storage types — kept in sync manually with the MITWAY-BaaS shared-schemas
+ * definitions at
+ * `MITWAY-BaaS/packages/shared-schemas/src/storage.schema.ts`.
+ *
+ * All SDK-facing fields are camelCase. The wire format is snake_case; the
+ * storage module maps between the two.
+ */
+interface StorageBucket {
+    id: string;
+    name: string;
+    public: boolean;
+    fileSizeLimitBytes: number | null;
+    allowedMimeTypes: string[] | null;
+    createdAt: string;
+    updatedAt: string;
+}
+interface StorageObject {
+    id: string;
+    bucket: string;
+    key: string;
+    size: number;
+    mimeType: string | null;
+    etag: string;
+    cacheControl: string | null;
+    contentDisposition: string | null;
+    uploadedBy: string | null;
+    uploadedAt: string;
+    updatedAt: string;
+}
+interface StorageConfig {
+    defaultFileSizeLimitBytes: number;
+    maxFileSizeLimitBytes: number;
+    tenantStorageQuotaBytes: number;
+    reservedSpaceBytes: number;
+    signedUrlDefaultTtlSec: number;
+    signedUrlMaxTtlSec: number;
+}
+interface CreateBucketOptions {
+    public?: boolean;
+    fileSizeLimitBytes?: number | null;
+    allowedMimeTypes?: string[] | null;
+}
+interface UpdateBucketOptions {
+    public?: boolean;
+    fileSizeLimitBytes?: number | null;
+    allowedMimeTypes?: string[] | null;
+}
+interface UploadOptions {
+    contentType?: string;
+    cacheControl?: string;
+    contentDisposition?: string;
+    /** Defaults to false (POST, fails on duplicate). If true, uses PUT (upsert). */
+    upsert?: boolean;
+    abortSignal?: AbortSignal;
+}
+interface DownloadOptions {
+    range?: {
+        start: number;
+        end: number;
+    };
+    abortSignal?: AbortSignal;
+}
+interface ListOptions {
+    prefix?: string;
+    limit?: number;
+    startAfter?: string;
+}
+interface SignedUrlOptions {
+    expiresIn?: number;
+}
+interface SignedUrlResult {
+    url: string;
+    token: string;
+    expiresAt: string;
+}
+type UploadBody = Blob | ArrayBuffer | ArrayBufferView | ReadableStream<Uint8Array> | string;
+
+/**
+ * Storage module — thin wrapper over the /api/storage/* REST endpoints
+ * exposed by MITWAY-BaaS.
+ *
+ * Surface mirrors what coding agents expect from a Supabase-style storage
+ * SDK but routes through the Mitway backend (no direct S3 calls). Binary
+ * upload/download uses `HttpClient.rawFetch`; JSON operations use the
+ * standard typed `request<T>` path.
+ */
+
+type StorageResult<T> = {
+    data: T | null;
+    error: MitwayBaasError | null;
+};
+declare class StorageBucketClient {
+    private readonly http;
+    private readonly bucketName;
+    constructor(http: HttpClient, bucketName: string);
+    private bucketBase;
+    private objectPath;
+    upload(key: string, body: UploadBody, opts?: UploadOptions): Promise<StorageResult<StorageObject>>;
+    download(key: string, opts?: DownloadOptions): Promise<StorageResult<Blob>>;
+    getStream(key: string, opts?: DownloadOptions): Promise<StorageResult<ReadableStream<Uint8Array>>>;
+    remove(keys: string[]): Promise<StorageResult<{
+        removed: string[];
+    }>>;
+    list(opts?: ListOptions): Promise<StorageResult<StorageObject[]>>;
+    copy(fromKey: string, toKey: string, toBucket?: string): Promise<StorageResult<StorageObject>>;
+    move(fromKey: string, toKey: string, toBucket?: string): Promise<StorageResult<StorageObject>>;
+    createSignedUrl(key: string, opts?: SignedUrlOptions): Promise<StorageResult<SignedUrlResult>>;
+    getPublicUrl(key: string): {
+        data: {
+            url: string;
+        };
+    };
+}
+declare class Storage {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Scope subsequent operations to a single bucket. */
+    from(bucketName: string): StorageBucketClient;
+    listBuckets(): Promise<StorageResult<StorageBucket[]>>;
+    getBucket(name: string): Promise<StorageResult<StorageBucket>>;
+    createBucket(name: string, opts?: CreateBucketOptions): Promise<StorageResult<StorageBucket>>;
+    updateBucket(name: string, opts: UpdateBucketOptions): Promise<StorageResult<StorageBucket>>;
+    deleteBucket(name: string): Promise<StorageResult<null>>;
+    emptyBucket(name: string): Promise<StorageResult<{
+        removed: number;
+    }>>;
+    getConfig(): Promise<StorageResult<StorageConfig>>;
+}
+
 /**
  * MITWAY-BaaS SDK client.
  *
@@ -751,6 +893,7 @@ declare class MitwayBaasClient {
     readonly auth: Auth;
     readonly database: Database;
     readonly realtime: Realtime;
+    readonly storage: Storage;
     constructor(config?: MitwayBaasConfig);
     /**
      * Escape hatch for callers that need to make custom requests against the
@@ -791,4 +934,4 @@ declare class MitwayBaasClient {
  */
 declare function createClient(config: MitwayBaasConfig): MitwayBaasClient;
 
-export { type ApiError, Auth, type AuthRefreshResponse, type AuthResponse, type AuthResult, type AuthSession, type BroadcastFilter, type BroadcastPayload, type ChannelOptions, type ChannelStatus, type ChannelStatusCallback, Database, HttpClient, Logger, MitwayBaasClient, type MitwayBaasConfig, MitwayBaasError, type PostgresChangesDeletePayload, type PostgresChangesEventSelector, type PostgresChangesFilter, type PostgresChangesInsertPayload, type PostgresChangesPayload, type PostgresChangesUpdatePayload, type PresenceEventSelector, type PresenceFilter, type PresenceJoinPayload, type PresenceLeavePayload, type PresencePayload, type PresenceState, type PresenceSyncPayload, Realtime, RealtimeChannel, type RealtimeMessageMeta, type RealtimeOptions, type SignInRequest, type SignUpRequest, TokenManager, type User, createClient, MitwayBaasClient as default };
+export { type ApiError, Auth, type AuthRefreshResponse, type AuthResponse, type AuthResult, type AuthSession, type BroadcastFilter, type BroadcastPayload, type ChannelOptions, type ChannelStatus, type ChannelStatusCallback, type CreateBucketOptions, Database, type DownloadOptions, HttpClient, type ListOptions, Logger, MitwayBaasClient, type MitwayBaasConfig, MitwayBaasError, type PostgresChangesDeletePayload, type PostgresChangesEventSelector, type PostgresChangesFilter, type PostgresChangesInsertPayload, type PostgresChangesPayload, type PostgresChangesUpdatePayload, type PresenceEventSelector, type PresenceFilter, type PresenceJoinPayload, type PresenceLeavePayload, type PresencePayload, type PresenceState, type PresenceSyncPayload, Realtime, RealtimeChannel, type RealtimeMessageMeta, type RealtimeOptions, type SignInRequest, type SignUpRequest, type SignedUrlOptions, type SignedUrlResult, Storage, type StorageBucket, StorageBucketClient, type StorageConfig, type StorageObject, type StorageResult, TokenManager, type UpdateBucketOptions, type UploadBody, type UploadOptions, type User, createClient, MitwayBaasClient as default };