@multitenantkit/domain 0.1.1

package/dist/organizations/use-cases/update-organization/UpdateOrganization.d.ts

@@ -0,0 +1,22 @@
+import type { Adapters } from '@multitenantkit/domain-contracts';
+import type { IUpdateOrganization, UpdateOrganizationInput, UpdateOrganizationOutput } from '@multitenantkit/domain-contracts/organizations';
+import type { OperationContext, ToolkitOptions } from '@multitenantkit/domain-contracts/shared';
+import { type ConflictError, type NotFoundError, UnauthorizedError, ValidationError } from '@multitenantkit/domain-contracts/shared/errors/index';
+import { Result } from '../../../shared/result';
+import { BaseUseCase } from '../../../shared/use-case';
+/**
+ * UpdateOrganization use case
+ * Handles the business logic for updating a organization (any fields including custom)
+ * Note: Despite the name, this use case now handles updates to any organization property
+ *
+ * Generic support for custom fields:
+ * @template TOrganizationCustomFields - Custom fields added to Organization
+ * @template TUserCustomFields - User custom fields (for toolkit options compatibility)
+ * @template TOrganizationMembershipCustomFields - Membership custom fields (for toolkit options compatibility)
+ */
+export declare class UpdateOrganization<TOrganizationCustomFields = {}, TUserCustomFields = {}, TOrganizationMembershipCustomFields = {}> extends BaseUseCase<UpdateOrganizationInput & TOrganizationCustomFields, UpdateOrganizationOutput, ValidationError | NotFoundError | ConflictError | UnauthorizedError, TUserCustomFields, TOrganizationCustomFields, TOrganizationMembershipCustomFields> implements IUpdateOrganization {
+    private readonly customSchema?;
+    constructor(adapters: Adapters<TUserCustomFields, TOrganizationCustomFields, TOrganizationMembershipCustomFields>, toolkitOptions?: ToolkitOptions<TUserCustomFields, TOrganizationCustomFields, TOrganizationMembershipCustomFields>);
+    protected executeBusinessLogic(input: UpdateOrganizationInput & TOrganizationCustomFields, context: OperationContext): Promise<Result<UpdateOrganizationOutput, ValidationError | NotFoundError | ConflictError | UnauthorizedError>>;
+}
+//# sourceMappingURL=UpdateOrganization.d.ts.map

package/dist/organizations/use-cases/update-organization/UpdateOrganization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UpdateOrganization.d.ts","sourceRoot":"","sources":["../../../../src/organizations/use-cases/update-organization/UpdateOrganization.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AACjE,OAAO,KAAK,EACR,mBAAmB,EAEnB,uBAAuB,EACvB,wBAAwB,EAC3B,MAAM,gDAAgD,CAAC;AAMxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAChG,OAAO,EACH,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,iBAAiB,EACjB,eAAe,EAClB,MAAM,sDAAsD,CAAC;AAE9D,OAAO,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAkB,MAAM,0BAA0B,CAAC;AAEvE;;;;;;;;;GASG;AACH,qBAAa,kBAAkB,CAEvB,yBAAyB,GAAG,EAAE,EAE9B,iBAAiB,GAAG,EAAE,EAEtB,mCAAmC,GAAG,EAAE,CAE5C,SAAQ,WAAW,CACf,uBAAuB,GAAG,yBAAyB,EACnD,wBAAwB,EACxB,eAAe,GAAG,aAAa,GAAG,aAAa,GAAG,iBAAiB,EACnE,iBAAiB,EACjB,yBAAyB,EACzB,mCAAmC,CAEvC,YAAW,mBAAmB;IAE9B,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;cA8CW,oBAAoB,CAChC,KAAK,EAAE,uBAAuB,GAAG,yBAAyB,EAC1D,OAAO,EAAE,gBAAgB,GAC1B,OAAO,CACN,MAAM,CACF,wBAAwB,EACxB,eAAe,GAAG,aAAa,GAAG,aAAa,GAAG,iBAAiB,CACtE,CACJ;CAmGJ"}

package/dist/organizations/use-cases/update-organization/UpdateOrganization.js

