@nextsparkjs/mobile 0.1.0-beta.1 → 0.1.0-beta.76

package/README.md

@@ -2,6 +2,34 @@
 
 Mobile app infrastructure for NextSpark. Provides API client, authentication providers, and utilities for building Expo apps that connect to your NextSpark backend.
 
+## Repository Structure
+
+When developing the package, it's important to understand the different directories:
+
+```
+packages/mobile/
+├── src/                    # Package source code (published to npm)
+│   ├── api/                # API client and entity factory
+│   ├── providers/          # AuthProvider, QueryProvider
+│   ├── hooks/              # useAuth hook
+│   └── lib/                # Storage, Alert utilities
+├── templates/              # Scaffolding templates for `nextspark add:mobile`
+│   ├── app/                # Expo Router pages
+│   └── src/                # Example entities and components
+└── dist/                   # Compiled output
+
+apps/mobile/                # Monorepo development app (NOT distributed)
+├── app/                    # Uses local source for development
+└── src/                    # Local copies for hot reload & debugging
+```
+
+**Key distinction:**
+- **`packages/mobile/src/`** → Published to npm as `@nextsparkjs/mobile`
+- **`packages/mobile/templates/`** → Copied to user projects via `nextspark add:mobile`
+- **`apps/mobile/`** → Internal dev app with local source (for package development)
+
+The templates correctly use `@nextsparkjs/mobile` imports, while `apps/mobile` uses local paths for development convenience.
+
 ## Installation
 
 ```bash

package/dist/api/entities/factory.d.ts

@@ -22,17 +22,17 @@ import '../client.types.js';
  * ```typescript
  * const tasksApi = createEntityApi<Task, CreateTaskInput, UpdateTaskInput>('tasks')
  *
- * // List tasks
+ * // List tasks (returns PaginatedResponse)
  * const { data, meta } = await tasksApi.list({ page: 1, limit: 10 })
  *
- * // Get single task
- * const { data: task } = await tasksApi.get('task-id')
+ * // Get single task (returns entity directly)
+ * const task = await tasksApi.get('task-id')
  *
- * // Create task
- * const { data: newTask } = await tasksApi.create({ title: 'New Task' })
+ * // Create task (returns entity directly)
+ * const newTask = await tasksApi.create({ title: 'New Task' })
  *
- * // Update task
- * const { data: updated } = await tasksApi.update('task-id', { status: 'done' })
+ * // Update task (returns entity directly)
+ * const updated = await tasksApi.update('task-id', { status: 'done' })
  *
  * // Delete task
  * await tasksApi.delete('task-id')

package/dist/api/entities/factory.js

