@startsimpli/api 0.5.4 → 0.5.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@startsimpli/api",
-  "version": "0.5.4",
+  "version": "0.5.5",
   "description": "Type-safe Django REST API client for StartSimpli apps",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/constants/endpoints.ts

@@ -49,6 +49,10 @@ export const ENDPOINTS = {
   FUNNEL_RUN_BY_ID: (runId: string) => `api/v1/funnel-runs/${runId}`,
   FUNNEL_RUN_CANCEL: (runId: string) => `api/v1/funnel-runs/${runId}/cancel`,
   FUNNEL_RUNS_GLOBAL: 'api/v1/funnel-runs',
+  // Users
+  USER_ME: 'api/v1/users/me',
+  USER_CHANGE_PASSWORD: 'api/v1/users/me/change-password',
+
   // Companies / Feature flags
   FEATURE_FLAGS: 'api/v1/companies/feature-flags',
 } as const;

package/src/index.ts

@@ -16,6 +16,8 @@ export { EntitiesApi } from './lib/entities-api';
 export { WorkflowsApi } from './lib/workflows-api';
 export { MessagesApi } from './lib/messages-api';
 export type { Message, MessageStatus as MessageApiStatus, MessageRecipient, MessagingChannel as MessagingChannelType } from './lib/messages-api';
+export { UsersApi } from './lib/users-api';
+export type { UserProfile, UpdateProfileRequest, ChangePasswordRequest, ChangePasswordResponse } from './types/user';
 export { FunnelsApi, isFunnelRunConflict, isFunnelValidationError } from './lib/funnels-api';
 export type { FunnelPreviewResult, FunnelRunFilters, FunnelTemplate } from './lib/funnels-api';
 
@@ -126,6 +128,7 @@ import { WorkflowsApi } from './lib/workflows-api';
 import { MessagesApi } from './lib/messages-api';
 import { FunnelsApi } from './lib/funnels-api';
 import { FeatureFlagsApi } from './lib/feature-flags';
+import { UsersApi } from './lib/users-api';
 
 import type { ApiClientConfig } from './lib/api-client';
 
@@ -145,5 +148,6 @@ export function createStartSimpliApi(config: ApiClientConfig = {}) {
     messages: new MessagesApi(client),
     funnels: new FunnelsApi(client),
     featureFlags: new FeatureFlagsApi(client),
+    users: new UsersApi(client),
   };
 }

package/src/lib/api-client.ts