@@ -0,0 +1,100 @@
+import { OrganizationSchema, UpdateOrganizationInputSchema, UpdateOrganizationOutputSchema } from '@multitenantkit/domain-contracts/organizations';
+import { UnauthorizedError, ValidationError } from '@multitenantkit/domain-contracts/shared/errors/index';
+import { Result } from '../../../shared/result';
+import { BaseUseCase, UseCaseHelpers } from '../../../shared/use-case';
+/**
+ * UpdateOrganization use case
+ * Handles the business logic for updating a organization (any fields including custom)
+ * Note: Despite the name, this use case now handles updates to any organization property
+ *
+ * Generic support for custom fields:
+ * @template TOrganizationCustomFields - Custom fields added to Organization
+ * @template TUserCustomFields - User custom fields (for toolkit options compatibility)
+ * @template TOrganizationMembershipCustomFields - Membership custom fields (for toolkit options compatibility)
+ */
+export class UpdateOrganization extends BaseUseCase {
+    customSchema;
+    constructor(adapters, toolkitOptions) {
+        // Extract custom schema from toolkit options
+        const customSchema = toolkitOptions?.organizations?.customFields?.customSchema;
+        // Build input schema with optional custom fields
+        const inputSchema = (customSchema
+            ? UpdateOrganizationInputSchema.and(customSchema.partial())
+            : UpdateOrganizationInputSchema).refine((data) => Object.keys(data).some((k) => k !== 'organizationId' && k !== 'userId' && data[k] !== undefined), {
+            message: 'At least one field must be provided for update',
+            path: ['root']
+        });
+        // Extend output schema with custom fields if provided
+        const outputSchema = customSchema
+            ? UpdateOrganizationOutputSchema.merge(customSchema)
+            : UpdateOrganizationOutputSchema;
+        super('organization-updateOrganization', adapters, toolkitOptions, inputSchema, outputSchema, 'Failed to update organization');
+        // Store custom schema for use in validation
+        this.customSchema = customSchema;
+    }
+    async executeBusinessLogic(input, context) {
+        // 1. Find existing organization
+        const organizationResult = await UseCaseHelpers.findByIdOrFail(this.adapters.persistence.organizationRepository, input.organizationId, 'Organization');
+        if (organizationResult.isFailure) {
+            return organizationResult;
+        }
+        const getUserResult = await this.getUserFromExternalId(input.principalExternalId);
+        if (getUserResult.isFailure) {
+            return Result.fail(getUserResult.getError());
+        }
+        const existingUser = getUserResult.getValue();
+        const existingOrganizationDB = organizationResult.getValue();
+        const existingOrganization = existingOrganizationDB;
+        // 1.5. Verify organization is not deleted
+        if (existingOrganization.deletedAt) {
+            return Result.fail(new ValidationError('Cannot update a deleted organization', 'organizationId'));
+        }
+        // 2. Verify permissions - organization owner or admin can update organization
+        const isOwner = existingOrganization.ownerUserId === existingUser.id;
+        let isAdmin = false;
+        if (!isOwner) {
+            // Check if user is an admin organization member
+            const membershipDB = await this.adapters.persistence.organizationMembershipRepository.findByUserIdAndOrganizationId(existingUser.id, input.organizationId);
+            isAdmin =
+                !!membershipDB &&
+                    !!membershipDB.joinedAt &&
+                    !membershipDB.leftAt &&
+                    !membershipDB.deletedAt &&
+                    membershipDB.roleCode === 'admin';
+        }
+        if (!isOwner && !isAdmin) {
+            return Result.fail(new UnauthorizedError('Only organization owner or admin members can update organization'));
+        }
+        // 3. Build updated organization data
+        const now = this.adapters.system.clock.now();
+        // Filter out undefined values from input to preserve existing values
+        // Exclude organizationId and userId as they are not organization properties
+        const { _organizationId, _userId, ...updateFields } = input;
+        const definedInputFields = Object.fromEntries(Object.entries(updateFields).filter(([_, value]) => value !== undefined));
+        // Merge existing organization with defined input fields
+        const updatedOrganizationData = {
+            ...existingOrganization,
+            ...definedInputFields,
+            updatedAt: now
+        };
+        // Validate the merged data with custom schema if provided
+        const validationSchema = this.customSchema
+            ? OrganizationSchema.strip().and(this.customSchema.strip())
+            : OrganizationSchema.strip();
+        const organizationValidationResult = validationSchema.safeParse(updatedOrganizationData);
+        if (!organizationValidationResult.success) {
+            const firstError = organizationValidationResult.error.errors[0];
+            return Result.fail(new ValidationError(firstError.message, firstError.path.join('.')));
+        }
+        // Use validated and potentially transformed data from Zod
+        const updatedOrganization = organizationValidationResult.data;
+        // 4. Persist the updated organization using Unit of Work (transaction) with audit context
+        const auditContext = UseCaseHelpers.enrichAuditContext(context, 'UPDATE_ORGANIZATION', input.organizationId);
+        await this.adapters.persistence.uow.transaction(async (repos) => {
+            await repos.organizations.update(updatedOrganization, auditContext);
+        });
+        // 5. Return success response; BaseUseCase will parse output
+        return Result.ok(updatedOrganization);
+    }
+}
+//# sourceMappingURL=UpdateOrganization.js.map

