@multitenantkit/sdk 0.1.2 → 0.1.3

package/dist/supabase.d.ts

@@ -1,56 +1,6 @@
 import { createUseCases } from '@multitenantkit/composition';
+import type { ToolkitOptions } from '@multitenantkit/domain-contracts';
 import type { Express, Router } from 'express';
-import type { ZodSchema } from 'zod';
-/**
- * Simplified custom fields configuration for Supabase users
- * Only requires the schema, everything else is pre-configured
- */
-export interface SupabaseUserCustomFieldsConfig<TCustomFields> {
-    /**
-     * Zod schema defining custom fields structure
-     */
-    customSchema: ZodSchema<TCustomFields>;
-}
-export interface SupabaseOrganizationCustomFieldsConfig<TCustomFields> {
-    /**
-     * Zod schema defining custom fields structure
-     */
-    customSchema: ZodSchema<TCustomFields>;
-}
-export interface SupabaseOrganizationMembershipCustomFieldsConfig<TCustomFields> {
-    /**
-     * Zod schema defining custom fields structure
-     */
-    customSchema: ZodSchema<TCustomFields>;
-}
-/**
- * Simplified toolkit options for Supabase
- * Pre-configures common Supabase defaults
- */
-export interface SupabaseToolkitOptions<TUserCustomFields = {}, TOrganizationCustomFields = {}, TOrganizationMembershipCustomFields = {}> {
-    /**
-     * Optional naming strategy (defaults to snake_case for Supabase/PostgreSQL)
-     */
-    namingStrategy?: 'camelCase' | 'snake_case' | 'kebab-case' | 'PascalCase';
-    /**
-     * Users configuration (optional, uses Supabase defaults)
-     */
-    users?: {
-        customFields?: SupabaseUserCustomFieldsConfig<TUserCustomFields>;
-    };
-    /**
-     * Organizations configuration (optional, uses Supabase defaults)
-     */
-    organizations?: {
-        customFields?: SupabaseOrganizationCustomFieldsConfig<TOrganizationCustomFields>;
-    };
-    /**
-     * Organization memberships configuration (optional, uses Supabase defaults)
-     */
-    organizationMemberships?: {
-        customFields?: SupabaseOrganizationMembershipCustomFieldsConfig<TOrganizationMembershipCustomFields>;
-    };
-}
 /**
  * Create a complete Express application with Supabase defaults
  *
@@ -60,11 +10,14 @@ export interface SupabaseToolkitOptions<TUserCustomFields = {}, TOrganizationCus
  * - Pre-configured Supabase defaults (auth.users, raw_user_meta_data, etc.)
  * - All MultiTenantKit routes and middleware
  *
+ * Accepts standard ToolkitOptions and applies Supabase-specific defaults.
+ * User-provided options take precedence over defaults.
+ *
  * @template TUserCustomFields - Custom fields schema for Users
  * @template TOrganizationCustomFields - Custom fields schema for Organizations
  * @template TOrganizationMembershipCustomFields - Custom fields schema for Organization Memberships
  *
- * @param options - Simplified Supabase toolkit options (only custom fields needed)
+ * @param options - ToolkitOptions with Supabase defaults applied automatically
  * @returns Express application ready to listen on a port
  *
  * @example
@@ -78,7 +31,7 @@ export interface SupabaseToolkitOptions<TUserCustomFields = {}, TOrganizationCus
  *
  * @example
  * ```typescript
- * // With custom fields
+ * // With custom fields and hooks
  * import { createSupabaseExpressApp } from '@multitenantkit/sdk';
  * import { z } from 'zod';
  *
@@ -87,25 +40,15 @@ export interface SupabaseToolkitOptions<TUserCustomFields = {}, TOrganizationCus
  *     customFields: {
  *       customSchema: z.object({
  *         firstName: z.string(),
- *         lastName: z.string(),
- *         phone: z.string().optional()
- *       })
- *     }
- *   },
- *   organizations: {
- *     customFields: {
- *       customSchema: z.object({
- *         organizationName: z.string(),
- *         industry: z.string().optional(),
- *         size: z.string().optional()
+ *         lastName: z.string()
  *       })
  *     }
  *   },
- *   organizationMemberships: {
- *     customFields: {
- *       customSchema: z.object({
- *         internalRole: z.string().optional()
- *       })
+ *   useCaseHooks: {
+ *     CreateUser: {
+ *       afterExecution: async ({ stepResults }) => {
+ *         await sendWelcomeEmail(stepResults.output.email);
+ *       }
  *     }
  *   }
  * });
@@ -113,18 +56,21 @@ export interface SupabaseToolkitOptions<TUserCustomFields = {}, TOrganizationCus
  * app.listen(3000);
  * ```
  */
