@multitenantkit/domain 0.1.1

package/dist/shared/use-case/BaseUseCase.js

@@ -0,0 +1,366 @@
+import { randomUUID } from 'node:crypto';
+import { AbortedError, InfrastructureError, NotFoundError, ValidationError } from '@multitenantkit/domain-contracts';
+import { Result } from '../result/Result';
+/**
+ * Base class for all use cases following a consistent execution pipeline.
+ *
+ * Provides automatic:
+ * - Input validation with Zod schemas
+ * - Output parsing/transformation
+ * - Error handling and wrapping
+ * - Hook lifecycle management with abort support
+ * - Consistent structure across all use cases
+ *
+ * @template TInput - Input type for the use case
+ * @template TOutput - Output type returned by the use case
+ * @template TError - Domain error types that can be returned
+ * @template TCustomFields - Custom fields extension for entities
+ * @template TOrganizationCustomFields - Custom fields for organizations (toolkit options compatibility)
+ * @template TOrganizationMembershipCustomFields - Custom fields for organization memberships (toolkit options compatibility)
+ */
+export class BaseUseCase {
+    adapters;
+    toolkitOptions;
+    inputSchema;
+    outputSchema;
+    errorMessage;
+    /**
+     * Abort state tracking
+     * These track whether a hook has requested abort and the reason
+     */
+    abortRequested = false;
+    abortReason = '';
+    /**
+     * Shared state object for hooks
+     * Reset at the start of each execution
+     */
+    sharedState = {};
+    /**
+     * Step results object for hooks
+     * Stores results from each pipeline step
+     */
+    stepResults = {};
+    /**
+     * Execution ID for tracking
+     * Generated at the start of each execution
+     */
+    executionId = '';
+    /**
+     * Use case name in format "entity-useCaseName"
+     * Example: "user-updateUser", "organization-createOrganization"
+     * This helps prevent name collisions between different entities
+     */
+    useCaseName;
+    constructor(useCaseName, adapters, toolkitOptions, inputSchema, outputSchema, errorMessage) {
+        this.adapters = adapters;
+        this.toolkitOptions = toolkitOptions;
+        this.inputSchema = inputSchema;
+        this.outputSchema = outputSchema;
+        this.errorMessage = errorMessage;
+        this.useCaseName = useCaseName;
+    }
+    /**
+     * Initialize execution state for a new execution
+     * Resets abort state, shared state, step results, and generates execution ID
+     */
+    initializeExecutionState() {
+        this.abortRequested = false;
+        this.abortReason = '';
+        this.sharedState = {};
+        this.stepResults = {};
+        this.executionId = randomUUID();
+    }
+    /**
+     * Create abort function for hook context
+     * When called, sets abort state which will be checked after each hook
+     *
+     * @returns Abort function that hooks can call
+     */
+    createAbortFunction() {
+        return (reason) => {
+            this.abortRequested = true;
+            this.abortReason = reason;
+        };
+    }
+    /**
+     * Check if abort was requested
+     * Should be called after each hook execution
+     *
+     * @returns true if abort was requested
+     */
+    checkAborted() {
+        return this.abortRequested;
+    }
+    /**
+     * Build HookContext object for passing to hooks
+     * Provides immutable access to input/stepResults and mutable shared state
+     *
+     * @param input - Original input to the use case
+     * @param context - Operation context
+     * @returns HookContext object
+     */
+    buildHookContext(input, context) {
+        return {
+            executionId: this.executionId,
+            useCaseName: this.useCaseName,
+            input: input, // Readonly via type
+            stepResults: this.stepResults, // Readonly via type
+            shared: this.sharedState,
+            adapters: this.adapters,
+            context: context,
+            abort: this.createAbortFunction()
+        };
+    }
+    /**
+     * Get configured hooks for this use case from ToolkitOptions
+     *
+     * @returns UseCaseHooks if configured, undefined otherwise
+     */
+    getHooksConfig() {
+        if (!this.toolkitOptions?.useCaseHooks) {
+            return undefined;
+        }
+        const useCaseName = this.constructor.name;
+        return this.toolkitOptions.useCaseHooks[useCaseName];
+    }
+    /**
+     * Execute a hook safely with error handling and metrics logging
+     * If hook throws an error, it propagates (hooks can abort execution)
+     *
+     * @param hookFn - Hook function to execute
+     * @param ctx - HookContext to pass to the hook
+     * @param hookName - Name of the hook for logging purposes
+     */
+    async executeHook(hookFn, ctx, hookName) {
+        // 🔥 Fire-and-forget: Log hook execution (without await)
+        this.logMetrics(hookName, ctx);
+        if (!hookFn) {
+            return;
+        }
+        await hookFn(ctx);
+    }
+    /**
+     * Log hook execution metrics (fire-and-forget)
+     * Errors are silently caught to not affect execution flow
+     *
+     * @param hookName - Name of the hook being executed
+     * @param ctx - Hook context (will be filtered for PII)
+     */
+    logMetrics(hookName, ctx) {
+        try {
+            // Fire-and-forget (no await)
+            this.adapters.observability
+                ?.logHookExecution({
+                requestId: ctx.context.requestId || 'unknown',
+                useCaseName: this.useCaseName,
+                hookName,
+                executionId: ctx.executionId,
+                timestamp: new Date(),
+                params: ctx
+            })
+                .catch(() => {
+                // Silent fail - metrics should never break execution
+            });
+        }
+        catch {
+            // Silent fail - if extracting data fails, don't break execution
+        }
+    }
+    /**
+     * Get user from external ID (auth provider ID)
+     *
+     * This helper maps the external auth provider ID to the internal User entity.
+     * It's used by use cases that operate on the authenticated user.
+     *
+     * @param externalId - Auth provider user ID (from Principal.authProviderId)
+     * @returns User entity with internal ID
+     * @throws NotFoundError if user doesn't exist
+     *
+     * @example
+     * ```typescript
+     * // In a use case
+     * const user = await this.getUserFromExternalId(context.principal.authProviderId);
+     * ```
+     */
+    async getUserFromExternalId(externalId) {
+        if (!this.adapters.persistence.userRepository) {
+            return Result.fail(new InfrastructureError('UserRepository is required for getUserFromExternalId'));
+        }
+        const user = await this.adapters.persistence.userRepository.findByExternalId(externalId);
+        if (!user) {
+            return Result.fail(new NotFoundError('User', externalId, {
+                message: 'User not found with the provided external ID from auth provider. Please ensure the user is registered in the system.'
+            }));
+        }
+        return Result.ok(user);
+    }
+    /**
+     * Main execution method - defines the pipeline with hook integration
+     *
+     * Pipeline stages:
+     * 1. Initialize execution state
+     * 2. onStart hook
+     * 3. Validate input with schema
+     * 4. afterValidation hook
+     * 5. Authorize (optional)
+     * 6. beforeExecution hook (renamed from afterAuthorization)
+     * 7. Execute business logic
+     * 8. afterExecution hook
+     * 9. Parse output with schema
+     * 10. onError hook (if error occurs)
+     * 11. onAbort hook (if abort requested)
+     * 12. onFinally hook (always executes)
+     */
+    async execute(input, context) {
+        // Initialize execution state
+        this.initializeExecutionState();
+        const hooks = this.getHooksConfig();
+        let result = await this.withErrorHandling(async () => {
+            // Build hook context (will be updated as execution progresses)
+            const hookCtx = this.buildHookContext(input, context);
+            // HOOK 1: onStart - before validation
+            await this.executeHook(hooks?.onStart, hookCtx, 'onStart');
+            if (this.checkAborted()) {
+                return Result.fail(new AbortedError(this.abortReason));
+            }
+            // 1. Validate input
+            const validatedInput = await this.validateInput(input);
+            if (validatedInput.isFailure) {
+                return validatedInput;
+            }
+            // Store validated input in step results
+            this.stepResults.validatedInput = validatedInput.getValue();
+            // HOOK 2: afterValidation - after successful validation
+            await this.executeHook(hooks?.afterValidation, hookCtx, 'afterValidation');
+            if (this.checkAborted()) {
+                return Result.fail(new AbortedError(this.abortReason));
+            }
+            // 2. Authorize (optional)
+            const authResult = await this.authorize(validatedInput.getValue(), context);
+            if (authResult.isFailure) {
+                return authResult;
+            }
+            // Store authorization result in step results
+            this.stepResults.authorized = true;
+            // HOOK 3: beforeExecution - after successful authorization, before business logic
+            await this.executeHook(hooks?.beforeExecution, hookCtx, 'beforeExecution');
+            if (this.checkAborted()) {
+                return Result.fail(new AbortedError(this.abortReason));
+            }
+            // 3. Execute business logic
+            const businessResult = await this.executeBusinessLogic(validatedInput.getValue(), context);
+            if (businessResult.isFailure) {
+                return businessResult;
+            }
+            // Store business output in step results
+            this.stepResults.output = businessResult.getValue();
+            // HOOK 4: afterExecution - after successful business logic
+            await this.executeHook(hooks?.afterExecution, hookCtx, 'afterExecution');
+            if (this.checkAborted()) {
+                return Result.fail(new AbortedError(this.abortReason));
+            }
+            // 4. Parse and return output
+            return this.parseOutput(businessResult.getValue());
+        });
+        // If result is AbortedError, execute onAbort hook
+        if (result.isFailure && result.getError() instanceof AbortedError) {
+            try {
+                const hookCtx = this.buildHookContext(input, context);
+                const onAbortHook = hooks?.onAbort;
+                if (onAbortHook) {
+                    this.logMetrics('onAbort', hookCtx);
+                    await onAbortHook({ ...hookCtx, reason: this.abortReason });
+                }
+            }
+            catch (abortError) {
+                // onAbort errors are logged but don't affect the abort result
+                console.error(`Error in onAbort hook for ${this.useCaseName}:`, abortError);
+            }
+        }
+        // If result is failure (but not abort), execute onError hook
+        else if (result.isFailure) {
+            try {
+                const hookCtx = this.buildHookContext(input, context);
+                const onErrorHook = hooks?.onError;
+                if (onErrorHook) {
+                    // HOOK 5: onError - after failure
+                    this.logMetrics('onError', hookCtx);
+                    await onErrorHook({ ...hookCtx, error: result.getError() });
+                }
+            }
+            catch (error) {
+                // If onError hook throws, create new error result
+                result = Result.fail(new ValidationError(this.errorMessage, undefined, {
+                    originalError: result.getError(),
+                    error
+                }));
+            }
+        }
+        // HOOK 6: onFinally - always executes, errors are caught and logged
+        try {
+            const hookCtx = this.buildHookContext(input, context);
+            const onFinallyHook = hooks?.onFinally;
+            if (onFinallyHook) {
+                this.logMetrics('onFinally', hookCtx);
+                await onFinallyHook({ ...hookCtx, result });
+            }
+        }
+        catch (finallyError) {
+            // onFinally errors don't affect the result, just log them
+            console.error(`Error in onFinally hook for ${this.useCaseName}:`, finallyError);
+        }
+        return result;
+    }
+    /**
+     * Validates input using the provided Zod schema
+     */
+    async validateInput(input) {
+        const validationResult = this.inputSchema.safeParse(input);
+        if (!validationResult.success) {
+            const firstError = validationResult.error.errors[0];
+            return Result.fail(new ValidationError(firstError.message, firstError.path.join('.')));
+        }
+        return Result.ok(validationResult.data);
+    }
+    /**
+     * Authorization hook - override for permission checks
+     * Default: no authorization
+     */
+    async authorize(_input, _context) {
+        return Result.ok(undefined);
+    }
+    /**
+     * Parses output using the provided Zod schema
+     */
+    parseOutput(data) {
+        try {
+            // Handle void/undefined case - no need to spread
+            const valueToParse = data === undefined
+                ? undefined
+                : Array.isArray(data)
+                    ? data
+                    : { ...data };
+            const parsed = this.outputSchema.parse(valueToParse);
+            return Result.ok(parsed);
+        }
+        catch (error) {
+            return Result.fail(new ValidationError('Failed to parse output', undefined, {
+                originalError: error
+            }));
+        }
+    }
+    /**
+     * Wraps execution in try-catch for consistent error handling
+     */
+    async withErrorHandling(operation) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            return Result.fail(new ValidationError(this.errorMessage, undefined, {
+                originalError: error
+            }));
+        }
+    }
+}
+//# sourceMappingURL=BaseUseCase.js.map

