reqwise-core 1.0.0 → 1.1.1

package/README.md

@@ -0,0 +1,71 @@
+# @reqwise/core 🚀
+
+> **Reqwise**, React və vanilla JavaScript tətbiqlərində edilən HTTP API istəklərini (Axios/Fetch) tutan, qeyd edən və tətbiq daxilində vizuallaşdıran güclü bir tərtibatçı (developer) alətidir.
+
+Tətbiqinizin içində mini bir **Postman** və ya **Chrome DevTools Network** paneli kimi işləyir. Sayfada üzən (floating aside) bir panel vasitəsilə istəkləri real vaxt rejimində izləyə, tarixçəyə baxa və tək kliklə test istəkləri göndərə bilərsiniz.
+
+---
+
+## ✨ Özəlliklər
+
+- 🔄 **Tam HTTP İzləmə:** `ReqwiseClient` üzərindən keçən bütün Payload-ları (method, url, body, headers, duration, response) avtomatik qeyd edir.
+- 💾 **Davamlılıq (Persistence):** İstəkləri `localStorage` (`reqwise_log` açarı) üzərində saxlayır, səhifə yenilənsə belə itmir.
+- 🛡️ **Təhlükəsizlik (Masking):** Həssas məlumatları gizlətmək üçün `maskHeaders` (məs. Authorization) və `maskFields` (məs. password) dəstəyi.
+- 🌍 **Beynəlmiləlləşdirmə (i18n):** Daxili 15 dil dəstəyi və ağıllı `t(key, lang)` köməkçisi.
+- ⌨️ **Hotkey Dəstəyi:** Özəlləşdirilə bilən qısayollar (məs. `ctrl+shift+e`) ilə paneli gizlədib-açma.
+
+---
+
+## 📦 Qurulum (Installation)
+
+Paketi layihənizə `npm` və ya `pnpm` vasitəsilə əlavə edin:
+
+```bash
+npm install @reqwise/core
+# və ya
+pnpm add @reqwise/core
+```
+
+---
+
+## 🚀 İşləmə Məntiqi (Architecture Flow)
+
+Reqwise tətbiqiniz ilə backend arasında bir körpü rolunu oynayır:
+
+front ➔ ReqwiseClient ➔ axios (və ya fetch fallback) ➔ backend
+
+1. İstək göndərilir ➔ Payload (`ReqwiseEntry` formatında) qeyd olunur.
+2. Gerçək HTTP istəyi icra edilir.
+3. Cavab (Response) alınır ➔ Müddət (duration) və status qeyd olunur.
+4. Məlumatlar `reqwise_log` ilə local-a yazılır və `reqwise:update` eventi tetiklenir.
+5. DOM-a yeridilmiş `#reqwise-panel` interfeysi dərhal yenilənir.
+
+---
+
+## 🛠️ Konfiqurasiya Nümunəsi
+
+Projenin core tərəfini başlamaq üçün `core.configure()` funksiyasından istifadə olunur:
+
+```typescript
+import { core } from "@reqwise/core";
+
+core.configure({
+  theme: "dark",
+  placement: "right",
+  enabled: true,
+  maxItems: 500,
+  persistHistory: true,
+  ignore: ["/health", "/ping"],
+  maskHeaders: ["Authorization"]
+});
+```
+
+---
+
+## 🤖 Reqwise Development Agent (RDA)
+
+Bu layihə **RDA (Reqwise Development Agent)** adlı xüsusi bir AI arxitekturası tərəfindən idarə olunur və inkişaf etdirilir. RDA layihənin struktur bütövlüyünü qorumaq, `.b64.txt` kimi böyük faylların bundle-a girməsinin qarşısını almaq (`/bundle-check`) və ciddi isimləndirmə qaydalarına riayət etmək üçün xüsusi əmrlərə (`/status`, `/fix`, `/checklist`) malikdir.
+
+## 📄 Lisenziya
+
+MIT © Alizadeh

package/dist/index.d.mts

@@ -46,11 +46,21 @@ declare function initClient(c?: Partial<ReqwiseConfig>): void;
 declare function recordPartial(entry: Partial<ReqwiseEntry>): void;
 declare function wrapAxios(instance: any): void;
 declare function fetchWithRecord(input: RequestInfo, init?: RequestInit & RequestConfig): Promise<Response>;
+declare function get(url: string, config?: RequestConfig): Promise<any>;
+declare function post(url: string, data?: unknown, config?: RequestConfig): Promise<any>;
+declare function put(url: string, data?: unknown, config?: RequestConfig): Promise<any>;
+declare function patch(url: string, data?: unknown, config?: RequestConfig): Promise<any>;
+declare function del(url: string, config?: RequestConfig): Promise<any>;
 declare const ReqwiseClient: {
     init: typeof initClient;
     wrapAxios: typeof wrapAxios;
     fetch: typeof fetchWithRecord;
     record: typeof recordPartial;
+    get: typeof get;
+    post: typeof post;
+    put: typeof put;
+    patch: typeof patch;
+    delete: typeof del;
 };
 
 type Translations = Record<string, string>;
@@ -104,7 +114,7 @@ interface PanelConfig {
     defaultOpen?: boolean;
     placement?: Placement;
     hotkey?: string;
-    theme?: 'dark' | 'light' | 'auto';
+    theme?: 'dark' | 'light' | 'system';
 }
 type RendererFn = (container: HTMLElement) => void;
 declare const panel: {
@@ -150,6 +160,11 @@ declare const _default: {
         wrapAxios: typeof wrapAxios;
         fetch: typeof fetchWithRecord;
         record: typeof recordPartial;
+        get: typeof get;
+        post: typeof post;
+        put: typeof put;
+        patch: typeof patch;
+        delete: typeof del;
     };
 };
 

package/dist/index.d.ts

@@ -46,11 +46,21 @@ declare function initClient(c?: Partial<ReqwiseConfig>): void;
 declare function recordPartial(entry: Partial<ReqwiseEntry>): void;
 declare function wrapAxios(instance: any): void;
 declare function fetchWithRecord(input: RequestInfo, init?: RequestInit & RequestConfig): Promise<Response>;
+declare function get(url: string, config?: RequestConfig): Promise<any>;
+declare function post(url: string, data?: unknown, config?: RequestConfig): Promise<any>;
+declare function put(url: string, data?: unknown, config?: RequestConfig): Promise<any>;
+declare function patch(url: string, data?: unknown, config?: RequestConfig): Promise<any>;
+declare function del(url: string, config?: RequestConfig): Promise<any>;
 declare const ReqwiseClient: {
     init: typeof initClient;
     wrapAxios: typeof wrapAxios;
     fetch: typeof fetchWithRecord;
     record: typeof recordPartial;
+    get: typeof get;
+    post: typeof post;
+    put: typeof put;
+    patch: typeof patch;
+    delete: typeof del;
 };
 
 type Translations = Record<string, string>;
@@ -104,7 +114,7 @@ interface PanelConfig {
     defaultOpen?: boolean;
     placement?: Placement;
     hotkey?: string;
-    theme?: 'dark' | 'light' | 'auto';
+    theme?: 'dark' | 'light' | 'system';
 }
 type RendererFn = (container: HTMLElement) => void;
 declare const panel: {
@@ -150,6 +160,11 @@ declare const _default: {
         wrapAxios: typeof wrapAxios;
         fetch: typeof fetchWithRecord;
         record: typeof recordPartial;
+        get: typeof get;
+        post: typeof post;
+        put: typeof put;
+        patch: typeof patch;
+        delete: typeof del;
     };
 };