jskelet 0.5.5 → 0.6.1

package/types/log.d.mts

@@ -0,0 +1,153 @@
+/**
+ * @param {{ console?: boolean, emitHttp?: boolean }} [options]
+ */
+export declare function configureLog(options?: {
+    console?: boolean;
+    emitHttp?: boolean;
+}): void;
+export declare const c: {
+    bold: (text: string) => string;
+    dim: (text: string) => string;
+    red: (text: string) => string;
+    green: (text: string) => string;
+    yellow: (text: string) => string;
+    blue: (text: string) => string;
+    magenta: (text: string) => string;
+    cyan: (text: string) => string;
+    gray: (text: string) => string;
+};
+export declare const symbols: {
+    ok: string;
+    fail: string;
+    warn: string;
+    cycle: string;
+    ready: string;
+    arrow: string;
+};
+/** @param {number} value */
+export declare function ms(value: number): string;
+/** @param {number} bytes */
+export declare function size(bytes: number): string;
+/**
+ * Saat, yerelden bağımsız olarak 24 saatlik biçimde. Dil etiketi vermek
+ * sunucunun bulunduğu makinenin diline göre `ÖÖ/ÖS` ya da `AM/PM` basılmasına
+ * yol açıyordu; log satırının genişliği sabit kalmalı.
+ *
+ * @returns {string} `01:49:02`
+ */
+export declare function clock(): string;
+/**
+ * @param {string} version
+ * @param {string} mode
+ * @param {string} [root]
+ */
+export declare function banner(version: string, mode: string, root?: string): void;
+/** @param {string} title */
+export declare function section(title: string): void;
+/**
+ * Build adımı. TTY'de spinner döner; bitince satır aynı ızgaraya oturur.
+ *
+ * @param {string} label
+ * @returns {{ done: (detail?: string) => number, fail: (error: unknown) => void }}
+ */
+export declare function task(label: string): {
+    done: (detail?: string) => number;
+    fail: (error: unknown) => void;
+};
+/**
+ * Adımın sütununa yazılacak kısa özet; ikinci ve sonraki çağrılar alt satıra
+ * düşer. Adım dışında çağrılırsa doğrudan basılır.
+ *
+ * @param {string} text
+ */
+export declare function detail(text: string): void;
+/**
+ * Sütuna yazılacak özeti, adım içinde daha önce ayrıntı basılmış olsa bile
+ * öne alır (ör. font indirme satırlarından sonra "4/4 weights").
+ *
+ * @param {string} text
+ */
+export declare function summary(text: string): void;
+/** @param {string} text */
+export declare function warn(text: string): void;
+/**
+ * Bölüm gövdesindeki düz satır (ör. çıktı boyutları).
+ * @param {string} text
+ */
+export declare function line(text: string): void;
+/** @param {string} text */
+export declare function error(text: string): void;
+/**
+ * Başlangıç özeti: süre, adres ve watch durumu.
+ *
+ * @param {{ elapsed: number, url?: string | null, watching?: boolean, label?: string }} info
+ */
+export declare function ready({ elapsed, url, watching, label }: {
+    elapsed: number;
+    url?: string | null;
+    watching?: boolean;
+    label?: string;
+}): void;
+/**
+ * Çalışma anı olayı: `01:49:03  ✓ css        rebuilt   195.9 kB   150ms`
+ *
+ * Hizalama ANSI kodlarından etkilenmesin diye `message` düz metin olmalı;
+ * ek bilgi `note` ile geçilir.
+ *
+ * @param {{ symbol?: string, scope: string, message: string, note?: string, time?: number | null }} info
+ */
+export declare function event({ symbol, scope, message, note, time }: {
+    symbol?: string;
+    scope: string;
+    message: string;
+    note?: string;
+    time?: number | null;
+}): void;
+/**
+ * HTTP isteği. Cache bilgisi yalnızca gerçekten anlamlıysa (HIT) gösterilir;
+ * her satıra MISS yazmak akışı okunmaz hâle getiriyor.
+ *
+ * @param {{ method: string, url: string, status: number, ms: number, cache?: string | null }} info
+ */
+export declare function http(info: {
+    method: string;
+    url: string;
+    status: number;
+    ms: number;
+    cache?: string | null;
+}): void;
+/**
+ * Çerçeveli bilgi kutusu.
+ *
+ * Açılış logunda kaybolmaması gereken tek şey sır: önbellek panelinin şifresi
+ * her restart'ta değişiyor ve kullanıcı onu bir kez, akışın içinde görüyor.
+ * Genişlik içeriğe göre büyür — bir URL'i ya da 32 haneli bir şifreyi
+ * kırpmak kutunun bütün amacını bozar.
+ *
+ * @param {{ title: string, lines: string[],
+ *   tint?: (value: string) => string }} info `lines` içinde boş string ayırıcı
+ *   satır olur. Satırlar **düz metin** olmalı: bir ANSI dizisi `length`e
+ *   sayıldığı için hizalamayı bozar, rengi çerçeve taşır.
+ */
+export declare function box({ title, lines, tint }: {
+    title: string;
+    lines: string[];
+    tint?: (value: string) => string;
+}): void;
+/**
+ * Çerçeveli hata kutusu — kendi framework'ünü geliştirirken hatanın
+ * akış içinde kaybolmaması için.
+ *
+ * @param {{ title: string, name: string, message: string, lines?: string[] }} info
+ */
+export declare function errorBox({ title, name, message, lines }: {
+    title: string;
+    name: string;
+    message: string;
+    lines?: string[];
+}): void;
+/**
+ * @param {(entry: Record<string, unknown>) => void} listener
+ * @returns {() => void} Aboneliği iptal eden fonksiyon.
+ */
+export declare function subscribe(listener: (entry: Record<string, unknown>) => void): () => void;