package/dist/shared/use-case/BaseUseCase.js.map

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

package/dist/shared/use-case/UseCaseHelpers.d.ts

@@ -0,0 +1,43 @@
+import type { OperationContext } from '@multitenantkit/domain-contracts';
+import { NotFoundError } from '@multitenantkit/domain-contracts';
+import { Result } from '../result/Result';
+/**
+ * Helper functions for common use case patterns
+ *
+ * Philosophy: Keep it minimal. Only extract truly repetitive patterns.
+ * If a helper reduces readability, don't use it.
+ */
+export declare class UseCaseHelpers {
+    /**
+     * Find entity by ID or return NotFoundError
+     *
+     * Common pattern across many use cases that retrieve entities by ID
+     *
+     * @example
+     * const userResult = await UseCaseHelpers.findByIdOrFail(
+     *     this.adapters.persistence.userRepository,
+     *     input.userId,
+     *     "User"
+     * );
+     * if (userResult.isFailure) return userResult;
+     * const user = userResult.getValue();
+     */
+    static findByIdOrFail<T>(repository: {
+        findById: (id: string) => Promise<T | null>;
+    }, id: string, entityName: string): Promise<Result<T, NotFoundError>>;
+    /**
+     * Enrich audit context with specific action and metadata
+     *
+     * Ensures consistent audit context across all use cases
+     *
+     * @example
+     * const auditContext = UseCaseHelpers.enrichAuditContext(
+     *     context,
+     *     "CREATE_USER",
+     *     undefined,
+     *     { source: "admin-panel" }
+     * );
+     */
+    static enrichAuditContext(context: OperationContext, action: string, organizationId?: string, metadata?: Record<string, any>): OperationContext;
+}
+//# sourceMappingURL=UseCaseHelpers.d.ts.map

