silgi 0.4.12 → 0.6.0

package/dist/_chunks/index.mjs

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

package/dist/cli/prepare.mjs

@@ -93,6 +93,18 @@ async function nitroFramework(silgi, skip = false) {
     packageImport: "silgi/runtime/internal/nitro",
     path: join(runtimeDir, "internal/nitro")
   });
+  silgi.hook("prepare:core.ts", (data) => {
+    data.importItems["nitropack/runtime"] ??= {
+      import: [],
+      from: "nitropack/runtime"
+    };
+    data.importItems["nitropack/runtime"].import.push(
+      { name: "useStorage" }
+    );
+    data._silgiConfigs.push({
+      storage: `useStorage()`
+    });
+  });
   await h3Framework(silgi, true);
 }
 
@@ -112,12 +124,39 @@ async function prepareDir(dir) {
   await fsp.mkdir(dir, { recursive: true });
 }
 
+function myBabelPlugin() {
+  return {
+    visitor: {
+      CallExpression(path) {
+        const callee = path.get("callee");
+        if (callee.isMemberExpression() && callee.get("object").isIdentifier({ name: "console" }) && callee.get("property").isIdentifier({ name: "log" })) {
+          callee.get("property").replaceWithSourceString("warn");
+        }
+      },
+      StringLiteral(path) {
+        if (path.node.value === "nitropack/runtime") {
+          path.replaceWithSourceString("'silgi/runtime'");
+        }
+      }
+    }
+  };
+}
 async function readCoreFile(silgi) {
   const path = resolve(silgi.options.silgi.serverDir, "core.ts");
   const jiti = createJiti(silgi.options.rootDir, {
     fsCache: false,
     interopDefault: true,
     moduleCache: false,
+    transformOptions: {
+      babel: {
+        plugins: [myBabelPlugin()]
+      }
+    },
+    // debug: true,
+    // transform(opts) {
+    //   console.log(opts)
+    //   return babelTransform(opts)
+    // },
     alias: silgi.options.alias
   });
   const resolvedPath = jiti.esmResolve(path);
@@ -188,16 +227,19 @@ function scanActionModulesUris(silgi, obj, currentPath = []) {
     if (path.length === 4) {
       const basePath = path.join("/");
       let moduleName = "";
-      if (node.modules?.graphqlyoga) {
+      if (node.modules?.yoga) {
         let rootFieldName = null;
-        if (node.modules?.graphqlyoga?.rootFieldName) {
-          moduleName = "graphqlyoga";
-          rootFieldName = node.modules?.graphqlyoga?.rootFieldName;
+        if (node.modules?.yoga?.rootFieldName) {
+          moduleName = "yoga";
+          rootFieldName = node.modules?.yoga?.rootFieldName;
         }
         if (!rootFieldName) {
           return;
         }
         uriMap[moduleName] ??= {};
+        if (uriMap[moduleName].rootFieldName) {
+          silgi.logger.withTag("scanActionModulesUris").error(`Hata ${moduleName} ${rootFieldName} ${basePath} bu zaten burada kullanilmis.`);
+        }
         uriMap[moduleName].rootFieldName ??= {};
         uriMap[moduleName].rootFieldName[rootFieldName] = basePath;
       }
@@ -360,7 +402,7 @@ async function createCoreFramework(silgi) {
     functions
   });
   const content = [
-    ...functions.map((f) => ` await ${f}(framework)`)
+    ...functions.map((f) => f.params?.length ? ` await ${f.name}(framework, ${f.params.join(",")})` : ` await ${f.name}(framework)`)
   ];
   return {
     content,
@@ -535,7 +577,8 @@ async function silgiCoreFile(data, frameworkContext, silgi) {
       import: [
         { name: "SilgiModuleOptions", type: true },
         { name: "SilgiOptions", type: true },
-        { name: "FrameworkContext", type: true }
+        { name: "FrameworkContext", type: true },
+        { name: "DeepPartial", type: true }
       ],
       from: "silgi/types"
     }
@@ -559,6 +602,13 @@ async function silgiCoreFile(data, frameworkContext, silgi) {
   const shareds = [];
   const schemas = [];
   const buildSilgiExtraContent = [];
+  const _silgiOptions = {};
+  const _silgiConfigs = [];
+  for (const module of silgi.scanModules) {
+    _silgiOptions[module.meta.configKey] = {
+      ...module.options
+    };
+  }
   await silgi.callHook("prepare:core.ts", {
     importItems,
     customImports,
@@ -566,7 +616,9 @@ async function silgiCoreFile(data, frameworkContext, silgi) {
     services,
     shareds,
     schemas,
-    buildSilgiExtraContent
+    buildSilgiExtraContent,
+    _silgiOptions,
+    _silgiConfigs
   });
   if (services.length > 0) {
     importItems["silgi/core"].import.push({ name: "mergeServices" });
@@ -613,6 +665,7 @@ async function silgiCoreFile(data, frameworkContext, silgi) {
     }),
     shareds.length > 0 ? "])" : "}",
     "",
+    `export const _silgiOptions: DeepPartial<SilgiModuleOptions> = ${JSON.stringify(_silgiOptions, null, 2)}`,
     "",
     "export async function buildSilgi(framework: FrameworkContext, options?: Partial<SilgiModuleOptions>) {",
     "  const silgi = await createSilgi({",
@@ -623,8 +676,10 @@ async function silgiCoreFile(data, frameworkContext, silgi) {
     "      uris,",
     "      modulesURIs,",
     `      plugins: [${plugins.join(", ")}],`,
-    "",
+    _silgiConfigs.length > 0 ? `      ${_silgiConfigs.map((config) => Object.entries(config).map(([key, value]) => `${key}: ${value}`)).join(",\n      ")},` : "",
     "      options: {",
+    `      present: '${silgi.options.preset}',`,
+    "      ..._silgiOptions,",
     "      ...options,",
     "     },",
     "    })",
@@ -989,7 +1044,8 @@ async function _resolveSilgiModule(mod, silgi) {
     silgi.scanModules.push({
       meta: buildTimeModuleMeta,
       entryPath: _url,
-      installed: false
+      installed: false,
+      options: await mod.getOptions?.() || {}
     });
   }
 }
@@ -1334,8 +1390,11 @@ async function createSilgiCLI(config = {}, opts = {}) {
   }
   await scanAndSyncOptions(silgi);
   await scanModules$1(silgi);
-  await scanFiles$1(silgi);
-  await graphqlLoadSync(silgi);
+  try {
+    await scanFiles$1(silgi);
+    await graphqlLoadSync(silgi);
+  } catch {
+  }
   silgi.storage = await createStorageCLI(silgi);
   silgi.hooks.hook("close", async () => {
     await silgi.storage.dispose();

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, u as useStorage } from '../shared/silgi.DRWtysQv.mjs';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import 'unstorage';
 
@@ -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, u as useStorage } from '../shared/silgi.DRWtysQv.js';
 import { StandardSchemaV1 } from '@standard-schema/spec';
 import 'unstorage';
 
@@ -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 };