-export declare function createSupabaseExpressApp<TUserCustomFields = {}, TOrganizationCustomFields = {}, TOrganizationMembershipCustomFields = {}>(options?: SupabaseToolkitOptions<TUserCustomFields, TOrganizationCustomFields, TOrganizationMembershipCustomFields>): Express;
+export declare function createSupabaseExpressApp<TUserCustomFields = {}, TOrganizationCustomFields = {}, TOrganizationMembershipCustomFields = {}>(options?: ToolkitOptions<TUserCustomFields, TOrganizationCustomFields, TOrganizationMembershipCustomFields>): Express;
 /**
  * Create an Express Router with Supabase defaults
  *
  * Use this when you want to integrate MultiTenantKit into an existing Express application.
  * The router can be mounted at any path in your app.
  *
+ * Accepts standard ToolkitOptions and applies Supabase-specific defaults.
+ * User-provided options take precedence over defaults.
+ *
  * @template TUserCustomFields - Custom fields schema for Users
  * @template TOrganizationCustomFields - Custom fields schema for Organizations
  * @template TOrganizationMembershipCustomFields - Custom fields schema for Organization Memberships
  *
- * @param options - Simplified Supabase toolkit options (only custom fields needed)
+ * @param options - ToolkitOptions with Supabase defaults applied automatically
  * @returns Express Router with all MultiTenantKit routes
  *
  * @example
@@ -163,18 +109,21 @@ export declare function createSupabaseExpressApp<TUserCustomFields = {}, TOrgani
  * });
  * ```
  */
-export declare function createSupabaseExpressRouter<TUserCustomFields = {}, TOrganizationCustomFields = {}, TOrganizationMembershipCustomFields = {}>(options?: SupabaseToolkitOptions<TUserCustomFields, TOrganizationCustomFields, TOrganizationMembershipCustomFields>): Router;
+export declare function createSupabaseExpressRouter<TUserCustomFields = {}, TOrganizationCustomFields = {}, TOrganizationMembershipCustomFields = {}>(options?: ToolkitOptions<TUserCustomFields, TOrganizationCustomFields, TOrganizationMembershipCustomFields>): Router;
 /**
  * Create use cases with Supabase defaults
  *
  * Use this when you want to use MultiTenantKit use cases directly without Express.
  * Useful for background jobs, CLI tools, or custom transport layers.
  *
+ * Accepts standard ToolkitOptions and applies Supabase-specific defaults.
+ * User-provided options take precedence over defaults.
+ *
  * @template TUserCustomFields - Custom fields schema for Users
  * @template TOrganizationCustomFields - Custom fields schema for Organizations
  * @template TOrganizationMembershipCustomFields - Custom fields schema for Organization Memberships
  *
- * @param options - Simplified Supabase toolkit options (only custom fields needed)
+ * @param options - ToolkitOptions with Supabase defaults applied automatically
  * @returns Configured use cases ready to execute
  *
  * @example
@@ -202,5 +151,5 @@ export declare function createSupabaseExpressRouter<TUserCustomFields = {}, TOrg
  * });
  * ```
  */
-export declare function createSupabaseUseCases<TUserCustomFields = {}, TOrganizationCustomFields = {}, TOrganizationMembershipCustomFields = {}>(options?: SupabaseToolkitOptions<TUserCustomFields, TOrganizationCustomFields, TOrganizationMembershipCustomFields>): ReturnType<typeof createUseCases<TUserCustomFields, TOrganizationCustomFields, TOrganizationMembershipCustomFields>>;
+export declare function createSupabaseUseCases<TUserCustomFields = {}, TOrganizationCustomFields = {}, TOrganizationMembershipCustomFields = {}>(options?: ToolkitOptions<TUserCustomFields, TOrganizationCustomFields, TOrganizationMembershipCustomFields>): ReturnType<typeof createUseCases<TUserCustomFields, TOrganizationCustomFields, TOrganizationMembershipCustomFields>>;
 //# sourceMappingURL=supabase.d.ts.map

