chore(sync): sdk from monorepo

.github/workflows/ci.yml

@@ -0,0 +1,29 @@
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: oven-sh/setup-bun@v1
+        with:
+          bun-version: latest
+
+      - name: Install dependencies
+        run: bun install
+
+      - name: Lint
+        run: bun run lint
+
+      - name: Build
+        run: bun run build
+
+      - name: Test
+        run: bun test

.gitignore

@@ -0,0 +1,6 @@
+node_modules
+dist
+.turbo
+.DS_Store
+*.log
+coverage

README.md

@@ -44,7 +44,7 @@ console.log(session.checkout_url);
 const payark = new PayArk({
   apiKey: "sk_test_...", // Required – your project secret key
   sandbox: true, // Optional – enable Sandbox Mode (default: false)
-  baseUrl: "http://localhost:3001", // Optional – for local dev
+  baseUrl: "https://payark-api.codimo-dev.workers.dev", // Optional – for local dev
   timeout: 10_000, // Optional – request timeout in ms (default: 30s)
   maxRetries: 2, // Optional – retries on 5xx errors (default: 2)
 });
@@ -206,7 +206,12 @@ try {
 
 ## Retries & Idempotency
 
-The SDK automatically retries **server errors (500, 502, 503, 504)** with exponential back-off and jitter. Client errors (4xx) fail immediately since they are deterministic.
+The SDK automatically retries:
+
+- **Server errors (`500`, `502`, `503`, `504`)** with exponential back-off and jitter.
+- **Rate limits (`429`)** only when the API provides a valid `Retry-After` header.
+
+Other client errors (`4xx`) fail immediately since they are deterministic.
 
 - Default: 2 retries
 - Back-off: 500ms → 1s → 2s (+ random jitter)
@@ -261,6 +266,23 @@ tests/
     └── sdk.test.ts          – End-to-end workflows (checkout → payment → recovery)
 ```
 
+## Effect API 🚀
+
+For users of the **[Effect](https://effect.website/)** ecosystem, we provide a dedicated package **[@payark/sdk-effect](https://www.npmjs.com/package/@payark/sdk-effect)**.
+
+This package offers a fully functional, type-safe API with:
+
+- **Zero Promise overhead**: Uses `@effect/platform/HttpClient` natively.
+- **Runtime Validation**: Validates all responses using `@effect/schema`.
+- **Typed Errors**: Tagged errors for clean matching.
+- **Observability**: Built-in support for Effect's tracing and spans.
+
+```bash
+bun add @payark/sdk-effect
+```
+
+See the [@payark/sdk-effect documentation](../sdk-effect/README.md) for more details.
+
 ## License
 
 MIT

docs/PLAN-EFFECT-SDK.md

@@ -0,0 +1,38 @@
+# Plan: Extract @payark/sdk-effect into a standalone package
+
+## Goal
+
+Restore @payark/sdk to a zero-dependency package and create a high-performance @payark/sdk-effect package.
+
+## Phase 1: Infrastructure
+
+- [ ] Create `packages/sdk-effect` directory.
+- [ ] Initialize `package.json` with `@effect/*` dependencies.
+- [ ] Setup `tsup.config.ts`, `tsconfig.json`, and `bun` testing.
+- [ ] Copy shared types from `packages/sdk/src/types.ts` to reaching accessible location or link them.
+
+## Phase 2: Code Migration
+
+- [ ] Move `src/effect/*` from `sdk` to `sdk-effect/src`.
+- [ ] Refactor `http.ts` in `sdk-effect` to be completely independent of `sdk/src/client`.
+- [ ] Remove `effect` dependencies from `packages/sdk/package.json`.
+- [ ] Clean up `packages/sdk/src/effect` (delete directory).
+- [ ] Update `packages/sdk/src/client.ts` to remove the `.effect` property.
+
+## Phase 3: Optimization & Polish
+
+- [ ] Implement `Effect.withSpan` for all resource methods for observability.
+- [ ] Add `Config` provider for global API keys.
+- [ ] Implement `Stream` support for `list` methods (for effortless pagination).
+- [ ] Update `sdk-effect` tests and ensure they pass in the new location.
+
+## Phase 4: Documentation
+
+- [ ] Create `packages/sdk-effect/README.md`.
+- [ ] Update `packages/sdk/README.md` to point to the new package.
+
+## Verification
+
+- [ ] `bun run build` in both packages.
+- [ ] `bun test` in both packages.
+- [ ] Zero-dependency check for `@payark/sdk`.

docs/PLAN.md

@@ -0,0 +1,68 @@
+# Plan: Implement Effect in PayArk SDK
+
+This document outlines the strategy for integrating the [Effect](https://effect.website/) ecosystem into the PayArk SDK to provide a type-safe, functional, and robust developer experience.
+
+## Objectives
+
+- Integrate `effect` as a core dependency for internal logic (HTTP, Error handling).
+- Expose an `Effect`-based API side-by-side with the current Promise-based API.
+- Leverage Effect Schema for robust runtime validation and type-safe error reporting.
+- Implement specialized "Effectful" resources (e.g., `checkout.effect`, `payments.effect`).
+
+## 1. Analysis & Infrastructure
+
+- [ ] Research Effect Ecosystem: Study `Schema`, `HttpClient`, `Effect` patterns for SDKs.
+- [ ] Define Core Effect Types: Map existing `PayArkError` to Effect `Data.Error` or tagged unions.
+- [ ] Define API Schema: Use `@effect/schema` to define request/response shapes for better runtime safety.
+
+## 2. Implementation: Core Layers
+
+- [ ] **HTTP Layer (`HttpClient`)**:
+  - Optional: Refactor internal `HttpClient` to use `@effect/platform/HttpClient`.
+  - Map HTTP errors to specialized Effect types.
+- [ ] **Error Handling**:
+  - Convert `errors.ts` definitions to be Effect-compatible.
+  - Implement a centralized error mapper from raw API responses to Effect errors.
+
+## 3. Implementation: Resource Extension
+
+- [ ] Update `BaseResource`: Add support for Effect-returning methods.
+- [ ] **Checkout Resource**:
+  - Implement `checkout.createEffect()` or `checkout.effect`.
+- [ ] **Payments Resource**:
+  - Implement `payments.listEffect()`, `payments.getEffect()`.
+- [ ] **Project Resource**:
+  - Implement `projects.listEffect()`.
+
+## 4. API Exposure & Documentation
+
+- [ ] Update `PayArk` class to expose the Effect flavor.
+- [ ] Update `index.ts` re-exports.
+- [ ] Update README with examples of using the Effect API.
+- [ ] Add `examples/` folder showing Effect integration in Next.js/Express.
+
+## 5. Verification & Testing
+
+- [ ] Unit Tests: Validate Effect-based methods return correct results/errors.
+- [ ] Integration Tests: Use TestHttpClient to mock API responses and verify Effect behavior.
+- [ ] Ensure backward compatibility with existing Promise API.
+
+---
+
+## Decisions
+
+- **Namespaced API**: We will expose the Effect API via `payark.effect.*` (e.g., `payark.effect.checkout.create`). This keeps the top-level API clean while providing a sandbox for functional patterns.
+- **Internal Refactor**: We will implement a new `EffectHttpClient` that leverages `@effect/platform/HttpClient`. This allows us to use Effect's native retry, timeout, and tracing capabilities without touching the legacy `fetch` logic for the Promise API.
+- **Schema First**: We will integrate `@effect/schema` for the Effect API. This ensures that any data coming from the Effect side is validated at runtime, providing much better error messages than a simple `try/catch`.
+
+## Status
+
+- [x] Initial Research
+- [x] Plan Created
+- [x] `effect` package added to `packages/sdk/package.json`
+- [x] Implementation Strategy Finalized
+- [x] Infrastructure (Errors, HTTP Client, Config Service)
+- [x] Schema Definitions (Checkout, Payment, Project, Paginated)
+- [x] Resource Implementation (Checkout, Payments, Projects)
+- [x] Verification (Unit & High-Level Tests)
+- [x] Documentation (README)

package.json

@@ -1,6 +1,6 @@
 {
     "name": "@payark/sdk",
-    "version": "0.1.0",
+    "version": "0.1.7",
     "description": "Official TypeScript SDK for the PayArk payment gateway API.",
     "main": "dist/index.js",
     "module": "dist/index.mjs",
@@ -38,5 +38,10 @@
         "tsup": "^8.0.0",
         "typescript": "^5.7.0",
         "@types/node": "^20.0.0"
+    },
+    "dependencies": {
+        "@effect/platform": "^0.94.5",
+        "@payark/sdk-effect": "^0.1.6",
+        "effect": "^3.19.19"
     }
-}
+}