alepha 0.13.1 → 0.13.2

package/dist/server/index.browser.js

@@ -449,7 +449,7 @@ const okSchema = t.object({
 //#region src/server/index.browser.ts
 const AlephaServer = $module({
 	name: "alepha.server",
-	descriptors: [],
+	primitives: [],
 	services: [HttpClient]
 });
 

package/dist/server/index.browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.browser.js","names":["json: Record<string, unknown>","errorNameByStatus: Record<number, string>","properties: Record<string, any>","request: RequestInit","headers: Record<string, string>","fetchResponse: FetchResponse"],"sources":["../../src/server/errors/HttpError.ts","../../src/server/helpers/isMultipart.ts","../../src/server/schemas/errorSchema.ts","../../src/server/services/HttpClient.ts","../../src/server/constants/routeMethods.ts","../../src/server/errors/BadRequestError.ts","../../src/server/errors/ConflictError.ts","../../src/server/errors/ForbiddenError.ts","../../src/server/errors/NotFoundError.ts","../../src/server/errors/UnauthorizedError.ts","../../src/server/errors/ValidationError.ts","../../src/server/helpers/ServerReply.ts","../../src/server/schemas/okSchema.ts","../../src/server/index.browser.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\nimport type { ErrorSchema } from \"../schemas/errorSchema.ts\";\n\nexport const isHttpError = (\n  error: unknown,\n  status?: number,\n): error is HttpErrorLike => {\n  const isError =\n    !!error &&\n    typeof error === \"object\" &&\n    \"message\" in error &&\n    typeof error.message === \"string\" &&\n    \"status\" in error &&\n    typeof error.status === \"number\";\n\n  if (!isError) {\n    return false;\n  }\n\n  if (status) {\n    return (error as HttpErrorLike).status === status;\n  }\n\n  return true;\n};\n\nexport class HttpError extends AlephaError {\n  public name = \"HttpError\";\n\n  static is = isHttpError;\n\n  static toJSON(error: HttpError): ErrorSchema {\n    const json: Record<string, unknown> = {\n      error: error.error,\n      status: error.status,\n      message: error.message,\n    };\n\n    if (error.details) json.details = error.details;\n    if (error.requestId) json.requestId = error.requestId;\n    if (error.reason) json.cause = error.reason;\n\n    return json as ErrorSchema;\n  }\n\n  public readonly error: string;\n  public readonly status: number;\n\n  public readonly requestId?: string;\n  public readonly details?: string;\n  public readonly reason?: {\n    name: string;\n    message: string;\n  };\n\n  constructor(options: Partial<ErrorSchema>, cause?: unknown) {\n    super(options.message, {\n      cause,\n    });\n\n    this.status = options.status ?? 500;\n    this.details = options.details;\n    this.requestId = options.requestId;\n\n    if (typeof options.cause === \"object\") {\n      this.reason = {\n        name: (options.cause as { name: string }).name,\n        message: (options.cause as { message: string }).message,\n      };\n    } else if (cause instanceof Error) {\n      this.reason = {\n        name: cause.name,\n        message: cause.message,\n      };\n    }\n\n    if (this.constructor.name === \"HttpError\") {\n      this.error =\n        options.error ?? errorNameByStatus[this.status] ?? \"HttpError\";\n    } else {\n      this.error = this.constructor.name;\n    }\n  }\n}\n\nexport const errorNameByStatus: Record<number, string> = {\n  400: \"BadRequestError\",\n  401: \"UnauthorizedError\",\n  403: \"ForbiddenError\",\n  404: \"NotFoundError\",\n  405: \"MethodNotAllowedError\",\n  409: \"ConflictError\",\n  410: \"GoneError\",\n  413: \"PayloadTooLargeError\",\n  415: \"UnsupportedMediaTypeError\",\n  429: \"TooManyRequestsError\",\n  500: \"InternalServerError\",\n  501: \"NotImplementedError\",\n  502: \"BadGatewayError\",\n  503: \"ServiceUnavailableError\",\n  504: \"GatewayTimeoutError\",\n};\n\nexport interface HttpErrorLike extends Error {\n  status: number;\n}\n","import type { RequestConfigSchema } from \"../interfaces/ServerRequest.ts\";\n\n/**\n * Checks if the route has multipart/form-data request body.\n */\nexport const isMultipart = (options: {\n  schema?: RequestConfigSchema;\n  requestBodyType?: string;\n}): boolean => {\n  if (options.requestBodyType === \"multipart/form-data\") {\n    return true;\n  }\n\n  if (options.schema?.body && \"properties\" in options.schema.body) {\n    const properties: Record<string, any> = options.schema.body.properties;\n    for (const key in properties) {\n      if (properties[key].format === \"binary\") {\n        return true;\n      }\n    }\n  }\n\n  return false;\n};\n","import { type Static, t } from \"alepha\";\n\nexport const errorSchema = t.object(\n  {\n    error: t.text({ description: \"HTTP error name\" }),\n    status: t.integer({\n      description: \"HTTP status code\",\n    }),\n    message: t.text({\n      description: \"Short text which describe the error\",\n      size: \"rich\",\n    }),\n    details: t.optional(\n      t.text({\n        description: \"Detailed description of the error\",\n        size: \"rich\",\n      }),\n    ),\n    requestId: t.optional(t.text()),\n    cause: t.optional(\n      t.object({\n        name: t.text(),\n        message: t.text({\n          description: \"Cause Error message\",\n          size: \"rich\",\n        }),\n      }),\n    ),\n  },\n  {\n    title: \"HttpError\",\n    description: \"Generic response after a failed operation\",\n  },\n);\n\nexport type ErrorSchema = Static<typeof errorSchema>;\n","import {\n  $inject,\n  Alepha,\n  type FileLike,\n  isFileLike,\n  type Static,\n  type TObject,\n  type TSchema,\n} from \"alepha\";\nimport { $cache } from \"alepha/cache\";\nimport type { DurationLike } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport type { ClientRequestOptions } from \"../descriptors/$action.ts\";\nimport { HttpError } from \"../errors/HttpError.ts\";\nimport { isMultipart } from \"../helpers/isMultipart.ts\";\nimport type {\n  ServerRequestConfigEntry,\n  TRequestBody,\n  TResponseBody,\n} from \"../interfaces/ServerRequest.ts\";\nimport { errorSchema } from \"../schemas/errorSchema.ts\";\n\nexport class HttpClient {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n\n  public readonly cache = $cache<HttpClientCache>();\n\n  protected readonly pendingRequests: HttpClientPendingRequests = {};\n\n  public async fetchAction(args: FetchActionArgs): Promise<FetchResponse> {\n    const route = args.action; // our link to fetch\n    const options = args.options ?? {}; // fetch standard options, cache, etc.\n    const config = args.config ?? {}; // params, query, body, etc.\n    const host = args.host ?? \"\"; // remote host, e.g. \"https://api.example.com\" or empty (for browser)\n\n    const request: RequestInit = {\n      ...options.request,\n    };\n\n    const method = route.method;\n    const headers: Record<string, string> = {};\n    const url = this.url(host, route, config);\n\n    await this.alepha.events.emit(\"client:onRequest\", {\n      route,\n      config,\n      options,\n      headers,\n      request,\n    });\n\n    request.method ??= method;\n\n    await this.body(request, headers, route, config);\n\n    request.headers = {\n      ...config.headers,\n      ...Object.fromEntries(new Headers(request.headers).entries()),\n      ...headers,\n    };\n\n    return await this.fetch(url, {\n      ...request,\n      schema: route.schema,\n      ...options,\n    });\n  }\n\n  public async fetch<T extends TSchema>(\n    url: string,\n    request: RequestInitWithOptions<T> = {}, // standard options\n  ): Promise<FetchResponse<Static<T>>> {\n    const options = {\n      cache: request.localCache,\n      schema: request.schema?.response,\n      key: request.key,\n    };\n\n    request.method ??= \"GET\";\n\n    this.log.trace(\"Request\", {\n      url,\n      method: request.method,\n      body: request.body,\n      headers: request.headers,\n      options,\n    });\n\n    // Only add automatic ETag if user didn't explicitly provide headers\n    const cached = await this.cache.get(url);\n    if (cached && request.method === \"GET\") {\n      if (cached.etag) {\n        request.headers = new Headers(request.headers);\n        if (!request.headers.has(\"if-none-match\")) {\n          request.headers.set(\"if-none-match\", cached.etag);\n        }\n      } else {\n        return {\n          data: cached.data as Static<T>,\n          status: 200,\n          statusText: \"OK\",\n          headers: new Headers(),\n        };\n      }\n    }\n\n    await this.alepha.events.emit(\"client:beforeFetch\", {\n      url,\n      options,\n      request,\n    });\n\n    // make a key for the request\n    // this will be used to check if the request is already pending\n    const key =\n      options.key ??\n      JSON.stringify({\n        url,\n        method: request.method,\n        body: request.body,\n      });\n\n    const existing = this.pendingRequests[key];\n    if (existing) {\n      this.log.info(\"Request already pending\", key);\n      return existing;\n    }\n\n    this.pendingRequests[key] = fetch(url, request)\n      .then(async (response) => {\n        this.log.debug(\"Response\", {\n          url,\n          status: response.status,\n        });\n\n        const fetchResponse: FetchResponse = {\n          data: await this.responseData(response, options),\n          status: response.status,\n          statusText: response.statusText,\n          headers: response.headers,\n          raw: response,\n        };\n\n        if (request.method === \"GET\") {\n          if (options.cache) {\n            await this.cache.set(\n              url,\n              { data: fetchResponse.data },\n              typeof options.cache === \"boolean\" ? undefined : options.cache,\n            );\n          } else if (!this.alepha.isBrowser()) {\n            // only cache etag on server, browser can handle etag itself\n            const etag = response.headers.get(\"etag\") ?? undefined;\n            if (etag) {\n              await this.cache.set(url, { data: fetchResponse.data, etag });\n            }\n          }\n        }\n\n        return fetchResponse;\n      })\n      .finally(() => {\n        delete this.pendingRequests[key];\n      });\n\n    return this.pendingRequests[key];\n  }\n\n  protected url(\n    host: string,\n    action: HttpAction,\n    args: ServerRequestConfigEntry,\n  ) {\n    let url = host;\n\n    if (action.prefix) {\n      url += action.prefix;\n    }\n\n    url += action.path;\n    url = this.pathVariables(url, action, args);\n    url = this.queryParams(url, action, args);\n\n    return url;\n  }\n\n  protected async body(\n    init: RequestInit,\n    headers: Record<string, string>,\n    action: HttpAction,\n    args: ServerRequestConfigEntry = {},\n  ) {\n    const hasHeader =\n      typeof init.headers === \"object\" &&\n      \"content-type\" in init.headers &&\n      init.headers[\"content-type\"] === \"multipart/form-data\";\n\n    if (hasHeader || isMultipart(action)) {\n      if (typeof init.headers === \"object\" && \"content-type\" in init.headers) {\n        delete init.headers[\"content-type\"]; // fetch() will fill this for us\n      }\n\n      const formData = new FormData();\n\n      for (const [key, value] of Object.entries(args.body ?? {})) {\n        if (typeof value === \"string\") {\n          formData.append(key, value);\n          continue;\n        }\n        if (value instanceof Blob) {\n          formData.append(key, value);\n          continue;\n        }\n        if (isFileLike(value)) {\n          // FileLike must be transformed to WebFile\n          formData.append(\n            key,\n            new File([await value.arrayBuffer()], value.name, {\n              type: value.type,\n            }),\n          );\n        }\n      }\n\n      init.body = formData;\n\n      return;\n    }\n\n    if (!init.body && action.schema?.body) {\n      headers[\"content-type\"] = \"application/json\";\n      init.body = this.alepha.codec.encode(action.schema?.body, args.body, {\n        as: \"string\",\n      });\n    }\n  }\n\n  protected async responseData(\n    response: Response,\n    options: FetchOptions,\n  ): Promise<any> {\n    if (response.status === 304) {\n      let cacheKey = response.url;\n      if (typeof window !== \"undefined\") {\n        cacheKey = cacheKey.replace(window.location.origin, \"\");\n      }\n\n      const cached = await this.cache.get(cacheKey);\n      if (cached) {\n        return cached.data;\n      }\n\n      // if no cached data (etag-only routes), return empty string\n      return \"\";\n    }\n\n    if (response.status === 204) {\n      return;\n    }\n\n    if (this.isMaybeFile(response)) {\n      return this.createFileLike(response);\n    }\n\n    if (response.headers.get(\"Content-Type\")?.startsWith(\"text/\")) {\n      return await response.text();\n    }\n\n    if (response.headers.get(\"Content-Type\") === \"application/json\") {\n      const json = await response.json();\n\n      if (response.status >= 400) {\n        const jsonError = this.alepha.codec.decode(errorSchema, json);\n        const error = new HttpError(jsonError);\n\n        await this.alepha.events.emit(\"client:onError\", {\n          error,\n        });\n\n        throw error;\n      }\n\n      if (options.schema) {\n        return this.alepha.codec.decode(options.schema, json);\n      }\n\n      return json;\n    }\n\n    if (response.status >= 400) {\n      const error = new HttpError({\n        status: response.status,\n        message: `An error occurred while fetching the resource. (${response.statusText})`,\n      });\n\n      await this.alepha.events.emit(\"client:onError\", {\n        error,\n      });\n\n      throw error;\n    }\n\n    return response;\n  }\n\n  protected isMaybeFile(response: Response): boolean {\n    const contentType = response.headers.get(\"Content-Type\");\n    if (!contentType) {\n      return false;\n    }\n\n    if (response.headers.get(\"Content-Disposition\")?.includes(\"attachment\")) {\n      return true; // If Content-Disposition indicates an attachment, treat it as a file\n    }\n\n    return (\n      contentType.startsWith(\"application/octet-stream\") ||\n      contentType.startsWith(\"application/pdf\") ||\n      contentType.startsWith(\"application/zip\") ||\n      contentType.startsWith(\"image/\") ||\n      contentType.startsWith(\"video/\") ||\n      contentType.startsWith(\"audio/\")\n    );\n  }\n\n  protected createFileLike(response: Response, defaultFileName = \"\"): FileLike {\n    const match = (response.headers.get(\"Content-Disposition\") ?? \"\").match(\n      /filename=\"(.+)\"/,\n    );\n    return {\n      name: match?.[1] ? match[1] : defaultFileName,\n      type: response.headers.get(\"Content-Type\") ?? \"application/octet-stream\",\n      size: Number(response.headers.get(\"Content-Length\") ?? 0),\n      lastModified: Date.now(),\n      stream: () => {\n        throw new Error(\"Not implemented\");\n      },\n      arrayBuffer: async () => {\n        return await response.arrayBuffer();\n      },\n      text: async () => {\n        return await response.text();\n      },\n    };\n  }\n\n  public pathVariables(\n    url: string,\n    action: { schema?: { params?: TObject } },\n    args: ServerRequestConfigEntry = {},\n  ): string {\n    if (typeof args.params === \"object\") {\n      const params = action.schema?.params\n        ? (this.alepha.codec.decode(\n            action.schema.params,\n            args.params,\n          ) as Record<string, any>)\n        : args.params;\n\n      for (const key of Object.keys(params)) {\n        url = url.replace(`:${key}`, params[key]);\n        url = url.replace(`{${key}}`, params[key]);\n      }\n    }\n\n    return url;\n  }\n\n  public queryParams(\n    url: string,\n    action: { schema?: { query?: TObject } },\n    args: ServerRequestConfigEntry = {},\n  ): string {\n    if (typeof args.query === \"object\") {\n      const query = action.schema?.query\n        ? this.alepha.codec.decode(action.schema.query, args.query ?? {})\n        : args.query;\n\n      for (const key of Object.keys(query)) {\n        if (query[key] === undefined) {\n          delete query[key];\n        }\n        if (typeof query[key] === \"object\") {\n          query[key] = JSON.stringify(query[key]);\n        }\n      }\n\n      return `${url}?${new URLSearchParams(\n        query as Record<string, string>,\n      ).toString()}`;\n    }\n    return url;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface FetchOptions<T extends TSchema = TSchema> {\n  /**\n   * Key to identify the request in the pending requests.\n   */\n  key?: string;\n\n  /**\n   * The schema to validate the response against.\n   */\n  schema?: {\n    response?: T;\n  };\n\n  /**\n   * Built-in cache options.\n   */\n  localCache?: boolean | number | DurationLike;\n}\n\nexport type RequestInitWithOptions<T extends TSchema = TSchema> = RequestInit &\n  FetchOptions<T>;\n\nexport interface FetchResponse<T = any> {\n  data: T;\n  status: number;\n  statusText: string;\n  headers: Headers;\n  raw?: Response;\n}\n\nexport type HttpClientPendingRequests = Record<\n  string,\n  Promise<any> | undefined\n>;\n\ninterface HttpClientCache {\n  data: any;\n  etag?: string;\n}\n\nexport interface FetchActionArgs {\n  action: HttpAction;\n  host?: string;\n  config?: ServerRequestConfigEntry;\n  options?: ClientRequestOptions;\n}\n\nexport interface HttpAction {\n  method?: string;\n  prefix?: string;\n  path: string;\n  requestBodyType?: string;\n  schema?: {\n    params?: TObject;\n    query?: TObject;\n    body?: TRequestBody;\n    response?: TResponseBody;\n  };\n}\n","export const routeMethods = [\n  // list of supported http methods\n  \"GET\",\n  \"POST\",\n  \"PUT\",\n  \"PATCH\",\n  \"DELETE\",\n  \"HEAD\",\n  \"OPTIONS\",\n  \"CONNECT\",\n  \"TRACE\",\n] as const;\n\nexport type RouteMethod = (typeof routeMethods)[number];\n","import { HttpError } from \"./HttpError.ts\";\n\nexport class BadRequestError extends HttpError {\n  constructor(message = \"Invalid request body\", cause?: unknown) {\n    super(\n      {\n        message,\n        status: 400,\n      },\n      cause,\n    );\n  }\n}\n","import { HttpError } from \"./HttpError.ts\";\n\nexport class ConflictError extends HttpError {\n  constructor(message = \"Entity already exists\", cause?: unknown) {\n    super(\n      {\n        message,\n        status: 409,\n      },\n      cause,\n    );\n  }\n}\n","import { HttpError } from \"./HttpError.ts\";\n\nexport class ForbiddenError extends HttpError {\n  constructor(\n    message = \"No permission to access this resource\",\n    cause?: unknown,\n  ) {\n    super(\n      {\n        message,\n        status: 403,\n      },\n      cause,\n    );\n  }\n}\n","import { HttpError } from \"./HttpError.ts\";\n\nexport class NotFoundError extends HttpError {\n  constructor(message = \"Resource not found\", cause?: unknown) {\n    super(\n      {\n        message,\n        status: 404,\n      },\n      cause,\n    );\n  }\n}\n","import { HttpError } from \"./HttpError.ts\";\n\nexport class UnauthorizedError extends HttpError {\n  readonly name = \"UnauthorizedError\";\n\n  constructor(\n    message = \"Not allowed to access this resource\",\n    cause?: unknown,\n  ) {\n    super(\n      {\n        message,\n        status: 401,\n      },\n      cause,\n    );\n  }\n}\n","import { HttpError } from \"./HttpError.ts\";\n\nexport class ValidationError extends HttpError {\n  constructor(message = \"Validation has failed\", cause?: unknown) {\n    super(\n      {\n        message,\n        status: 400,\n      },\n      cause,\n    );\n  }\n}\n","/**\n * Helper for building server replies.\n */\nexport class ServerReply {\n  // TODO: make it private\n  public headers: Record<string, string> & {\n    \"set-cookie\"?: string[];\n  } = {};\n\n  public status?: number; // default 200, or 204 (no content)\n\n  public body?: any;\n\n  /**\n   * Redirect to a given URL with optional status code (default 302).\n   */\n  public redirect(url: string, status: number = 302): void {\n    this.status = status;\n    this.headers.location = url;\n  }\n\n  // TODO: check if status / header is already set and throw an error if so (for allow to override with force flag)\n\n  /**\n   * Set the response status code.\n   */\n  public setStatus(status: number): this {\n    this.status = status;\n    return this;\n  }\n\n  /**\n   * Set a response header.\n   */\n  public setHeader(name: string, value: string): this {\n    this.headers[name.toLowerCase()] = value;\n    return this;\n  }\n\n  /**\n   * Set the response body.\n   */\n  public setBody(body: any): this {\n    this.body = body;\n    return this;\n  }\n}\n","import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\n\nexport const okSchema = t.object(\n  {\n    ok: t.boolean({ description: \"True when operation succeed\" }),\n    id: t.optional(t.union([t.text(), t.integer()])),\n    count: t.optional(\n      t.number({ description: \"Number of resources affected\" }),\n    ),\n  },\n  {\n    title: \"Ok\",\n    description: \"Generic response after a successful operation on a resource\",\n  },\n);\n\nexport type Ok = Static<typeof okSchema>;\n","import { $module } from \"alepha\";\nimport { HttpClient } from \"./services/HttpClient.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./index.shared.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const AlephaServer = $module({\n  name: \"alepha.server\",\n  descriptors: [],\n  services: [HttpClient],\n});\n"],"mappings":"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"}
+{"version":3,"file":"index.browser.js","names":["json: Record<string, unknown>","errorNameByStatus: Record<number, string>","properties: Record<string, any>","request: RequestInit","headers: Record<string, string>","fetchResponse: FetchResponse"],"sources":["../../src/server/errors/HttpError.ts","../../src/server/helpers/isMultipart.ts","../../src/server/schemas/errorSchema.ts","../../src/server/services/HttpClient.ts","../../src/server/constants/routeMethods.ts","../../src/server/errors/BadRequestError.ts","../../src/server/errors/ConflictError.ts","../../src/server/errors/ForbiddenError.ts","../../src/server/errors/NotFoundError.ts","../../src/server/errors/UnauthorizedError.ts","../../src/server/errors/ValidationError.ts","../../src/server/helpers/ServerReply.ts","../../src/server/schemas/okSchema.ts","../../src/server/index.browser.ts"],"sourcesContent":["import { AlephaError } from \"alepha\";\nimport type { ErrorSchema } from \"../schemas/errorSchema.ts\";\n\nexport const isHttpError = (\n  error: unknown,\n  status?: number,\n): error is HttpErrorLike => {\n  const isError =\n    !!error &&\n    typeof error === \"object\" &&\n    \"message\" in error &&\n    typeof error.message === \"string\" &&\n    \"status\" in error &&\n    typeof error.status === \"number\";\n\n  if (!isError) {\n    return false;\n  }\n\n  if (status) {\n    return (error as HttpErrorLike).status === status;\n  }\n\n  return true;\n};\n\nexport class HttpError extends AlephaError {\n  public name = \"HttpError\";\n\n  static is = isHttpError;\n\n  static toJSON(error: HttpError): ErrorSchema {\n    const json: Record<string, unknown> = {\n      error: error.error,\n      status: error.status,\n      message: error.message,\n    };\n\n    if (error.details) json.details = error.details;\n    if (error.requestId) json.requestId = error.requestId;\n    if (error.reason) json.cause = error.reason;\n\n    return json as ErrorSchema;\n  }\n\n  public readonly error: string;\n  public readonly status: number;\n\n  public readonly requestId?: string;\n  public readonly details?: string;\n  public readonly reason?: {\n    name: string;\n    message: string;\n  };\n\n  constructor(options: Partial<ErrorSchema>, cause?: unknown) {\n    super(options.message, {\n      cause,\n    });\n\n    this.status = options.status ?? 500;\n    this.details = options.details;\n    this.requestId = options.requestId;\n\n    if (typeof options.cause === \"object\") {\n      this.reason = {\n        name: (options.cause as { name: string }).name,\n        message: (options.cause as { message: string }).message,\n      };\n    } else if (cause instanceof Error) {\n      this.reason = {\n        name: cause.name,\n        message: cause.message,\n      };\n    }\n\n    if (this.constructor.name === \"HttpError\") {\n      this.error =\n        options.error ?? errorNameByStatus[this.status] ?? \"HttpError\";\n    } else {\n      this.error = this.constructor.name;\n    }\n  }\n}\n\nexport const errorNameByStatus: Record<number, string> = {\n  400: \"BadRequestError\",\n  401: \"UnauthorizedError\",\n  403: \"ForbiddenError\",\n  404: \"NotFoundError\",\n  405: \"MethodNotAllowedError\",\n  409: \"ConflictError\",\n  410: \"GoneError\",\n  413: \"PayloadTooLargeError\",\n  415: \"UnsupportedMediaTypeError\",\n  429: \"TooManyRequestsError\",\n  500: \"InternalServerError\",\n  501: \"NotImplementedError\",\n  502: \"BadGatewayError\",\n  503: \"ServiceUnavailableError\",\n  504: \"GatewayTimeoutError\",\n};\n\nexport interface HttpErrorLike extends Error {\n  status: number;\n}\n","import type { RequestConfigSchema } from \"../interfaces/ServerRequest.ts\";\n\n/**\n * Checks if the route has multipart/form-data request body.\n */\nexport const isMultipart = (options: {\n  schema?: RequestConfigSchema;\n  requestBodyType?: string;\n}): boolean => {\n  if (options.requestBodyType === \"multipart/form-data\") {\n    return true;\n  }\n\n  if (options.schema?.body && \"properties\" in options.schema.body) {\n    const properties: Record<string, any> = options.schema.body.properties;\n    for (const key in properties) {\n      if (properties[key].format === \"binary\") {\n        return true;\n      }\n    }\n  }\n\n  return false;\n};\n","import { type Static, t } from \"alepha\";\n\nexport const errorSchema = t.object(\n  {\n    error: t.text({ description: \"HTTP error name\" }),\n    status: t.integer({\n      description: \"HTTP status code\",\n    }),\n    message: t.text({\n      description: \"Short text which describe the error\",\n      size: \"rich\",\n    }),\n    details: t.optional(\n      t.text({\n        description: \"Detailed description of the error\",\n        size: \"rich\",\n      }),\n    ),\n    requestId: t.optional(t.text()),\n    cause: t.optional(\n      t.object({\n        name: t.text(),\n        message: t.text({\n          description: \"Cause Error message\",\n          size: \"rich\",\n        }),\n      }),\n    ),\n  },\n  {\n    title: \"HttpError\",\n    description: \"Generic response after a failed operation\",\n  },\n);\n\nexport type ErrorSchema = Static<typeof errorSchema>;\n","import {\n  $inject,\n  Alepha,\n  type FileLike,\n  isFileLike,\n  type Static,\n  type TObject,\n  type TSchema,\n} from \"alepha\";\nimport { $cache } from \"alepha/cache\";\nimport type { DurationLike } from \"alepha/datetime\";\nimport { $logger } from \"alepha/logger\";\nimport { HttpError } from \"../errors/HttpError.ts\";\nimport { isMultipart } from \"../helpers/isMultipart.ts\";\nimport type {\n  ServerRequestConfigEntry,\n  TRequestBody,\n  TResponseBody,\n} from \"../interfaces/ServerRequest.ts\";\nimport type { ClientRequestOptions } from \"../primitives/$action.ts\";\nimport { errorSchema } from \"../schemas/errorSchema.ts\";\n\nexport class HttpClient {\n  protected readonly log = $logger();\n  protected readonly alepha = $inject(Alepha);\n\n  public readonly cache = $cache<HttpClientCache>();\n\n  protected readonly pendingRequests: HttpClientPendingRequests = {};\n\n  public async fetchAction(args: FetchActionArgs): Promise<FetchResponse> {\n    const route = args.action; // our link to fetch\n    const options = args.options ?? {}; // fetch standard options, cache, etc.\n    const config = args.config ?? {}; // params, query, body, etc.\n    const host = args.host ?? \"\"; // remote host, e.g. \"https://api.example.com\" or empty (for browser)\n\n    const request: RequestInit = {\n      ...options.request,\n    };\n\n    const method = route.method;\n    const headers: Record<string, string> = {};\n    const url = this.url(host, route, config);\n\n    await this.alepha.events.emit(\"client:onRequest\", {\n      route,\n      config,\n      options,\n      headers,\n      request,\n    });\n\n    request.method ??= method;\n\n    await this.body(request, headers, route, config);\n\n    request.headers = {\n      ...config.headers,\n      ...Object.fromEntries(new Headers(request.headers).entries()),\n      ...headers,\n    };\n\n    return await this.fetch(url, {\n      ...request,\n      schema: route.schema,\n      ...options,\n    });\n  }\n\n  public async fetch<T extends TSchema>(\n    url: string,\n    request: RequestInitWithOptions<T> = {}, // standard options\n  ): Promise<FetchResponse<Static<T>>> {\n    const options = {\n      cache: request.localCache,\n      schema: request.schema?.response,\n      key: request.key,\n    };\n\n    request.method ??= \"GET\";\n\n    this.log.trace(\"Request\", {\n      url,\n      method: request.method,\n      body: request.body,\n      headers: request.headers,\n      options,\n    });\n\n    // Only add automatic ETag if user didn't explicitly provide headers\n    const cached = await this.cache.get(url);\n    if (cached && request.method === \"GET\") {\n      if (cached.etag) {\n        request.headers = new Headers(request.headers);\n        if (!request.headers.has(\"if-none-match\")) {\n          request.headers.set(\"if-none-match\", cached.etag);\n        }\n      } else {\n        return {\n          data: cached.data as Static<T>,\n          status: 200,\n          statusText: \"OK\",\n          headers: new Headers(),\n        };\n      }\n    }\n\n    await this.alepha.events.emit(\"client:beforeFetch\", {\n      url,\n      options,\n      request,\n    });\n\n    // make a key for the request\n    // this will be used to check if the request is already pending\n    const key =\n      options.key ??\n      JSON.stringify({\n        url,\n        method: request.method,\n        body: request.body,\n      });\n\n    const existing = this.pendingRequests[key];\n    if (existing) {\n      this.log.info(\"Request already pending\", key);\n      return existing;\n    }\n\n    this.pendingRequests[key] = fetch(url, request)\n      .then(async (response) => {\n        this.log.debug(\"Response\", {\n          url,\n          status: response.status,\n        });\n\n        const fetchResponse: FetchResponse = {\n          data: await this.responseData(response, options),\n          status: response.status,\n          statusText: response.statusText,\n          headers: response.headers,\n          raw: response,\n        };\n\n        if (request.method === \"GET\") {\n          if (options.cache) {\n            await this.cache.set(\n              url,\n              { data: fetchResponse.data },\n              typeof options.cache === \"boolean\" ? undefined : options.cache,\n            );\n          } else if (!this.alepha.isBrowser()) {\n            // only cache etag on server, browser can handle etag itself\n            const etag = response.headers.get(\"etag\") ?? undefined;\n            if (etag) {\n              await this.cache.set(url, { data: fetchResponse.data, etag });\n            }\n          }\n        }\n\n        return fetchResponse;\n      })\n      .finally(() => {\n        delete this.pendingRequests[key];\n      });\n\n    return this.pendingRequests[key];\n  }\n\n  protected url(\n    host: string,\n    action: HttpAction,\n    args: ServerRequestConfigEntry,\n  ) {\n    let url = host;\n\n    if (action.prefix) {\n      url += action.prefix;\n    }\n\n    url += action.path;\n    url = this.pathVariables(url, action, args);\n    url = this.queryParams(url, action, args);\n\n    return url;\n  }\n\n  protected async body(\n    init: RequestInit,\n    headers: Record<string, string>,\n    action: HttpAction,\n    args: ServerRequestConfigEntry = {},\n  ) {\n    const hasHeader =\n      typeof init.headers === \"object\" &&\n      \"content-type\" in init.headers &&\n      init.headers[\"content-type\"] === \"multipart/form-data\";\n\n    if (hasHeader || isMultipart(action)) {\n      if (typeof init.headers === \"object\" && \"content-type\" in init.headers) {\n        delete init.headers[\"content-type\"]; // fetch() will fill this for us\n      }\n\n      const formData = new FormData();\n\n      for (const [key, value] of Object.entries(args.body ?? {})) {\n        if (typeof value === \"string\") {\n          formData.append(key, value);\n          continue;\n        }\n        if (value instanceof Blob) {\n          formData.append(key, value);\n          continue;\n        }\n        if (isFileLike(value)) {\n          // FileLike must be transformed to WebFile\n          formData.append(\n            key,\n            new File([await value.arrayBuffer()], value.name, {\n              type: value.type,\n            }),\n          );\n        }\n      }\n\n      init.body = formData;\n\n      return;\n    }\n\n    if (!init.body && action.schema?.body) {\n      headers[\"content-type\"] = \"application/json\";\n      init.body = this.alepha.codec.encode(action.schema?.body, args.body, {\n        as: \"string\",\n      });\n    }\n  }\n\n  protected async responseData(\n    response: Response,\n    options: FetchOptions,\n  ): Promise<any> {\n    if (response.status === 304) {\n      let cacheKey = response.url;\n      if (typeof window !== \"undefined\") {\n        cacheKey = cacheKey.replace(window.location.origin, \"\");\n      }\n\n      const cached = await this.cache.get(cacheKey);\n      if (cached) {\n        return cached.data;\n      }\n\n      // if no cached data (etag-only routes), return empty string\n      return \"\";\n    }\n\n    if (response.status === 204) {\n      return;\n    }\n\n    if (this.isMaybeFile(response)) {\n      return this.createFileLike(response);\n    }\n\n    if (response.headers.get(\"Content-Type\")?.startsWith(\"text/\")) {\n      return await response.text();\n    }\n\n    if (response.headers.get(\"Content-Type\") === \"application/json\") {\n      const json = await response.json();\n\n      if (response.status >= 400) {\n        const jsonError = this.alepha.codec.decode(errorSchema, json);\n        const error = new HttpError(jsonError);\n\n        await this.alepha.events.emit(\"client:onError\", {\n          error,\n        });\n\n        throw error;\n      }\n\n      if (options.schema) {\n        return this.alepha.codec.decode(options.schema, json);\n      }\n\n      return json;\n    }\n\n    if (response.status >= 400) {\n      const error = new HttpError({\n        status: response.status,\n        message: `An error occurred while fetching the resource. (${response.statusText})`,\n      });\n\n      await this.alepha.events.emit(\"client:onError\", {\n        error,\n      });\n\n      throw error;\n    }\n\n    return response;\n  }\n\n  protected isMaybeFile(response: Response): boolean {\n    const contentType = response.headers.get(\"Content-Type\");\n    if (!contentType) {\n      return false;\n    }\n\n    if (response.headers.get(\"Content-Disposition\")?.includes(\"attachment\")) {\n      return true; // If Content-Disposition indicates an attachment, treat it as a file\n    }\n\n    return (\n      contentType.startsWith(\"application/octet-stream\") ||\n      contentType.startsWith(\"application/pdf\") ||\n      contentType.startsWith(\"application/zip\") ||\n      contentType.startsWith(\"image/\") ||\n      contentType.startsWith(\"video/\") ||\n      contentType.startsWith(\"audio/\")\n    );\n  }\n\n  protected createFileLike(response: Response, defaultFileName = \"\"): FileLike {\n    const match = (response.headers.get(\"Content-Disposition\") ?? \"\").match(\n      /filename=\"(.+)\"/,\n    );\n    return {\n      name: match?.[1] ? match[1] : defaultFileName,\n      type: response.headers.get(\"Content-Type\") ?? \"application/octet-stream\",\n      size: Number(response.headers.get(\"Content-Length\") ?? 0),\n      lastModified: Date.now(),\n      stream: () => {\n        throw new Error(\"Not implemented\");\n      },\n      arrayBuffer: async () => {\n        return await response.arrayBuffer();\n      },\n      text: async () => {\n        return await response.text();\n      },\n    };\n  }\n\n  public pathVariables(\n    url: string,\n    action: { schema?: { params?: TObject } },\n    args: ServerRequestConfigEntry = {},\n  ): string {\n    if (typeof args.params === \"object\") {\n      const params = action.schema?.params\n        ? (this.alepha.codec.decode(\n            action.schema.params,\n            args.params,\n          ) as Record<string, any>)\n        : args.params;\n\n      for (const key of Object.keys(params)) {\n        url = url.replace(`:${key}`, params[key]);\n        url = url.replace(`{${key}}`, params[key]);\n      }\n    }\n\n    return url;\n  }\n\n  public queryParams(\n    url: string,\n    action: { schema?: { query?: TObject } },\n    args: ServerRequestConfigEntry = {},\n  ): string {\n    if (typeof args.query === \"object\") {\n      const query = action.schema?.query\n        ? this.alepha.codec.decode(action.schema.query, args.query ?? {})\n        : args.query;\n\n      for (const key of Object.keys(query)) {\n        if (query[key] === undefined) {\n          delete query[key];\n        }\n        if (typeof query[key] === \"object\") {\n          query[key] = JSON.stringify(query[key]);\n        }\n      }\n\n      return `${url}?${new URLSearchParams(\n        query as Record<string, string>,\n      ).toString()}`;\n    }\n    return url;\n  }\n}\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport interface FetchOptions<T extends TSchema = TSchema> {\n  /**\n   * Key to identify the request in the pending requests.\n   */\n  key?: string;\n\n  /**\n   * The schema to validate the response against.\n   */\n  schema?: {\n    response?: T;\n  };\n\n  /**\n   * Built-in cache options.\n   */\n  localCache?: boolean | number | DurationLike;\n}\n\nexport type RequestInitWithOptions<T extends TSchema = TSchema> = RequestInit &\n  FetchOptions<T>;\n\nexport interface FetchResponse<T = any> {\n  data: T;\n  status: number;\n  statusText: string;\n  headers: Headers;\n  raw?: Response;\n}\n\nexport type HttpClientPendingRequests = Record<\n  string,\n  Promise<any> | undefined\n>;\n\ninterface HttpClientCache {\n  data: any;\n  etag?: string;\n}\n\nexport interface FetchActionArgs {\n  action: HttpAction;\n  host?: string;\n  config?: ServerRequestConfigEntry;\n  options?: ClientRequestOptions;\n}\n\nexport interface HttpAction {\n  method?: string;\n  prefix?: string;\n  path: string;\n  requestBodyType?: string;\n  schema?: {\n    params?: TObject;\n    query?: TObject;\n    body?: TRequestBody;\n    response?: TResponseBody;\n  };\n}\n","export const routeMethods = [\n  // list of supported http methods\n  \"GET\",\n  \"POST\",\n  \"PUT\",\n  \"PATCH\",\n  \"DELETE\",\n  \"HEAD\",\n  \"OPTIONS\",\n  \"CONNECT\",\n  \"TRACE\",\n] as const;\n\nexport type RouteMethod = (typeof routeMethods)[number];\n","import { HttpError } from \"./HttpError.ts\";\n\nexport class BadRequestError extends HttpError {\n  constructor(message = \"Invalid request body\", cause?: unknown) {\n    super(\n      {\n        message,\n        status: 400,\n      },\n      cause,\n    );\n  }\n}\n","import { HttpError } from \"./HttpError.ts\";\n\nexport class ConflictError extends HttpError {\n  constructor(message = \"Entity already exists\", cause?: unknown) {\n    super(\n      {\n        message,\n        status: 409,\n      },\n      cause,\n    );\n  }\n}\n","import { HttpError } from \"./HttpError.ts\";\n\nexport class ForbiddenError extends HttpError {\n  constructor(\n    message = \"No permission to access this resource\",\n    cause?: unknown,\n  ) {\n    super(\n      {\n        message,\n        status: 403,\n      },\n      cause,\n    );\n  }\n}\n","import { HttpError } from \"./HttpError.ts\";\n\nexport class NotFoundError extends HttpError {\n  constructor(message = \"Resource not found\", cause?: unknown) {\n    super(\n      {\n        message,\n        status: 404,\n      },\n      cause,\n    );\n  }\n}\n","import { HttpError } from \"./HttpError.ts\";\n\nexport class UnauthorizedError extends HttpError {\n  readonly name = \"UnauthorizedError\";\n\n  constructor(\n    message = \"Not allowed to access this resource\",\n    cause?: unknown,\n  ) {\n    super(\n      {\n        message,\n        status: 401,\n      },\n      cause,\n    );\n  }\n}\n","import { HttpError } from \"./HttpError.ts\";\n\nexport class ValidationError extends HttpError {\n  constructor(message = \"Validation has failed\", cause?: unknown) {\n    super(\n      {\n        message,\n        status: 400,\n      },\n      cause,\n    );\n  }\n}\n","/**\n * Helper for building server replies.\n */\nexport class ServerReply {\n  // TODO: make it private\n  public headers: Record<string, string> & {\n    \"set-cookie\"?: string[];\n  } = {};\n\n  public status?: number; // default 200, or 204 (no content)\n\n  public body?: any;\n\n  /**\n   * Redirect to a given URL with optional status code (default 302).\n   */\n  public redirect(url: string, status: number = 302): void {\n    this.status = status;\n    this.headers.location = url;\n  }\n\n  // TODO: check if status / header is already set and throw an error if so (for allow to override with force flag)\n\n  /**\n   * Set the response status code.\n   */\n  public setStatus(status: number): this {\n    this.status = status;\n    return this;\n  }\n\n  /**\n   * Set a response header.\n   */\n  public setHeader(name: string, value: string): this {\n    this.headers[name.toLowerCase()] = value;\n    return this;\n  }\n\n  /**\n   * Set the response body.\n   */\n  public setBody(body: any): this {\n    this.body = body;\n    return this;\n  }\n}\n","import type { Static } from \"alepha\";\nimport { t } from \"alepha\";\n\nexport const okSchema = t.object(\n  {\n    ok: t.boolean({ description: \"True when operation succeed\" }),\n    id: t.optional(t.union([t.text(), t.integer()])),\n    count: t.optional(\n      t.number({ description: \"Number of resources affected\" }),\n    ),\n  },\n  {\n    title: \"Ok\",\n    description: \"Generic response after a successful operation on a resource\",\n  },\n);\n\nexport type Ok = Static<typeof okSchema>;\n","import { $module } from \"alepha\";\nimport { HttpClient } from \"./services/HttpClient.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport * from \"./index.shared.ts\";\n\n// ---------------------------------------------------------------------------------------------------------------------\n\nexport const AlephaServer = $module({\n  name: \"alepha.server\",\n  primitives: [],\n  services: [HttpClient],\n});\n"],"mappings":"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"}

