@neevjs/client 0.0.1

package/README.md

@@ -0,0 +1,48 @@
+<div align="center">
+  <img src="https://raw.githubusercontent.com/Rahul7raj/neevjs/main/docs/logo-inline.png" alt="NeevJS" height="80" />
+  <br />
+  <br />
+  <a href="https://github.com/Rahul7raj/neevjs"><strong>GitHub Repository</strong></a> &nbsp;|&nbsp; <a href="https://Rahul7raj.github.io/neevjs"><strong>Documentation</strong></a>
+</div>
+
+<br />
+
+# @neevjs/client
+
+> NeevJS core React framework — plugin-driven, offline-first, built for business apps.
+
+## Install
+
+```bash
+npm install @neevjs/client
+```
+
+## Usage
+
+```tsx
+import { createClient, NeevProvider, useModel, AuthPlugin } from '@neevjs/client'
+
+const client = createClient({ baseURL: '/api' })
+client.use(AuthPlugin)
+
+function App() {
+  return (
+    <NeevProvider client={client}>
+      <YourApp />
+    </NeevProvider>
+  )
+}
+
+function YourApp() {
+  const { data, loading, create, remove } = useModel('users')
+  // data, CRUD — all in one hook
+}
+```
+
+## Docs
+
+Full documentation at [Rahul7raj.github.io/neevjs](https://Rahul7raj.github.io/neevjs)
+
+## License
+
+MIT — Rahul Raj Kushwaha

package/dist/index.d.mts

@@ -0,0 +1,91 @@
+import { NeevClientConfig, NeevClientInterface, AuthInterface, AuthUser, ModelRecord, UseModelReturn, SyncStatus, NeevPlugin } from '@neevjs/shared';
+export { ApiMeta, ApiResponse, AuthInterface, AuthLoginResponse, AuthUser, ModelRecord, NeevClientConfig, NeevClientInterface, NeevPlugin, NeevRequest, Pagination, QueuedAction, RequestOptions, SyncStatus, UseModelReturn } from '@neevjs/shared';
+import React from 'react';
+
+declare function createClient(config?: NeevClientConfig): NeevClientInterface;
+
+declare const NeevContext: React.Context<NeevClientInterface | null>;
+interface NeevProviderProps {
+    client: NeevClientInterface;
+    children: React.ReactNode;
+}
+declare function NeevProvider({ client, children }: NeevProviderProps): React.ReactElement;
+declare function useNeevClient(): NeevClientInterface;
+
+declare class AuthClient implements AuthInterface {
+    private client;
+    private userData;
+    constructor(client: NeevClientInterface);
+    login(email: string, password: string): Promise<void>;
+    register(email: string, password: string, name?: string): Promise<void>;
+    logout(): void;
+    user(): Promise<AuthUser | null>;
+    isAuthenticated(): boolean;
+    getToken(): string | null;
+}
+
+declare function useModel<T extends ModelRecord>(name: string): UseModelReturn<T>;
+
+declare function useAuth(): AuthInterface;
+
+declare function useSyncStatus(): SyncStatus;
+
+interface TableColumn<T extends ModelRecord> {
+    key: keyof T & string;
+    label?: string;
+    render?: (value: T[keyof T], row: T) => React.ReactNode;
+}
+interface TableProps<T extends ModelRecord> {
+    model: string;
+    columns?: TableColumn<T>[];
+    onEdit?: (row: T) => void;
+    onDelete?: (row: T) => void;
+    emptyMessage?: string;
+}
+declare function Table<T extends ModelRecord>({ model, columns, onEdit, onDelete, emptyMessage, }: TableProps<T>): React.ReactElement;
+
+interface FormField {
+    name: string;
+    label?: string;
+    type?: 'text' | 'email' | 'password' | 'number' | 'textarea' | 'select';
+    placeholder?: string;
+    required?: boolean;
+    options?: {
+        label: string;
+        value: string;
+    }[];
+}
+interface FormProps<T extends ModelRecord> {
+    model: string;
+    fields?: FormField[];
+    initialValues?: Partial<T>;
+    editId?: number | string;
+    onSuccess?: () => void;
+    onError?: (err: Error) => void;
+    submitLabel?: string;
+    children?: React.ReactNode;
+}
+declare function Form<T extends ModelRecord>({ model, fields, initialValues, editId, onSuccess, onError, submitLabel, children, }: FormProps<T>): React.ReactElement;
+
+interface ProtectedProps {
+    children: React.ReactNode;
+    fallback?: React.ReactNode;
+    role?: string;
+}
+declare function Protected({ children, fallback, role }: ProtectedProps): React.ReactElement;
+
+declare const AuthPlugin: NeevPlugin;
+
+declare const LoggerPlugin: NeevPlugin;
+
+interface CachePluginOptions {
+    /** TTL in milliseconds. Default: 60_000 (1 minute) */
+    ttl?: number;
+}
+declare function createCachePlugin(options?: CachePluginOptions): NeevPlugin;
+declare const CachePlugin: NeevPlugin;
+
+declare function createOfflinePlugin(): NeevPlugin;
+declare const OfflinePlugin: NeevPlugin;
+
+export { AuthClient, AuthPlugin, CachePlugin, Form, LoggerPlugin, NeevContext, NeevProvider, OfflinePlugin, Protected, Table, createCachePlugin, createClient, createOfflinePlugin, useAuth, useModel, useNeevClient, useSyncStatus };

package/dist/index.d.ts

@@ -0,0 +1,91 @@
+import { NeevClientConfig, NeevClientInterface, AuthInterface, AuthUser, ModelRecord, UseModelReturn, SyncStatus, NeevPlugin } from '@neevjs/shared';
+export { ApiMeta, ApiResponse, AuthInterface, AuthLoginResponse, AuthUser, ModelRecord, NeevClientConfig, NeevClientInterface, NeevPlugin, NeevRequest, Pagination, QueuedAction, RequestOptions, SyncStatus, UseModelReturn } from '@neevjs/shared';
+import React from 'react';
+
+declare function createClient(config?: NeevClientConfig): NeevClientInterface;
+
+declare const NeevContext: React.Context<NeevClientInterface | null>;
+interface NeevProviderProps {
+    client: NeevClientInterface;
+    children: React.ReactNode;
+}
+declare function NeevProvider({ client, children }: NeevProviderProps): React.ReactElement;
+declare function useNeevClient(): NeevClientInterface;
+
+declare class AuthClient implements AuthInterface {
+    private client;
+    private userData;
+    constructor(client: NeevClientInterface);
+    login(email: string, password: string): Promise<void>;
+    register(email: string, password: string, name?: string): Promise<void>;
+    logout(): void;
+    user(): Promise<AuthUser | null>;
+    isAuthenticated(): boolean;
+    getToken(): string | null;
+}
+
+declare function useModel<T extends ModelRecord>(name: string): UseModelReturn<T>;
+
+declare function useAuth(): AuthInterface;
+
+declare function useSyncStatus(): SyncStatus;
+
+interface TableColumn<T extends ModelRecord> {
+    key: keyof T & string;
+    label?: string;
+    render?: (value: T[keyof T], row: T) => React.ReactNode;
+}
+interface TableProps<T extends ModelRecord> {
+    model: string;
+    columns?: TableColumn<T>[];
+    onEdit?: (row: T) => void;
+    onDelete?: (row: T) => void;
+    emptyMessage?: string;
+}
+declare function Table<T extends ModelRecord>({ model, columns, onEdit, onDelete, emptyMessage, }: TableProps<T>): React.ReactElement;
+
+interface FormField {
+    name: string;
+    label?: string;
+    type?: 'text' | 'email' | 'password' | 'number' | 'textarea' | 'select';
+    placeholder?: string;
+    required?: boolean;
+    options?: {
+        label: string;
+        value: string;
+    }[];
+}
+interface FormProps<T extends ModelRecord> {
+    model: string;
+    fields?: FormField[];
+    initialValues?: Partial<T>;
+    editId?: number | string;
+    onSuccess?: () => void;
+    onError?: (err: Error) => void;
+    submitLabel?: string;
+    children?: React.ReactNode;
+}
+declare function Form<T extends ModelRecord>({ model, fields, initialValues, editId, onSuccess, onError, submitLabel, children, }: FormProps<T>): React.ReactElement;
+
+interface ProtectedProps {
+    children: React.ReactNode;
+    fallback?: React.ReactNode;
+    role?: string;
+}
+declare function Protected({ children, fallback, role }: ProtectedProps): React.ReactElement;
+
+declare const AuthPlugin: NeevPlugin;
+
+declare const LoggerPlugin: NeevPlugin;
+
+interface CachePluginOptions {
+    /** TTL in milliseconds. Default: 60_000 (1 minute) */
+    ttl?: number;
+}
+declare function createCachePlugin(options?: CachePluginOptions): NeevPlugin;
+declare const CachePlugin: NeevPlugin;
+
+declare function createOfflinePlugin(): NeevPlugin;
+declare const OfflinePlugin: NeevPlugin;
+
+export { AuthClient, AuthPlugin, CachePlugin, Form, LoggerPlugin, NeevContext, NeevProvider, OfflinePlugin, Protected, Table, createCachePlugin, createClient, createOfflinePlugin, useAuth, useModel, useNeevClient, useSyncStatus };