@fanapps/react-native 0.4.0 → 0.5.0

package/README.md

@@ -1,6 +1,6 @@
 # @fanapps/react-native
 
-React Native SDK for the Fanapps API — Firebase-powered auth, paginated content hooks, and FCM push-target registration.
+React Native SDK for the Fanapps API — Firebase-powered auth, paginated content hooks, entry create/update/delete mutations, asset upload, and FCM push-target registration.
 
 ## Install
 
@@ -98,7 +98,32 @@ function Screen() {
 }
 ```
 
-Google and Apple sign-in are imported from subpaths (peer-isolated):
+### Email / password
+
+```tsx
+const { signInWithEmail, signUpWithEmail, sendPasswordResetEmail, sendEmailVerification, signOut } = useAuth();
+
+// Sign in
+const user = await signInWithEmail('a@b.com', 's3cret');
+
+// Sign up (creates Firebase user, signs them in)
+const newUser = await signUpWithEmail('new@b.com', 's3cret');
+
+// Password reset email
+await sendPasswordResetEmail('a@b.com');
+
+// Send verification email to currently signed-in user
+await sendEmailVerification();
+
+// Sign out
+await signOut();
+```
+
+All return promises; failures throw Firebase errors (e.g. `auth/wrong-password`, `auth/email-already-in-use`).
+
+### Google and Apple
+
+Imported from subpaths (peer-isolated):
 
 ```tsx
 import { signInWithGoogle } from '@fanapps/react-native/google';
@@ -193,6 +218,87 @@ useEntry(id, options?)                        // Entry
 
 Filters: `blueprint`, `collection`, `slug`, `published`, `sort` (e.g. `-date`), `perPage`, `page`.
 
