Merge main into develop

.github/workflows/ci.yml

@@ -38,7 +38,7 @@ jobs:
         run: pnpm changeset:status
 
       - name: Build all packages
-        run: pnpm -r --workspace-concurrency=Infinity --filter=!@oaknetwork/contracts build
+        run: pnpm -r --workspace-concurrency=Infinity build
 
       - name: Run tests with coverage (enforces 100% threshold)
         run: pnpm -r --workspace-concurrency=Infinity --filter=!@oaknetwork/contracts test --coverage

.github/workflows/release.yml

@@ -47,7 +47,7 @@ jobs:
 
       - name: Build packages
         if: steps.changesets.outputs.hasChangesets == 'false'
-        run: pnpm --filter=!@oaknetwork/contracts build
+        run: pnpm build
 
       - name: Update npm for OIDC support
         if: steps.changesets.outputs.hasChangesets == 'false'

.vscode/settings.json

@@ -17,9 +17,9 @@
   "jest.runMode": "on-demand",
   "jest.virtualFolders": [
     {
-      "name": "api",
-      "rootPath": "packages/api",
-      "jestCommandLine": "node packages/api/scripts/jest-run-exact.js --",
+      "name": "payments",
+      "rootPath": "packages/payments",
+      "jestCommandLine": "node packages/payments/scripts/jest-run-exact.js --",
       "pathToConfig": "jest.config.js"
     },
     {

CHANGELOG.md

@@ -10,7 +10,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 
 - **Webhook Verification Utilities**: New `verifyWebhookSignature()` and `parseWebhookPayload()` functions for secure webhook handling using HMAC-SHA256 with timing-safe comparison
-- **RefundService**: Added to Crowdsplit product facade, exposing refund functionality that was previously available but not exposed
+- **RefundService**: Exposed refund functionality that was previously available but not exported
 - **Helper Utilities**:
   - `withAuth()`: Higher-order function for wrapping HTTP operations with authentication (eliminates 35+ duplications)
   - `buildUrl()`: Centralized URL construction with consistent trailing slash handling (standardizes 36+ URL constructions)
@@ -29,7 +29,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - **BREAKING**: Removed `createAuthService()` wrapper - use `client.getAccessToken()` and `client.grantToken()` directly
 - **Type System Improvements**:
   - Replaced `any` with `unknown` in httpClient methods (`post`, `put`, `patch`) and retryHandler for better type safety
-  - Converted `ReturnType<typeof>` to direct interface imports in Crowdsplit facade
+  - Converted `ReturnType<typeof>` to direct interface imports in service types
   - Converted intersection types to standalone interfaces in Payment and Transfer types
 - **Dependency Updates**:
   - Moved `nock` and `dotenv` from dependencies to devDependencies (reduces production bundle size)
@@ -97,7 +97,7 @@ const client = createOakClient({
 **Before:**
 
 ```typescript
-import { createAuthService } from "@oaknetwork/api";
+import { createAuthService } from "@oaknetwork/payments-sdk";
 
 const auth = createAuthService(client);
 const token = await auth.getAccessToken();
@@ -136,7 +136,10 @@ httpClient.post<ResponseType>(url, requestData as RequestType, config);
 #### Webhook Verification
 
 ```typescript
-import { verifyWebhookSignature, parseWebhookPayload } from "@oaknetwork/api";
+import {
+  verifyWebhookSignature,
+  parseWebhookPayload,
+} from "@oaknetwork/payments-sdk";
 
 // Option 1: Verify signature only
 app.post("/webhook", (req, res) => {
@@ -173,13 +176,15 @@ app.post("/webhook", (req, res) => {
 #### RefundService Now Available
 
 ```typescript
-import { Crowdsplit } from "@oaknetwork/api/products/crowdsplit";
+import { createOakClient, createRefundService } from "@oaknetwork/payments-sdk";
 
-const crowdsplit = Crowdsplit(client);
+const client = createOakClient({
+  /* config */
+});
+const refunds = createRefundService(client);
 
-// Refund service is now exposed
-const result = await crowdsplit.refunds.create({
-  transaction_id: "txn_123",
+// Create a refund
+const result = await refunds.create("pay_123", {
   amount: 1000,
 });
 ```
@@ -189,23 +194,20 @@ const result = await crowdsplit.refunds.create({
 1. **Update Package**:
 
    ```bash
-   pnpm update @oaknetwork/api@latest
+   pnpm update @oaknetwork/payments-sdk@latest
    ```
 
 2. **Remove `clientSecret` Access**:
-
    - Search codebase for `client.config.clientSecret`
    - Store separately if needed for non-SDK purposes
    - Update to use environment variables
 
 3. **Replace `createAuthService()`**:
-
    - Search for `createAuthService`
    - Replace with direct `client.getAccessToken()` or `client.grantToken()` calls
    - Remove import
 
 4. **Add Type Assertions** (if needed):
-
    - TypeScript may require type assertions for HTTP client methods
    - Add `as RequestType` where compiler indicates `unknown` cannot be assigned
 
@@ -219,7 +221,7 @@ const result = await crowdsplit.refunds.create({
 ### Added
 
 - Initial release of Oak SDK
-- Support for Crowdsplit API
+- Support for Oak Network API
 - Customer, Payment, PaymentMethod, Transaction services
 - Transfer, Webhook, Plan, Buy, Sell services
 - OAuth 2.0 client credentials flow

CLAUDE.md

@@ -143,13 +143,13 @@ function processData(data: any): any {
 
    ```typescript
    // ✅ CORRECT
-   export interface CrowdsplitProduct {
+   export interface OakServices {
      customers: CustomerService;
      payments: PaymentService;
    }
 
    // ❌ WRONG
-   export interface CrowdsplitProduct {
+   export interface OakServices {
      customers: ReturnType<typeof createCustomerService>;
    }
    ```
@@ -230,7 +230,6 @@ create(customer: Customer.Request): Promise<Result<Customer.Response>>;
    ```
 
 4. **NEVER log sensitive data**:
-
    - No passwords, tokens, or API keys in logs
    - Sanitize error messages before logging
    - Use structured logging with sensitive field filtering
@@ -632,7 +631,7 @@ When introducing breaking changes:
 
 1. Remove references to `client.config.clientSecret`
 2. Store secret in environment variables
-3. Update to latest `@oaknetwork/api` version
+3. Update to latest `@oaknetwork/payments-sdk` version
 ```
 
 ### TSDoc Examples