@kaiz11/stack-client 0.0.14

package/dist/mocks/responses.js

@@ -0,0 +1,91 @@
+/**
+ * Generate a valid JWT for testing
+ *
+ * Creates a properly structured JWT that can be decoded by the SDK.
+ * The signature is fake but the payload is valid.
+ */
+export function generateTestJwt(options) {
+    const now = Math.floor(Date.now() / 1000);
+    const header = { alg: "ES256", typ: "JWT" };
+    const payload = {
+        sub: options.sub,
+        email: options.email,
+        exp: options.exp ?? now + 3600, // 1 hour
+        iat: options.iat ?? now,
+        aud: "authenticated",
+        role: "authenticated",
+        app_metadata: { provider: "email", providers: ["email"] },
+        user_metadata: { email: options.email },
+    };
+    const encode = (obj) => btoa(JSON.stringify(obj))
+        .replace(/=/g, "")
+        .replace(/\+/g, "-")
+        .replace(/\//g, "_");
+    // Fake signature (not verified in tests)
+    return `${encode(header)}.${encode(payload)}.fake-signature`;
+}
+/**
+ * Generate a user ID from an email address
+ */
+export function generateUserId(email) {
+    return "user-" + email.replace("@", "-at-");
+}
+/**
+ * Create a GoTrue token response
+ *
+ * This is the single source of truth for mock token responses.
+ * Used by both MSW handlers (for SDK tests) and mock auth client (for developer tests).
+ */
+export function createTokenResponse(options) {
+    const userId = generateUserId(options.email);
+    const now = Math.floor(Date.now() / 1000);
+    const expiresIn = options.expiresIn ?? 3600;
+    return {
+        access_token: generateTestJwt({ sub: userId, email: options.email }),
+        refresh_token: options.refreshToken ?? `refresh-token-${Date.now()}`,
+        expires_in: expiresIn,
+        expires_at: now + expiresIn,
+        token_type: "bearer",
+        user: {
+            id: userId,
+            aud: "authenticated",
+            email: options.email,
+            email_confirmed_at: new Date().toISOString(),
+            created_at: new Date().toISOString(),
+            updated_at: new Date().toISOString(),
+            app_metadata: { provider: "email", providers: ["email"] },
+            user_metadata: options.userMetadata ?? { email: options.email },
+        },
+    };
+}
+/**
+ * Standard error responses (GoTrue format)
+ */
+export const errors = {
+    invalidCredentials: {
+        code: 401,
+        error_code: "invalid_credentials",
+        msg: "Invalid email or password",
+    },
+    userAlreadyExists: {
+        code: 422,
+        error_code: "user_already_exists",
+        msg: "User already registered",
+    },
+    invalidRefreshToken: {
+        code: 401,
+        error_code: "invalid_grant",
+        msg: "Invalid refresh token",
+    },
+    unauthorized: {
+        code: 401,
+        error_code: "unauthorized",
+        msg: "Missing or invalid authorization",
+    },
+    unsupportedGrantType: {
+        code: 400,
+        error_code: "unsupported_grant_type",
+        msg: "Unsupported grant type",
+    },
+};
+//# sourceMappingURL=responses.js.map

package/dist/mocks/responses.js.map

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

package/dist/mocks/server.d.ts

@@ -0,0 +1,7 @@
+/**
+ * MSW server for Node.js tests
+ *
+ * Pre-configured with default handlers. For SDK internal tests only.
+ */
+export declare const server: import("msw/node").SetupServerApi;
+//# sourceMappingURL=server.d.ts.map

package/dist/mocks/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mocks/server.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,eAAO,MAAM,MAAM,mCAA2B,CAAC"}

package/dist/mocks/server.js

@@ -0,0 +1,9 @@
+import { setupServer } from "msw/node";
+import { handlers } from "./handlers.js";
+/**
+ * MSW server for Node.js tests
+ *
+ * Pre-configured with default handlers. For SDK internal tests only.
+ */
+export const server = setupServer(...handlers);
+//# sourceMappingURL=server.js.map

package/dist/mocks/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/mocks/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,QAAQ,CAAC,CAAC"}

package/dist/mocks/state.d.ts

@@ -0,0 +1,86 @@
+import { type MockErrorResponse } from "./responses.js";
+/**
+ * Mock configuration options
+ */
+export interface MockOptions {
+    /** Artificial latency in milliseconds (default: 0) */
+    latency?: number;
+}
+/**
+ * Mock state for controlling behavior
+ *
+ * This state is shared between MSW handlers and mock auth client,
+ * ensuring consistent behavior across all mock implementations.
+ */
+export interface MockState {
+    /** Whether signIn should fail */
+    shouldFailSignIn: boolean;
+    /** Whether signUp should fail */
+    shouldFailSignUp: boolean;
+    /** Whether refresh should fail */
+    shouldFailRefresh: boolean;
+    /** Error to return when signIn fails */
+    signInError: MockErrorResponse;
+    /** Error to return when signUp fails */
+    signUpError: MockErrorResponse;
+    /** Error to return when refresh fails */
+    refreshError: MockErrorResponse;
+    /** Artificial latency in milliseconds */
+    latency: number;
+    /** Reset all state to defaults */
+    reset(): void;
+}
+/**
+ * Request tracking for test assertions
+ */
+export interface RequestCounts {
+    signIn: number;
+    signUp: number;
+    signOut: number;
+    refresh: number;
+    reset(): void;
+}
+/**
+ * Global mock state instance
+ *
+ * Use this to control mock behavior in tests:
+ *
+ * @example
+ * ```typescript
+ * import { mockState } from "@kaiz11/stack-client/mocks";
+ *
+ * // Make signIn fail
+ * mockState.shouldFailSignIn = true;
+ *
+ * // Custom error message
+ * mockState.signInError = {
+ *   code: 429,
+ *   error_code: "too_many_attempts",
+ *   msg: "Too many login attempts",
+ * };
+ *
+ * // Reset after test
+ * mockState.reset();
+ * ```
+ */
+export declare const mockState: MockState;
+/**
+ * Request counts for test assertions
+ *
+ * @example
+ * ```typescript
+ * import { requestCounts } from "@kaiz11/stack-client/mocks";
+ *
+ * // Check how many requests were made
+ * expect(requestCounts.signIn).toBe(1);
+ *
+ * // Reset after test
+ * requestCounts.reset();
+ * ```
+ */
+export declare const requestCounts: RequestCounts;
+/**
+ * Apply artificial latency
+ */
+export declare function delay(ms: number): Promise<void>;
+//# sourceMappingURL=state.d.ts.map

package/dist/mocks/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/mocks/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,SAAS;IACxB,iCAAiC;IACjC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iCAAiC;IACjC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,kCAAkC;IAClC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,wCAAwC;IACxC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,wCAAwC;IACxC,WAAW,EAAE,iBAAiB,CAAC;IAC/B,yCAAyC;IACzC,YAAY,EAAE,iBAAiB,CAAC;IAChC,yCAAyC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,kCAAkC;IAClC,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,IAAI,IAAI,CAAC;CACf;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,SAAS,EAAE,SAiBvB,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,aAAa,EAAE,aAW3B,CAAC;AAEF;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/C"}

package/dist/mocks/state.js

@@ -0,0 +1,77 @@
+import { errors } from "./responses.js";
+/**
+ * Global mock state instance
+ *
+ * Use this to control mock behavior in tests:
+ *
+ * @example
+ * ```typescript
+ * import { mockState } from "@kaiz11/stack-client/mocks";
+ *
+ * // Make signIn fail
+ * mockState.shouldFailSignIn = true;
+ *
+ * // Custom error message
+ * mockState.signInError = {
+ *   code: 429,
+ *   error_code: "too_many_attempts",
+ *   msg: "Too many login attempts",
+ * };
+ *
+ * // Reset after test
+ * mockState.reset();
+ * ```
+ */
+export const mockState = {
+    shouldFailSignIn: false,
+    shouldFailSignUp: false,
+    shouldFailRefresh: false,
+    signInError: { ...errors.invalidCredentials },
+    signUpError: { ...errors.userAlreadyExists },
+    refreshError: { ...errors.invalidRefreshToken },
+    latency: 0,
+    reset() {
+        this.shouldFailSignIn = false;
+        this.shouldFailSignUp = false;
+        this.shouldFailRefresh = false;
+        this.signInError = { ...errors.invalidCredentials };
+        this.signUpError = { ...errors.userAlreadyExists };
+        this.refreshError = { ...errors.invalidRefreshToken };
+        this.latency = 0;
+    },
+};
+/**
+ * Request counts for test assertions
+ *
+ * @example
+ * ```typescript
+ * import { requestCounts } from "@kaiz11/stack-client/mocks";
+ *
+ * // Check how many requests were made
+ * expect(requestCounts.signIn).toBe(1);
+ *
+ * // Reset after test
+ * requestCounts.reset();
+ * ```
+ */
+export const requestCounts = {
+    signIn: 0,
+    signUp: 0,
+    signOut: 0,
+    refresh: 0,
+    reset() {
+        this.signIn = 0;
+        this.signUp = 0;
+        this.signOut = 0;
+        this.refresh = 0;
+    },
+};
+/**
+ * Apply artificial latency
+ */
+export function delay(ms) {
+    if (ms <= 0)
+        return Promise.resolve();
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=state.js.map

package/dist/mocks/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/mocks/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA0B,MAAM,gBAAgB,CAAC;AA8ChE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,SAAS,GAAc;IAClC,gBAAgB,EAAE,KAAK;IACvB,gBAAgB,EAAE,KAAK;IACvB,iBAAiB,EAAE,KAAK;IACxB,WAAW,EAAE,EAAE,GAAG,MAAM,CAAC,kBAAkB,EAAE;IAC7C,WAAW,EAAE,EAAE,GAAG,MAAM,CAAC,iBAAiB,EAAE;IAC5C,YAAY,EAAE,EAAE,GAAG,MAAM,CAAC,mBAAmB,EAAE;IAC/C,OAAO,EAAE,CAAC;IACV,KAAK;QACH,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;QAC9B,IAAI,CAAC,gBAAgB,GAAG,KAAK,CAAC;QAC9B,IAAI,CAAC,iBAAiB,GAAG,KAAK,CAAC;QAC/B,IAAI,CAAC,WAAW,GAAG,EAAE,GAAG,MAAM,CAAC,kBAAkB,EAAE,CAAC;QACpD,IAAI,CAAC,WAAW,GAAG,EAAE,GAAG,MAAM,CAAC,iBAAiB,EAAE,CAAC;QACnD,IAAI,CAAC,YAAY,GAAG,EAAE,GAAG,MAAM,CAAC,mBAAmB,EAAE,CAAC;QACtD,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;IACnB,CAAC;CACF,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,aAAa,GAAkB;IAC1C,MAAM,EAAE,CAAC;IACT,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,KAAK;QACH,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;IACnB,CAAC;CACF,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,EAAU;IAC9B,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IACtC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/storage/bucket-ref.d.ts

@@ -0,0 +1,183 @@
+import type { HttpClient } from "../lib/http.js";
+import type { IBucketRef } from "./interface.js";
+import { type CopyOptions, type CopyResult, type DownloadOptions, type FileBody, type ListOptions, type ListV2Options, type ListV2Result, type MoveOptions, type PublicUrlOptions, type SignedUrl, type SignedUploadUrl, type SignedUploadUrlOptions, type SignedUrlOptions, type StorageObject, type TusUpload, type TusUploadOptions, type UploadOptions, type UploadResult } from "./types.js";
+/**
+ * Bucket reference for fluent object operations
+ */
+export declare class BucketRef implements IBucketRef {
+    private readonly http;
+    private readonly tenantId;
+    private readonly bucketId;
+    constructor(http: HttpClient, tenantId: string, bucketId: string);
+    private path;
+    /**
+     * Upload a file to the bucket
+     *
+     * Accepts string, Blob, ArrayBuffer, or ReadableStream.
+     * By default, throws if file already exists. Use `upsert: true` to overwrite.
+     *
+     * @example
+     * await client.storage.from("docs").upload("report.pdf", file);
+     * await client.storage.from("docs").upload("report.pdf", file, { upsert: true });
+     */
+    upload(path: string, file: FileBody, options?: UploadOptions): Promise<UploadResult>;
+    /**
+     * Download a file from the bucket
+     *
+     * Returns the file as a Blob. Supports image transforms for on-the-fly resizing.
+     *
+     * @example
+     * const blob = await client.storage.from("docs").download("report.pdf");
+     * const thumbnail = await client.storage.from("images").download("photo.jpg", {
+     *   transform: { width: 200, height: 200 }
+     * });
+     */
+    download(path: string, options?: DownloadOptions): Promise<Blob>;
+    /**
+     * Get the public URL for an object
+     *
+     * Constructs the URL locally (no API call). The URL only works if
+     * the bucket is set to `public: true`. Does not validate if the
+     * file exists.
+     *
+     * @example
+     * const url = client.storage.from("avatars").getPublicUrl("user123.jpg");
+     */
+    getPublicUrl(path: string, options?: PublicUrlOptions): string;
+    /**
+     * Create a signed URL for temporary access to a private file
+     *
+     * The URL expires after the specified time. Use for private buckets
+     * when you need to share a file temporarily.
+     *
+     * @example
+     * const { signedUrl } = await client.storage.from("private").createSignedUrl("doc.pdf", {
+     *   expiresIn: 3600 // 1 hour
+     * });
+     */
+    createSignedUrl(path: string, options: SignedUrlOptions): Promise<SignedUrl>;
+    /**
+     * Create signed URLs for multiple files in a single request
+     *
+     * More efficient than calling createSignedUrl multiple times.
+     *
+     * @example
+     * const urls = await client.storage.from("private").createSignedUrls(
+     *   ["doc1.pdf", "doc2.pdf"],
+     *   { expiresIn: 3600 }
+     * );
+     */
+    createSignedUrls(paths: string[], options: SignedUrlOptions): Promise<SignedUrl[]>;
+    /**
+     * Create a signed URL for uploading a file
+     *
+     * Useful for client-side uploads without exposing credentials.
+     * The returned token is used with uploadToSignedUrl.
+     *
+     * @example
+     * const { signedUrl, token } = await client.storage.from("uploads").createSignedUploadUrl("file.pdf");
+     * await client.storage.from("uploads").uploadToSignedUrl(signedUrl, token, file);
+     */
+    createSignedUploadUrl(path: string, options?: SignedUploadUrlOptions): Promise<SignedUploadUrl>;
+    /**
+     * Upload a file using a signed upload URL
+     *
+     * Use with createSignedUploadUrl for client-side uploads.
+     * The signedUrl may point to a different domain (e.g., R2/S3).
+     *
+     * @example
+     * const { signedUrl, token } = await client.storage.from("uploads").createSignedUploadUrl("file.pdf");
+     * await client.storage.from("uploads").uploadToSignedUrl(signedUrl, token, file);
+     */
+    uploadToSignedUrl(signedUrl: string, token: string, file: FileBody, options?: UploadOptions): Promise<UploadResult>;
+    private uploadWithXhr;
+    /**
+     * Create a resumable upload using the TUS protocol
+     *
+     * For large files that may need to resume after interruption.
+     * Returns a TusUpload object with start(), abort(), and progress callbacks.
+     *
+     * @example
+     * const upload = client.storage.from("videos").createResumableUpload("large.mp4", file, {
+     *   onProgress: ({ percentage }) => console.log(`${percentage}%`)
+     * });
+     * await upload.start();
+     */
+    createResumableUpload(path: string, file: FileBody, options?: TusUploadOptions): TusUpload;
+    /**
+     * List objects in the bucket
+     *
+     * Supports prefix filtering, pagination, and search.
+     *
+     * @example
+     * const files = await client.storage.from("docs").list();
+     * const pdfs = await client.storage.from("docs").list({ prefix: "reports/", search: ".pdf" });
+     */
+    list(options?: ListOptions): Promise<StorageObject[]>;
+    /**
+     * List objects with cursor-based pagination
+     *
+     * Better for large buckets. Returns prefixes (folders) separately
+     * and provides a cursor for fetching the next page.
+     *
+     * @example
+     * let cursor: string | null = null;
+     * do {
+     *   const result = await client.storage.from("docs").listV2({ cursor, limit: 100 });
+     *   console.log(result.objects);
+     *   cursor = result.nextCursor;
+     * } while (cursor);
+     */
+    listV2(options?: ListV2Options): Promise<ListV2Result>;
+    /**
+     * Delete objects from the bucket
+     *
+     * Accepts an array of paths. Returns the deleted objects.
+     *
+     * @example
+     * await client.storage.from("docs").remove(["old.pdf", "draft.pdf"]);
+     */
+    remove(paths: string[]): Promise<StorageObject[]>;
+    /**
+     * Move or rename an object
+     *
+     * Can move to a different bucket using destinationBucket option.
+     *
+     * @example
+     * await client.storage.from("docs").move("draft.pdf", "final.pdf");
+     * await client.storage.from("docs").move("file.pdf", "file.pdf", { destinationBucket: "archive" });
+     */
+    move(fromPath: string, toPath: string, options?: MoveOptions): Promise<void>;
+    /**
+     * Copy an object to a new location
+     *
+     * By default copies metadata. Can copy to a different bucket.
+     *
+     * @example
+     * await client.storage.from("docs").copy("template.pdf", "copy.pdf");
+     * await client.storage.from("docs").copy("file.pdf", "file.pdf", { destinationBucket: "backup" });
+     */
+    copy(fromPath: string, toPath: string, options?: CopyOptions): Promise<CopyResult>;
+    /**
+     * Get metadata for an object
+     *
+     * Returns size, content type, last modified, and custom metadata.
+     *
+     * @example
+     * const info = await client.storage.from("docs").getInfo("report.pdf");
+     * console.log(info.metadata.size, info.metadata.mimetype);
+     */
+    getInfo(path: string): Promise<StorageObject>;
+    /**
+     * Check if an object exists in the bucket
+     *
+     * Uses a HEAD request to check existence without downloading content.
+     *
+     * @example
+     * if (await client.storage.from("docs").exists("report.pdf")) {
+     *   console.log("File exists");
+     * }
+     */
+    exists(path: string): Promise<boolean>;
+}
+//# sourceMappingURL=bucket-ref.d.ts.map

package/dist/storage/bucket-ref.d.ts.map

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