package/dist/server/index.d.ts

@@ -1,6 +1,6 @@
-import * as alepha1 from "alepha";
-import { Alepha, AlephaError, Async, Descriptor, FileLike, KIND, Static, StreamLike, TArray, TFile, TObject, TRecord, TSchema, TStream, TString, TVoid } from "alepha";
-import * as alepha_logger0 from "alepha/logger";
+import * as alepha19 from "alepha";
+import { Alepha, AlephaError, Async, FileLike, KIND, Primitive, Static, StreamLike, TArray, TFile, TObject, TRecord, TSchema, TStream, TString, TVoid } from "alepha";
+import * as alepha_logger6 from "alepha/logger";
 import { Readable } from "node:stream";
 import { DateTimeProvider, DurationLike } from "alepha/datetime";
 import { ReadableStream } from "node:stream/web";
@@ -8,6 +8,41 @@ import { Route, RouterProvider } from "alepha/router";
 import * as alepha_cache0 from "alepha/cache";
 import { IncomingMessage, Server, ServerResponse as ServerResponse$1 } from "node:http";
 
+//#region src/server/schemas/errorSchema.d.ts
+declare const errorSchema: alepha19.TObject<{
+  error: alepha19.TString;
+  status: alepha19.TInteger;
+  message: alepha19.TString;
+  details: alepha19.TOptional<alepha19.TString>;
+  requestId: alepha19.TOptional<alepha19.TString>;
+  cause: alepha19.TOptional<alepha19.TObject<{
+    name: alepha19.TString;
+    message: alepha19.TString;
+  }>>;
+}>;
+type ErrorSchema = Static<typeof errorSchema>;
+//#endregion
+//#region src/server/errors/HttpError.d.ts
+declare const isHttpError: (error: unknown, status?: number) => error is HttpErrorLike;
+declare class HttpError extends AlephaError {
+  name: string;
+  static is: (error: unknown, status?: number) => error is HttpErrorLike;
+  static toJSON(error: HttpError): ErrorSchema;
+  readonly error: string;
+  readonly status: number;
+  readonly requestId?: string;
+  readonly details?: string;
+  readonly reason?: {
+    name: string;
+    message: string;
+  };
+  constructor(options: Partial<ErrorSchema>, cause?: unknown);
+}
+declare const errorNameByStatus: Record<number, string>;
+interface HttpErrorLike extends Error {
+  status: number;
+}
+//#endregion
 //#region src/server/constants/routeMethods.d.ts
 declare const routeMethods: readonly ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS", "CONNECT", "TRACE"];
 type RouteMethod = (typeof routeMethods)[number];
