@kaiz11/stack-client 0.0.14

package/dist/storage/types.d.ts

@@ -0,0 +1,335 @@
+/**
+ * Normalized bucket metadata (camelCase)
+ */
+export interface Bucket {
+    id: string;
+    name: string;
+    owner: string | null;
+    public: boolean;
+    fileSizeLimit: number | null;
+    allowedMimeTypes: string[] | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Options for creating a bucket
+ */
+export interface CreateBucketOptions {
+    /** Bucket name (also used as ID if id not specified) */
+    name: string;
+    /** Optional bucket ID (defaults to name) */
+    id?: string;
+    /** Whether the bucket is public (default: false) */
+    public?: boolean;
+    /** Max file size in bytes (null = no limit) */
+    fileSizeLimit?: number | null;
+    /** Allowed MIME types (null = all types) */
+    allowedMimeTypes?: string[] | null;
+}
+/**
+ * Options for updating a bucket
+ */
+export interface UpdateBucketOptions {
+    /** Whether the bucket is public */
+    public?: boolean;
+    /** Max file size in bytes */
+    fileSizeLimit?: number | null;
+    /** Allowed MIME types */
+    allowedMimeTypes?: string[] | null;
+}
+/**
+ * Raw bucket response from API (snake_case)
+ */
+export interface ApiBucket {
+    id: string;
+    name: string;
+    owner: string | null;
+    owner_id: string | null;
+    public: boolean;
+    file_size_limit: number | null;
+    allowed_mime_types: string[] | null;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Normalized storage object metadata (camelCase)
+ */
+export interface StorageObject {
+    id: string | null;
+    name: string;
+    bucketId: string;
+    owner: string | null;
+    version: string | null;
+    createdAt: string | null;
+    updatedAt: string | null;
+    lastAccessedAt: string | null;
+    metadata: ObjectMetadata | null;
+    userMetadata: Record<string, string> | null;
+}
+/**
+ * Object metadata (size, mimetype, etc.)
+ */
+export interface ObjectMetadata {
+    size?: number;
+    mimetype?: string;
+    cacheControl?: string;
+    eTag?: string;
+    contentLength?: number;
+    httpStatusCode?: number;
+    lastModified?: string;
+}
+/**
+ * Raw object response from API (snake_case)
+ */
+export interface ApiObject {
+    id: string | null;
+    name: string;
+    bucket_id: string;
+    owner: string | null;
+    owner_id: string | null;
+    version: string | null;
+    created_at: string | null;
+    updated_at: string | null;
+    last_accessed_at: string | null;
+    metadata: Record<string, unknown> | null;
+    user_metadata: Record<string, string> | null;
+}
+/**
+ * Supported file body types for upload
+ */
+export type FileBody = Blob | File | ArrayBuffer | ReadableStream<Uint8Array> | string;
+/**
+ * Progress callback data for uploads
+ */
+export interface UploadProgress {
+    /** Bytes uploaded so far */
+    bytesUploaded: number;
+    /** Total bytes to upload */
+    bytesTotal: number;
+    /** Progress percentage (0-100) */
+    percentage: number;
+}
+/**
+ * Options for uploading a file
+ */
+export interface UploadOptions {
+    /** Cache-Control header */
+    cacheControl?: string;
+    /** Content-Type (auto-detected if not provided) */
+    contentType?: string;
+    /** Whether to upsert if file exists (default: false) */
+    upsert?: boolean;
+    /** Custom user metadata */
+    metadata?: Record<string, string>;
+    /** Progress callback (uses XHR instead of fetch when provided) */
+    onProgress?: (progress: UploadProgress) => void;
+}
+/**
+ * Result of a successful upload
+ */
+export interface UploadResult {
+    /** Object UUID */
+    id: string;
+    /** Object path within bucket */
+    path: string;
+    /** Full path including bucket */
+    fullPath: string;
+}
+/**
+ * Options for downloading a file
+ */
+export interface DownloadOptions {
+    /** Transform image on download */
+    transform?: ImageTransformOptions;
+}
+/**
+ * Image transformation options
+ */
+export interface ImageTransformOptions {
+    /** Target width in pixels */
+    width?: number;
+    /** Target height in pixels */
+    height?: number;
+    /** Resize mode */
+    resize?: "cover" | "contain" | "fill";
+    /** Output format */
+    format?: "origin" | "avif" | "webp";
+    /** Quality (1-100) */
+    quality?: number;
+}
+/**
+ * Options for listing objects (v1 - offset pagination)
+ */
+export interface ListOptions {
+    /** Folder prefix to filter by */
+    prefix?: string;
+    /** Max number of results (default: 100) */
+    limit?: number;
+    /** Offset for pagination */
+    offset?: number;
+    /** Sort configuration */
+    sortBy?: {
+        column: "name" | "updated_at" | "created_at" | "last_accessed_at";
+        order?: "asc" | "desc";
+    };
+    /** Search term */
+    search?: string;
+}
+/**
+ * Options for listing objects (v2 - cursor pagination)
+ */
+export interface ListV2Options {
+    /** Folder prefix to filter by */
+    prefix?: string;
+    /** Max number of results (default: 100) */
+    limit?: number;
+    /** Cursor for pagination (from previous response) */
+    cursor?: string;
+    /** Whether to use delimiter for folder-like listing */
+    delimiter?: boolean;
+    /** Sort configuration */
+    sortBy?: {
+        column: "name" | "updated_at" | "created_at";
+        order?: "asc" | "desc";
+    };
+}
+/**
+ * Result of listing objects (v2)
+ */
+export interface ListV2Result {
+    /** Objects in the result */
+    objects: StorageObject[];
+    /** Folders/prefixes (when delimiter is true) */
+    prefixes: string[];
+    /** Cursor for next page (null if no more results) */
+    nextCursor: string | null;
+}
+/**
+ * Options for creating a signed download URL
+ */
+export interface SignedUrlOptions {
+    /** URL expiration in seconds */
+    expiresIn: number;
+    /** Image transformation options */
+    transform?: ImageTransformOptions;
+    /** Force download with filename (true = use original name) */
+    download?: string | boolean;
+}
+/**
+ * Options for creating a signed upload URL
+ */
+export interface SignedUploadUrlOptions {
+    /** Whether to upsert if file exists */
+    upsert?: boolean;
+}
+/**
+ * Signed URL result
+ */
+export interface SignedUrl {
+    /** Full signed URL */
+    signedUrl: string;
+    /** Token component of the URL */
+    token?: string;
+    /** Object path */
+    path: string;
+}
+/**
+ * Signed upload URL result
+ */
+export interface SignedUploadUrl {
+    /** Full signed URL for upload */
+    signedUrl: string;
+    /** Token to use for upload */
+    token: string;
+    /** Object path */
+    path: string;
+}
+/**
+ * Options for moving an object
+ */
+export interface MoveOptions {
+    /** Destination bucket (defaults to source bucket) */
+    destinationBucket?: string;
+}
+/**
+ * Options for copying an object
+ */
+export interface CopyOptions {
+    /** Destination bucket (defaults to source bucket) */
+    destinationBucket?: string;
+    /** Whether to copy source metadata (default: true) */
+    copyMetadata?: boolean;
+    /** Override metadata */
+    metadata?: {
+        cacheControl?: string;
+        contentType?: string;
+    };
+    /** Whether to upsert if destination exists */
+    upsert?: boolean;
+}
+/**
+ * Result of copying an object
+ */
+export interface CopyResult {
+    /** Object UUID */
+    id: string;
+    /** Full path of the copied object */
+    path: string;
+}
+/**
+ * Progress callback data for TUS uploads
+ */
+export interface TusProgress {
+    /** Bytes uploaded so far */
+    bytesUploaded: number;
+    /** Total bytes to upload */
+    bytesTotal: number;
+    /** Progress percentage (0-100) */
+    percentage: number;
+}
+/**
+ * Options for creating a TUS resumable upload
+ */
+export interface TusUploadOptions {
+    /** Chunk size in bytes (default: 6MB) */
+    chunkSize?: number;
+    /** Custom metadata to include */
+    metadata?: Record<string, string>;
+    /** Progress callback */
+    onProgress?: (progress: TusProgress) => void;
+    /** Error callback */
+    onError?: (error: Error) => void;
+    /** Success callback */
+    onSuccess?: (result: UploadResult) => void;
+}
+/**
+ * TUS upload controller
+ */
+export interface TusUpload {
+    /** Start the upload */
+    start(): Promise<UploadResult>;
+    /** Pause the upload */
+    pause(): void;
+    /** Resume a paused upload */
+    resume(): Promise<UploadResult>;
+    /** Abort the upload */
+    abort(): Promise<void>;
+}
+/**
+ * Options for getting a public URL
+ */
+export interface PublicUrlOptions {
+    /** Image transformation options */
+    transform?: ImageTransformOptions;
+    /** Force download with filename */
+    download?: string | boolean;
+}
+/**
+ * Normalize API bucket response to SDK format
+ */
+export declare function normalizeBucket(bucket: ApiBucket): Bucket;
+/**
+ * Normalize API object response to SDK format
+ */
+export declare function normalizeObject(obj: ApiObject): StorageObject;
+//# 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,39 @@
+// ============================================
+// Bucket Types
+// ============================================
+// ============================================
+// Normalizers
+// ============================================
+/**
+ * Normalize API bucket response to SDK format
+ */
+export function normalizeBucket(bucket) {
+    return {
+        id: bucket.id,
+        name: bucket.name,
+        owner: bucket.owner,
+        public: bucket.public,
+        fileSizeLimit: bucket.file_size_limit,
+        allowedMimeTypes: bucket.allowed_mime_types,
+        createdAt: bucket.created_at,
+        updatedAt: bucket.updated_at,
+    };
+}
+/**
+ * Normalize API object response to SDK format
+ */
+export function normalizeObject(obj) {
+    return {
+        id: obj.id,
+        name: obj.name,
+        bucketId: obj.bucket_id,
+        owner: obj.owner,
+        version: obj.version,
+        createdAt: obj.created_at,
+        updatedAt: obj.updated_at,
+        lastAccessedAt: obj.last_accessed_at,
+        metadata: obj.metadata,
+        userMetadata: obj.user_metadata,
+    };
+}
+//# 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":"AAAA,+CAA+C;AAC/C,eAAe;AACf,+CAA+C;AAwY/C,+CAA+C;AAC/C,cAAc;AACd,+CAA+C;AAE/C;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,aAAa,EAAE,MAAM,CAAC,eAAe;QACrC,gBAAgB,EAAE,MAAM,CAAC,kBAAkB;QAC3C,SAAS,EAAE,MAAM,CAAC,UAAU;QAC5B,SAAS,EAAE,MAAM,CAAC,UAAU;KAC7B,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAAc;IAC5C,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,QAAQ,EAAE,GAAG,CAAC,SAAS;QACvB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,SAAS,EAAE,GAAG,CAAC,UAAU;QACzB,cAAc,EAAE,GAAG,CAAC,gBAAgB;QACpC,QAAQ,EAAE,GAAG,CAAC,QAAiC;QAC/C,YAAY,EAAE,GAAG,CAAC,aAAa;KAChC,CAAC;AACJ,CAAC"}

package/dist/test/auth/helpers.d.ts

@@ -0,0 +1,33 @@
+import { isMailpitAvailable, skipWithoutMailpit } from "../helpers/mailpit.js";
+export declare const BASE_URL = "https://stack.test";
+export declare const TEST_EMAIL = "test@example.com";
+export declare const TEST_PASSWORD = "password123";
+export declare const INTEGRATION_BASE_URL: string;
+export declare const INTEGRATION_TENANT_ID: string;
+export { isMailpitAvailable, skipWithoutMailpit };
+/**
+ * Create a mock platform client for unit tests
+ */
+export declare function createMockClient(): import("../../client.js").StackClient<Record<string, unknown>>;
+/**
+ * Create a mock tenant client for unit tests
+ */
+export declare function createMockTenantClient(tenantId?: string): import("../../client.js").StackClient<Record<string, unknown>>;
+/**
+ * Create a real client for integration tests
+ */
+export declare function createIntegrationClient(): import("../../client.js").StackClient<Record<string, unknown>>;
+/**
+ * Generate unique email for integration tests
+ */
+export declare function uniqueEmail(prefix?: string): string;
+/**
+ * Skip condition for integration tests
+ */
+export declare const skipIntegration: boolean;
+/**
+ * Sign up a user and confirm their email via Mailpit OTP
+ * Requires MAILPIT_URL to be set
+ */
+export declare function signUpAndConfirm(client: ReturnType<typeof createIntegrationClient>, email: string, password?: string): Promise<import("../../index.js").Session>;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/test/auth/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../../src/test/auth/helpers.ts"],"names":[],"mappings":"AAKA,OAAO,EAGL,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,uBAAuB,CAAC;AAE/B,eAAO,MAAM,QAAQ,uBAAmB,CAAC;AACzC,eAAO,MAAM,UAAU,qBAAqB,CAAC;AAC7C,eAAO,MAAM,aAAa,gBAAgB,CAAC;AAG3C,eAAO,MAAM,oBAAoB,QACiB,CAAC;AACnD,eAAO,MAAM,qBAAqB,QAAmC,CAAC;AAGtE,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,CAAC;AAElD;;GAEG;AACH,wBAAgB,gBAAgB,mEAM/B;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,QAAQ,SAAgB,kEAO9D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,mEAMtC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,SAAS,UAE1C;AAED;;GAEG;AACH,eAAO,MAAM,eAAe,SAAyB,CAAC;AAEtD;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,EAClD,KAAK,EAAE,MAAM,EACb,QAAQ,GAAE,MAAsB,6CAyBjC"}

package/dist/test/auth/helpers.js

@@ -0,0 +1,80 @@
+/**
+ * Shared test helpers for auth tests
+ */
+import { createClient } from "../../index.js";
+import { DEFAULT_BASE_URL } from "../../mocks/index.js";
+import { waitForEmail, extractOtp, isMailpitAvailable, skipWithoutMailpit, } from "../helpers/mailpit.js";
+export const BASE_URL = DEFAULT_BASE_URL;
+export const TEST_EMAIL = "test@example.com";
+export const TEST_PASSWORD = "password123";
+// For integration tests - set via environment
+export const INTEGRATION_BASE_URL = process.env.STACK_URL ?? "http://localhost:7300";
+export const INTEGRATION_TENANT_ID = process.env.TENANT_ID ?? "alpha";
+// Re-export mailpit helpers
+export { isMailpitAvailable, skipWithoutMailpit };
+/**
+ * Create a mock platform client for unit tests
+ */
+export function createMockClient() {
+    return createClient({
+        baseUrl: BASE_URL,
+        tokenStore: "memory",
+        mock: true,
+    });
+}
+/**
+ * Create a mock tenant client for unit tests
+ */
+export function createMockTenantClient(tenantId = "test-tenant") {
+    return createClient({
+        baseUrl: BASE_URL,
+        tenantId,
+        tokenStore: "memory",
+        mock: true,
+    });
+}
+/**
+ * Create a real client for integration tests
+ */
+export function createIntegrationClient() {
+    return createClient({
+        baseUrl: INTEGRATION_BASE_URL,
+        tenantId: INTEGRATION_TENANT_ID,
+        tokenStore: "memory",
+    });
+}
+/**
+ * Generate unique email for integration tests
+ */
+export function uniqueEmail(prefix = "test") {
+    return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}@example.com`;
+}
+/**
+ * Skip condition for integration tests
+ */
+export const skipIntegration = !process.env.STACK_URL;
+/**
+ * Sign up a user and confirm their email via Mailpit OTP
+ * Requires MAILPIT_URL to be set
+ */
+export async function signUpAndConfirm(client, email, password = TEST_PASSWORD) {
+    if (!isMailpitAvailable()) {
+        throw new Error("Mailpit not available - cannot confirm email");
+    }
+    // Sign up (will send confirmation email)
+    await client.auth.signUp({ email, password });
+    // Wait for confirmation email
+    const confirmEmail = await waitForEmail(email, { subject: "Confirm" });
+    const otp = extractOtp(confirmEmail);
+    if (!otp) {
+        throw new Error("Could not extract OTP from confirmation email");
+    }
+    // Verify with OTP
+    const session = await client.auth.verification.verify({
+        email,
+        token: otp,
+        type: "signup",
+    });
+    return session;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/test/auth/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../../src/test/auth/helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EACL,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,CAAC,MAAM,QAAQ,GAAG,gBAAgB,CAAC;AACzC,MAAM,CAAC,MAAM,UAAU,GAAG,kBAAkB,CAAC;AAC7C,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC;AAE3C,8CAA8C;AAC9C,MAAM,CAAC,MAAM,oBAAoB,GAC/B,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,uBAAuB,CAAC;AACnD,MAAM,CAAC,MAAM,qBAAqB,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,OAAO,CAAC;AAEtE,4BAA4B;AAC5B,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,CAAC;AAElD;;GAEG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,YAAY,CAAC;QAClB,OAAO,EAAE,QAAQ;QACjB,UAAU,EAAE,QAAQ;QACpB,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,QAAQ,GAAG,aAAa;IAC7D,OAAO,YAAY,CAAC;QAClB,OAAO,EAAE,QAAQ;QACjB,QAAQ;QACR,UAAU,EAAE,QAAQ;QACpB,IAAI,EAAE,IAAI;KACX,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB;IACrC,OAAO,YAAY,CAAC;QAClB,OAAO,EAAE,oBAAoB;QAC7B,QAAQ,EAAE,qBAAqB;QAC/B,UAAU,EAAE,QAAQ;KACrB,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAM,GAAG,MAAM;IACzC,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,cAAc,CAAC;AACzF,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;AAEtD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,MAAkD,EAClD,KAAa,EACb,WAAmB,aAAa;IAEhC,IAAI,CAAC,kBAAkB,EAAE,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IAClE,CAAC;IAED,yCAAyC;IACzC,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE9C,8BAA8B;IAC9B,MAAM,YAAY,GAAG,MAAM,YAAY,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IACvE,MAAM,GAAG,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;IAErC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACnE,CAAC;IAED,kBAAkB;IAClB,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;QACpD,KAAK;QACL,KAAK,EAAE,GAAG;QACV,IAAI,EAAE,QAAQ;KACf,CAAC,CAAC;IAEH,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/test/helpers/jwt.d.ts

@@ -0,0 +1,61 @@
+/**
+ * JWT generation helpers for tests (ES256)
+ *
+ * Uses ES256 (ECDSA P-256) to match production GoTrue configuration.
+ */
+import * as jose from "jose";
+export type JwtRole = "anon" | "authenticated" | "service_role";
+/**
+ * Generate or retrieve the test ES256 keypair
+ */
+export declare function getTestKeyPair(): Promise<jose.GenerateKeyPairResult>;
+/**
+ * Get the test JWKS (for createLocalJWKS)
+ */
+export declare function getTestJWKS(): Promise<jose.JSONWebKeySet>;
+/**
+ * Reset test keys (for isolation between test suites if needed)
+ */
+export declare function resetTestKeys(): void;
+/**
+ * Generate an ES256 JWT token for testing
+ *
+ * @param role - The role (anon, authenticated, service_role)
+ * @param sub - Optional user ID for the sub claim
+ * @param options - Additional options (email, phone, aal)
+ * @returns Signed JWT token
+ */
+export declare function generateJwt(role: JwtRole, sub?: string, options?: {
+    email?: string;
+    phone?: string;
+    aal?: "aal1" | "aal2";
+}): Promise<string>;
+/**
+ * Generate an expired ES256 JWT for testing expiration handling
+ */
+export declare function generateExpiredJwt(role: JwtRole, sub?: string): Promise<string>;
+/**
+ * Generate a JWT with custom audience
+ */
+export declare function generateJwtWithAudience(role: JwtRole, sub: string, audience: string): Promise<string>;
+/**
+ * Generate a JWT missing the sub claim (for testing validation)
+ */
+export declare function generateJwtWithoutSub(role: JwtRole): Promise<string>;
+/**
+ * Generate an anon JWT
+ */
+export declare function generateAnonJwt(): Promise<string>;
+/**
+ * Generate a service_role JWT (bypasses RLS)
+ */
+export declare function generateServiceRoleJwt(): Promise<string>;
+/**
+ * Generate an authenticated JWT for a specific user
+ */
+export declare function generateAuthenticatedJwt(userId: string, options?: {
+    email?: string;
+    phone?: string;
+    aal?: "aal1" | "aal2";
+}): Promise<string>;
+//# sourceMappingURL=jwt.d.ts.map

package/dist/test/helpers/jwt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jwt.d.ts","sourceRoot":"","sources":["../../../src/test/helpers/jwt.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,MAAM,MAAM,OAAO,GAAG,MAAM,GAAG,eAAe,GAAG,cAAc,CAAC;AAShE;;GAEG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAM1E;AAED;;GAEG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,CAU/D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAGpC;AAED;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,OAAO,EACb,GAAG,CAAC,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAClE,OAAO,CAAC,MAAM,CAAC,CAoBjB;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,OAAO,EACb,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAiBjB;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,IAAI,EAAE,OAAO,EACb,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAWjB;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAS1E;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAEvD;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAE9D;AAED;;GAEG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAClE,OAAO,CAAC,MAAM,CAAC,CAEjB"}