package/dist/shared/use-case/UseCaseHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UseCaseHelpers.d.ts","sourceRoot":"","sources":["../../../src/shared/use-case/UseCaseHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C;;;;;GAKG;AAGH,qBAAa,cAAc;IACvB;;;;;;;;;;;;;OAaG;WACU,cAAc,CAAC,CAAC,EACzB,UAAU,EAAE;QAAE,QAAQ,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAA;KAAE,EAC3D,EAAE,EAAE,MAAM,EACV,UAAU,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC;IAYpC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,kBAAkB,CACrB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,MAAM,EACd,cAAc,CAAC,EAAE,MAAM,EACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC/B,gBAAgB;CAQtB"}

package/dist/shared/use-case/UseCaseHelpers.js

@@ -0,0 +1,56 @@
+import { NotFoundError } from '@multitenantkit/domain-contracts';
+import { Result } from '../result/Result';
+/**
+ * Helper functions for common use case patterns
+ *
+ * Philosophy: Keep it minimal. Only extract truly repetitive patterns.
+ * If a helper reduces readability, don't use it.
+ */
+// biome-ignore lint/complexity/noStaticOnlyClass: ignore
+export class UseCaseHelpers {
+    /**
+     * Find entity by ID or return NotFoundError
+     *
+     * Common pattern across many use cases that retrieve entities by ID
+     *
+     * @example
+     * const userResult = await UseCaseHelpers.findByIdOrFail(
+     *     this.adapters.persistence.userRepository,
+     *     input.userId,
+     *     "User"
+     * );
+     * if (userResult.isFailure) return userResult;
+     * const user = userResult.getValue();
+     */
+    static async findByIdOrFail(repository, id, entityName) {
+        const entity = await repository.findById(id.trim());
+        if (!entity) {
+            return Result.fail(new NotFoundError(entityName, id, {
+                reason: `${entityName} not found`
+            }));
+        }
+        return Result.ok(entity);
+    }
+    /**
+     * Enrich audit context with specific action and metadata
+     *
+     * Ensures consistent audit context across all use cases
+     *
+     * @example
+     * const auditContext = UseCaseHelpers.enrichAuditContext(
+     *     context,
+     *     "CREATE_USER",
+     *     undefined,
+     *     { source: "admin-panel" }
+     * );
+     */
+    static enrichAuditContext(context, action, organizationId, metadata) {
+        return {
+            ...context,
+            auditAction: action,
+            organizationId: organizationId ?? context.organizationId,
+            metadata: { ...context.metadata, ...metadata }
+        };
+    }
+}
+//# sourceMappingURL=UseCaseHelpers.js.map