package/dist/organizations/use-cases/update-organization/UpdateOrganization.js.map

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

package/dist/shared/index.d.ts

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

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

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

package/dist/shared/index.js

@@ -0,0 +1,4 @@
+// Shared domain types and utilities
+export * from './result';
+export * from './use-case';
+//# sourceMappingURL=index.js.map

package/dist/shared/index.js.map

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

package/dist/shared/result/Result.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Result pattern for handling errors in a functional way
+ * Based on Railway Oriented Programming
+ */
+export declare abstract class Result<T, E> {
+    readonly isSuccess: boolean;
+    readonly isFailure: boolean;
+    constructor(isSuccess: boolean);
+    static ok<U>(value: U): Ok<U, never>;
+    static fail<F>(error: F): Fail<never, F>;
+    abstract getValue(): T;
+    abstract getError(): E;
+    map<U>(fn: (value: T) => U): Result<U, E>;
+    mapError<F>(fn: (error: E) => F): Result<T, F>;
+    flatMap<U>(fn: (value: T) => Result<U, E>): Result<U, E>;
+    match<U>(onSuccess: (value: T) => U, onFailure: (error: E) => U): U;
+}
+export declare class Ok<T, E> extends Result<T, E> {
+    private readonly _value;
+    constructor(value: T);
+    getValue(): T;
+    getError(): E;
+}
+export declare class Fail<T, E> extends Result<T, E> {
+    private readonly _error;
+    constructor(error: E);
+    getValue(): T;
+    getError(): E;
+}
+//# sourceMappingURL=Result.d.ts.map

package/dist/shared/result/Result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Result.d.ts","sourceRoot":"","sources":["../../../src/shared/result/Result.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,8BAAsB,MAAM,CAAC,CAAC,EAAE,CAAC;IAC7B,SAAgB,SAAS,EAAE,OAAO,CAAC;IACnC,SAAgB,SAAS,EAAE,OAAO,CAAC;gBAEvB,SAAS,EAAE,OAAO;WAKhB,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,KAAK,CAAC;WAI7B,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;aAI/B,QAAQ,IAAI,CAAC;aACb,QAAQ,IAAI,CAAC;IAEtB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAOzC,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAO9C,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAOxD,KAAK,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC;CAM7E;AAED,qBAAa,EAAE,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IACtC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAI;gBAEf,KAAK,EAAE,CAAC;IAKb,QAAQ,IAAI,CAAC;IAIb,QAAQ,IAAI,CAAC;CAGvB;AAED,qBAAa,IAAI,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAI;gBAEf,KAAK,EAAE,CAAC;IAKb,QAAQ,IAAI,CAAC;IAIb,QAAQ,IAAI,CAAC;CAGvB"}

package/dist/shared/result/Result.js

@@ -0,0 +1,69 @@
+/**
+ * Result pattern for handling errors in a functional way
+ * Based on Railway Oriented Programming
+ */
+export class Result {
+    isSuccess;
+    isFailure;
+    constructor(isSuccess) {
+        this.isSuccess = isSuccess;
+        this.isFailure = !isSuccess;
+    }
+    static ok(value) {
+        return new Ok(value);
+    }
+    static fail(error) {
+        return new Fail(error);
+    }
+    map(fn) {
+        if (this.isFailure) {
+            return Result.fail(this.getError());
+        }
+        return Result.ok(fn(this.getValue()));
+    }
+    mapError(fn) {
+        if (this.isSuccess) {
+            return Result.ok(this.getValue());
+        }
+        return Result.fail(fn(this.getError()));
+    }
+    flatMap(fn) {
+        if (this.isFailure) {
+            return Result.fail(this.getError());
+        }
+        return fn(this.getValue());
+    }
+    match(onSuccess, onFailure) {
+        if (this.isSuccess) {
+            return onSuccess(this.getValue());
+        }
+        return onFailure(this.getError());
+    }
+}
+export class Ok extends Result {
+    _value;
+    constructor(value) {
+        super(true);
+        this._value = value;
+    }
+    getValue() {
+        return this._value;
+    }
+    getError() {
+        throw new Error('Cannot get error from Ok result');
+    }
+}
+export class Fail extends Result {
+    _error;
+    constructor(error) {
+        super(false);
+        this._error = error;
+    }
+    getValue() {
+        throw new Error('Cannot get value from Fail result');
+    }
+    getError() {
+        return this._error;
+    }
+}
+//# sourceMappingURL=Result.js.map