package/types/server/admin/actions.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @param {Record<string, any>} body
+ * @param {import('express').Request} req
+ * @returns {Promise<{ ok: boolean, code?: string,
+ *   params?: Record<string, string | number>,
+ *   parts?: ({ code: string, params?: Record<string, string | number> } | null)[] }>}
+ */
+export declare function runAction(body: Record<string, any>, req: import('express').Request): Promise<{
+    ok: boolean;
+    code?: string;
+    params?: Record<string, string | number>;
+    parts?: ({
+        code: string;
+        params?: Record<string, string | number>;
+    } | null)[];
+}>;

package/types/server/admin/auth.d.ts

@@ -0,0 +1,52 @@
+export declare const COOKIE_NAME = "jskelet_admin_sid";
+/**
+ * Aksiyon isteklerinde beklenen başlık. Tarayıcı bu başlığı çapraz site bir
+ * formla gönderemez (preflight gerekir), yani panelin kendi CSRF freni.
+ */
+export declare const ACTION_HEADER = "x-jskelet-admin";
+/** 32 haneli, süreç ömrü kadar geçerli şifre. */
+export declare const PASSWORD: string;
+/**
+ * @param {import('express').Request} req
+ * @param {string} name
+ * @returns {string | null}
+ */
+export declare function readCookie(req: import('express').Request, name: string): string | null;
+/**
+ * Süresi geçmiş oturumları eler.
+ */
+export declare function pruneSessions(): void;
+/**
+ * @param {import('express').Request} req
+ * @returns {boolean}
+ */
+export declare function authenticated(req: import('express').Request): boolean;
+/**
+ * @param {string} password
+ * @returns {boolean}
+ */
+export declare function passwordMatches(password: string): boolean;
+/**
+ * @param {number} sessionHours
+ * @returns {{ token: string, maxAge: number }}
+ */
+export declare function createSession(sessionHours: number): {
+    token: string;
+    maxAge: number;
+};
+/**
+ * @param {import('express').Request} req
+ */
+export declare function destroySession(req: import('express').Request): void;
+/**
+ * @param {string} basePath
+ * @param {string} token
+ * @param {number} maxAge
+ * @returns {string}
+ */
+export declare function sessionCookie(basePath: string, token: string, maxAge: number): string;
+/**
+ * @param {string} basePath
+ * @returns {string}
+ */
+export declare function clearSessionCookie(basePath: string): string;

package/types/server/admin/event-log.d.ts