package/dist/shared/use-case/UseCaseHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UseCaseHelpers.js","sourceRoot":"","sources":["../../../src/shared/use-case/UseCaseHelpers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C;;;;;GAKG;AAEH,yDAAyD;AACzD,MAAM,OAAO,cAAc;IACvB;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,KAAK,CAAC,cAAc,CACvB,UAA2D,EAC3D,EAAU,EACV,UAAkB;QAElB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,EAAE,CAAC;YACV,OAAO,MAAM,CAAC,IAAI,CACd,IAAI,aAAa,CAAC,UAAU,EAAE,EAAE,EAAE;gBAC9B,MAAM,EAAE,GAAG,UAAU,YAAY;aACpC,CAAC,CACL,CAAC;QACN,CAAC;QACD,OAAO,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;IAC7B,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,kBAAkB,CACrB,OAAyB,EACzB,MAAc,EACd,cAAuB,EACvB,QAA8B;QAE9B,OAAO;YACH,GAAG,OAAO;YACV,WAAW,EAAE,MAAM;YACnB,cAAc,EAAE,cAAc,IAAI,OAAO,CAAC,cAAc;YACxD,QAAQ,EAAE,EAAE,GAAG,OAAO,CAAC,QAAQ,EAAE,GAAG,QAAQ,EAAE;SACjD,CAAC;IACN,CAAC;CACJ"}