+### Mutations: create / update / delete entries
+
+```ts
+useCreateEntry()  // UseMutationResult<Entry, FanappsError, CreateEntryInput>
+useUpdateEntry()  // UseMutationResult<Entry, FanappsError, UpdateEntryInput>
+useDeleteEntry()  // UseMutationResult<void, FanappsError, string | number>
+```
+
+Each hook returns a React Query mutation. Pass field values keyed by their blueprint **handle** — validation is derived dynamically from the blueprint's field configuration on the server. Translatable fields write into the locale resolved by the backend (`SetLocale` middleware) — pass `locale` as a query param via the escape hatch if you need to target a specific one.
+
+```tsx
+import { useCreateEntry, useUpdateEntry, useDeleteEntry } from '@fanapps/react-native';
+
+function NewsForm() {
+  const create = useCreateEntry();
+  const update = useUpdateEntry();
+  const remove = useDeleteEntry();
+
+  const onCreate = () =>
+    create.mutate({
+      blueprint: 'news',          // required: blueprint handle
+      name: 'Hello world',        // any field defined on the blueprint
+      body: 'Lorem ipsum',
+      featured: true,
+      publishedAt: '2026-01-01T12:00:00Z',  // optional, null = draft
+      terms: { category: [1, 2] },          // optional taxonomy tag IDs
+    });
+
+  const onUpdate = (id: number) =>
+    update.mutate({ id, body: 'Updated body' });
+
+  const onDelete = (id: number) => remove.mutate(id);
+
+  if (create.isError) console.error(create.error.body);
+  return null;
+}
+```
+
+On success, the hooks invalidate `['fanapps','entries']` and the affected `['fanapps','entry', id]` query so paginated lists and detail views refetch automatically. `useDeleteEntry` removes the cached detail entirely.
+
+Validation errors come back as `FanappsError` with `status: 422` and `body: { message, errors: { fieldHandle: [...] } }`.
+
+### Assets
+
+`useUploadAsset` uploads a single file via multipart/form-data and returns the saved `Asset` (with `id`, `url`, `thumbnail_url`, `width`, `height`, etc.). Reference the returned `id` in entry asset fields.
+
+```tsx
+import { useUploadAsset, useCreateEntry } from '@fanapps/react-native';
+import * as ImagePicker from 'expo-image-picker';
+
+function PickAndUpload() {
+  const upload = useUploadAsset();
+  const create = useCreateEntry();
+
+  const onPick = async () => {
+    const picked = await ImagePicker.launchImageLibraryAsync({ mediaTypes: 'images' });
+    if (picked.canceled) return;
+
+    const [file] = picked.assets;
+    const asset = await upload.mutateAsync({
+      file: {
+        uri: file.uri,
+        name: file.fileName ?? 'photo.jpg',
+        type: file.mimeType ?? 'image/jpeg',
+      },
+      altText: 'Optional alt text',
+    });
+
+    await create.mutateAsync({
+      blueprint: 'gallery',
+      name: 'My gallery',
+      images: [{ id: asset.id }], // shape expected by `assets` field type
+    });
+  };
+
+  return null;
+}
+```
+
+The file shape `{ uri, name, type }` matches the React Native `FormData` convention and works directly with output from `expo-image-picker`, `react-native-image-picker`, and `expo-document-picker`. Max upload size is 10 MB; files larger than that throw `FanappsError` with `status: 422`.
+
 ### Articles
 
 ```ts

package/dist/apple.js

@@ -36,26 +36,16 @@ module.exports = __toCommonJS(apple_exports);
 var import_auth = __toESM(require("@react-native-firebase/auth"));
 var import_react_native_apple_authentication = require("@invertase/react-native-apple-authentication");
 var import_react_native = require("react-native");
-
-// src/auth/errors.ts
-var FanappsAuthError = class extends Error {
-  constructor(message, code) {
-    super(message);
-    this.name = "FanappsAuthError";
-    this.code = code;
-  }
-};
-
-// src/apple/index.ts
+var import_react_native2 = require("@fanapps/react-native");
 async function signInWithApple() {
   if (import_react_native.Platform.OS !== "ios") {
-    throw new FanappsAuthError(
+    throw new import_react_native2.FanappsAuthError(
       "Apple sign-in is only supported on iOS in v1.",
       "auth/platform-not-supported"
     );
   }
   if (!import_react_native_apple_authentication.appleAuth.isSupported) {
-    throw new FanappsAuthError(
+    throw new import_react_native2.FanappsAuthError(
       "Apple sign-in not supported on this device.",
       "auth/not-supported"
     );
@@ -65,7 +55,7 @@ async function signInWithApple() {
     requestedScopes: [import_react_native_apple_authentication.appleAuth.Scope.EMAIL, import_react_native_apple_authentication.appleAuth.Scope.FULL_NAME]
   });
   if (!result.identityToken) {
-    throw new FanappsAuthError(
+    throw new import_react_native2.FanappsAuthError(
       "Apple did not return an identity token.",
       "auth/no-token"
     );

package/dist/apple.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/apple/index.ts","../src/auth/errors.ts"],"sourcesContent":["import auth, { type FirebaseAuthTypes } from '@react-native-firebase/auth';\nimport { appleAuth } from '@invertase/react-native-apple-authentication';\nimport { Platform } from 'react-native';\nimport { FanappsAuthError } from '../auth/errors';\n\nexport async function signInWithApple(): Promise<FirebaseAuthTypes.UserCredential> {\n  if (Platform.OS !== 'ios') {\n    throw new FanappsAuthError(\n      'Apple sign-in is only supported on iOS in v1.',\n      'auth/platform-not-supported',\n    );\n  }\n\n  if (!appleAuth.isSupported) {\n    throw new FanappsAuthError(\n      'Apple sign-in not supported on this device.',\n      'auth/not-supported',\n    );\n  }\n\n  const result = await appleAuth.performRequest({\n    requestedOperation: appleAuth.Operation.LOGIN,\n    requestedScopes: [appleAuth.Scope.EMAIL, appleAuth.Scope.FULL_NAME],\n  });\n\n  if (!result.identityToken) {\n    throw new FanappsAuthError(\n      'Apple did not return an identity token.',\n      'auth/no-token',\n    );\n  }\n\n  const credential = auth.AppleAuthProvider.credential(\n    result.identityToken,\n    result.nonce ?? undefined,\n  );\n\n  return auth().signInWithCredential(credential);\n}\n","export class FanappsAuthError extends Error {\n  readonly code: string;\n\n  constructor(message: string, code: string) {\n    super(message);\n    this.name = 'FanappsAuthError';\n    this.code = code;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAA6C;AAC7C,+CAA0B;AAC1B,0BAAyB;;;ACFlB,IAAM,mBAAN,cAA+B,MAAM;AAAA,EAG1C,YAAY,SAAiB,MAAc;AACzC,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,OAAO;AAAA,EACd;AACF;;;ADHA,eAAsB,kBAA6D;AACjF,MAAI,6BAAS,OAAO,OAAO;AACzB,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,MAAI,CAAC,mDAAU,aAAa;AAC1B,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,SAAS,MAAM,mDAAU,eAAe;AAAA,IAC5C,oBAAoB,mDAAU,UAAU;AAAA,IACxC,iBAAiB,CAAC,mDAAU,MAAM,OAAO,mDAAU,MAAM,SAAS;AAAA,EACpE,CAAC;AAED,MAAI,CAAC,OAAO,eAAe;AACzB,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,aAAa,YAAAA,QAAK,kBAAkB;AAAA,IACxC,OAAO;AAAA,IACP,OAAO,SAAS;AAAA,EAClB;AAEA,aAAO,YAAAA,SAAK,EAAE,qBAAqB,UAAU;AAC/C;","names":["auth"]}
+{"version":3,"sources":["../src/apple/index.ts"],"sourcesContent":["import auth, { type FirebaseAuthTypes } from '@react-native-firebase/auth';\nimport { appleAuth } from '@invertase/react-native-apple-authentication';\nimport { Platform } from 'react-native';\nimport { FanappsAuthError } from '@fanapps/react-native';\n\nexport async function signInWithApple(): Promise<FirebaseAuthTypes.UserCredential> {\n  if (Platform.OS !== 'ios') {\n    throw new FanappsAuthError(\n      'Apple sign-in is only supported on iOS in v1.',\n      'auth/platform-not-supported',\n    );\n  }\n\n  if (!appleAuth.isSupported) {\n    throw new FanappsAuthError(\n      'Apple sign-in not supported on this device.',\n      'auth/not-supported',\n    );\n  }\n\n  const result = await appleAuth.performRequest({\n    requestedOperation: appleAuth.Operation.LOGIN,\n    requestedScopes: [appleAuth.Scope.EMAIL, appleAuth.Scope.FULL_NAME],\n  });\n\n  if (!result.identityToken) {\n    throw new FanappsAuthError(\n      'Apple did not return an identity token.',\n      'auth/no-token',\n    );\n  }\n\n  const credential = auth.AppleAuthProvider.credential(\n    result.identityToken,\n    result.nonce ?? undefined,\n  );\n\n  return auth().signInWithCredential(credential);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,kBAA6C;AAC7C,+CAA0B;AAC1B,0BAAyB;AACzB,IAAAA,uBAAiC;AAEjC,eAAsB,kBAA6D;AACjF,MAAI,6BAAS,OAAO,OAAO;AACzB,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,MAAI,CAAC,mDAAU,aAAa;AAC1B,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,SAAS,MAAM,mDAAU,eAAe;AAAA,IAC5C,oBAAoB,mDAAU,UAAU;AAAA,IACxC,iBAAiB,CAAC,mDAAU,MAAM,OAAO,mDAAU,MAAM,SAAS;AAAA,EACpE,CAAC;AAED,MAAI,CAAC,OAAO,eAAe;AACzB,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,aAAa,YAAAC,QAAK,kBAAkB;AAAA,IACxC,OAAO;AAAA,IACP,OAAO,SAAS;AAAA,EAClB;AAEA,aAAO,YAAAA,SAAK,EAAE,qBAAqB,UAAU;AAC/C;","names":["import_react_native","auth"]}

package/dist/apple.mjs

@@ -1,11 +1,8 @@
-import {
-  FanappsAuthError
-} from "./chunk-SWOKCWWX.mjs";
-
 // src/apple/index.ts
 import auth from "@react-native-firebase/auth";
 import { appleAuth } from "@invertase/react-native-apple-authentication";
 import { Platform } from "react-native";
+import { FanappsAuthError } from "@fanapps/react-native";
 async function signInWithApple() {
   if (Platform.OS !== "ios") {
     throw new FanappsAuthError(

package/dist/apple.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/apple/index.ts"],"sourcesContent":["import auth, { type FirebaseAuthTypes } from '@react-native-firebase/auth';\nimport { appleAuth } from '@invertase/react-native-apple-authentication';\nimport { Platform } from 'react-native';\nimport { FanappsAuthError } from '../auth/errors';\n\nexport async function signInWithApple(): Promise<FirebaseAuthTypes.UserCredential> {\n  if (Platform.OS !== 'ios') {\n    throw new FanappsAuthError(\n      'Apple sign-in is only supported on iOS in v1.',\n      'auth/platform-not-supported',\n    );\n  }\n\n  if (!appleAuth.isSupported) {\n    throw new FanappsAuthError(\n      'Apple sign-in not supported on this device.',\n      'auth/not-supported',\n    );\n  }\n\n  const result = await appleAuth.performRequest({\n    requestedOperation: appleAuth.Operation.LOGIN,\n    requestedScopes: [appleAuth.Scope.EMAIL, appleAuth.Scope.FULL_NAME],\n  });\n\n  if (!result.identityToken) {\n    throw new FanappsAuthError(\n      'Apple did not return an identity token.',\n      'auth/no-token',\n    );\n  }\n\n  const credential = auth.AppleAuthProvider.credential(\n    result.identityToken,\n    result.nonce ?? undefined,\n  );\n\n  return auth().signInWithCredential(credential);\n}\n"],"mappings":";;;;;AAAA,OAAO,UAAsC;AAC7C,SAAS,iBAAiB;AAC1B,SAAS,gBAAgB;AAGzB,eAAsB,kBAA6D;AACjF,MAAI,SAAS,OAAO,OAAO;AACzB,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,MAAI,CAAC,UAAU,aAAa;AAC1B,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,SAAS,MAAM,UAAU,eAAe;AAAA,IAC5C,oBAAoB,UAAU,UAAU;AAAA,IACxC,iBAAiB,CAAC,UAAU,MAAM,OAAO,UAAU,MAAM,SAAS;AAAA,EACpE,CAAC;AAED,MAAI,CAAC,OAAO,eAAe;AACzB,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,aAAa,KAAK,kBAAkB;AAAA,IACxC,OAAO;AAAA,IACP,OAAO,SAAS;AAAA,EAClB;AAEA,SAAO,KAAK,EAAE,qBAAqB,UAAU;AAC/C;","names":[]}
+{"version":3,"sources":["../src/apple/index.ts"],"sourcesContent":["import auth, { type FirebaseAuthTypes } from '@react-native-firebase/auth';\nimport { appleAuth } from '@invertase/react-native-apple-authentication';\nimport { Platform } from 'react-native';\nimport { FanappsAuthError } from '@fanapps/react-native';\n\nexport async function signInWithApple(): Promise<FirebaseAuthTypes.UserCredential> {\n  if (Platform.OS !== 'ios') {\n    throw new FanappsAuthError(\n      'Apple sign-in is only supported on iOS in v1.',\n      'auth/platform-not-supported',\n    );\n  }\n\n  if (!appleAuth.isSupported) {\n    throw new FanappsAuthError(\n      'Apple sign-in not supported on this device.',\n      'auth/not-supported',\n    );\n  }\n\n  const result = await appleAuth.performRequest({\n    requestedOperation: appleAuth.Operation.LOGIN,\n    requestedScopes: [appleAuth.Scope.EMAIL, appleAuth.Scope.FULL_NAME],\n  });\n\n  if (!result.identityToken) {\n    throw new FanappsAuthError(\n      'Apple did not return an identity token.',\n      'auth/no-token',\n    );\n  }\n\n  const credential = auth.AppleAuthProvider.credential(\n    result.identityToken,\n    result.nonce ?? undefined,\n  );\n\n  return auth().signInWithCredential(credential);\n}\n"],"mappings":";AAAA,OAAO,UAAsC;AAC7C,SAAS,iBAAiB;AAC1B,SAAS,gBAAgB;AACzB,SAAS,wBAAwB;AAEjC,eAAsB,kBAA6D;AACjF,MAAI,SAAS,OAAO,OAAO;AACzB,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,MAAI,CAAC,UAAU,aAAa;AAC1B,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,SAAS,MAAM,UAAU,eAAe;AAAA,IAC5C,oBAAoB,UAAU,UAAU;AAAA,IACxC,iBAAiB,CAAC,UAAU,MAAM,OAAO,UAAU,MAAM,SAAS;AAAA,EACpE,CAAC;AAED,MAAI,CAAC,OAAO,eAAe;AACzB,UAAM,IAAI;AAAA,MACR;AAAA,MACA;AAAA,IACF;AAAA,EACF;AAEA,QAAM,aAAa,KAAK,kBAAkB;AAAA,IACxC,OAAO;AAAA,IACP,OAAO,SAAS;AAAA,EAClB;AAEA,SAAO,KAAK,EAAE,qBAAqB,UAAU;AAC/C;","names":[]}

package/dist/index.d.mts

@@ -1,8 +1,175 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { QueryClient, UseQueryResult, UseMutationResult } from '@tanstack/react-query';
 import { ReactNode } from 'react';
-import { L as Locale, S as StorageAdapter, C as CreatePushTargetInput, P as PushTarget, A as AuthUser, a as AuthStatus, E as EntryFilters, H as HookOptions, b as Paginated, c as Entry, d as ArticleFilters, e as Article, T as Trivia, f as TriviaResponseResult } from './types-CKpYrzCw.mjs';
-export { g as ArticleStatus, h as EntryData, i as PaginationLinks, j as PaginationMeta, k as PaginationParams, l as TriviaAnswer } from './types-CKpYrzCw.mjs';
+import { S as StorageAdapter } from './storage-D6z5ScLn.mjs';
+import { FirebaseAuthTypes } from '@react-native-firebase/auth';
+
+type Locale = string;
+type EntryData = Record<string, unknown>;
+interface Entry {
+    id: string | number;
+    slug: string;
+    published: boolean;
+    date: string | null;
+    order: number | null;
+    collection: string | null;
+    blueprint: string;
+    data: EntryData;
+    created_at: string;
+    updated_at: string;
+    locale: Locale;
+    available_locales?: Locale[];
+}
+type ArticleStatus = 'draft' | 'scheduled' | 'published';
+interface Article {
+    id: string | number;
+    title: string;
+    content: string;
+    status: ArticleStatus;
+    published_at: string | null;
+    featured_image_url: string | null;
+    created_at: string;
+    updated_at: string;
+    locale: Locale;
+    available_locales?: Locale[];
+}
+interface TriviaAnswer {
+    id: string | number;
+    text: string;
+    is_correct: boolean;
+    sort_order: number;
+}
+interface Trivia {
+    id: string | number;
+    title: string;
+    description: string | null;
+    featured_image_id: string | number | null;
+    featured_image?: {
+        id: string | number;
+        url: string;
+        [key: string]: unknown;
+    } | null;
+    awards_points: boolean;
+    points_amount: number;
+    max_time_seconds: number | null;
+    show_correct_after: boolean;
+    starts_at: string | null;
+    ends_at: string | null;
+    answers: TriviaAnswer[];
+    responses_count?: number;
+    created_at: string;
+    updated_at: string;
+}
+interface TriviaResponseResult {
+    is_correct: boolean;
+    points_awarded: number;
+    correct_answer?: TriviaAnswer;
+}
+interface PaginationMeta {
+    current_page: number;
+    last_page: number;
+    per_page: number;
+    total: number;
+    from: number | null;
+    to: number | null;
+    path?: string;
+}
+interface PaginationLinks {
+    first: string | null;
+    last: string | null;
+    prev: string | null;
+    next: string | null;
+}
+interface Paginated<T> {
+    data: T[];
+    meta: PaginationMeta;
+    links: PaginationLinks;
+}
+interface PaginationParams {
+    page?: number;
+    perPage?: number;
+    sort?: string;
+}
+interface EntryFilters extends PaginationParams {
+    blueprint?: string;
+    collection?: string;
+    slug?: string;
+    published?: boolean;
+}
+interface ArticleFilters extends PaginationParams {
+    status?: ArticleStatus;
+}
+interface HookOptions {
+    locale?: Locale;
+    enabled?: boolean;
+}
+type AuthStatus = 'loading' | 'signed-in' | 'signed-out';
+interface AuthUser {
+    uid: string;
+    email: string | null;
+    displayName: string | null;
+    photoURL: string | null;
+    phoneNumber: string | null;
+    isAnonymous: boolean;
+    providerId: string | null;
+}
+interface PushTarget {
+    id: string;
+    app_user_id: number | string | null;
+    identifier: string;
+    provider: 'fcm' | 'apns';
+    provider_id: string | null;
+    device_brand: string | null;
+    device_model: string | null;
+    os_name: string | null;
+    os_version: string | null;
+    last_seen_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+interface CreatePushTargetInput {
+    targetId: string;
+    identifier: string;
+    providerId?: string;
+    deviceBrand?: string;
+    deviceModel?: string;
+    osName?: string;
+    osVersion?: string;
+}
+interface Asset {
+    id: number;
+    name: string;
+    alt_text: string | null;
+    url: string | null;
+    thumbnail_url: string | null;
+    mime_type: string | null;
+    size: number | null;
+    width: number | null;
+    height: number | null;
+    created_at: string;
+    updated_at: string;
+}
+interface AssetUploadFile {
+    uri: string;
+    name: string;
+    type: string;
+}
+interface UploadAssetInput {
+    file: AssetUploadFile;
+    altText?: string;
+}
+interface CreateEntryInput {
+    blueprint: string;
+    publishedAt?: string | null;
+    terms?: Record<string, Array<number | string>>;
+    [field: string]: unknown;
+}
+interface UpdateEntryInput {
+    id: string | number;
+    publishedAt?: string | null;
+    terms?: Record<string, Array<number | string>>;
+    [field: string]: unknown;
+}
 
 interface FanappsProviderProps {
     apiKey: string;
@@ -35,6 +202,11 @@ declare class FanappsClient {
     createPushTarget(input: CreatePushTargetInput): Promise<PushTarget>;
     updatePushTarget(targetId: string, identifier: string): Promise<PushTarget>;
     deletePushTarget(targetId: string): Promise<void>;
+    createEntry(input: CreateEntryInput): Promise<Entry>;
+    updateEntry({ id, ...rest }: UpdateEntryInput): Promise<Entry>;
+    deleteEntry(id: string | number): Promise<void>;
+    uploadAsset(input: UploadAssetInput): Promise<Asset>;
+    private requestMultipart;
     private request;
     private buildUrl;
 }
@@ -50,6 +222,32 @@ declare class FanappsAuthError extends Error {
     constructor(message: string, code: string);
 }
 
+type AuthListener = (snapshot: AuthStoreSnapshot) => void;
+interface AuthStoreSnapshot {
+    user: AuthUser | null;
+    firebaseUser: FirebaseAuthTypes.User | null;
+    status: AuthStatus;
+}
+declare class AuthStore {
+    private snapshot;
+    private listeners;
+    private unsubscribe;
+    start(): void;
+    stop(): void;
+    subscribe(listener: AuthListener): () => void;
+    getSnapshot(): AuthStoreSnapshot;
+    getCurrentIdToken(): Promise<string | null>;
+    private emit;
+}
+
+interface FanappsContextValue {
+    client: FanappsClient;
+    authStore: AuthStore;
+    storage: StorageAdapter | undefined;
+    locale?: Locale;
+}
+declare function useFanapps(): FanappsContextValue;
+
 declare function useFanappsClient(): FanappsClient;
 
 interface UseAuthResult {
@@ -67,6 +265,14 @@ declare function useEntries(filters?: EntryFilters, options?: HookOptions): UseQ
 
 declare function useEntry(id: string | number | null | undefined, options?: HookOptions): UseQueryResult<Entry>;
 
+declare function useCreateEntry(): UseMutationResult<Entry, FanappsError, CreateEntryInput>;
+
+declare function useUpdateEntry(): UseMutationResult<Entry, FanappsError, UpdateEntryInput>;
+
+declare function useDeleteEntry(): UseMutationResult<void, FanappsError, string | number>;
+
+declare function useUploadAsset(): UseMutationResult<Asset, FanappsError, UploadAssetInput>;
+
 declare function useArticles(filters?: ArticleFilters, options?: HookOptions): UseQueryResult<Paginated<Article>>;
 
 declare function useArticle(id: string | number | null | undefined, options?: HookOptions): UseQueryResult<Article>;
@@ -81,4 +287,4 @@ interface SubmitTriviaResponseInput {
 }
 declare function useSubmitTriviaResponse(): UseMutationResult<TriviaResponseResult, FanappsError, SubmitTriviaResponseInput>;
 
-export { Article, ArticleFilters, AuthStatus, AuthUser, CreatePushTargetInput, Entry, EntryFilters, FanappsAuthError, FanappsClient, type FanappsClientOptions, FanappsError, FanappsProvider, type FanappsProviderProps, HookOptions, Locale, Paginated, PushTarget, StorageAdapter, type SubmitTriviaResponseInput, Trivia, TriviaResponseResult, type UseAuthResult, useArticle, useArticles, useAuth, useEntries, useEntry, useFanappsClient, useSubmitTriviaResponse, useTrivia, useTrivias };
+export { type Article, type ArticleFilters, type ArticleStatus, type Asset, type AssetUploadFile, type AuthStatus, type AuthUser, type CreateEntryInput, type CreatePushTargetInput, type Entry, type EntryData, type EntryFilters, FanappsAuthError, FanappsClient, type FanappsClientOptions, type FanappsContextValue, FanappsError, FanappsProvider, type FanappsProviderProps, type HookOptions, type Locale, type Paginated, type PaginationLinks, type PaginationMeta, type PaginationParams, type PushTarget, StorageAdapter, type SubmitTriviaResponseInput, type Trivia, type TriviaAnswer, type TriviaResponseResult, type UpdateEntryInput, type UploadAssetInput, type UseAuthResult, useArticle, useArticles, useAuth, useCreateEntry, useDeleteEntry, useEntries, useEntry, useFanapps, useFanappsClient, useSubmitTriviaResponse, useTrivia, useTrivias, useUpdateEntry, useUploadAsset };

package/dist/index.d.ts

@@ -1,8 +1,175 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { QueryClient, UseQueryResult, UseMutationResult } from '@tanstack/react-query';
 import { ReactNode } from 'react';
-import { L as Locale, S as StorageAdapter, C as CreatePushTargetInput, P as PushTarget, A as AuthUser, a as AuthStatus, E as EntryFilters, H as HookOptions, b as Paginated, c as Entry, d as ArticleFilters, e as Article, T as Trivia, f as TriviaResponseResult } from './types-CKpYrzCw.js';
-export { g as ArticleStatus, h as EntryData, i as PaginationLinks, j as PaginationMeta, k as PaginationParams, l as TriviaAnswer } from './types-CKpYrzCw.js';
+import { S as StorageAdapter } from './storage-D6z5ScLn.js';
+import { FirebaseAuthTypes } from '@react-native-firebase/auth';
+
+type Locale = string;
+type EntryData = Record<string, unknown>;
+interface Entry {
+    id: string | number;
+    slug: string;
+    published: boolean;
+    date: string | null;
+    order: number | null;
+    collection: string | null;
+    blueprint: string;
+    data: EntryData;
+    created_at: string;
+    updated_at: string;
+    locale: Locale;
+    available_locales?: Locale[];
+}
+type ArticleStatus = 'draft' | 'scheduled' | 'published';
+interface Article {
+    id: string | number;
+    title: string;
+    content: string;
+    status: ArticleStatus;
+    published_at: string | null;
+    featured_image_url: string | null;
+    created_at: string;
+    updated_at: string;
+    locale: Locale;
+    available_locales?: Locale[];
+}
+interface TriviaAnswer {
+    id: string | number;
+    text: string;
+    is_correct: boolean;
+    sort_order: number;
+}
+interface Trivia {
+    id: string | number;
+    title: string;
+    description: string | null;
+    featured_image_id: string | number | null;
+    featured_image?: {
+        id: string | number;
+        url: string;
+        [key: string]: unknown;
+    } | null;
+    awards_points: boolean;
+    points_amount: number;
+    max_time_seconds: number | null;
+    show_correct_after: boolean;
+    starts_at: string | null;
+    ends_at: string | null;
+    answers: TriviaAnswer[];
+    responses_count?: number;
+    created_at: string;
+    updated_at: string;
+}
+interface TriviaResponseResult {
+    is_correct: boolean;
+    points_awarded: number;
+    correct_answer?: TriviaAnswer;
+}
+interface PaginationMeta {
+    current_page: number;
+    last_page: number;
+    per_page: number;
+    total: number;
+    from: number | null;
+    to: number | null;
+    path?: string;
+}
+interface PaginationLinks {
+    first: string | null;
+    last: string | null;
+    prev: string | null;
+    next: string | null;
+}
+interface Paginated<T> {
+    data: T[];
+    meta: PaginationMeta;
+    links: PaginationLinks;
+}
+interface PaginationParams {
+    page?: number;
+    perPage?: number;
+    sort?: string;
+}
+interface EntryFilters extends PaginationParams {
+    blueprint?: string;
+    collection?: string;
+    slug?: string;
+    published?: boolean;
+}
+interface ArticleFilters extends PaginationParams {
+    status?: ArticleStatus;
+}
+interface HookOptions {
+    locale?: Locale;
+    enabled?: boolean;
+}
+type AuthStatus = 'loading' | 'signed-in' | 'signed-out';
+interface AuthUser {
+    uid: string;
+    email: string | null;
+    displayName: string | null;
+    photoURL: string | null;
+    phoneNumber: string | null;
+    isAnonymous: boolean;
+    providerId: string | null;
+}
+interface PushTarget {
+    id: string;
+    app_user_id: number | string | null;
+    identifier: string;
+    provider: 'fcm' | 'apns';
+    provider_id: string | null;
+    device_brand: string | null;
+    device_model: string | null;
+    os_name: string | null;
+    os_version: string | null;
+    last_seen_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+interface CreatePushTargetInput {
+    targetId: string;
+    identifier: string;
+    providerId?: string;
+    deviceBrand?: string;
+    deviceModel?: string;
+    osName?: string;
+    osVersion?: string;
+}
+interface Asset {
+    id: number;
+    name: string;
+    alt_text: string | null;
+    url: string | null;
+    thumbnail_url: string | null;
+    mime_type: string | null;
+    size: number | null;
+    width: number | null;
+    height: number | null;
+    created_at: string;
+    updated_at: string;
+}
+interface AssetUploadFile {
+    uri: string;
+    name: string;
+    type: string;
+}
+interface UploadAssetInput {
+    file: AssetUploadFile;
+    altText?: string;
+}
+interface CreateEntryInput {
+    blueprint: string;
+    publishedAt?: string | null;
+    terms?: Record<string, Array<number | string>>;
+    [field: string]: unknown;
+}
+interface UpdateEntryInput {
+    id: string | number;
+    publishedAt?: string | null;
+    terms?: Record<string, Array<number | string>>;
+    [field: string]: unknown;
+}
 
 interface FanappsProviderProps {
     apiKey: string;
@@ -35,6 +202,11 @@ declare class FanappsClient {
     createPushTarget(input: CreatePushTargetInput): Promise<PushTarget>;
     updatePushTarget(targetId: string, identifier: string): Promise<PushTarget>;
     deletePushTarget(targetId: string): Promise<void>;
+    createEntry(input: CreateEntryInput): Promise<Entry>;
+    updateEntry({ id, ...rest }: UpdateEntryInput): Promise<Entry>;
+    deleteEntry(id: string | number): Promise<void>;
+    uploadAsset(input: UploadAssetInput): Promise<Asset>;
+    private requestMultipart;
     private request;
     private buildUrl;
 }
@@ -50,6 +222,32 @@ declare class FanappsAuthError extends Error {
     constructor(message: string, code: string);
 }
 
+type AuthListener = (snapshot: AuthStoreSnapshot) => void;
+interface AuthStoreSnapshot {
+    user: AuthUser | null;
+    firebaseUser: FirebaseAuthTypes.User | null;
+    status: AuthStatus;
+}
+declare class AuthStore {
+    private snapshot;
+    private listeners;
+    private unsubscribe;
+    start(): void;
+    stop(): void;
+    subscribe(listener: AuthListener): () => void;
+    getSnapshot(): AuthStoreSnapshot;
+    getCurrentIdToken(): Promise<string | null>;
+    private emit;
+}
+
+interface FanappsContextValue {
+    client: FanappsClient;
+    authStore: AuthStore;
+    storage: StorageAdapter | undefined;
+    locale?: Locale;
+}
+declare function useFanapps(): FanappsContextValue;
+
 declare function useFanappsClient(): FanappsClient;
 
 interface UseAuthResult {
@@ -67,6 +265,14 @@ declare function useEntries(filters?: EntryFilters, options?: HookOptions): UseQ
 
 declare function useEntry(id: string | number | null | undefined, options?: HookOptions): UseQueryResult<Entry>;
 
+declare function useCreateEntry(): UseMutationResult<Entry, FanappsError, CreateEntryInput>;
+
+declare function useUpdateEntry(): UseMutationResult<Entry, FanappsError, UpdateEntryInput>;
+
+declare function useDeleteEntry(): UseMutationResult<void, FanappsError, string | number>;
+
+declare function useUploadAsset(): UseMutationResult<Asset, FanappsError, UploadAssetInput>;
+
 declare function useArticles(filters?: ArticleFilters, options?: HookOptions): UseQueryResult<Paginated<Article>>;
 
 declare function useArticle(id: string | number | null | undefined, options?: HookOptions): UseQueryResult<Article>;
@@ -81,4 +287,4 @@ interface SubmitTriviaResponseInput {
 }
 declare function useSubmitTriviaResponse(): UseMutationResult<TriviaResponseResult, FanappsError, SubmitTriviaResponseInput>;
 
-export { Article, ArticleFilters, AuthStatus, AuthUser, CreatePushTargetInput, Entry, EntryFilters, FanappsAuthError, FanappsClient, type FanappsClientOptions, FanappsError, FanappsProvider, type FanappsProviderProps, HookOptions, Locale, Paginated, PushTarget, StorageAdapter, type SubmitTriviaResponseInput, Trivia, TriviaResponseResult, type UseAuthResult, useArticle, useArticles, useAuth, useEntries, useEntry, useFanappsClient, useSubmitTriviaResponse, useTrivia, useTrivias };
+export { type Article, type ArticleFilters, type ArticleStatus, type Asset, type AssetUploadFile, type AuthStatus, type AuthUser, type CreateEntryInput, type CreatePushTargetInput, type Entry, type EntryData, type EntryFilters, FanappsAuthError, FanappsClient, type FanappsClientOptions, type FanappsContextValue, FanappsError, FanappsProvider, type FanappsProviderProps, type HookOptions, type Locale, type Paginated, type PaginationLinks, type PaginationMeta, type PaginationParams, type PushTarget, StorageAdapter, type SubmitTriviaResponseInput, type Trivia, type TriviaAnswer, type TriviaResponseResult, type UpdateEntryInput, type UploadAssetInput, type UseAuthResult, useArticle, useArticles, useAuth, useCreateEntry, useDeleteEntry, useEntries, useEntry, useFanapps, useFanappsClient, useSubmitTriviaResponse, useTrivia, useTrivias, useUpdateEntry, useUploadAsset };