@@ -0,0 +1,38 @@
+export type LogEntry = {
+    kind: string;
+    id: number;
+    at: number;
+    [key: string]: unknown;
+};
+/**
+ * @param {{ basePath: string, logSize: number, prewarmUserAgent?: string }} options
+ */
+export declare function configureEventLog(options: {
+    basePath: string;
+    logSize: number;
+    prewarmUserAgent?: string;
+}): void;
+/**
+ * @param {Omit<LogEntry, "id" | "at"> & { kind: string }} partial
+ * @returns {LogEntry}
+ */
+export declare function push(partial: Omit<LogEntry, "id" | "at"> & {
+    kind: string;
+}): LogEntry;
+/**
+ * @param {number} [afterId]
+ * @param {number} [limit]
+ * @returns {LogEntry[]}
+ */
+export declare function list(afterId?: number, limit?: number): LogEntry[];
+/**
+ * @param {(entry: LogEntry) => void} listener
+ * @returns {() => void}
+ */
+export declare function subscribeLive(listener: (entry: LogEntry) => void): () => void;
+/**
+ * HTTP yanıt bitiminde ring'e yazar. Admin yolları ve prewarm UA atlanır.
+ *
+ * @returns {import('express').RequestHandler}
+ */
+export declare function requestLogMiddleware(): import('express').RequestHandler;

package/types/server/admin/gate.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @param {import('express').Request} req
+ * @returns {string}
+ */
+export declare function clientKey(req: import('express').Request): string;
+/**
+ * @param {string} ua
+ * @returns {boolean}
+ */
+export declare function looksLikeBot(ua: string): boolean;
+/**
+ * Exact IP veya CIDR (`10.0.0.0/8`). IPv6 için yalnızca exact eşleşme.
+ *
+ * @param {string} ip
+ * @param {string[]} allowIps
+ * @returns {boolean}
+ */
+export declare function ipAllowed(ip: string, allowIps: string[]): boolean;
+/**
+ * @param {import('express').Request} req
+ * @returns {boolean}
+ */
+export declare function banned(req: import('express').Request): boolean;
+/**
+ * @param {import('express').Request} req
+ * @param {string} reason
+ * @param {{ banAttempts: number, banHours: number }} settings
+ */
+export declare function noteFailure(req: import('express').Request, reason: string, settings: {
+    banAttempts: number;
+    banHours: number;
+}): void;
+/**
+ * @param {import('express').Request} req
+ */
+export declare function clearOffender(req: import('express').Request): void;
+/**
+ * Kapı middleware'i: ban → IP → bot. Hepsi 404.
+ *
+ * @param {() => typeof import('../../config/defaults.js').DEFAULT_ADMIN} getSettings
+ * @returns {import('express').RequestHandler}
+ */
+export declare function gateMiddleware(getSettings: () => typeof import('../../config/defaults.js').DEFAULT_ADMIN): import('express').RequestHandler;

package/types/server/admin/inventory.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Express router stack'ini dolaşır. İç API kırılgan; yalnızca gözlem için.
+ *
+ * @param {import('express').Express} app
+ * @returns {{ method: string, path: string }[]}
+ */
+export declare function listExpressRoutes(app: import('express').Express): {
+    method: string;
+    path: string;
+}[];
+/**
+ * `routes/` altındaki (veya config.routes listesindeki) modül dosyaları.
+ *
+ * @returns {{ file: string, relative: string }[]}
+ */
+export declare function listRouteModules(): {
+    file: string;
+    relative: string;
+}[];
+/**
+ * `views/` altındaki şablon ve bileşen dosyaları.
+ *
+ * @returns {{ relative: string, kind: "ejs" | "js" | "other" }[]}
+ */
+export declare function listViews(): {
+    relative: string;
+    kind: "ejs" | "js" | "other";
+}[];
+/**
+ * Son HTTP log'larından path başına özet.
+ *
+ * @returns {Record<string, { status: number, ms: number, cache: string | null, at: number, count: number }>}
+ */
+export declare function routeActivity(): Record<string, {
+    status: number;
+    ms: number;
+    cache: string | null;
+    at: number;
+    count: number;
+}>;

package/types/server/admin/mount.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Paneli uygulamaya bağlar, istek log middleware'ini kurar ve şifreyi loglar.
+ *
+ * @param {import('express').Express} app
+ */
+export declare function mountAdmin(app: import('express').Express): void;

package/types/server/admin/router.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @param {() => typeof import('../../config/defaults.js').DEFAULT_ADMIN} getSettings
+ * @param {import('express').Express} app
+ * @returns {import('express').Router}
+ */
+export declare function createAdminRouter(getSettings: () => typeof import('../../config/defaults.js').DEFAULT_ADMIN, app: import('express').Express): import('express').Router;