package/dist/shared/use-case/index.d.ts

@@ -0,0 +1,3 @@
+export * from './BaseUseCase';
+export * from './UseCaseHelpers';
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/use-case/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/use-case/index.ts"],"names":[],"mappings":"AACA,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}

package/dist/shared/use-case/index.js

@@ -0,0 +1,4 @@
+// Use case base classes and helpers
+export * from './BaseUseCase';
+export * from './UseCaseHelpers';
+//# sourceMappingURL=index.js.map

package/dist/shared/use-case/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/use-case/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}

package/dist/users/index.d.ts

@@ -0,0 +1,2 @@
+export * from './use-cases';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/users/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAC"}

package/dist/users/index.js

@@ -0,0 +1,3 @@
+// Users domain slice
+export * from './use-cases';
+//# sourceMappingURL=index.js.map

package/dist/users/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/users/index.ts"],"names":[],"mappings":"AAAA,qBAAqB;AACrB,cAAc,aAAa,CAAC"}

package/dist/users/use-cases/create-user/CreateUser.d.ts

@@ -0,0 +1,21 @@
+import type { Adapters } from '@multitenantkit/domain-contracts';
+import type { OperationContext, ToolkitOptions } from '@multitenantkit/domain-contracts/shared';
+import { type DomainError } from '@multitenantkit/domain-contracts/shared/errors/index';
+import type { CreateUserInput, CreateUserOutput, ICreateUser } from '@multitenantkit/domain-contracts/users';
+import { Result } from '../../../shared/result/Result';
+import { BaseUseCase } from '../../../shared/use-case';
+/**
+ * CreateUser use case
+ * Handles the business logic for creating a new user
+ *
+ * Generic support for custom fields:
+ * @template TUserCustomFields - Custom fields added to User
+ * @template TOrganizationCustomFields - Custom fields added to Organization (for toolkit options compatibility)
+ * @template TOrganizationMembershipCustomFields - Custom fields added to OrganizationMembership (for toolkit options compatibility)
+ */
+export declare class CreateUser<TUserCustomFields = {}, TOrganizationCustomFields = {}, TOrganizationMembershipCustomFields = {}> extends BaseUseCase<CreateUserInput & TUserCustomFields, CreateUserOutput, DomainError, TUserCustomFields, TOrganizationCustomFields, TOrganizationMembershipCustomFields> implements ICreateUser {
+    private readonly customSchema?;
+    constructor(adapters: Adapters<TUserCustomFields, TOrganizationCustomFields, TOrganizationMembershipCustomFields>, toolkitOptions?: ToolkitOptions<TUserCustomFields, TOrganizationCustomFields, TOrganizationMembershipCustomFields>);
+    protected executeBusinessLogic(input: CreateUserInput & TUserCustomFields, context: OperationContext): Promise<Result<CreateUserOutput, DomainError>>;
+}
+//# sourceMappingURL=CreateUser.d.ts.map

package/dist/users/use-cases/create-user/CreateUser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateUser.d.ts","sourceRoot":"","sources":["../../../../src/users/use-cases/create-user/CreateUser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAChG,OAAO,EAEH,KAAK,WAAW,EAEnB,MAAM,sDAAsD,CAAC;AAC9D,OAAO,KAAK,EACR,eAAe,EACf,gBAAgB,EAChB,WAAW,EAEd,MAAM,wCAAwC,CAAC;AAOhD,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD;;;;;;;;GAQG;AACH,qBAAa,UAAU,CAEf,iBAAiB,GAAG,EAAE,EAEtB,yBAAyB,GAAG,EAAE,EAE9B,mCAAmC,GAAG,EAAE,CAE5C,SAAQ,WAAW,CACf,eAAe,GAAG,iBAAiB,EACnC,gBAAgB,EAChB,WAAW,EACX,iBAAiB,EACjB,yBAAyB,EACzB,mCAAmC,CAEvC,YAAW,WAAW;IAEtB,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAmB;gBAG7C,QAAQ,EAAE,QAAQ,CACd,iBAAiB,EACjB,yBAAyB,EACzB,mCAAmC,CACtC,EACD,cAAc,CAAC,EAAE,cAAc,CAC3B,iBAAiB,EACjB,yBAAyB,EACzB,mCAAmC,CACtC;cA4BW,oBAAoB,CAChC,KAAK,EAAE,eAAe,GAAG,iBAAiB,EAC1C,OAAO,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;CA8DpD"}