package/dist/supabase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../src/supabase.ts"],"names":[],"mappings":"AAOA,OAAO,EAGH,cAAc,EACjB,MAAM,6BAA6B,CAAC;AAOrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAErC;;;GAGG;AACH,MAAM,WAAW,8BAA8B,CAAC,aAAa;IACzD;;OAEG;IACH,YAAY,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,sCAAsC,CAAC,aAAa;IACjE;;OAEG;IACH,YAAY,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;CAC1C;AAED,MAAM,WAAW,gDAAgD,CAAC,aAAa;IAC3E;;OAEG;IACH,YAAY,EAAE,SAAS,CAAC,aAAa,CAAC,CAAC;CAC1C;AAED;;;GAGG;AACH,MAAM,WAAW,sBAAsB,CAEnC,iBAAiB,GAAG,EAAE,EAEtB,yBAAyB,GAAG,EAAE,EAE9B,mCAAmC,GAAG,EAAE;IAExC;;OAEG;IACH,cAAc,CAAC,EAAE,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,YAAY,CAAC;IAE1E;;OAEG;IACH,KAAK,CAAC,EAAE;QACJ,YAAY,CAAC,EAAE,8BAA8B,CAAC,iBAAiB,CAAC,CAAC;KACpE,CAAC;IAEF;;OAEG;IACH,aAAa,CAAC,EAAE;QACZ,YAAY,CAAC,EAAE,sCAAsC,CAAC,yBAAyB,CAAC,CAAC;KACpF,CAAC;IAEF;;OAEG;IACH,uBAAuB,CAAC,EAAE;QACtB,YAAY,CAAC,EAAE,gDAAgD,CAAC,mCAAmC,CAAC,CAAC;KACxG,CAAC;CACL;AAmID;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6DG;AACH,wBAAgB,wBAAwB,CAEpC,iBAAiB,GAAG,EAAE,EAEtB,yBAAyB,GAAG,EAAE,EAE9B,mCAAmC,GAAG,EAAE,EAExC,OAAO,CAAC,EAAE,sBAAsB,CAC5B,iBAAiB,EACjB,yBAAyB,EACzB,mCAAmC,CACtC,GACF,OAAO,CAwCT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,2BAA2B,CAEvC,iBAAiB,GAAG,EAAE,EAEtB,yBAAyB,GAAG,EAAE,EAE9B,mCAAmC,GAAG,EAAE,EAExC,OAAO,CAAC,EAAE,sBAAsB,CAC5B,iBAAiB,EACjB,yBAAyB,EACzB,mCAAmC,CACtC,GACF,MAAM,CAwCR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,sBAAsB,CAElC,iBAAiB,GAAG,EAAE,EAEtB,yBAAyB,GAAG,EAAE,EAE9B,mCAAmC,GAAG,EAAE,EAExC,OAAO,CAAC,EAAE,sBAAsB,CAC5B,iBAAiB,EACjB,yBAAyB,EACzB,mCAAmC,CACtC,GACF,UAAU,CACT,OAAO,cAAc,CACjB,iBAAiB,EACjB,yBAAyB,EACzB,mCAAmC,CACtC,CACJ,CA2BA"}
+{"version":3,"file":"supabase.d.ts","sourceRoot":"","sources":["../src/supabase.ts"],"names":[],"mappings":"AAOA,OAAO,EAGH,cAAc,EACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,cAAc,EAA0B,MAAM,kCAAkC,CAAC;AAC/F,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAqH/C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,wBAAgB,wBAAwB,CAEpC,iBAAiB,GAAG,EAAE,EAEtB,yBAAyB,GAAG,EAAE,EAE9B,mCAAmC,GAAG,EAAE,EAExC,OAAO,CAAC,EAAE,cAAc,CACpB,iBAAiB,EACjB,yBAAyB,EACzB,mCAAmC,CACtC,GACF,OAAO,CAwCT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAgB,2BAA2B,CAEvC,iBAAiB,GAAG,EAAE,EAEtB,yBAAyB,GAAG,EAAE,EAE9B,mCAAmC,GAAG,EAAE,EAExC,OAAO,CAAC,EAAE,cAAc,CACpB,iBAAiB,EACjB,yBAAyB,EACzB,mCAAmC,CACtC,GACF,MAAM,CAwCR;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AACH,wBAAgB,sBAAsB,CAElC,iBAAiB,GAAG,EAAE,EAEtB,yBAAyB,GAAG,EAAE,EAE9B,mCAAmC,GAAG,EAAE,EAExC,OAAO,CAAC,EAAE,cAAc,CACpB,iBAAiB,EACjB,yBAAyB,EACzB,mCAAmC,CACtC,GACF,UAAU,CACT,OAAO,cAAc,CACjB,iBAAiB,EACjB,yBAAyB,EACzB,mCAAmC,CACtC,CACJ,CA2BA"}

