silgi 0.42.5 → 0.43.0

package/dist/kit/index.d.mts

@@ -1,321 +1,22 @@
-import { Commands, SilgiCLIHooks, GenImport, DefineFrameworkOptions, SilgiCLI, ModuleOptionsCustom, ModuleDefinition, SilgiModule, SilgiPreset, SilgiPresetMeta, SilgiTemplate, ResolvedSilgiTemplate, SilgiEvent } from 'silgi/types';
-import { PresetName } from 'silgi/presets';
-import { Buffer } from 'node:buffer';
-import { ConsolaOptions, ConsolaInstance } from 'consola';
-import * as rfc6902 from 'rfc6902';
-import { IncomingMessage } from 'node:http';
-
-declare function addCommands(data: Commands | Commands[]): Promise<void>;
-
-declare function addCoreFile(data: {
-    before?: SilgiCLIHooks['before:core.ts'];
-    after?: SilgiCLIHooks['after:core.ts'];
-}): Promise<void>;
-
-declare function addImports(data?: {
-    imports?: GenImport[];
-    typeImports?: GenImport[];
-}): {
-    genImports: GenImport[];
-    genTypeImports: GenImport[];
-    addImportItem: (data: GenImport | GenImport[]) => void;
-    addImportItemType: (data: GenImport | GenImport[]) => void;
-};
-
-declare function addNPMPackage(data: {
-    name: string;
-    version?: string;
-    isDev?: boolean;
-    when?: boolean;
-}[] | {
-    name: string;
-    version?: string;
-    isDev?: boolean;
-    when?: boolean;
-}): Promise<void>;
-
-/**
- * Define a framework handler with proper type safety using a fluent API
- *
- * @param preset The framework preset to use
- * @example
- * ```ts
- * const h3Handler = defineFramework('h3').build(async (options) => {
- *   // Type-safe access to h3 router
- *   const router = options.framework
- *   // Implementation here with async/await support
- *   await someAsyncOperation()
- * })
- * ```
- */
-declare function defineFramework<T extends PresetName>(preset: T): {
-    /**
-     * Build the framework handler
-     * @param callback The callback function that will receive typed options (can be async)
-     */
-    build(callback: (options: DefineFrameworkOptions<T>) => void | Promise<void>): (options: DefineFrameworkOptions<T>) => Promise<void>;
-};
-
-declare function hasError(type: SilgiCLI['errors'][0]['type'], silgi?: SilgiCLI): boolean;
-
-declare function directoryToURL(dir: string): URL;
-/**
- * Resolve a module from a given root path using an algorithm patterned on
- * the upcoming `import.meta.resolve`. It returns a file URL
- *
- * @internal
- */
-declare function tryResolveModule(id: string, url?: string | string[]): Promise<string | undefined>;
-
-declare function writeFile(file: string, contents: Buffer | string, log?: boolean): Promise<void>;
-declare function isDirectory(path: string): Promise<boolean>;
-
-/**
- * Interface for function call configurations
- */
-interface FunctionConfig {
-    name: string;
-    args: any[];
-}
-declare function createFunctionConfigs(configs: FunctionConfig[]): FunctionConfig[];
-/**
- * Generic utility function to create function call configurations
- * @param name Function name
- * @param args Function arguments (default empty object)
- * @returns Structured function configuration
- */
-declare function createFunction(name: string, args?: any): FunctionConfig;
-/**
- * Format function calls with consistent indentation for code generation
- * @param configs Array of function configurations
- * @param indentation Spaces for indentation (default 4)
- * @param specialVars Array of variable names that should be treated as code references not strings
- * @param deduplicateArgs Whether to extract duplicate arguments into variables (default false)
- * @returns Formatted string of function calls
- */
-declare function formatFunctions(configs: FunctionConfig[], indentation?: number, specialVars?: string[], deduplicateArgs?: boolean): string;
-
-declare function genEnsureSafeVar(name: string | any): string;
-declare function getAllEntries(obj: object): [string, any][];
-
-declare function hash(data: any): string;
-
-declare function isNuxt(): boolean;
-declare function isNitro(): boolean;
-declare function isH3(): boolean;
-
-declare function useLogger(tag?: string, options?: Partial<ConsolaOptions>): ConsolaInstance;
-
-/**
- * Migration bilgisi
- */
-interface MigrationInfo {
-    /** Migration zaman damgası */
-    timestamp: number;
-    /** Migration dosya adı */
-    file: string;
-    /** Migration oluşturulma tarihi */
-    created: string;
-    /** Migration açıklaması */
-    description?: string;
-    /** Patch formatında mı? */
-    isPatch?: boolean;
-}
-/**
- * İzin migration verisi
- */
-interface MigrationData {
-}
-/**
- * JSON Patch formatı (RFC6902)
- */
-type JsonPatch = Array<rfc6902.Operation>;
-/**
- * Migration durumu
- */
-declare enum MigrationStatus {
-    SUCCESS = "success",
-    ERROR = "error",
-    SKIPPED = "skipped"
-}
-/**
- * Migration options
- */
-interface MigrationOptions {
-    /** Migration açıklaması (opsiyonel) */
-    description?: string;
-    /** Değişiklikler için log göster */
-    verbose?: boolean;
-    /** JSON dosyasını pretty-print formatında kaydet */
-    prettyPrint?: boolean;
-    /** Patch formatını kullanmalı mı? */
-    usePatch?: boolean;
-    /** Değişiklik yoksa dosya oluşturma */
-    skipIfNoChanges?: boolean;
-}
-/**
- * Migration başlatma sonucu
- */
-interface MigrationResult {
-    /** İşlem başarılı mı? */
-    success: boolean;
-    /** Migration durumu */
-    status: MigrationStatus;
-    /** Migration dosya yolu (başarılıysa) */
-    filePath?: string;
-    /** Migration zaman damgası (başarılıysa) */
-    timestamp?: number;
-    /** Hata mesajı (başarısızsa) */
-    error?: string;
-    /** Patch türünde mi? */
-    isPatch?: boolean;
-    /** Migration verisi */
-    data?: MigrationData[] | JsonPatch;
-}
-/**
- * Migration oluşturur
- *
- * @param data Migration verisi
- * @param directoryPath Migration dizini
- * @param fileNamePrefix Dosya adı öneki
- * @param options Migration seçenekleri
- * @returns Migration sonucu
- */
-declare function generateMigration<T>(data: T, directoryPath: string, fileNamePrefix?: string, options?: MigrationOptions): Promise<MigrationResult>;
-/**
- * Belirli bir migration dosyasının bilgilerini alır
- *
- * @param migrationsDir Migration dizini
- * @param fileName Dosya adı (belirtilmezse son migration dosyası)
- * @returns Migration bilgileri ve verisi
- */
-declare function getMigration(migrationsDir: string, fileName?: string): Promise<MigrationResult>;
-/**
- * Tüm migration dosyalarını listeler
- *
- * @param migrationsDir Migration dizini
- * @param filePrefix Dosya adı öneki filtreleme (opsiyonel)
- * @returns Migration listesi
- */
-declare function listMigrations(migrationsDir: string, filePrefix?: string): Promise<MigrationInfo[]>;
-/**
- * Migration'ları ileri uygular (son duruma getirir)
- *
- * @param migrationsDir Migration dizini
- * @param targetTimestamp Hedef zaman damgası (belirtilmezse son migration'a kadar)
- * @returns Migration sonucu
- */
-declare function migrationUp(migrationsDir: string, targetTimestamp?: number): Promise<MigrationResult>;
-/**
- * Migration'ları geri alır (belirtilen noktaya kadar veya bir önceki migration'a)
- *
- * @param migrationsDir Migration dizini
- * @param targetTimestamp Hedef zaman damgası (belirtilmezse bir önceki migration'a döner)
- * @returns Migration sonucu
- */
-declare function migrationDown(migrationsDir: string, targetTimestamp?: number): Promise<MigrationResult>;
-
-/**
- * Define a Silgi module, automatically merging defaults with user provided options, installing
- * any hooks that are provided, and calling an optional setup function for full control.
- */
-declare function defineSilgiModule<TOptions extends ModuleOptionsCustom>(definition: ModuleDefinition<TOptions, Partial<TOptions>, false> | SilgiModule<TOptions, Partial<TOptions>, false>): SilgiModule<TOptions, TOptions, false>;
-declare function defineSilgiModule<TOptions extends ModuleOptionsCustom>(): {
-    with: <TOptionsDefaults extends Partial<TOptions>>(definition: ModuleDefinition<TOptions, TOptionsDefaults, true> | SilgiModule<TOptions, TOptionsDefaults, true>) => SilgiModule<TOptions, TOptionsDefaults, true>;
-};
-
-declare function prettyPath(p: string, highlight?: boolean): string;
-declare function resolveSilgiPath(path: string, silgiCLIOptions: SilgiCLI['options'], base?: string): string;
-
-declare function defineSilgiPreset<P extends SilgiPreset, M extends SilgiPresetMeta>(preset: P, meta?: M): P & {
-    _meta: SilgiPresetMeta;
-};
-
-interface ResolvePathOptions {
-    modulesDir?: string[];
-    /** Base for resolving paths from. Default is Nuxt rootDir. */
-    cwd?: string;
-    /** An object of aliases. Default is Nuxt configured aliases. */
-    alias?: Record<string, string>;
-    /** The file extensions to try. Default is Nuxt configured extensions. */
-    extensions?: string[];
-    /**
-     * Whether to fallback to the original path if the resolved path does not exist instead of returning the normalized input path.
-     *
-     * @default false
-     */
-    fallbackToOriginal?: boolean;
-}
-/**
- * Resolve full path to a file or directory respecting Nuxt alias and extensions options
- *
- * If path could not be resolved, normalized input path will be returned
- */
-declare function resolvePath(path: string, opts?: ResolvePathOptions): Promise<string>;
-/**
- * Resolve path aliases respecting Nuxt alias options
- */
-declare function resolveAlias(path: string, alias?: Record<string, string>): string;
-interface Resolver {
-    resolve: (...path: string[]) => string;
-    resolvePath: (path: string, opts?: ResolvePathOptions) => Promise<string>;
-}
-/**
- * Create a relative resolver
- */
-declare function createResolver(base: string | URL): Resolver;
-declare function resolveSilgiModule(base: string, paths: string[]): Promise<string[]>;
-
-/**
- * Renders given template during build into the virtual file system (and optionally to disk in the project `buildDir`)
- */
-declare function addTemplate<T>(_template: SilgiTemplate<T> | string): ResolvedSilgiTemplate<T>;
-/**
- * Normalize a silgi template object
- */
-declare function normalizeTemplate<T>(template: SilgiTemplate<T> | string, buildDir?: string): ResolvedSilgiTemplate<T>;
-
-/**
- * @deprecated
- */
-declare function useRequest<T extends IncomingMessage>(event: SilgiEvent): T | (IncomingMessage & {
-    originalUrl?: string;
-});
-/**
- * Extract the client's IP address from request headers with high accuracy
- * @param req - The incoming HTTP request (Fetch API Request)
- * @returns The client's IP address or empty string if not found
- */
-declare function getIpAddress(req: Request): string;
-
-declare function relativeWithDot(from: string, to: string): string;
-declare function toArray<T>(value: T | T[]): T[];
-/**
- * Filter out items from an array in place. This function mutates the array.
- * `predicate` get through the array from the end to the start for performance.
- *
- * This function should be faster than `Array.prototype.filter` on large arrays.
- */
-declare function filterInPlace<T>(array: T[], predicate: (item: T, index: number, arr: T[]) => unknown): T[];
-declare const MODE_RE: RegExp;
-/**
- * Check if a Silgi module is installed by name.
- *
- * This will check both the installed modules and the modules to be installed. Note
- * that it cannot detect if a module is _going to be_ installed programmatically by another module.
- */
-declare function hasSilgiModule(moduleKey: string, silgi?: SilgiCLI): boolean;
-declare function hasInstalledModule(moduleKey: string, silgi?: SilgiCLI): boolean;
-declare const baseHeaderBannerComment: string[];
-declare function processFilePath(src: string): string;
-declare function isPresents(names: PresetName[]): boolean;
-declare function isRuntimePresents(names: PresetName[]): boolean;
-declare function removeExtension(filePath: string, force?: boolean): string;
-declare function getServicePath(_route: string): {
-    method: string;
-    type: string;
-    route: string;
-};
-
-export { MODE_RE, MigrationStatus, addCommands, addCoreFile, addImports, addNPMPackage, addTemplate, baseHeaderBannerComment, createFunction, createFunctionConfigs, createResolver, defineFramework, defineSilgiModule, defineSilgiPreset, directoryToURL, filterInPlace, formatFunctions, genEnsureSafeVar, generateMigration, getAllEntries, getIpAddress, getMigration, getServicePath, hasError, hasInstalledModule, hasSilgiModule, hash, isDirectory, isH3, isNitro, isNuxt, isPresents, isRuntimePresents, listMigrations, migrationDown, migrationUp, normalizeTemplate, prettyPath, processFilePath, relativeWithDot, removeExtension, resolveAlias, resolvePath, resolveSilgiModule, resolveSilgiPath, toArray, tryResolveModule, useLogger, useRequest, writeFile };
-export type { FunctionConfig, JsonPatch, MigrationData, MigrationInfo, MigrationOptions, MigrationResult };
+import { addCommands$1 as addCommands } from "./add/add-commands.mjs";
+import { addCoreFile$1 as addCoreFile } from "./add/add-core-file.mjs";
+import { addImports$1 as addImports } from "./add/add-imports.mjs";
+import { addNPMPackage$1 as addNPMPackage } from "./add/add-npm.mjs";
+import { defineFramework$1 as defineFramework } from "./define.mjs";
+import { hasError$1 as hasError } from "./errors.mjs";
+import { directoryToURL$1 as directoryToURL, tryResolveModule$1 as tryResolveModule } from "./esm.mjs";
+import { isDirectory$1 as isDirectory, writeFile$1 as writeFile } from "./fs.mjs";
+import { FunctionConfig, createFunction$1 as createFunction, createFunctionConfigs$1 as createFunctionConfigs, formatFunctions$1 as formatFunctions } from "./function-utils.mjs";
+import { genEnsureSafeVar$1 as genEnsureSafeVar, getAllEntries$1 as getAllEntries } from "./gen.mjs";
+import { hash$1 as hash } from "./hash.mjs";
+import { isH3$1 as isH3, isNitro$1 as isNitro, isNuxt$1 as isNuxt } from "./isFramework.mjs";
+import { useLogger$1 as useLogger } from "./logger.mjs";
+import { JsonPatch, MigrationData, MigrationInfo, MigrationOptions, MigrationResult, MigrationStatus$1 as MigrationStatus, generateMigration$1 as generateMigration, getMigration$1 as getMigration, listMigrations$1 as listMigrations, migrationDown$1 as migrationDown, migrationUp$1 as migrationUp } from "./migration.mjs";
+import { defineSilgiModule$1 as defineSilgiModule } from "./module.mjs";
+import { prettyPath$1 as prettyPath, resolveSilgiPath$1 as resolveSilgiPath } from "./path.mjs";
+import { defineSilgiPreset$1 as defineSilgiPreset } from "./preset.mjs";
+import { createResolver$2 as createResolver, resolveAlias$1 as resolveAlias, resolvePath$1 as resolvePath, resolveSilgiModule$1 as resolveSilgiModule } from "./resolve.mjs";
+import { addTemplate$1 as addTemplate, normalizeTemplate$1 as normalizeTemplate } from "./template.mjs";
+import { getIpAddress$1 as getIpAddress, useRequest$1 as useRequest } from "./useRequest.mjs";
+import { MODE_RE$1 as MODE_RE, baseHeaderBannerComment$1 as baseHeaderBannerComment, filterInPlace$1 as filterInPlace, getServicePath$1 as getServicePath, hasInstalledModule$2 as hasInstalledModule, hasSilgiModule$1 as hasSilgiModule, isPresents$1 as isPresents, isRuntimePresents$1 as isRuntimePresents, processFilePath$1 as processFilePath, relativeWithDot$1 as relativeWithDot, removeExtension$1 as removeExtension, toArray$1 as toArray } from "./utils.mjs";
+export { FunctionConfig, JsonPatch, MODE_RE, MigrationData, MigrationInfo, MigrationOptions, MigrationResult, MigrationStatus, addCommands, addCoreFile, addImports, addNPMPackage, addTemplate, baseHeaderBannerComment, createFunction, createFunctionConfigs, createResolver, defineFramework, defineSilgiModule, defineSilgiPreset, directoryToURL, filterInPlace, formatFunctions, genEnsureSafeVar, generateMigration, getAllEntries, getIpAddress, getMigration, getServicePath, hasError, hasInstalledModule, hasSilgiModule, hash, isDirectory, isH3, isNitro, isNuxt, isPresents, isRuntimePresents, listMigrations, migrationDown, migrationUp, normalizeTemplate, prettyPath, processFilePath, relativeWithDot, removeExtension, resolveAlias, resolvePath, resolveSilgiModule, resolveSilgiPath, toArray, tryResolveModule, useLogger, useRequest, writeFile };