package/dist/users/use-cases/create-user/CreateUser.js

@@ -0,0 +1,81 @@
+import { ConflictError, ValidationError } from '@multitenantkit/domain-contracts/shared/errors/index';
+import { CreateUserInputSchema, CreateUserOutputSchema, UserSchema } from '@multitenantkit/domain-contracts/users';
+import { Result } from '../../../shared/result/Result';
+import { BaseUseCase } from '../../../shared/use-case';
+/**
+ * CreateUser use case
+ * Handles the business logic for creating a new user
+ *
+ * Generic support for custom fields:
+ * @template TUserCustomFields - Custom fields added to User
+ * @template TOrganizationCustomFields - Custom fields added to Organization (for toolkit options compatibility)
+ * @template TOrganizationMembershipCustomFields - Custom fields added to OrganizationMembership (for toolkit options compatibility)
+ */
+export class CreateUser extends BaseUseCase {
+    customSchema;
+    constructor(adapters, toolkitOptions) {
+        const customSchema = toolkitOptions?.users?.customFields?.customSchema;
+        // Build input schema with custom fields if provided
+        const inputSchema = (customSchema
+            ? CreateUserInputSchema.and(customSchema.partial())
+            : CreateUserInputSchema);
+        // Output is a User; merge custom fields if provided
+        const outputSchema = (customSchema
+            ? CreateUserOutputSchema.merge(customSchema)
+            : CreateUserOutputSchema);
+        super('user-createUser', adapters, toolkitOptions, inputSchema, outputSchema, 'Failed to create user');
+        this.customSchema = customSchema;
+    }
+    async executeBusinessLogic(input, context) {
+        if (input.externalId) {
+            const existingUser = await this.adapters.persistence.userRepository.findByExternalId(input.externalId);
+            if (existingUser) {
+                return Result.fail(new ConflictError('User', input.externalId, {
+                    reason: 'External ID already registered'
+                }));
+            }
+        }
+        // 2. Generate ID, externalId and timestamp
+        const userId = input.id ?? this.adapters.system.uuid.generate();
+        const externalId = input.externalId ?? userId; // If externalId is not provided, use userId as externalId
+        const now = this.adapters.system.clock.now();
+        // 3. Create User data with custom fields
+        const user = {
+            ...input,
+            id: userId,
+            externalId,
+            username: input.username, // username is required in input
+            createdAt: now,
+            updatedAt: now
+        };
+        // 4. Validate the user data with custom schema if provided
+        const validationSchema = this.customSchema
+            ? UserSchema.strip().and(this.customSchema.strip())
+            : UserSchema.strip();
+        const validationResult = validationSchema.safeParse(user);
+        if (!validationResult.success) {
+            const firstError = validationResult.error.errors[0];
+            return Result.fail(new ValidationError(firstError.message, firstError.path.join('.')));
+        }
+        const validatedUser = validationResult.data;
+        // 5. Persist the user using Unit of Work (transaction) with audit context
+        const auditContext = {
+            ...context,
+            organizationId: undefined, // Users don't belong directly to a organization
+            auditAction: 'CREATE_USER'
+        };
+        try {
+            await this.adapters.persistence.uow.transaction(async (repos) => {
+                await repos.users.insert(validatedUser, auditContext);
+            });
+        }
+        catch (error) {
+            return Result.fail(new ValidationError('Failed to save user', undefined, {
+                originalError: error
+            }));
+        }
+        // 6. Return success response; BaseUseCase will parse output
+        return Result.ok({ ...validatedUser });
+    }
+}
+//# sourceMappingURL=CreateUser.js.map

package/dist/users/use-cases/create-user/CreateUser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreateUser.js","sourceRoot":"","sources":["../../../../src/users/use-cases/create-user/CreateUser.ts"],"names":[],"mappings":"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"}