package/dist/supabase.js

@@ -6,109 +6,99 @@ import { buildExpressApp, buildExpressRouter } from '@multitenantkit/adapter-tra
 import { buildHandlers } from '@multitenantkit/api-handlers';
 import { createPostgresAdapters, createSystemAdapters, createUseCases } from '@multitenantkit/composition';
 /**
- * Converts simplified Supabase options to full ToolkitOptions
- * Applies Supabase-specific defaults
+ * Merges user-provided ToolkitOptions with Supabase-specific defaults.
+ *
+ * Supabase defaults applied:
+ * - namingStrategy: 'snake_case'
+ * - users.database: { schema: 'auth', table: 'users' }
+ * - users.customFields.columnMapping: { externalId: 'id', username: 'email' }
+ * - users.customFields.customMapper: maps to/from raw_user_meta_data
+ * - organizations.database: { schema: 'public', table: 'organizations' }
+ * - organizationMemberships.database: { schema: 'public', table: 'organization_memberships' }
+ *
+ * User-provided options take precedence over defaults.
  */
-function buildSupabaseToolkitOptions(options) {
-    const toolkitOptions = {
-        namingStrategy: options?.namingStrategy ?? 'snake_case'
-    };
-    // Configure users with Supabase defaults
-    if (options?.users?.customFields) {
-        const userCustomFieldsConfig = {
-            customSchema: options.users.customFields.customSchema,
-            // Map to Supabase's raw_user_meta_data column
-            customMapper: {
-                toDb: (fields) => ({
-                    raw_user_meta_data: {
-                        sub: fields.id,
-                        email: fields.email,
-                        ...fields,
-                        email_verified: true,
-                        phone_verified: false
-                    }
-                }),
-                toDomain: (dbRow) => {
-                    const metadata = dbRow.raw_user_meta_data || {};
-                    // biome-ignore lint/correctness/noUnusedVariables: these fields are intentionally extracted to exclude them
-                    const { sub, email_verified, phone_verified, ...customFields } = metadata;
-                    return customFields;
-                }
-            },
-            // Map base fields to Supabase columns
-            columnMapping: {
-                externalId: 'id',
-                username: 'email'
-            }
-        };
-        toolkitOptions.users = {
-            customFields: userCustomFieldsConfig,
-            database: {
-                schema: 'auth',
-                table: 'users'
-            }
-        };
-    }
-    else {
-        // No custom fields, but still configure Supabase defaults for users
-        toolkitOptions.users = {
-            customFields: {
-                columnMapping: {
-                    externalId: 'id',
-                    username: 'email'
-                }
-            },
-            database: {
-                schema: 'auth',
-                table: 'users'
-            }
-        };
-    }
-    // Configure organizations with Supabase defaults
-    if (options?.organizations?.customFields) {
-        const orgCustomFieldsConfig = {
-            customSchema: options.organizations.customFields.customSchema
-        };
-        toolkitOptions.organizations = {
-            customFields: orgCustomFieldsConfig,
-            database: {
-                schema: 'public',
-                table: 'organizations'
-            }
-        };
-    }
-    else {
-        // No custom fields, but still configure database defaults
-        toolkitOptions.organizations = {
-            database: {
-                schema: 'public',
-                table: 'organizations'
+function applySupabaseDefaults(options) {
+    // Default Supabase customMapper for users (maps to raw_user_meta_data)
+    const supabaseUserMapper = {
+        toDb: (fields) => ({
+            raw_user_meta_data: {
+                sub: fields.id,
+                email: fields.email,
+                ...fields,
+                email_verified: true,
+                phone_verified: false
             }
-        };
-    }
-    // Configure organization memberships with Supabase defaults
-    if (options?.organizationMemberships?.customFields) {
-        const membershipCustomFieldsConfig = {
-            customSchema: options.organizationMemberships.customFields.customSchema
-        };
-        toolkitOptions.organizationMemberships = {
-            customFields: membershipCustomFieldsConfig,
-            database: {
-                schema: 'public',
-                table: 'organization_memberships'
-            }
-        };
-    }
-    else {
-        // No custom fields, but still configure database defaults
-        toolkitOptions.organizationMemberships = {
-            database: {
-                schema: 'public',
-                table: 'organization_memberships'
-            }
-        };
-    }
-    return toolkitOptions;
+        }),
+        toDomain: (dbRow) => {
+            const metadata = dbRow.raw_user_meta_data || {};
+            // biome-ignore lint/correctness/noUnusedVariables: these fields are intentionally extracted to exclude them
+            const { sub, email_verified, phone_verified, ...customFields } = metadata;
+            return customFields;
+        }
+    };
+    // Default Supabase columnMapping for users
+    const supabaseUserColumnMapping = {
+        externalId: 'id',
+        username: 'email'
+    };
+    // Build users config with Supabase defaults
+    const usersConfig = {
+        customFields: {
+            // User's customSchema if provided
+            ...(options?.users?.customFields?.customSchema && {
+                customSchema: options.users.customFields.customSchema
+            }),
+            // Use user's columnMapping or Supabase default
+            columnMapping: options?.users?.customFields?.columnMapping ?? supabaseUserColumnMapping,
+            // Use user's customMapper or Supabase default (only if customSchema is provided)
+            ...(options?.users?.customFields?.customSchema && {
+                customMapper: options?.users?.customFields?.customMapper ?? supabaseUserMapper
+            })
+        },
+        database: {
+            schema: options?.users?.database?.schema ?? 'auth',
+            table: options?.users?.database?.table ?? 'users',
+            ...(options?.users?.database?.namingStrategy && {
+                namingStrategy: options.users.database.namingStrategy
+            })
+        }
+    };
+    // Build organizations config with Supabase defaults
+    const organizationsConfig = {
+        ...(options?.organizations?.customFields && {
+            customFields: options.organizations.customFields
+        }),
+        database: {
+            schema: options?.organizations?.database?.schema ?? 'public',
+            table: options?.organizations?.database?.table ?? 'organizations',
+            ...(options?.organizations?.database?.namingStrategy && {
+                namingStrategy: options.organizations.database.namingStrategy
+            })
+        }
+    };
+    // Build organization memberships config with Supabase defaults
+    const organizationMembershipsConfig = {
+        ...(options?.organizationMemberships?.customFields && {
+            customFields: options.organizationMemberships.customFields
+        }),
+        database: {
+            schema: options?.organizationMemberships?.database?.schema ?? 'public',
+            table: options?.organizationMemberships?.database?.table ?? 'organization_memberships',
+            ...(options?.organizationMemberships?.database?.namingStrategy && {
+                namingStrategy: options.organizationMemberships.database.namingStrategy
+            })
+        }
+    };
+    return {
+        namingStrategy: options?.namingStrategy ?? 'snake_case',
+        users: usersConfig,
+        organizations: organizationsConfig,
+        organizationMemberships: organizationMembershipsConfig,
+        // Pass through other options as-is
+        ...(options?.useCaseHooks && { useCaseHooks: options.useCaseHooks }),
+        ...(options?.responseTransformers && { responseTransformers: options.responseTransformers })
+    };
 }
 /**
  * Create a complete Express application with Supabase defaults
@@ -119,11 +109,14 @@ function buildSupabaseToolkitOptions(options) {
  * - Pre-configured Supabase defaults (auth.users, raw_user_meta_data, etc.)
  * - All MultiTenantKit routes and middleware
  *
+ * Accepts standard ToolkitOptions and applies Supabase-specific defaults.
+ * User-provided options take precedence over defaults.
+ *
  * @template TUserCustomFields - Custom fields schema for Users
  * @template TOrganizationCustomFields - Custom fields schema for Organizations
  * @template TOrganizationMembershipCustomFields - Custom fields schema for Organization Memberships
  *
- * @param options - Simplified Supabase toolkit options (only custom fields needed)
+ * @param options - ToolkitOptions with Supabase defaults applied automatically
  * @returns Express application ready to listen on a port
  *
  * @example
@@ -137,7 +130,7 @@ function buildSupabaseToolkitOptions(options) {
  *
  * @example
  * ```typescript
- * // With custom fields
+ * // With custom fields and hooks
  * import { createSupabaseExpressApp } from '@multitenantkit/sdk';
  * import { z } from 'zod';
  *
@@ -146,25 +139,15 @@ function buildSupabaseToolkitOptions(options) {
  *     customFields: {
  *       customSchema: z.object({
  *         firstName: z.string(),
- *         lastName: z.string(),
- *         phone: z.string().optional()
- *       })
- *     }
- *   },
- *   organizations: {
- *     customFields: {
- *       customSchema: z.object({
- *         organizationName: z.string(),
- *         industry: z.string().optional(),
- *         size: z.string().optional()
+ *         lastName: z.string()
  *       })
  *     }
  *   },
- *   organizationMemberships: {
- *     customFields: {
- *       customSchema: z.object({
- *         internalRole: z.string().optional()
- *       })
+ *   useCaseHooks: {
+ *     CreateUser: {
+ *       afterExecution: async ({ stepResults }) => {
+ *         await sendWelcomeEmail(stepResults.output.email);
+ *       }
  *     }
  *   }
  * });
@@ -173,7 +156,7 @@ function buildSupabaseToolkitOptions(options) {
  * ```
  */
 export function createSupabaseExpressApp(options) {
-    const toolkitOptions = buildSupabaseToolkitOptions(options);
+    const toolkitOptions = applySupabaseDefaults(options);
     // 1. Create persistence adapters (PostgreSQL)
     const persistenceAdapters = createPostgresAdapters(undefined, toolkitOptions);
     // 2. Create system and metrics adapters
@@ -197,11 +180,14 @@ export function createSupabaseExpressApp(options) {
  * Use this when you want to integrate MultiTenantKit into an existing Express application.
  * The router can be mounted at any path in your app.
  *
+ * Accepts standard ToolkitOptions and applies Supabase-specific defaults.
+ * User-provided options take precedence over defaults.
+ *
  * @template TUserCustomFields - Custom fields schema for Users
  * @template TOrganizationCustomFields - Custom fields schema for Organizations
  * @template TOrganizationMembershipCustomFields - Custom fields schema for Organization Memberships
  *
- * @param options - Simplified Supabase toolkit options (only custom fields needed)
+ * @param options - ToolkitOptions with Supabase defaults applied automatically
  * @returns Express Router with all MultiTenantKit routes
  *
  * @example
@@ -241,7 +227,7 @@ export function createSupabaseExpressApp(options) {
  * ```
  */
 export function createSupabaseExpressRouter(options) {
-    const toolkitOptions = buildSupabaseToolkitOptions(options);
+    const toolkitOptions = applySupabaseDefaults(options);
     // 1. Create persistence adapters (PostgreSQL)
     const persistenceAdapters = createPostgresAdapters(undefined, toolkitOptions);
     // 2. Create system and metrics adapters
@@ -265,11 +251,14 @@ export function createSupabaseExpressRouter(options) {
  * Use this when you want to use MultiTenantKit use cases directly without Express.
  * Useful for background jobs, CLI tools, or custom transport layers.
  *
+ * Accepts standard ToolkitOptions and applies Supabase-specific defaults.
+ * User-provided options take precedence over defaults.
+ *
  * @template TUserCustomFields - Custom fields schema for Users
  * @template TOrganizationCustomFields - Custom fields schema for Organizations
  * @template TOrganizationMembershipCustomFields - Custom fields schema for Organization Memberships
  *
- * @param options - Simplified Supabase toolkit options (only custom fields needed)
+ * @param options - ToolkitOptions with Supabase defaults applied automatically
  * @returns Configured use cases ready to execute
  *
  * @example
@@ -298,7 +287,7 @@ export function createSupabaseExpressRouter(options) {
  * ```
  */
 export function createSupabaseUseCases(options) {
-    const toolkitOptions = buildSupabaseToolkitOptions(options);
+    const toolkitOptions = applySupabaseDefaults(options);
     // 1. Create persistence adapters (PostgreSQL)
     const persistenceAdapters = createPostgresAdapters(undefined, toolkitOptions);
     // 2. Create system and metrics adapters

package/dist/supabase.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@multitenantkit/sdk",
-    "version": "0.1.2",
+    "version": "0.1.3",
     "description": "Complete SDK for building multi-tenant SaaS applications - includes all adapters and options",
     "keywords": [
         "multitenantkit",