package/dist/shared/result/Result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Result.js","sourceRoot":"","sources":["../../../src/shared/result/Result.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,OAAgB,MAAM;IACR,SAAS,CAAU;IACnB,SAAS,CAAU;IAEnC,YAAY,SAAkB;QAC1B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,CAAC,SAAS,CAAC;IAChC,CAAC;IAEM,MAAM,CAAC,EAAE,CAAI,KAAQ;QACxB,OAAO,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAEM,MAAM,CAAC,IAAI,CAAI,KAAQ;QAC1B,OAAO,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAKM,GAAG,CAAI,EAAmB;QAC7B,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC1C,CAAC;IAEM,QAAQ,CAAI,EAAmB;QAClC,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAC5C,CAAC;IAEM,OAAO,CAAI,EAA8B;QAC5C,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/B,CAAC;IAEM,KAAK,CAAI,SAA0B,EAAE,SAA0B;QAClE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACjB,OAAO,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtC,CAAC;CACJ;AAED,MAAM,OAAO,EAAS,SAAQ,MAAY;IACrB,MAAM,CAAI;IAE3B,YAAY,KAAQ;QAChB,KAAK,CAAC,IAAI,CAAC,CAAC;QACZ,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACxB,CAAC;IAEM,QAAQ;QACX,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;IAEM,QAAQ;QACX,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACvD,CAAC;CACJ;AAED,MAAM,OAAO,IAAW,SAAQ,MAAY;IACvB,MAAM,CAAI;IAE3B,YAAY,KAAQ;QAChB,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACxB,CAAC;IAEM,QAAQ;QACX,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;IACzD,CAAC;IAEM,QAAQ;QACX,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;CACJ"}

package/dist/shared/result/index.d.ts

@@ -0,0 +1,4 @@
+export { Fail, Ok, Result } from './Result';
+import type { Result } from './Result';
+export type Either<E, T> = Result<T, E>;
+//# sourceMappingURL=index.d.ts.map

package/dist/shared/result/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/shared/result/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAG5C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AACvC,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/shared/result/index.js

@@ -0,0 +1,2 @@
+export { Fail, Ok, Result } from './Result';
+//# sourceMappingURL=index.js.map

package/dist/shared/result/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/shared/result/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC"}

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