@@ -191,14 +226,14 @@ declare class ServerRequestParser {
 //#region src/server/providers/ServerTimingProvider.d.ts
 type TimingMap = Record<string, [number, number]>;
 declare class ServerTimingProvider {
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: alepha_logger6.Logger;
   protected readonly alepha: Alepha;
   options: {
     prefix: string;
     disabled: boolean;
   };
-  readonly onRequest: alepha1.HookDescriptor<"server:onRequest">;
-  readonly onResponse: alepha1.HookDescriptor<"server:onResponse">;
+  readonly onRequest: alepha19.HookPrimitive<"server:onRequest">;
+  readonly onResponse: alepha19.HookPrimitive<"server:onResponse">;
   protected get handlerName(): string;
   beginTiming(name: string): void;
   endTiming(name: string): void;
@@ -214,7 +249,7 @@ declare class ServerTimingProvider {
  * - $page => React route (for SSR)
  */
 declare class ServerRouterProvider extends RouterProvider<ServerRouteMatcher> {
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: alepha_logger6.Logger;
   protected readonly alepha: Alepha;
   protected readonly routes: ServerRoute[];
   protected readonly serverTimingProvider: ServerTimingProvider;
@@ -253,7 +288,7 @@ declare class ServerRouterProvider extends RouterProvider<ServerRouteMatcher> {
  * ServerProvider supports both Node.js HTTP requests and Web (Fetch API) requests.
  */
 declare class ServerProvider {
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: alepha_logger6.Logger;
   protected readonly alepha: Alepha;
   protected readonly dateTimeProvider: DateTimeProvider;
   protected readonly router: ServerRouterProvider;
@@ -262,11 +297,11 @@ declare class ServerProvider {
   /**
    * When a Node.js HTTP request is received from outside. (Vercel, AWS Lambda, etc.)
    */
-  protected readonly onNodeRequest: alepha1.HookDescriptor<"node:request">;
+  protected readonly onNodeRequest: alepha19.HookPrimitive<"node:request">;
   /**
    * When a Web (Fetch API) request is received from outside. (Netlify, Cloudflare Workers, etc.)
    */
-  protected readonly onWebRequest: alepha1.HookDescriptor<"web:request">;
+  protected readonly onWebRequest: alepha19.HookPrimitive<"web:request">;
   /**
    * Handle Node.js HTTP request event.
    *
@@ -285,9 +320,9 @@ declare class ServerProvider {
 //#endregion
 //#region src/server/services/HttpClient.d.ts
 declare class HttpClient {
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: alepha_logger6.Logger;
   protected readonly alepha: Alepha;
-  readonly cache: alepha_cache0.CacheDescriptorFn<HttpClientCache, any[]>;
+  readonly cache: alepha_cache0.CachePrimitiveFn<HttpClientCache, any[]>;
   protected readonly pendingRequests: HttpClientPendingRequests;
   fetchAction(args: FetchActionArgs): Promise<FetchResponse>;
   fetch<T extends TSchema>(url: string, request?: RequestInitWithOptions<T>): Promise<FetchResponse<Static<T>>>;
@@ -355,9 +390,9 @@ interface HttpAction {
   };
 }
 //#endregion
-//#region src/server/descriptors/$action.d.ts
+//#region src/server/primitives/$action.d.ts
 /**
- * Creates a server action descriptor for defining type-safe HTTP endpoints.
+ * Creates a server action primitive for defining type-safe HTTP endpoints.
  *
  * Server actions are the core building blocks for REST APIs in Alepha, providing declarative
  * HTTP endpoints with full type safety, automatic validation, and OpenAPI documentation.
@@ -422,10 +457,10 @@ interface HttpAction {
  * ```
  */
 declare const $action: {
-  <TConfig extends RequestConfigSchema>(options: ActionDescriptorOptions<TConfig>): ActionDescriptorFn<TConfig>;
-  [KIND]: typeof ActionDescriptor;
+  <TConfig extends RequestConfigSchema>(options: ActionPrimitiveOptions<TConfig>): ActionPrimitiveFn<TConfig>;
+  [KIND]: typeof ActionPrimitive;
 };
-interface ActionDescriptorOptions<TConfig extends RequestConfigSchema> extends Omit<ServerRoute, "handler" | "path" | "schema" | "mapParams"> {
+interface ActionPrimitiveOptions<TConfig extends RequestConfigSchema> extends Omit<ServerRoute, "handler" | "path" | "schema" | "mapParams"> {
   /**
    * Name of the action.
    *
@@ -491,8 +526,8 @@ interface ActionDescriptorOptions<TConfig extends RequestConfigSchema> extends O
    */
   handler: ServerActionHandler<TConfig>;
 }
-declare class ActionDescriptor<TConfig extends RequestConfigSchema> extends Descriptor<ActionDescriptorOptions<TConfig>> {
-  protected readonly log: alepha_logger0.Logger;
+declare class ActionPrimitive<TConfig extends RequestConfigSchema> extends Primitive<ActionPrimitiveOptions<TConfig>> {
+  protected readonly log: alepha_logger6.Logger;
   protected readonly env: {
     SERVER_API_PREFIX: string;
   };
@@ -532,7 +567,7 @@ declare class ActionDescriptor<TConfig extends RequestConfigSchema> extends Desc
    */
   fetch(config?: ClientRequestEntry<TConfig>, options?: ClientRequestOptions): Promise<FetchResponse<ClientRequestResponse<TConfig>>>;
 }
-interface ActionDescriptorFn<TConfig extends RequestConfigSchema> extends ActionDescriptor<TConfig> {
+interface ActionPrimitiveFn<TConfig extends RequestConfigSchema> extends ActionPrimitive<TConfig> {
   (config?: ClientRequestEntry<TConfig>, options?: ClientRequestOptions): Promise<ClientRequestResponse<TConfig>>;
 }
 type ClientRequestEntry<TConfig extends RequestConfigSchema, T = ClientRequestEntryContainer<TConfig>> = { [K in keyof T as T[K] extends undefined ? never : K]: T[K] };
@@ -562,60 +597,6 @@ type ServerActionHandler<TConfig extends RequestConfigSchema = RequestConfigSche
  */
 interface ServerActionRequest<TConfig extends RequestConfigSchema> extends ServerRequest<TConfig> {}
 //#endregion
-//#region src/server/schemas/errorSchema.d.ts
-declare const errorSchema: alepha1.TObject<{
-  error: alepha1.TString;
-  status: alepha1.TInteger;
-  message: alepha1.TString;
-  details: alepha1.TOptional<alepha1.TString>;
-  requestId: alepha1.TOptional<alepha1.TString>;
-  cause: alepha1.TOptional<alepha1.TObject<{
-    name: alepha1.TString;
-    message: alepha1.TString;
-  }>>;
-}>;
-type ErrorSchema = Static<typeof errorSchema>;
-//#endregion
-//#region src/server/errors/HttpError.d.ts
-declare const isHttpError: (error: unknown, status?: number) => error is HttpErrorLike;
-declare class HttpError extends AlephaError {
-  name: string;
-  static is: (error: unknown, status?: number) => error is HttpErrorLike;
-  static toJSON(error: HttpError): ErrorSchema;
-  readonly error: string;
-  readonly status: number;
-  readonly requestId?: string;
-  readonly details?: string;
-  readonly reason?: {
-    name: string;
-    message: string;
-  };
-  constructor(options: Partial<ErrorSchema>, cause?: unknown);
-}
-declare const errorNameByStatus: Record<number, string>;
-interface HttpErrorLike extends Error {
-  status: number;
-}
-//#endregion
-//#region src/server/descriptors/$route.d.ts
-/**
- * Create a basic endpoint.
- *
- * It's a low level descriptor. You probably want to use `$action` instead.
- *
- * @see {@link $action}
- * @see {@link $page}
- */
-declare const $route: {
-  <TConfig extends RequestConfigSchema>(options: RouteDescriptorOptions<TConfig>): RouteDescriptor<TConfig>;
-  [KIND]: typeof RouteDescriptor;
-};
-interface RouteDescriptorOptions<TConfig extends RequestConfigSchema = RequestConfigSchema> extends ServerRoute<TConfig> {}
-declare class RouteDescriptor<TConfig extends RequestConfigSchema> extends Descriptor<RouteDescriptorOptions<TConfig>> {
-  protected readonly serverRouterProvider: ServerRouterProvider;
-  protected onInit(): void;
-}
-//#endregion
 //#region src/server/errors/BadRequestError.d.ts
 declare class BadRequestError extends HttpError {
   constructor(message?: string, cause?: unknown);
@@ -657,17 +638,36 @@ declare const isMultipart: (options: {
 }) => boolean;
 //#endregion
 //#region src/server/schemas/okSchema.d.ts
-declare const okSchema: alepha1.TObject<{
-  ok: alepha1.TBoolean;
-  id: alepha1.TOptional<alepha1.TUnion<[alepha1.TString, alepha1.TInteger]>>;
-  count: alepha1.TOptional<alepha1.TNumber>;
+declare const okSchema: alepha19.TObject<{
+  ok: alepha19.TBoolean;
+  id: alepha19.TOptional<alepha19.TUnion<[alepha19.TString, alepha19.TInteger]>>;
+  count: alepha19.TOptional<alepha19.TNumber>;
 }>;
 type Ok = Static<typeof okSchema>;
 //#endregion
+//#region src/server/primitives/$route.d.ts
+/**
+ * Create a basic endpoint.
+ *
+ * It's a low level primitive. You probably want to use `$action` instead.
+ *
+ * @see {@link $action}
+ * @see {@link $page}
+ */
+declare const $route: {
+  <TConfig extends RequestConfigSchema>(options: RoutePrimitiveOptions<TConfig>): RoutePrimitive<TConfig>;
+  [KIND]: typeof RoutePrimitive;
+};
+interface RoutePrimitiveOptions<TConfig extends RequestConfigSchema = RequestConfigSchema> extends ServerRoute<TConfig> {}
+declare class RoutePrimitive<TConfig extends RequestConfigSchema> extends Primitive<RoutePrimitiveOptions<TConfig>> {
+  protected readonly serverRouterProvider: ServerRouterProvider;
+  protected onInit(): void;
+}
+//#endregion
 //#region src/server/providers/BunHttpServerProvider.d.ts
-declare const envSchema$1: alepha1.TObject<{
-  SERVER_PORT: alepha1.TInteger;
-  SERVER_HOST: alepha1.TString;
+declare const envSchema$1: alepha19.TObject<{
+  SERVER_PORT: alepha19.TInteger;
+  SERVER_HOST: alepha19.TString;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema$1>> {}
@@ -676,7 +676,7 @@ declare const Bun: any;
 declare class BunHttpServerProvider extends ServerProvider {
   protected readonly alepha: Alepha;
   protected readonly dateTimeProvider: DateTimeProvider;
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: alepha_logger6.Logger;
   protected readonly env: {
     SERVER_PORT: number;
     SERVER_HOST: string;
@@ -684,16 +684,16 @@ declare class BunHttpServerProvider extends ServerProvider {
   protected readonly router: ServerRouterProvider;
   protected bunServer?: ReturnType<typeof Bun.serve>;
   get hostname(): string;
-  readonly start: alepha1.HookDescriptor<"start">;
-  protected readonly stop: alepha1.HookDescriptor<"stop">;
+  readonly start: alepha19.HookPrimitive<"start">;
+  protected readonly stop: alepha19.HookPrimitive<"stop">;
   protected listen(): Promise<void>;
   protected close(): Promise<void>;
 }
 //#endregion
 //#region src/server/providers/NodeHttpServerProvider.d.ts
-declare const envSchema: alepha1.TObject<{
-  SERVER_PORT: alepha1.TInteger;
-  SERVER_HOST: alepha1.TString;
+declare const envSchema: alepha19.TObject<{
+  SERVER_PORT: alepha19.TInteger;
+  SERVER_HOST: alepha19.TString;
 }>;
 declare module "alepha" {
   interface Env extends Partial<Static<typeof envSchema>> {}
@@ -701,7 +701,7 @@ declare module "alepha" {
 declare class NodeHttpServerProvider extends ServerProvider {
   protected readonly alepha: Alepha;
   protected readonly dateTimeProvider: DateTimeProvider;
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: alepha_logger6.Logger;
   protected readonly env: {
     SERVER_PORT: number;
     SERVER_HOST: string;
@@ -709,20 +709,20 @@ declare class NodeHttpServerProvider extends ServerProvider {
   protected readonly router: ServerRouterProvider;
   get hostname(): string;
   readonly server: Server<typeof IncomingMessage, typeof ServerResponse$1>;
-  readonly start: alepha1.HookDescriptor<"start">;
+  readonly start: alepha19.HookPrimitive<"start">;
   protected createHttpServer(func: (req: IncomingMessage, res: ServerResponse$1) => void): Server;
-  protected readonly stop: alepha1.HookDescriptor<"stop">;
+  protected readonly stop: alepha19.HookPrimitive<"stop">;
   protected listen(): Promise<void>;
   protected close(): Promise<void>;
 }
 //#endregion
 //#region src/server/providers/ServerLoggerProvider.d.ts
 declare class ServerLoggerProvider {
-  protected readonly log: alepha_logger0.Logger;
+  protected readonly log: alepha_logger6.Logger;
   protected readonly alepha: Alepha;
-  readonly onRequest: alepha1.HookDescriptor<"server:onRequest">;
-  readonly onError: alepha1.HookDescriptor<"server:onError">;
-  readonly onResponse: alepha1.HookDescriptor<"server:onResponse">;
+  readonly onRequest: alepha19.HookPrimitive<"server:onRequest">;
+  readonly onError: alepha19.HookPrimitive<"server:onError">;
+  readonly onResponse: alepha19.HookPrimitive<"server:onResponse">;
 }
 //#endregion
 //#region src/server/providers/ServerNotReadyProvider.d.ts
@@ -735,7 +735,7 @@ declare class ServerLoggerProvider {
  */
 declare class ServerNotReadyProvider {
   protected readonly alepha: Alepha;
-  readonly onRequest: alepha1.HookDescriptor<"server:onRequest">;
+  readonly onRequest: alepha19.HookPrimitive<"server:onRequest">;
 }
 //#endregion
 //#region src/server/index.d.ts
@@ -745,12 +745,12 @@ declare module "alepha" {
   }
   interface Hooks {
     "action:onRequest": {
-      action: ActionDescriptor<RequestConfigSchema>;
+      action: ActionPrimitive<RequestConfigSchema>;
       request: ServerRequest;
       options: ClientRequestOptions;
     };
     "action:onResponse": {
-      action: ActionDescriptor<RequestConfigSchema>;
+      action: ActionPrimitive<RequestConfigSchema>;
       request: ServerRequest;
       options: ClientRequestOptions;
       response: any;
@@ -794,9 +794,9 @@ declare module "alepha" {
   }
 }
 /**
- * Provides high-performance HTTP server capabilities with declarative routing and action descriptors.
+ * Provides high-performance HTTP server capabilities with declarative routing and action primitives.
  *
- * The server module enables building REST APIs and web applications using `$route` and `$action` descriptors
+ * The server module enables building REST APIs and web applications using `$route` and `$action` primitives
  * on class properties. It provides automatic request/response handling, schema validation, middleware support,
  * and seamless integration with other Alepha modules for a complete backend solution.
  *
@@ -804,7 +804,7 @@ declare module "alepha" {
  * @see {@link $action}
  * @module alepha.server
  */
-declare const AlephaServer: alepha1.Service<alepha1.Module>;
+declare const AlephaServer: alepha19.Service<alepha19.Module>;
 //#endregion
-export { $action, $route, ActionDescriptor, ActionDescriptorFn, ActionDescriptorOptions, AlephaServer, BadRequestError, BunHttpServerProvider, ClientRequestEntry, ClientRequestEntryContainer, ClientRequestOptions, ClientRequestResponse, ConflictError, ErrorSchema, FetchActionArgs, FetchOptions, FetchResponse, ForbiddenError, HttpAction, HttpClient, HttpClientPendingRequests, HttpError, HttpErrorLike, NodeHttpServerProvider, NodeRequestEvent, NotFoundError, Ok, RequestConfigSchema, RequestInitWithOptions, ResponseBodyType, ResponseKind, RouteDescriptor, RouteDescriptorOptions, RouteMethod, ServerActionHandler, ServerActionRequest, ServerHandler, ServerLoggerProvider, ServerNotReadyProvider, ServerProvider, ServerRawRequest, ServerReply, ServerRequest, ServerRequestConfig, ServerRequestConfigEntry, ServerRequestData, ServerResponse, ServerResponseBody, ServerRoute, ServerRouteMatcher, ServerRouteRequestHandler, ServerRouterProvider, ServerTimingProvider, TRequestBody, TResponseBody, UnauthorizedError, ValidationError, WebRequestEvent, errorNameByStatus, errorSchema, isHttpError, isMultipart, okSchema, routeMethods };
+export { $action, $route, ActionPrimitive, ActionPrimitiveFn, ActionPrimitiveOptions, AlephaServer, BadRequestError, BunHttpServerProvider, ClientRequestEntry, ClientRequestEntryContainer, ClientRequestOptions, ClientRequestResponse, ConflictError, ErrorSchema, FetchActionArgs, FetchOptions, FetchResponse, ForbiddenError, HttpAction, HttpClient, HttpClientPendingRequests, HttpError, HttpErrorLike, NodeHttpServerProvider, NodeRequestEvent, NotFoundError, Ok, RequestConfigSchema, RequestInitWithOptions, ResponseBodyType, ResponseKind, RouteMethod, RoutePrimitive, RoutePrimitiveOptions, ServerActionHandler, ServerActionRequest, ServerHandler, ServerLoggerProvider, ServerNotReadyProvider, ServerProvider, ServerRawRequest, ServerReply, ServerRequest, ServerRequestConfig, ServerRequestConfigEntry, ServerRequestData, ServerResponse, ServerResponseBody, ServerRoute, ServerRouteMatcher, ServerRouteRequestHandler, ServerRouterProvider, ServerTimingProvider, TRequestBody, TResponseBody, UnauthorizedError, ValidationError, WebRequestEvent, errorNameByStatus, errorSchema, isHttpError, isMultipart, okSchema, routeMethods };
 //# sourceMappingURL=index.d.ts.map

package/dist/server/index.js

@@ -1,4 +1,4 @@
-import { $env, $hook, $inject, $module, Alepha, AlephaError, Descriptor, KIND, createDescriptor, isFileLike, isTypeFile, isUUID, t } from "alepha";
+import { $env, $hook, $inject, $module, Alepha, AlephaError, KIND, Primitive, createPrimitive, isFileLike, isTypeFile, isUUID, t } from "alepha";
 import { $logger } from "alepha/logger";
 import { Readable } from "node:stream";
 import { DateTimeProvider } from "alepha/datetime";
@@ -941,9 +941,9 @@ var HttpClient = class {
 };
 
 //#endregion
-//#region src/server/descriptors/$action.ts
+//#region src/server/primitives/$action.ts
 /**
-* Creates a server action descriptor for defining type-safe HTTP endpoints.
+* Creates a server action primitive for defining type-safe HTTP endpoints.
 *
 * Server actions are the core building blocks for REST APIs in Alepha, providing declarative
 * HTTP endpoints with full type safety, automatic validation, and OpenAPI documentation.
@@ -1008,7 +1008,7 @@ var HttpClient = class {
 * ```
 */
 const $action = (options) => {
-	const instance = createDescriptor(ActionDescriptor, options);
+	const instance = createPrimitive(ActionPrimitive, options);
 	const fn = (config, options$1) => {
 		return instance.run(config, options$1);
 	};
@@ -1021,7 +1021,7 @@ const envSchema$3 = t.object({ SERVER_API_PREFIX: t.text({
 	description: "Prefix for all API routes (e.g. $action).",
 	default: "/api"
 }) });
-var ActionDescriptor = class extends Descriptor {
+var ActionPrimitive = class extends Primitive {
 	log = $logger();
 	env = $env(envSchema$3);
 	httpClient = $inject(HttpClient);
@@ -1134,28 +1134,28 @@ var ActionDescriptor = class extends Descriptor {
 		});
 	}
 };
-$action[KIND] = ActionDescriptor;
+$action[KIND] = ActionPrimitive;
 
 //#endregion
-//#region src/server/descriptors/$route.ts
+//#region src/server/primitives/$route.ts
 /**
 * Create a basic endpoint.
 *
-* It's a low level descriptor. You probably want to use `$action` instead.
+* It's a low level primitive. You probably want to use `$action` instead.
 *
 * @see {@link $action}
 * @see {@link $page}
 */
 const $route = (options) => {
-	return createDescriptor(RouteDescriptor, options);
+	return createPrimitive(RoutePrimitive, options);
 };
-var RouteDescriptor = class extends Descriptor {
+var RoutePrimitive = class extends Primitive {
 	serverRouterProvider = $inject(ServerRouterProvider);
 	onInit() {
 		this.serverRouterProvider.createRoute(this.options);
 	}
 };
-$route[KIND] = RouteDescriptor;
+$route[KIND] = RoutePrimitive;
 
 //#endregion
 //#region src/server/providers/BunHttpServerProvider.ts
@@ -1296,7 +1296,7 @@ var NodeHttpServerProvider = class extends ServerProvider {
 		on: "start",
 		handler: async () => {
 			await this.listen();
-			this.alepha.state.set("alepha.node.server", this.server);
+			this.alepha.store.set("alepha.node.server", this.server);
 		}
 	});
 	createHttpServer(func) {
@@ -1607,9 +1607,9 @@ const okSchema = t.object({
 //#endregion
 //#region src/server/index.ts
 /**
-* Provides high-performance HTTP server capabilities with declarative routing and action descriptors.
+* Provides high-performance HTTP server capabilities with declarative routing and action primitives.
 *
-* The server module enables building REST APIs and web applications using `$route` and `$action` descriptors
+* The server module enables building REST APIs and web applications using `$route` and `$action` primitives
 * on class properties. It provides automatic request/response handling, schema validation, middleware support,
 * and seamless integration with other Alepha modules for a complete backend solution.
 *
@@ -1619,7 +1619,7 @@ const okSchema = t.object({
 */
 const AlephaServer = $module({
 	name: "alepha.server",
-	descriptors: [$route, $action],
+	primitives: [$route, $action],
 	services: [
 		ServerProvider,
 		BunHttpServerProvider,
@@ -1650,5 +1650,5 @@ const AlephaServer = $module({
 });
 
 //#endregion
-export { $action, $route, ActionDescriptor, AlephaServer, BadRequestError, BunHttpServerProvider, ConflictError, ForbiddenError, HttpClient, HttpError, NodeHttpServerProvider, NotFoundError, RouteDescriptor, ServerLoggerProvider, ServerNotReadyProvider, ServerProvider, ServerReply, ServerRouterProvider, ServerTimingProvider, UnauthorizedError, ValidationError, errorNameByStatus, errorSchema, isHttpError, isMultipart, okSchema, routeMethods };
+export { $action, $route, ActionPrimitive, AlephaServer, BadRequestError, BunHttpServerProvider, ConflictError, ForbiddenError, HttpClient, HttpError, NodeHttpServerProvider, NotFoundError, RoutePrimitive, ServerLoggerProvider, ServerNotReadyProvider, ServerProvider, ServerReply, ServerRouterProvider, ServerTimingProvider, UnauthorizedError, ValidationError, errorNameByStatus, errorSchema, isHttpError, isMultipart, okSchema, routeMethods };
 //# sourceMappingURL=index.js.map