silgi 0.4.11 → 0.5.0

package/dist/_chunks/index.mjs

@@ -1,6 +1,6 @@
 const name = "silgi";
 const type = "module";
-const version = "0.4.11";
+const version = "0.5.0";
 const packageManager = "pnpm@9.15.1";
 const sideEffects = false;
 const exports = {

package/dist/cli/prepare.mjs

@@ -250,11 +250,12 @@ async function generateRouterDTS(silgi) {
     silgi.hook("close", async () => {
       const { object } = await data();
       const uris = object.uris;
+      const subPath = "srn";
       const groupedPaths = /* @__PURE__ */ new Map();
       Object.entries(uris || {}).forEach(([key, params]) => {
         const [service, resource, method, action] = key.split("/");
-        const basePath = params ? `${service}/${resource}/${action}/${params}` : `${service}/${resource}/${action}`;
-        const fullPath = `${service}/${resource}/${action}`;
+        const basePath = params ? `${subPath}/${service}/${resource}/${action}/${params}` : `${subPath}/${service}/${resource}/${action}`;
+        const fullPath = `${subPath}/${service}/${resource}/${action}`;
         if (!groupedPaths.has(basePath)) {
           groupedPaths.set(basePath, /* @__PURE__ */ new Map());
         }
@@ -272,7 +273,7 @@ async function generateRouterDTS(silgi) {
       ].join("\n");
       const groupedRoutes = Object.entries(uris || {}).reduce((acc, [key, _params]) => {
         const [service, resource, method, action] = key.split("/");
-        const routePath = `${service}/${resource}/${action}`;
+        const routePath = `${subPath}/${service}/${resource}/${action}`;
         if (!acc[routePath]) {
           acc[routePath] = {};
         }
@@ -614,6 +615,7 @@ async function silgiCoreFile(data, frameworkContext, silgi) {
     "",
     "",
     "export async function buildSilgi(framework: FrameworkContext, options?: Partial<SilgiModuleOptions>) {",
+    "  try {",
     "  const silgi = await createSilgi({",
     "      framework,",
     "      shared: shareds as any,",
@@ -624,6 +626,7 @@ async function silgiCoreFile(data, frameworkContext, silgi) {
     `      plugins: [${plugins.join(", ")}],`,
     "",
     "      options: {",
+    `      present: '${silgi.options.preset}',`,
     "      ...options,",
     "     },",
     "    })",
@@ -633,6 +636,9 @@ async function silgiCoreFile(data, frameworkContext, silgi) {
     ...buildSilgiExtraContent,
     "",
     "  return silgi",
+    "  } catch (error) {",
+    "    throw new Error(error.message)",
+    "  }",
     "}",
     ""
   ];

package/dist/core/index.d.mts

@@ -1,7 +1,7 @@
 import { SilgiCLIConfig, LoadConfigOptions, SilgiCLIOptions, SilgiCLI, SilgiConfig, Silgi, SilgiRouterTypes, SilgiOperation, MergedSilgiSchema, ServiceType, SilgiSchema, RequiredServiceType, SilgiModuleShared, SilgiEvent, DefaultNamespaces, BaseSchemaType } from 'silgi/types';
 import { TSConfig } from 'pkg-types';
 import { FetchOptions } from 'ofetch';
-export { c as createStorage, s as silgi } from '../shared/silgi.40ZJYm8F.mjs';
+export { c as createStorage, s as silgi } from '../shared/silgi.DGmIWx95.mjs';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import 'unstorage';
 
@@ -14,7 +14,7 @@ declare function silgiGenerateType(silgi: SilgiCLI): Promise<{
 
 declare function createSilgi(config: SilgiConfig): Promise<Silgi>;
 
-type TrimAfterFourSlashes<T extends string> = T extends `/${infer S1}/${infer S2}/${infer S3}/${infer _}` ? `/${S1}/${S2}/${S3}` : T;
+type TrimAfterFourSlashes<T extends string> = T extends `/${infer S1}/${infer S2}/${infer S3}/${infer S4}/${infer _}` ? `/${S1}/${S2}/${S3}/${S4}` : T;
 type AllPaths = SilgiRouterTypes extends {
     keys: infer U;
 } ? keyof U extends never ? string : keyof U : string;
@@ -37,7 +37,7 @@ type RouterParams<R extends ValidRoute> = ExtractPathParams<R>;
 type SilgiFetchOptions<R extends ValidRoute, M extends Method<R>> = {
     method: M;
 } & RequestBodyOption<R, M> & (RouterParams<R> extends object ? {
-    params: RouterParams<R>;
+    params?: RouterParams<R>;
 } : {
     params?: never;
 }) & Omit<FetchOptions, 'query' | 'body' | 'method'>;
@@ -98,47 +98,194 @@ declare function createService<T extends SilgiSchema>(variables: ServiceType<T>)
 
 declare function createShared(shared: Partial<SilgiModuleShared>): SilgiModuleShared;
 
-declare enum SilgiErrorCode {
-    AUTH_UNAUTHORIZED = "AUTH_UNAUTHORIZED",
-    AUTH_MISSING_CONTEXT = "AUTH_MISSING_CONTEXT",
-    AUTH_INVALID_CONTEXT = "AUTH_INVALID_CONTEXT",
-    AUTH_PERMISSION_DENIED = "AUTH_PERMISSION_DENIED",
-    PLUGIN_ERROR = "PLUGIN_ERROR",
-    METHOD_NOT_FOUND = "METHOD_NOT_FOUND",
-    EXECUTION_ERROR = "EXECUTION_ERROR",
-    CACHE_ERROR = "CACHE_ERROR",
-    PLUGIN_ALREADY_EXISTS = "PLUGIN_ALREADY_EXISTS",
-    PLUGIN_NOT_FOUND = "PLUGIN_NOT_FOUND",
-    PLUGIN_INIT_ERROR = "PLUGIN_INIT_ERROR"
+declare enum HttpStatus {
+    /** [100] Server has received the request headers and client should proceed to send the request body */
+    CONTINUE = 100,
+    /** [101] Server is switching protocols according to Upgrade header */
+    SWITCHING_PROTOCOLS = 101,
+    /** [102] Server is processing the request but no response is available yet */
+    PROCESSING = 102,
+    /** [103] Server is likely to send a final response with the header fields in the informational response */
+    EARLY_HINTS = 103,
+    /** [200] Request succeeded and response contains requested data */
+    OK = 200,
+    /** [201] Request succeeded and new resource has been created */
+    CREATED = 201,
+    /** [202] Request accepted for processing but processing not completed */
+    ACCEPTED = 202,
+    /** [203] Request processed successfully but response may be from another source */
+    NON_AUTHORITATIVE_INFORMATION = 203,
+    /** [204] Request processed successfully but response has no content */
+    NO_CONTENT = 204,
+    /** [205] Server fulfilled the request and client should reset the document view */
+    RESET_CONTENT = 205,
+    /** [206] Server delivered only part of the resource due to range header */
+    PARTIAL_CONTENT = 206,
+    /** [207] Response conveys information about multiple resources for XML messages */
+    MULTI_STATUS = 207,
+    /** [208] Members of DAV binding have already been enumerated and not included again */
+    ALREADY_REPORTED = 208,
+    /** [226] Server has fulfilled a GET request, response is result of transformations */
+    IM_USED = 226,
+    /** [300] Multiple options for the resource from which client may choose */
+    MULTIPLE_CHOICES = 300,
+    /** [301] Resource permanently moved to new URL */
+    MOVED_PERMANENTLY = 301,
+    /** [302] Resource temporarily moved to different URL */
+    FOUND = 302,
+    /** [303] Response to request found at another URL using GET */
+    SEE_OTHER = 303,
+    /** [304] Resource has not been modified since last requested */
+    NOT_MODIFIED = 304,
+    /** [305] Deprecated. Resource must be accessed through proxy */
+    USE_PROXY = 305,
+    /** [307] Resource temporarily moved to different URL, keep method */
+    TEMPORARY_REDIRECT = 307,
+    /** [308] Resource permanently moved to different URL, keep method */
+    PERMANENT_REDIRECT = 308,
+    /** [400] Request malformed, syntax error or invalid request */
+    BAD_REQUEST = 400,
+    /** [401] Request requires user authentication or authorization */
+    UNAUTHORIZED = 401,
+    /** [402] Reserved for future use, payment required */
+    PAYMENT_REQUIRED = 402,
+    /** [403] Server understood request but refuses to authorize it */
+    FORBIDDEN = 403,
+    /** [404] Server cannot find the requested resource */
+    NOT_FOUND = 404,
+    /** [405] Request method (GET, POST, etc.) not supported for this resource */
+    METHOD_NOT_ALLOWED = 405,
+    /** [406] Resource cannot generate response matching accept headers */
+    NOT_ACCEPTABLE = 406,
+    /** [407] Client must first authenticate with the proxy */
+    PROXY_AUTHENTICATION_REQUIRED = 407,
+    /** [408] Server timed out waiting for the request */
+    REQUEST_TIMEOUT = 408,
+    /** [409] Request conflicts with current state of the server */
+    CONFLICT = 409,
+    /** [410] Resource requested is no longer available and will not be available again */
+    GONE = 410,
+    /** [411] Server requires Content-Length header field */
+    LENGTH_REQUIRED = 411,
+    /** [412] Precondition given in request headers evaluated to false */
+    PRECONDITION_FAILED = 412,
+    /** [413] Request entity larger than limits defined by server */
+    PAYLOAD_TOO_LARGE = 413,
+    /** [414] URI requested by client is longer than server can interpret */
+    URI_TOO_LONG = 414,
+    /** [415] Media format of requested data not supported by server */
+    UNSUPPORTED_MEDIA_TYPE = 415,
+    /** [416] Range specified by Range header cannot be fulfilled */
+    RANGE_NOT_SATISFIABLE = 416,
+    /** [417] Expectation indicated by Expect header cannot be met */
+    EXPECTATION_FAILED = 417,
+    /** [418] April Fools' joke by RFC 2324 - Server refuses to brew coffee in a teapot */
+    IM_A_TEAPOT = 418,
+    /** [421] Request directed at a server that is not configured to produce a response */
+    MISDIRECTED_REQUEST = 421,
+    /** [422] Server understands content type but cannot process contained instructions */
+    UNPROCESSABLE_ENTITY = 422,
+    /** [423] Requested resource is currently locked */
+    LOCKED = 423,
+    /** [424] Request failed due to failure of a previous request */
+    FAILED_DEPENDENCY = 424,
+    /** [425] Server is unwilling to risk processing a request that might be replayed */
+    TOO_EARLY = 425,
+    /** [426] Server requires client to upgrade to a different protocol */
+    UPGRADE_REQUIRED = 426,
+    /** [428] Origin server requires request to be conditional */
+    PRECONDITION_REQUIRED = 428,
+    /** [429] User has sent too many requests in a given time period */
+    TOO_MANY_REQUESTS = 429,
+    /** [431] Server refusing to process request due to oversized headers */
+    REQUEST_HEADER_FIELDS_TOO_LARGE = 431,
+    /** [451] Server denies access for legal reasons (e.g., censorship) */
+    UNAVAILABLE_FOR_LEGAL_REASONS = 451,
+    /** [500] Generic server error, no specific message */
+    INTERNAL_SERVER_ERROR = 500,
+    /** [501] Server does not recognize method or lacks ability to fulfill */
+    NOT_IMPLEMENTED = 501,
+    /** [502] Bad response received from upstream server */
+    BAD_GATEWAY = 502,
+    /** [503] Server temporarily unavailable (overloaded/maintenance) */
+    SERVICE_UNAVAILABLE = 503,
+    /** [504] Gateway server did not get response from upstream server */
+    GATEWAY_TIMEOUT = 504,
+    /** [505] Server does not support the HTTP protocol version */
+    HTTP_VERSION_NOT_SUPPORTED = 505,
+    /** [506] Server has a circular reference in content negotiation */
+    VARIANT_ALSO_NEGOTIATES = 506,
+    /** [507] Server has insufficient storage to complete request */
+    INSUFFICIENT_STORAGE = 507,
+    /** [508] Server detected an infinite loop while processing request */
+    LOOP_DETECTED = 508,
+    /** [510] Further extensions needed for server to fulfill request */
+    NOT_EXTENDED = 510,
+    /** [511] Client needs to authenticate to gain network access */
+    NETWORK_AUTHENTICATION_REQUIRED = 511
 }
-interface SilgiErrorOptions {
-    code: SilgiErrorCode | string;
+declare enum ErrorSeverity {
+    DEBUG = "DEBUG",
+    INFO = "INFO",
+    WARNING = "WARNING",
+    ERROR = "ERROR",
+    CRITICAL = "CRITICAL"
+}
+declare enum ErrorCategory {
+    AUTHENTICATION = "auth",
+    AUTHORIZATION = "authorization",
+    VALIDATION = "validation",
+    BUSINESS = "business",
+    INFRASTRUCTURE = "infrastructure",
+    EXTERNAL = "external",
+    UNKNOWN = "unknown"
+}
+interface ErrorMetadata {
+    timestamp: number;
+    correlationId?: string;
+    requestId?: string;
+    userId?: string;
+    path?: string;
+    source?: string;
+    [key: string]: unknown;
+}
+interface BaseError {
+    code: number;
     message: string;
+    category: ErrorCategory;
+    severity: ErrorSeverity;
+    httpStatus: HttpStatus;
+    metadata?: ErrorMetadata;
     cause?: Error;
-    details?: Record<string, unknown>;
-    meta?: Record<string, unknown>;
+    context?: Record<string, unknown>;
 }
-declare class SilgiError extends Error {
-    readonly code: string;
-    readonly details?: Record<string, unknown>;
-    readonly meta?: Record<string, unknown>;
-    readonly timestamp: number;
-    cause?: Error;
-    constructor(options: SilgiErrorOptions);
-    toString(): string;
-    toJSON(): {
-        name: string;
-        code: string;
+declare class ErrorFactory {
+    private static createMetadata;
+    static create(options: Partial<BaseError> & {
         message: string;
-        details: Record<string, unknown> | undefined;
-        meta: Record<string, unknown> | undefined;
-        timestamp: number;
-        stack: string | undefined;
-    };
-    static createFrom(error: unknown, code?: string): SilgiError;
-    static isSilgiError(error: unknown): error is SilgiError;
+    }): SilgiError;
+    static authenticationError(message: string, context?: Record<string, unknown>): SilgiError;
+    static authorizationError(message: string, context?: Record<string, unknown>): SilgiError;
+    static validationError(message: string, context?: Record<string, unknown>): SilgiError;
+    static notFoundError(message: string, context?: Record<string, unknown>): SilgiError;
+    static internalError(message: string, cause?: Error): SilgiError;
+}
+declare class SilgiError extends Error implements BaseError {
+    readonly code: number;
+    readonly category: ErrorCategory;
+    readonly severity: ErrorSeverity;
+    readonly httpStatus: HttpStatus;
+    readonly metadata: ErrorMetadata;
+    readonly context?: Record<string, unknown>;
+    readonly cause?: Error;
+    constructor(error: BaseError);
+    toString(): string;
+    toJSON(): Record<string, unknown>;
+    static isError(error: unknown): error is SilgiError;
+    static from(error: unknown): SilgiError;
 }
+declare function isBaseError(error: unknown): error is BaseError;
 
 declare function useSilgi(): Silgi;
 
-export { SchemaParser, SilgiError, createSchema, createService, createShared, createSilgi, createSilgiFetch, getEvent, loadOptions, mergeSchemas, mergeServices, mergeShared, parseURI, silgiGenerateType, useSilgi };
+export { type BaseError, ErrorCategory, ErrorFactory, type ErrorMetadata, ErrorSeverity, HttpStatus, SchemaParser, SilgiError, createSchema, createService, createShared, createSilgi, createSilgiFetch, getEvent, isBaseError, loadOptions, mergeSchemas, mergeServices, mergeShared, parseURI, silgiGenerateType, useSilgi };

package/dist/core/index.d.ts

@@ -1,7 +1,7 @@
 import { SilgiCLIConfig, LoadConfigOptions, SilgiCLIOptions, SilgiCLI, SilgiConfig, Silgi, SilgiRouterTypes, SilgiOperation, MergedSilgiSchema, ServiceType, SilgiSchema, RequiredServiceType, SilgiModuleShared, SilgiEvent, DefaultNamespaces, BaseSchemaType } from 'silgi/types';
 import { TSConfig } from 'pkg-types';
 import { FetchOptions } from 'ofetch';
-export { c as createStorage, s as silgi } from '../shared/silgi.40ZJYm8F.js';
+export { c as createStorage, s as silgi } from '../shared/silgi.DGmIWx95.js';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import 'unstorage';
 
@@ -14,7 +14,7 @@ declare function silgiGenerateType(silgi: SilgiCLI): Promise<{
 
 declare function createSilgi(config: SilgiConfig): Promise<Silgi>;
 
-type TrimAfterFourSlashes<T extends string> = T extends `/${infer S1}/${infer S2}/${infer S3}/${infer _}` ? `/${S1}/${S2}/${S3}` : T;
+type TrimAfterFourSlashes<T extends string> = T extends `/${infer S1}/${infer S2}/${infer S3}/${infer S4}/${infer _}` ? `/${S1}/${S2}/${S3}/${S4}` : T;
 type AllPaths = SilgiRouterTypes extends {
     keys: infer U;
 } ? keyof U extends never ? string : keyof U : string;
@@ -37,7 +37,7 @@ type RouterParams<R extends ValidRoute> = ExtractPathParams<R>;
 type SilgiFetchOptions<R extends ValidRoute, M extends Method<R>> = {
     method: M;
 } & RequestBodyOption<R, M> & (RouterParams<R> extends object ? {
-    params: RouterParams<R>;
+    params?: RouterParams<R>;
 } : {
     params?: never;
 }) & Omit<FetchOptions, 'query' | 'body' | 'method'>;
@@ -98,47 +98,194 @@ declare function createService<T extends SilgiSchema>(variables: ServiceType<T>)
 
 declare function createShared(shared: Partial<SilgiModuleShared>): SilgiModuleShared;
 
-declare enum SilgiErrorCode {
-    AUTH_UNAUTHORIZED = "AUTH_UNAUTHORIZED",
-    AUTH_MISSING_CONTEXT = "AUTH_MISSING_CONTEXT",
-    AUTH_INVALID_CONTEXT = "AUTH_INVALID_CONTEXT",
-    AUTH_PERMISSION_DENIED = "AUTH_PERMISSION_DENIED",
-    PLUGIN_ERROR = "PLUGIN_ERROR",
-    METHOD_NOT_FOUND = "METHOD_NOT_FOUND",
-    EXECUTION_ERROR = "EXECUTION_ERROR",
-    CACHE_ERROR = "CACHE_ERROR",
-    PLUGIN_ALREADY_EXISTS = "PLUGIN_ALREADY_EXISTS",
-    PLUGIN_NOT_FOUND = "PLUGIN_NOT_FOUND",
-    PLUGIN_INIT_ERROR = "PLUGIN_INIT_ERROR"
+declare enum HttpStatus {
+    /** [100] Server has received the request headers and client should proceed to send the request body */
+    CONTINUE = 100,
+    /** [101] Server is switching protocols according to Upgrade header */
+    SWITCHING_PROTOCOLS = 101,
+    /** [102] Server is processing the request but no response is available yet */
+    PROCESSING = 102,
+    /** [103] Server is likely to send a final response with the header fields in the informational response */
+    EARLY_HINTS = 103,
+    /** [200] Request succeeded and response contains requested data */
+    OK = 200,
+    /** [201] Request succeeded and new resource has been created */
+    CREATED = 201,
+    /** [202] Request accepted for processing but processing not completed */
+    ACCEPTED = 202,
+    /** [203] Request processed successfully but response may be from another source */
+    NON_AUTHORITATIVE_INFORMATION = 203,
+    /** [204] Request processed successfully but response has no content */
+    NO_CONTENT = 204,
+    /** [205] Server fulfilled the request and client should reset the document view */
+    RESET_CONTENT = 205,
+    /** [206] Server delivered only part of the resource due to range header */
+    PARTIAL_CONTENT = 206,
+    /** [207] Response conveys information about multiple resources for XML messages */
+    MULTI_STATUS = 207,
+    /** [208] Members of DAV binding have already been enumerated and not included again */
+    ALREADY_REPORTED = 208,
+    /** [226] Server has fulfilled a GET request, response is result of transformations */
+    IM_USED = 226,
+    /** [300] Multiple options for the resource from which client may choose */
+    MULTIPLE_CHOICES = 300,
+    /** [301] Resource permanently moved to new URL */
+    MOVED_PERMANENTLY = 301,
+    /** [302] Resource temporarily moved to different URL */
+    FOUND = 302,
+    /** [303] Response to request found at another URL using GET */
+    SEE_OTHER = 303,
+    /** [304] Resource has not been modified since last requested */
+    NOT_MODIFIED = 304,
+    /** [305] Deprecated. Resource must be accessed through proxy */
+    USE_PROXY = 305,
+    /** [307] Resource temporarily moved to different URL, keep method */
+    TEMPORARY_REDIRECT = 307,
+    /** [308] Resource permanently moved to different URL, keep method */
+    PERMANENT_REDIRECT = 308,
+    /** [400] Request malformed, syntax error or invalid request */
+    BAD_REQUEST = 400,
+    /** [401] Request requires user authentication or authorization */
+    UNAUTHORIZED = 401,
+    /** [402] Reserved for future use, payment required */
+    PAYMENT_REQUIRED = 402,
+    /** [403] Server understood request but refuses to authorize it */
+    FORBIDDEN = 403,
+    /** [404] Server cannot find the requested resource */
+    NOT_FOUND = 404,
+    /** [405] Request method (GET, POST, etc.) not supported for this resource */
+    METHOD_NOT_ALLOWED = 405,
+    /** [406] Resource cannot generate response matching accept headers */
+    NOT_ACCEPTABLE = 406,
+    /** [407] Client must first authenticate with the proxy */
+    PROXY_AUTHENTICATION_REQUIRED = 407,
+    /** [408] Server timed out waiting for the request */
+    REQUEST_TIMEOUT = 408,
+    /** [409] Request conflicts with current state of the server */
+    CONFLICT = 409,
+    /** [410] Resource requested is no longer available and will not be available again */
+    GONE = 410,
+    /** [411] Server requires Content-Length header field */
+    LENGTH_REQUIRED = 411,
+    /** [412] Precondition given in request headers evaluated to false */
+    PRECONDITION_FAILED = 412,
+    /** [413] Request entity larger than limits defined by server */
+    PAYLOAD_TOO_LARGE = 413,
+    /** [414] URI requested by client is longer than server can interpret */
+    URI_TOO_LONG = 414,
+    /** [415] Media format of requested data not supported by server */
+    UNSUPPORTED_MEDIA_TYPE = 415,
+    /** [416] Range specified by Range header cannot be fulfilled */
+    RANGE_NOT_SATISFIABLE = 416,
+    /** [417] Expectation indicated by Expect header cannot be met */
+    EXPECTATION_FAILED = 417,
+    /** [418] April Fools' joke by RFC 2324 - Server refuses to brew coffee in a teapot */
+    IM_A_TEAPOT = 418,
+    /** [421] Request directed at a server that is not configured to produce a response */
+    MISDIRECTED_REQUEST = 421,
+    /** [422] Server understands content type but cannot process contained instructions */
+    UNPROCESSABLE_ENTITY = 422,
+    /** [423] Requested resource is currently locked */
+    LOCKED = 423,
+    /** [424] Request failed due to failure of a previous request */
+    FAILED_DEPENDENCY = 424,
+    /** [425] Server is unwilling to risk processing a request that might be replayed */
+    TOO_EARLY = 425,
+    /** [426] Server requires client to upgrade to a different protocol */
+    UPGRADE_REQUIRED = 426,
+    /** [428] Origin server requires request to be conditional */
+    PRECONDITION_REQUIRED = 428,
+    /** [429] User has sent too many requests in a given time period */
+    TOO_MANY_REQUESTS = 429,
+    /** [431] Server refusing to process request due to oversized headers */
+    REQUEST_HEADER_FIELDS_TOO_LARGE = 431,
+    /** [451] Server denies access for legal reasons (e.g., censorship) */
+    UNAVAILABLE_FOR_LEGAL_REASONS = 451,
+    /** [500] Generic server error, no specific message */
+    INTERNAL_SERVER_ERROR = 500,
+    /** [501] Server does not recognize method or lacks ability to fulfill */
+    NOT_IMPLEMENTED = 501,
+    /** [502] Bad response received from upstream server */
+    BAD_GATEWAY = 502,
+    /** [503] Server temporarily unavailable (overloaded/maintenance) */
+    SERVICE_UNAVAILABLE = 503,
+    /** [504] Gateway server did not get response from upstream server */
+    GATEWAY_TIMEOUT = 504,
+    /** [505] Server does not support the HTTP protocol version */
+    HTTP_VERSION_NOT_SUPPORTED = 505,
+    /** [506] Server has a circular reference in content negotiation */
+    VARIANT_ALSO_NEGOTIATES = 506,
+    /** [507] Server has insufficient storage to complete request */
+    INSUFFICIENT_STORAGE = 507,
+    /** [508] Server detected an infinite loop while processing request */
+    LOOP_DETECTED = 508,
+    /** [510] Further extensions needed for server to fulfill request */
+    NOT_EXTENDED = 510,
+    /** [511] Client needs to authenticate to gain network access */
+    NETWORK_AUTHENTICATION_REQUIRED = 511
 }
-interface SilgiErrorOptions {
-    code: SilgiErrorCode | string;
+declare enum ErrorSeverity {
+    DEBUG = "DEBUG",
+    INFO = "INFO",
+    WARNING = "WARNING",
+    ERROR = "ERROR",
+    CRITICAL = "CRITICAL"
+}
+declare enum ErrorCategory {
+    AUTHENTICATION = "auth",
+    AUTHORIZATION = "authorization",
+    VALIDATION = "validation",
+    BUSINESS = "business",
+    INFRASTRUCTURE = "infrastructure",
+    EXTERNAL = "external",
+    UNKNOWN = "unknown"
+}
+interface ErrorMetadata {
+    timestamp: number;
+    correlationId?: string;
+    requestId?: string;
+    userId?: string;
+    path?: string;
+    source?: string;
+    [key: string]: unknown;
+}
+interface BaseError {
+    code: number;
     message: string;
+    category: ErrorCategory;
+    severity: ErrorSeverity;
+    httpStatus: HttpStatus;
+    metadata?: ErrorMetadata;
     cause?: Error;
-    details?: Record<string, unknown>;
-    meta?: Record<string, unknown>;
+    context?: Record<string, unknown>;
 }
-declare class SilgiError extends Error {
-    readonly code: string;
-    readonly details?: Record<string, unknown>;
-    readonly meta?: Record<string, unknown>;
-    readonly timestamp: number;
-    cause?: Error;
-    constructor(options: SilgiErrorOptions);
-    toString(): string;
-    toJSON(): {
-        name: string;
-        code: string;
+declare class ErrorFactory {
+    private static createMetadata;
+    static create(options: Partial<BaseError> & {
         message: string;
-        details: Record<string, unknown> | undefined;
-        meta: Record<string, unknown> | undefined;
-        timestamp: number;
-        stack: string | undefined;
-    };
-    static createFrom(error: unknown, code?: string): SilgiError;
-    static isSilgiError(error: unknown): error is SilgiError;
+    }): SilgiError;
+    static authenticationError(message: string, context?: Record<string, unknown>): SilgiError;
+    static authorizationError(message: string, context?: Record<string, unknown>): SilgiError;
+    static validationError(message: string, context?: Record<string, unknown>): SilgiError;
+    static notFoundError(message: string, context?: Record<string, unknown>): SilgiError;
+    static internalError(message: string, cause?: Error): SilgiError;
+}
+declare class SilgiError extends Error implements BaseError {
+    readonly code: number;
+    readonly category: ErrorCategory;
+    readonly severity: ErrorSeverity;
+    readonly httpStatus: HttpStatus;
+    readonly metadata: ErrorMetadata;
+    readonly context?: Record<string, unknown>;
+    readonly cause?: Error;
+    constructor(error: BaseError);
+    toString(): string;
+    toJSON(): Record<string, unknown>;
+    static isError(error: unknown): error is SilgiError;
+    static from(error: unknown): SilgiError;
 }
+declare function isBaseError(error: unknown): error is BaseError;
 
 declare function useSilgi(): Silgi;
 
-export { SchemaParser, SilgiError, createSchema, createService, createShared, createSilgi, createSilgiFetch, getEvent, loadOptions, mergeSchemas, mergeServices, mergeShared, parseURI, silgiGenerateType, useSilgi };
+export { type BaseError, ErrorCategory, ErrorFactory, type ErrorMetadata, ErrorSeverity, HttpStatus, SchemaParser, SilgiError, createSchema, createService, createShared, createSilgi, createSilgiFetch, getEvent, isBaseError, loadOptions, mergeSchemas, mergeServices, mergeShared, parseURI, silgiGenerateType, useSilgi };