@@ -0,0 +1,164 @@
+import type { Adapters, DomainError, OperationContext, ToolkitOptions, User } from '@multitenantkit/domain-contracts';
+import type { z } from 'zod';
+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 declare abstract class BaseUseCase<TInput, TOutput, TError extends DomainError = DomainError, TCustomFields = any, TOrganizationCustomFields = any, TOrganizationMembershipCustomFields = any> {
+    protected readonly adapters: Adapters<TCustomFields, TOrganizationCustomFields, TOrganizationMembershipCustomFields>;
+    protected readonly toolkitOptions: ToolkitOptions<TCustomFields, TOrganizationCustomFields, TOrganizationMembershipCustomFields> | undefined;
+    private readonly inputSchema;
+    private readonly outputSchema;
+    private readonly errorMessage;
+    /**
+     * Abort state tracking
+     * These track whether a hook has requested abort and the reason
+     */
+    private abortRequested;
+    private abortReason;
+    /**
+     * Shared state object for hooks
+     * Reset at the start of each execution
+     */
+    private sharedState;
+    /**
+     * Step results object for hooks
+     * Stores results from each pipeline step
+     */
+    private stepResults;
+    /**
+     * Execution ID for tracking
+     * Generated at the start of each execution
+     */
+    private executionId;
+    /**
+     * Use case name in format "entity-useCaseName"
+     * Example: "user-updateUser", "organization-createOrganization"
+     * This helps prevent name collisions between different entities
+     */
+    protected readonly useCaseName: string;
+    constructor(useCaseName: string, adapters: Adapters<TCustomFields, TOrganizationCustomFields, TOrganizationMembershipCustomFields>, toolkitOptions: ToolkitOptions<TCustomFields, TOrganizationCustomFields, TOrganizationMembershipCustomFields> | undefined, inputSchema: z.ZodType<TInput>, outputSchema: z.ZodType<TOutput>, errorMessage: string);
+    /**
+     * Initialize execution state for a new execution
+     * Resets abort state, shared state, step results, and generates execution ID
+     */
+    private initializeExecutionState;
+    /**
+     * 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
+     */
+    private createAbortFunction;
+    /**
+     * Check if abort was requested
+     * Should be called after each hook execution
+     *
+     * @returns true if abort was requested
+     */
+    private checkAborted;
+    /**
+     * 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
+     */
+    private buildHookContext;
+    /**
+     * Get configured hooks for this use case from ToolkitOptions
+     *
+     * @returns UseCaseHooks if configured, undefined otherwise
+     */
+    private getHooksConfig;
+    /**
+     * 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
+     */
+    private executeHook;
+    /**
+     * 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)
+     */
+    private logMetrics;
+    /**
+     * 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);
+     * ```
+     */
+    protected getUserFromExternalId(externalId: string): Promise<Result<User & TCustomFields, DomainError>>;
+    /**
+     * 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)
+     */
+    execute(input: TInput, context: OperationContext): Promise<Result<TOutput, TError>>;
+    /**
+     * Validates input using the provided Zod schema
+     */
+    private validateInput;
+    /**
+     * Authorization hook - override for permission checks
+     * Default: no authorization
+     */
+    protected authorize(_input: TInput, _context: OperationContext): Promise<Result<void, DomainError>>;
+    /**
+     * Main business logic - must be implemented by each use case
+     * This is where the actual domain logic lives
+     */
+    protected abstract executeBusinessLogic(input: TInput, context: OperationContext): Promise<Result<TOutput, TError>>;
+    /**
+     * Parses output using the provided Zod schema
+     */
+    private parseOutput;
+    /**
+     * Wraps execution in try-catch for consistent error handling
+     */
+    private withErrorHandling;
+}
+//# sourceMappingURL=BaseUseCase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BaseUseCase.d.ts","sourceRoot":"","sources":["../../../src/shared/use-case/BaseUseCase.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACR,QAAQ,EACR,WAAW,EAEX,gBAAgB,EAChB,cAAc,EAEd,IAAI,EACP,MAAM,kCAAkC,CAAC;AAO1C,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAE1C;;;;;;;;;;;;;;;;GAgBG;AACH,8BAAsB,WAAW,CAC7B,MAAM,EACN,OAAO,EACP,MAAM,SAAS,WAAW,GAAG,WAAW,EACxC,aAAa,GAAG,GAAG,EACnB,yBAAyB,GAAG,GAAG,EAC/B,mCAAmC,GAAG,GAAG;IAwCrC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CACjC,aAAa,EACb,yBAAyB,EACzB,mCAAmC,CACtC;IACD,SAAS,CAAC,QAAQ,CAAC,cAAc,EAC3B,cAAc,CACV,aAAa,EACb,yBAAyB,EACzB,mCAAmC,CACtC,GACD,SAAS;IACf,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY;IApDjC;;;OAGG;IACH,OAAO,CAAC,cAAc,CAAkB;IACxC,OAAO,CAAC,WAAW,CAAc;IAEjC;;;OAGG;IACH,OAAO,CAAC,WAAW,CAA2B;IAE9C;;;OAGG;IACH,OAAO,CAAC,WAAW,CAIZ;IAEP;;;OAGG;IACH,OAAO,CAAC,WAAW,CAAc;IAEjC;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;gBAGnC,WAAW,EAAE,MAAM,EACA,QAAQ,EAAE,QAAQ,CACjC,aAAa,EACb,yBAAyB,EACzB,mCAAmC,CACtC,EACkB,cAAc,EAC3B,cAAc,CACV,aAAa,EACb,yBAAyB,EACzB,mCAAmC,CACtC,GACD,SAAS,EACE,WAAW,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,EAC9B,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAChC,YAAY,EAAE,MAAM;IAKzC;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAQhC;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAO3B;;;;;OAKG;IACH,OAAO,CAAC,YAAY;IAIpB;;;;;;;OAOG;IACH,OAAO,CAAC,gBAAgB;IAsBxB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IA2BtB;;;;;;;OAOG;YACW,WAAW;IA+BzB;;;;;;OAMG;IACH,OAAO,CAAC,UAAU;IA6BlB;;;;;;;;;;;;;;;OAeG;cACa,qBAAqB,CACjC,UAAU,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC,IAAI,GAAG,aAAa,EAAE,WAAW,CAAC,CAAC;IAoBrD;;;;;;;;;;;;;;;;OAgBG;IACU,OAAO,CAChB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAkInC;;OAEG;YACW,aAAa;IAS3B;;;OAGG;cACa,SAAS,CACrB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,gBAAgB,GAC3B,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAIrC;;;OAGG;IACH,SAAS,CAAC,QAAQ,CAAC,oBAAoB,CACnC,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,gBAAgB,GAC1B,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAEnC;;OAEG;IACH,OAAO,CAAC,WAAW;IAoBnB;;OAEG;YACW,iBAAiB;CAalC"}