package/types/server/admin/snapshot.d.ts

@@ -0,0 +1,6 @@
+export declare const BOOT_ID: string;
+/**
+ * @param {string} query Anahtar filtresi (boş → filtre yok).
+ * @returns {Promise<object>}
+ */
+export declare function snapshot(query: string): Promise<object>;

package/types/server/assets.d.ts

@@ -0,0 +1,47 @@
+/**
+ * @param {string} name Örn. "app.css", "main.js", "sprite.svg"
+ * @returns {string}
+ */
+export declare function asset(name: string): string;
+/**
+ * @param {string} name
+ * @returns {boolean}
+ */
+export declare function hasAsset(name: string): boolean;
+/**
+ * Bu build'i tanımlayan kısa kimlik (`build.json` → `id`).
+ *
+ * Paylaşımlı önbellek anahtarlarının isim alanı bu: saklanan HTML hash'li
+ * varlık yollarını gömdüğü için bir deploy'dan sonra eski HTML **geçersizdir**.
+ *
+ * Build çalışmadıysa `"dev"` döner — build çıktısı olmadan da ayağa kalkma
+ * kuralı burada da geçerli.
+ *
+ * @returns {string}
+ */
+export declare function getBuildId(): string;
+export type OptimizedImage = {
+    width: number;
+    height: number;
+    variants: {
+        width: number;
+        url: string;
+    }[];
+};
+/**
+ * `build/tasks/images.mjs` çıktısı: kaynak yolundan webp varyantlarına.
+ * Build çalışmadıysa boş kalır ve görseller orijinalleriyle servis edilir.
+ *
+ * @param {string} [src] Örn. "/hero.png"
+ * @returns {OptimizedImage | undefined}
+ */
+export declare function optimizedImage(src?: string): OptimizedImage | undefined;
+/**
+ * Sprite'taki sembol kimlikleri. Sprite yalnızca kaynakta **statik olarak**
+ * görülen ikon adlarını içerir; adı çalışma anında hesaplanan bir `icon()`
+ * çağrısı eksik sembole işaret ederse ekranda sessizce boşluk kalır. Dev'de
+ * `icon()` bu kümeye bakıp uyarır.
+ *
+ * @returns {Set<string>}
+ */
+export declare function getSpriteIds(): Set<string>;

package/types/server/auth/handoff.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Handoff uçlarını mount eder. `auth.crossSubdomainHandoff` kapalıysa no-op.
+ * create-app CSRF'den *sonra* çağırmalıdır.
+ *
+ * @param {import('express').Express} app
+ * @returns {void}
+ */
+export declare function mountAuthHandoff(app: import('express').Express): void;
+/** @returns {void} */
+export declare function _resetHandoffTickets(): void;
+/** @returns {number} */
+export declare function _handoffTicketCount(): number;

package/types/server/cache-deps.d.ts

@@ -0,0 +1,16 @@
+/**
+ * `run`'ı, içindeki `recordDependency()` çağrılarının `deps`'e yazacağı bir
+ * bağlamda çalıştırır.
+ *
+ * @template T
+ * @param {Set<string>} deps
+ * @param {() => T} run
+ * @returns {T}
+ */
+export declare function collectDependencies<T>(deps: Set<string>, run: () => T): T;
+/**
+ * Bu render'ın bir veri anahtarını okuduğunu bildirir. Bağlam yoksa no-op.
+ *
+ * @param {string} key
+ */
+export declare function recordDependency(key: string): void;

package/types/server/cache-vary.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Public Host: `x-forwarded-host` (ilk değer) yoksa `Host`. Lowercase, portsuz.
+ * IPv6 (`[::1]:3000`) köşeli parantezleri korur.
+ *
+ * @param {{ headers?: Record<string, unknown>, get?: (name: string) => string | undefined }} req
+ * @returns {string}
+ */
+export declare function publicHost(req: {
+    headers?: Record<string, unknown>;
+    get?: (name: string) => string | undefined;
+}): string;
+/**
+ * Anahtarın başına eklenen önek: `h=tr.example.com|` veya
+ * `h=…&x-locale=tr|`. Vary yoksa boş string.
+ *
+ * @param {{ headers?: Record<string, unknown>, get?: (name: string) => string | undefined }} [req]
+ * @returns {string}
+ */
+export declare function buildVaryPrefix(req?: {
+    headers?: Record<string, unknown>;
+    get?: (name: string) => string | undefined;
+}): string;
+/**
+ * Anahtardan yol kısmını çıkarır (`[vary|]yol?query` → `yol`).
+ * Invalidation hedefleri `/…` ile başlar; vary öneki eşleşmeye karışmamalı.
+ *
+ * @param {string} key
+ * @returns {string}
+ */
+export declare function pathOfCacheKey(key: string): string;