@@ -10,6 +10,8 @@ export interface ApiClientConfig {
   getToken?: () => Promise<string | null> | string | null;
   onUnauthorized?: () => void;
   onTokenRefresh?: () => Promise<string | null>;
+  /** Auto-convert snake_case↔camelCase on responses/requests. Defaults to true. */
+  transformKeys?: boolean;
 }
 
 export class ApiClient {
@@ -24,6 +26,7 @@ export class ApiClient {
       getToken: config.getToken,
       onUnauthorized: config.onUnauthorized,
       onTokenRefresh: config.onTokenRefresh,
+      transformKeys: config.transformKeys,
       defaultHeaders: {
         'Content-Type': 'application/json',
         'Accept': 'application/json',

package/src/lib/fetch-wrapper.ts

@@ -5,6 +5,7 @@
 import type { FetchOptions, HttpMethod } from '../types';
 import { buildUrl, buildQueryString } from '../utils';
 import { ApiException, parseErrorResponse, handleFetchError } from './error-handler';
+import { snakeToCamel, camelToSnake } from '../utils/case-transform';
 
 export interface FetchWrapperConfig {
   baseUrl?: string;
@@ -12,6 +13,12 @@ export interface FetchWrapperConfig {
   onUnauthorized?: () => void;
   onTokenRefresh?: () => Promise<string | null>;
   defaultHeaders?: HeadersInit;
+  /**
+   * Automatically convert response keys from snake_case to camelCase
+   * and request body keys from camelCase to snake_case.
+   * Defaults to true — set to false for endpoints that need raw keys.
+   */
+  transformKeys?: boolean;
 }
 
 export class FetchWrapper {
@@ -131,8 +138,12 @@ export class FetchWrapper {
         return undefined as T;
       }
 
-      // Parse JSON response
-      return await response.json();
+      // Parse JSON response, auto-convert snake_case → camelCase
+      const data = await response.json();
+      if (this.config.transformKeys !== false) {
+        return snakeToCamel(data) as T;
+      }
+      return data as T;
     } catch (error) {
       handleFetchError(error);
     }
@@ -155,6 +166,15 @@ export class FetchWrapper {
   /**
    * POST request
    */
+  /** Convert request body keys to snake_case if transformKeys is enabled */
+  private serializeBody(data: unknown): string | undefined {
+    if (data === undefined || data === null) return undefined;
+    if (this.config.transformKeys !== false) {
+      return JSON.stringify(camelToSnake(data));
+    }
+    return JSON.stringify(data);
+  }
+
   async post<T, D = unknown>(
     endpoint: string,
     data?: D,
@@ -162,7 +182,7 @@ export class FetchWrapper {
   ): Promise<T> {
     return this.execute<T>('POST', endpoint, {
       ...options,
-      body: data ? JSON.stringify(data) : undefined,
+      body: this.serializeBody(data),
     });
   }
 
@@ -176,7 +196,7 @@ export class FetchWrapper {
   ): Promise<T> {
     return this.execute<T>('PUT', endpoint, {
       ...options,
-      body: data ? JSON.stringify(data) : undefined,
+      body: this.serializeBody(data),
     });
   }
 
@@ -190,7 +210,7 @@ export class FetchWrapper {
   ): Promise<T> {
     return this.execute<T>('PATCH', endpoint, {
       ...options,
-      body: data ? JSON.stringify(data) : undefined,
+      body: this.serializeBody(data),
     });
   }
 

package/src/lib/users-api.ts

@@ -0,0 +1,40 @@
+/**
+ * Users API wrapper for /api/v1/users/
+ */
+
+import type {
+  UserProfile,
+  UpdateProfileRequest,
+  ChangePasswordRequest,
+  ChangePasswordResponse,
+} from '../types/user';
+import { ENDPOINTS } from '../constants/endpoints';
+import type { ApiClient } from './api-client';
+
+export class UsersApi {
+  constructor(private client: ApiClient) {}
+
+  /**
+   * Get the current user's profile
+   */
+  async getProfile(): Promise<UserProfile> {
+    return this.client.fetch.get<UserProfile>(ENDPOINTS.USER_ME);
+  }
+
+  /**
+   * Update the current user's profile
+   */
+  async updateProfile(data: UpdateProfileRequest): Promise<UserProfile> {
+    return this.client.fetch.patch<UserProfile>(ENDPOINTS.USER_ME, data);
+  }
+
+  /**
+   * Change the current user's password
+   */
+  async changePassword(data: ChangePasswordRequest): Promise<ChangePasswordResponse> {
+    return this.client.fetch.post<ChangePasswordResponse>(
+      ENDPOINTS.USER_CHANGE_PASSWORD,
+      data
+    );
+  }
+}

package/src/types/index.ts

@@ -81,6 +81,14 @@ export type {
   UpdateWorkflowInput,
 } from './workflow';
 
+// User types
+export type {
+  UserProfile,
+  UpdateProfileRequest,
+  ChangePasswordRequest,
+  ChangePasswordResponse,
+} from './user';
+
 // Error types
 export type {
   FieldError,

package/src/types/user.ts

@@ -0,0 +1,31 @@
+/**
+ * User types for /api/v1/users/ endpoints
+ */
+
+export interface UserProfile {
+  id: string;
+  email: string;
+  first_name: string;
+  last_name: string;
+  full_name: string;
+  is_email_verified: boolean;
+  company: string | null;
+  is_active: boolean;
+  created_at: string;
+  updated_at: string;
+}
+
+export interface UpdateProfileRequest {
+  first_name?: string;
+  last_name?: string;
+}
+
+export interface ChangePasswordRequest {
+  old_password: string;
+  new_password: string;
+  new_password_confirm: string;
+}
+
+export interface ChangePasswordResponse {
+  detail: string;
+}

package/src/utils/case-transform.ts

@@ -0,0 +1,44 @@
+/**
+ * Recursive key case transformation utilities.
+ *
+ * Used by FetchWrapper to automatically convert between Django's snake_case
+ * and the frontend's camelCase so app code never handles snake_case.
+ */
+
+/** Convert a single snake_case string to camelCase */
+function snakeToCamelKey(key: string): string {
+  return key.replace(/_([a-z0-9])/g, (_, c) => c.toUpperCase())
+}
+
+/** Convert a single camelCase string to snake_case */
+function camelToSnakeKey(key: string): string {
+  return key.replace(/[A-Z]/g, (c) => `_${c.toLowerCase()}`)
+}
+
+/** Recursively convert all object keys from snake_case to camelCase */
+export function snakeToCamel(obj: unknown): unknown {
+  if (Array.isArray(obj)) return obj.map(snakeToCamel)
+  if (obj !== null && typeof obj === 'object' && !(obj instanceof Date)) {
+    return Object.fromEntries(
+      Object.entries(obj as Record<string, unknown>).map(([k, v]) => [
+        snakeToCamelKey(k),
+        snakeToCamel(v),
+      ])
+    )
+  }
+  return obj
+}
+
+/** Recursively convert all object keys from camelCase to snake_case */
+export function camelToSnake(obj: unknown): unknown {
+  if (Array.isArray(obj)) return obj.map(camelToSnake)
+  if (obj !== null && typeof obj === 'object' && !(obj instanceof Date)) {
+    return Object.fromEntries(
+      Object.entries(obj as Record<string, unknown>).map(([k, v]) => [
+        camelToSnakeKey(k),
+        camelToSnake(v),
+      ])
+    )
+  }
+  return obj
+}

package/src/utils/index.ts

@@ -17,6 +17,8 @@ export { validateApiResponse } from './validate-response';
 export { EntityQueryBuilder } from './entity-query-builder';
 
 export { normalizePaginated, isDRFPaginatedResponse } from './drf-transforms';
+
+export { snakeToCamel, camelToSnake } from './case-transform';
 export type {
   DRFPaginatedResponse,
   NormalizedPaginatedResponse,