Presets и среды выполнения

Пояснение повторяемых сборок одного DomainApi.

Связанные правила

Назначение

Preset является SLM-модулем в Group presets. Он создаёт API одной business-фабрики для конкретного повторяемого контекста выполнения. Каждый доменный пакет содержит минимум один preset-модуль.

authFactory
├── presets/browser       → AuthApi в браузере
├── presets/request       → AuthApi одного server request
└── presets/server-action → AuthApi server action

Архитектура не требует base или изоморфный preset и не ограничивает максимальное количество presets. Обязательный preset должен соответствовать реальному поддерживаемому контексту, а не существовать только для заполнения структуры.

Место сборки графа в composition может вызвать фабрику напрямую для одноразовой конфигурации. Такая сборка не отменяет обязательный preset пакета и при наличии технических зависимостей использует публичные adapter-модули, а не inline implementations.

Один контракт API

Каждый preset вызывает одну и ту же фабрику и возвращает один контракт DomainApi. При наличии технических зависимостей preset выбирает их публичные adapter-модули:

import type { AuthApi } from '@/domains/auth/business'
import { authFactory } from '@/domains/auth/business/factory'
import { createPhoneHttpAdapter } from '@/domains/auth/adapters/phone-http'
import { createBrowserSessionAdapter } from '@/domains/auth/adapters/browser-session'

export const createBrowserAuth = (): AuthApi => {
  return authFactory({
    phone: createPhoneHttpAdapter(),
    session: createBrowserSessionAdapter(),
  })
}

import type { AuthApi } from '@/domains/auth/business'
import { authFactory } from '@/domains/auth/business/factory'
import { createRequestPhoneAdapter } from '@/domains/auth/adapters/request-phone'
import { createRequestSessionAdapter } from '@/domains/auth/adapters/request-session'

export const createAuthForRequest = (
  input: AuthRequestInput,
): AuthApi => {
  return authFactory({
    phone: createRequestPhoneAdapter(input),
    session: createRequestSessionAdapter(input),
  })
}

Server preset может обращаться к database напрямую через adapter, а browser preset реализует тот же сценарий через HTTP или RPC. Preset не добавляет server-only метод к AuthApi и не меняет доменные ошибки.

Если полный DomainApi невозможно корректно создать в некоторой среде, пакет просто не предоставляет preset для этой среды. Метод, намеренно падающий только потому, что среда не поддерживается, не считается реализацией контракта.

Cross-domain input

Preset зависимого домена принимает готовый API аргументом. Cross-domain API не является adapter и не размещается в Group adapters:

import type { AuthApi } from '@/domains/auth/business'
import type { UserApi } from '@/domains/user/business'
import { userFactory } from '@/domains/user/business/factory'
import { createUserProfileAdapter } from '@/domains/user/adapters/profile'

export type CreateUserForRequestInput = {
  authApi: Pick<AuthApi, 'getSession'>
  request: UserRequestInput
}

export const createUserForRequest = ({
  authApi,
  request,
}: CreateUserForRequestInput): UserApi => {
  return userFactory({
    auth: authApi,
    profile: createUserProfileAdapter(request),
  })
}

Preset делает только type-only импорт AuthApi. Runtime-фабрику, preset или instance Auth он не импортирует.

Место сборки графа выполняет сборку:

const authApi = createAuthForRequest(authInput)
const userApi = createUserForRequest({ authApi, request: userInput })

Environment entry points

Server preset имеет отдельный публичный entry point и marker выбранного framework или bundler:

import 'server-only'

export { createAuthForRequest } from './create-auth-for-request'

Server entry point не реэкспортируется через business, Framework Group, browser preset или корень доменного пакета. Аналогично client-only код не достигается из server/shared entry point, если выбранная среда запрещает такую зависимость.

Lifecycle

Preset может создавать ресурсы, которым потребуется запуск или cleanup, но точная форма start, dispose, rollback и request abort пока не нормирована. До принятия решения действует общее правило владения lifecycle Level 1.

6.1 KiB Raw Blame History Unescape Escape