package/types/server/cloudflare.d.ts

@@ -0,0 +1,163 @@
+/** @returns {boolean} */
+export declare function cloudflareConfigured(): boolean;
+/**
+ * Panelin gösterdiği kurulum özeti. Token'ın kendisi değil, **nereden
+ * geldiği** döner.
+ *
+ * @returns {{ configured: boolean, enabled: boolean, zoneId: string | null,
+ *   tokenSource: "env" | "config" | null, hostname: string | null }}
+ */
+export declare function getCloudflareStatus(): {
+    configured: boolean;
+    enabled: boolean;
+    zoneId: string | null;
+    tokenSource: "env" | "config" | null;
+    hostname: string | null;
+};
+/**
+ * Zone künyesi + cache ile ilgili ayarlar.
+ *
+ * Ayarlar tek tek değil, tek `GET /settings` turuyla okunur ve ilgili olanlar
+ * ayıklanır. Tiered Cache ve Cache Reserve ayrı uçlarda yaşıyor; ikisi de
+ * planla sınırlı olduğu için hataları **yok sayılır**, yalnızca `null` olurlar
+ * — Free bir zone'da panel yine açılmalı.
+ *
+ * @param {{ force?: boolean }} [options]
+ * @returns {Promise<object>}
+ */
+export declare function fetchCloudflareOverview(options?: {
+    force?: boolean;
+}): Promise<object>;
+/**
+ * Zone'un cache durumu kırılımı: `hit`, `miss`, `dynamic`, `expired`… her biri
+ * için istek sayısı ve edge'den giden bayt.
+ *
+ * `httpRequestsAdaptiveGroups` bilinçli seçildi: `cacheStatus` boyutu eski
+ * `httpRequests1hGroups` veri kümesinde yok ve pek çok hesapta hata veriyor.
+ * Adaptive küme örnekleme kullanıyor, yani sayılar **tahmindir** — oranlar
+ * doğru, mutlak değerler yaklaşık.
+ *
+ * @param {{ hours?: number }} [options]
+ * @returns {Promise<{ ok: boolean, hours: number, sampled: boolean,
+ *   rows: { status: string, requests: number, bytes: number }[],
+ *   error?: string }>}
+ */
+export declare function fetchCacheAnalytics(options?: {
+    hours?: number;
+}): Promise<{
+    ok: boolean;
+    hours: number;
+    sampled: boolean;
+    rows: {
+        status: string;
+        requests: number;
+        bytes: number;
+    }[];
+    error?: string;
+}>;
+/**
+ * Bir yolun **kolo bazında** cache kırılımı.
+ *
+ * Bu, "kaç edge'de bu sayfanın kopyası var" sorusunun API'nin verdiği en yakın
+ * cevabı: son `hours` saatte hangi Cloudflare şehri o yolu kaç kez cache'ten
+ * (`hit`) ya da origin'den (`miss`, `expired`, `dynamic`) servis etti. Envanter
+ * değil, gözlem — hiç istek almamış bir edge listede görünmez, kopyası olsa da.
+ *
+ * @param {{ path: string, hours?: number }} options
+ * @returns {Promise<{ ok: boolean, path: string, hours: number,
+ *   colos: { colo: string, hits: number, misses: number }[],
+ *   hits: number, misses: number, error?: string }>}
+ */
+export declare function fetchPathEdges({ path, hours }: {
+    path: string;
+    hours?: number;
+}): Promise<{
+    ok: boolean;
+    path: string;
+    hours: number;
+    colos: {
+        colo: string;
+        hits: number;
+        misses: number;
+    }[];
+    hits: number;
+    misses: number;
+    error?: string;
+}>;
+/**
+ * Cloudflare önbelleğini düşürür.
+ *
+ * Dört hedefleme biçimi de API'nin verdiği hâliyle: `files` (tam URL),
+ * `prefixes`, `hosts`, `tags`. Hepsi artık her planda çalışıyor ama istek
+ * başına en fazla 100 anahtar kabul ediliyor; uzun listeler burada parçalanır
+ * ve **sırayla** gönderilir — paralel göndermek Free planda dakikada beş
+ * istekle sınırlı olan hız freni yüzünden yarısı reddedilen bir tur demek.
+ *
+ * @param {{ everything?: boolean, files?: string[], prefixes?: string[],
+ *   hosts?: string[], tags?: string[] }} target
+ * @returns {Promise<{ ok: boolean, purged: number, batches: number,
+ *   error?: string }>}
+ */
+export declare function purgeCloudflare(target: {
+    everything?: boolean;
+    files?: string[];
+    prefixes?: string[];
+    hosts?: string[];
+    tags?: string[];
+}): Promise<{
+    ok: boolean;
+    purged: number;
+    batches: number;
+    error?: string;
+}>;
+/**
+ * Yolları tam URL'e çevirir. Cloudflare `files` purge'ü şemayı da içeren tam
+ * URL istiyor; panel elinde yol (`/haber/abc`) tutuyor.
+ *
+ * @param {string[]} paths
+ * @param {string} [fallbackOrigin] `cloudflare.hostname` verilmediğinde
+ *   kullanılacak kök (panelin açıldığı origin).
+ * @returns {string[]}
+ */
+export declare function toCloudflareUrls(paths: string[], fallbackOrigin?: string): string[];
+/**
+ * Cache ile ilgili bir zone ayarını değiştirir.
+ *
+ * Yalnızca beyaz listedeki ayarlar: panelin işi cache, ve bir teşhis
+ * arayüzünden zone'un tamamını yeniden yapılandırılabilir yapmak gereksiz bir
+ * yüzey.
+ *
+ * @param {"development_mode" | "cache_level" | "browser_cache_ttl" |
+ *   "always_online" | "sort_query_string_for_cache"} id
+ * @param {string | number} value
+ * @returns {Promise<{ ok: boolean, value?: unknown, error?: string }>}
+ */
+export declare function setCloudflareSetting(id: "development_mode" | "cache_level" | "browser_cache_ttl" | "always_online" | "sort_query_string_for_cache", value: string | number): Promise<{
+    ok: boolean;
+    value?: unknown;
+    error?: string;
+}>;
+/**
+ * Tiered Cache ya da Cache Reserve'ü açar/kapatır. İkisi de ayrı uçlarda ve
+ * planla sınırlı; kapalı bir planda Cloudflare açıklayıcı bir hata döner ve
+ * panel onu gösterir.
+ *
+ * @param {"tiered_caching" | "cache_reserve" | "regional_tiered_cache"} feature
+ * @param {"on" | "off"} value
+ * @returns {Promise<{ ok: boolean, error?: string }>}
+ */
+export declare function setCloudflareFeature(feature: "tiered_caching" | "cache_reserve" | "regional_tiered_cache", value: "on" | "off"): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+/**
+ * Cache Reserve'ü (R2'deki kalıcı kopya) boşaltır. Purge'den ayrı bir işlem:
+ * `purge_everything` edge önbelleklerini düşürüyor, Cache Reserve'deki kopya
+ * kalıyor.
+ *
+ * @returns {Promise<{ ok: boolean, error?: string }>}
+ */
+export declare function clearCloudflareCacheReserve(): Promise<{
+    ok: boolean;
+    error?: string;
+}>;

package/types/server/create-app.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @param {{ root?: string, configFile?: string }} [options]
+ * @returns {Promise<import('express').Express>}
+ */
+export declare function createApp(options?: {
+    root?: string;
+    configFile?: string;
+}): Promise<import('express').Express>;
+/**
+ * Uygulamayı kurup dinlemeye başlar. CLI `jskelet start` bunu çağırır;
+ * gömülü kullanımda `createApp()` tercih edilir.
+ *
+ * Port doluysa başlamaz. `murder: true` veya argv'de `--murder` varsa
+ * dinleyen süreç öldürülüp bağlama denenir.
+ *
+ * @param {{ root?: string, configFile?: string, port?: number, host?: string, murder?: boolean }} [options]
+ * @returns {Promise<import('http').Server>}
+ */
+export declare function startServer(options?: {
+    root?: string;
+    configFile?: string;
+    port?: number;
+    host?: string;
+    murder?: boolean;
+}): Promise<import('http').Server>;