@@ -4,20 +4,33 @@ function createEntityApi(entityPath) {
   return {
     /**
      * List entities with pagination and filters
+     * Returns PaginatedResponse with data array and meta
      */
     list: (params) => apiClient.get(basePath, params),
     /**
      * Get a single entity by ID
+     * Returns the entity directly (unwrapped from SingleResponse)
      */
-    get: (id) => apiClient.get(`${basePath}/${id}`),
+    get: async (id) => {
+      const response = await apiClient.get(`${basePath}/${id}`);
+      return response.data;
+    },
     /**
      * Create a new entity
+     * Returns the created entity directly (unwrapped from SingleResponse)
      */
-    create: (data) => apiClient.post(basePath, data),
+    create: async (data) => {
+      const response = await apiClient.post(basePath, data);
+      return response.data;
+    },
     /**
      * Update an existing entity
+     * Returns the updated entity directly (unwrapped from SingleResponse)
      */
-    update: (id, data) => apiClient.patch(`${basePath}/${id}`, data),
+    update: async (id, data) => {
+      const response = await apiClient.patch(`${basePath}/${id}`, data);
+      return response.data;
+    },
     /**
      * Delete an entity
      * Returns void (no content expected from DELETE operations)

package/dist/api/entities/factory.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/api/entities/factory.ts"],"sourcesContent":["/**\n * Entity API Factory\n *\n * Factory function to create typed API clients for any entity.\n * Follows the same pattern as BaseEntityService in NextSpark web.\n */\n\nimport { apiClient } from '../client'\nimport type { PaginatedResponse, SingleResponse } from '../client.types'\nimport type { EntityApi, EntityListParams } from './types'\n\n/**\n * Create an API client for an entity\n *\n * @param entityPath - The entity path (e.g., 'tasks', 'customers')\n * @returns Typed API client with CRUD operations\n *\n * Note: This factory assumes entities have an `id: string` field for get/update/delete operations.\n * We intentionally don't enforce this via generic constraints to maintain flexibility for\n * entities with different ID field names or types.\n *\n * @example\n * ```typescript\n * const tasksApi = createEntityApi<Task, CreateTaskInput, UpdateTaskInput>('tasks')\n *\n * // List tasks\n * const { data, meta } = await tasksApi.list({ page: 1, limit: 10 })\n *\n * // Get single task\n * const { data: task } = await tasksApi.get('task-id')\n *\n * // Create task\n * const { data: newTask } = await tasksApi.create({ title: 'New Task' })\n *\n * // Update task\n * const { data: updated } = await tasksApi.update('task-id', { status: 'done' })\n *\n * // Delete task\n * await tasksApi.delete('task-id')\n * ```\n */\nexport function createEntityApi<T, CreateInput = Partial<T>, UpdateInput = Partial<T>>(\n  entityPath: string\n): EntityApi<T, CreateInput, UpdateInput> {\n  const basePath = `/api/v1/${entityPath}`\n\n  return {\n    /**\n     * List entities with pagination and filters\n     */\n    list: (params?: EntityListParams) =>\n      apiClient.get<PaginatedResponse<T>>(basePath, params),\n\n    /**\n     * Get a single entity by ID\n     */\n    get: (id: string) =>\n      apiClient.get<SingleResponse<T>>(`${basePath}/${id}`),\n\n    /**\n     * Create a new entity\n     */\n    create: (data: CreateInput) =>\n      apiClient.post<SingleResponse<T>>(basePath, data),\n\n    /**\n     * Update an existing entity\n     */\n    update: (id: string, data: UpdateInput) =>\n      apiClient.patch<SingleResponse<T>>(`${basePath}/${id}`, data),\n\n    /**\n     * Delete an entity\n     * Returns void (no content expected from DELETE operations)\n     */\n    delete: (id: string): Promise<void> =>\n      apiClient.delete<void>(`${basePath}/${id}`),\n  }\n}\n"],"mappings":"AAOA,SAAS,iBAAiB;AAkCnB,SAAS,gBACd,YACwC;AACxC,QAAM,WAAW,WAAW,UAAU;AAEtC,SAAO;AAAA;AAAA;AAAA;AAAA,IAIL,MAAM,CAAC,WACL,UAAU,IAA0B,UAAU,MAAM;AAAA;AAAA;AAAA;AAAA,IAKtD,KAAK,CAAC,OACJ,UAAU,IAAuB,GAAG,QAAQ,IAAI,EAAE,EAAE;AAAA;AAAA;AAAA;AAAA,IAKtD,QAAQ,CAAC,SACP,UAAU,KAAwB,UAAU,IAAI;AAAA;AAAA;AAAA;AAAA,IAKlD,QAAQ,CAAC,IAAY,SACnB,UAAU,MAAyB,GAAG,QAAQ,IAAI,EAAE,IAAI,IAAI;AAAA;AAAA;AAAA;AAAA;AAAA,IAM9D,QAAQ,CAAC,OACP,UAAU,OAAa,GAAG,QAAQ,IAAI,EAAE,EAAE;AAAA,EAC9C;AACF;","names":[]}
+{"version":3,"sources":["../../../src/api/entities/factory.ts"],"sourcesContent":["/**\n * Entity API Factory\n *\n * Factory function to create typed API clients for any entity.\n * Follows the same pattern as BaseEntityService in NextSpark web.\n */\n\nimport { apiClient } from '../client'\nimport type { PaginatedResponse, SingleResponse } from '../client.types'\nimport type { EntityApi, EntityListParams } from './types'\n\n/**\n * Create an API client for an entity\n *\n * @param entityPath - The entity path (e.g., 'tasks', 'customers')\n * @returns Typed API client with CRUD operations\n *\n * Note: This factory assumes entities have an `id: string` field for get/update/delete operations.\n * We intentionally don't enforce this via generic constraints to maintain flexibility for\n * entities with different ID field names or types.\n *\n * @example\n * ```typescript\n * const tasksApi = createEntityApi<Task, CreateTaskInput, UpdateTaskInput>('tasks')\n *\n * // List tasks (returns PaginatedResponse)\n * const { data, meta } = await tasksApi.list({ page: 1, limit: 10 })\n *\n * // Get single task (returns entity directly)\n * const task = await tasksApi.get('task-id')\n *\n * // Create task (returns entity directly)\n * const newTask = await tasksApi.create({ title: 'New Task' })\n *\n * // Update task (returns entity directly)\n * const updated = await tasksApi.update('task-id', { status: 'done' })\n *\n * // Delete task\n * await tasksApi.delete('task-id')\n * ```\n */\nexport function createEntityApi<T, CreateInput = Partial<T>, UpdateInput = Partial<T>>(\n  entityPath: string\n): EntityApi<T, CreateInput, UpdateInput> {\n  const basePath = `/api/v1/${entityPath}`\n\n  return {\n    /**\n     * List entities with pagination and filters\n     * Returns PaginatedResponse with data array and meta\n     */\n    list: (params?: EntityListParams) =>\n      apiClient.get<PaginatedResponse<T>>(basePath, params),\n\n    /**\n     * Get a single entity by ID\n     * Returns the entity directly (unwrapped from SingleResponse)\n     */\n    get: async (id: string): Promise<T> => {\n      const response = await apiClient.get<SingleResponse<T>>(`${basePath}/${id}`)\n      return response.data\n    },\n\n    /**\n     * Create a new entity\n     * Returns the created entity directly (unwrapped from SingleResponse)\n     */\n    create: async (data: CreateInput): Promise<T> => {\n      const response = await apiClient.post<SingleResponse<T>>(basePath, data)\n      return response.data\n    },\n\n    /**\n     * Update an existing entity\n     * Returns the updated entity directly (unwrapped from SingleResponse)\n     */\n    update: async (id: string, data: UpdateInput): Promise<T> => {\n      const response = await apiClient.patch<SingleResponse<T>>(`${basePath}/${id}`, data)\n      return response.data\n    },\n\n    /**\n     * Delete an entity\n     * Returns void (no content expected from DELETE operations)\n     */\n    delete: (id: string): Promise<void> =>\n      apiClient.delete<void>(`${basePath}/${id}`),\n  }\n}\n"],"mappings":"AAOA,SAAS,iBAAiB;AAkCnB,SAAS,gBACd,YACwC;AACxC,QAAM,WAAW,WAAW,UAAU;AAEtC,SAAO;AAAA;AAAA;AAAA;AAAA;AAAA,IAKL,MAAM,CAAC,WACL,UAAU,IAA0B,UAAU,MAAM;AAAA;AAAA;AAAA;AAAA;AAAA,IAMtD,KAAK,OAAO,OAA2B;AACrC,YAAM,WAAW,MAAM,UAAU,IAAuB,GAAG,QAAQ,IAAI,EAAE,EAAE;AAC3E,aAAO,SAAS;AAAA,IAClB;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,QAAQ,OAAO,SAAkC;AAC/C,YAAM,WAAW,MAAM,UAAU,KAAwB,UAAU,IAAI;AACvE,aAAO,SAAS;AAAA,IAClB;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,QAAQ,OAAO,IAAY,SAAkC;AAC3D,YAAM,WAAW,MAAM,UAAU,MAAyB,GAAG,QAAQ,IAAI,EAAE,IAAI,IAAI;AACnF,aAAO,SAAS;AAAA,IAClB;AAAA;AAAA;AAAA;AAAA;AAAA,IAMA,QAAQ,CAAC,OACP,UAAU,OAAa,GAAG,QAAQ,IAAI,EAAE,EAAE;AAAA,EAC9C;AACF;","names":[]}

package/dist/api/entities/types.d.ts

@@ -1,4 +1,4 @@
-import { PaginatedResponse, SingleResponse } from '../client.types.js';
+import { PaginatedResponse } from '../client.types.js';
 
 /**
  * Entity API Types
@@ -20,12 +20,15 @@ interface EntityListParams {
 /**
  * Generic entity API interface
  * Matches NextSpark web BaseEntityService pattern
+ *
+ * Note: get, create, and update return the entity directly (T),
+ * not wrapped in SingleResponse<T>. This provides a cleaner API.
  */
 interface EntityApi<T, CreateInput, UpdateInput> {
     list: (params?: EntityListParams) => Promise<PaginatedResponse<T>>;
-    get: (id: string) => Promise<SingleResponse<T>>;
-    create: (data: CreateInput) => Promise<SingleResponse<T>>;
-    update: (id: string, data: UpdateInput) => Promise<SingleResponse<T>>;
+    get: (id: string) => Promise<T>;
+    create: (data: CreateInput) => Promise<T>;
+    update: (id: string, data: UpdateInput) => Promise<T>;
     delete: (id: string) => Promise<void>;
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextsparkjs/mobile",
-  "version": "0.1.0-beta.1",
+  "version": "0.1.0-beta.76",
   "description": "Mobile app infrastructure for NextSpark - API client, providers, and utilities for Expo apps",
   "license": "MIT",
   "author": "NextSpark <hello@nextspark.dev>",