@fanapps/react-native 0.2.0 → 0.3.1

package/README.md

@@ -7,22 +7,24 @@ React Native SDK for the Fanapps API — Firebase-powered auth, paginated conten
 ```sh
 pnpm add @fanapps/react-native \
   @tanstack/react-query \
-  @react-native-firebase/app \
-  @react-native-firebase/auth
+  @react-native-firebase/app
 ```
 
-`react`, `react-native`, `@tanstack/react-query`, `@react-native-firebase/app`, and `@react-native-firebase/auth` are **required** peer dependencies.
+iOS:
 
-Optional peers (install only if you use the matching feature):
+```sh
+cd ios && pod install
+```
+
+The SDK auto-installs all required native modules (`@react-native-firebase/auth`, `/messaging`, Google sign-in, Apple sign-in, AsyncStorage) — autolinking handles native registration.
+
+You still need Firebase's native config:
+- `google-services.json` (Android) → `android/app/`
+- `GoogleService-Info.plist` (iOS) → `ios/<AppName>/`
 
-| Feature                             | Package                                        |
-| ----------------------------------- | ---------------------------------------------- |
-| Push registration + topic subscribe | `@react-native-firebase/messaging`             |
-| Persist `targetId` across launches  | `@react-native-async-storage/async-storage`    |
-| Google sign-in                      | `@react-native-google-signin/google-signin`    |
-| Apple sign-in (iOS)                 | `@invertase/react-native-apple-authentication` |
+See the [React Native Firebase setup docs](https://rnfirebase.io/#installation).
 
-You also need Firebase's native config (`google-services.json` on Android, `GoogleService-Info.plist` on iOS) — see the [React Native Firebase docs](https://rnfirebase.io).
+If you use Google sign-in, configure OAuth client IDs per the [google-signin docs](https://github.com/react-native-google-signin/google-signin). For Apple sign-in, enable the "Sign in with Apple" capability in Xcode.
 
 ## Quick start
 
@@ -180,7 +182,7 @@ useArticles(filters?: ArticleFilters, options?)  // Paginated<Article>
 useArticle(id, options?)                         // Article
 ```
 
-Filters: `is_published`, `sort`, `perPage`, `page`.
+Filters: `status` (`draft` | `scheduled` | `published`), `sort`, `perPage`, `page`.
 
 ### Trivia
 
@@ -225,7 +227,7 @@ All client calls carry the same `Authorization`, `X-Tenant`, and `X-Firebase-Tok
 ## Errors
 
 - Non-2xx HTTP responses throw `FanappsError` with `{ status, body, message }`.
-- Auth flows throw `FanappsAuthError` with a `code` field. Common codes: `peer/load-failed` (module can't be loaded — usually a Metro symlink issue, see below), `peer/unexpected-shape` (loaded but wrong interop shape), `auth/platform-not-supported`, `auth/not-supported`, `auth/no-token`.
+- Auth flows throw `FanappsAuthError` with a `code` field. Codes: `auth/platform-not-supported`, `auth/not-supported`, `auth/no-token`.
 
 ```tsx
 import { FanappsError, FanappsAuthError } from '@fanapps/react-native';
@@ -238,8 +240,8 @@ if (error instanceof FanappsError && error.status === 401) {
 try {
   await signInWithGoogle();
 } catch (e) {
-  if (e instanceof FanappsAuthError && e.code === 'peer/load-failed') {
-    // Google package couldn't be loaded — see "Symlinked installs" section
+  if (e instanceof FanappsAuthError && e.code === 'auth/platform-not-supported') {
+    // Apple sign-in on Android, etc.
   }
 }
 ```
@@ -256,64 +258,7 @@ interface StorageAdapter {
 }
 ```
 
-`@react-native-async-storage/async-storage`'s default export matches this exactly. If you want to use `expo-secure-store` or a custom backend, wrap it in an adapter.
-
-If no `storage` prop is passed and AsyncStorage isn't installed, the SDK falls back to in-memory storage — the `targetId` will be lost on app restart, and a new push target row will be created on the next `register()` call.
-
-## Symlinked installs (local development)
-
-If you link the SDK via `pnpm link`, a filesystem symlink, or `file:` protocol, Metro will often fail to resolve peer dependencies like `@react-native-firebase/auth` from the SDK's location — even though they're installed in your app. You'll see:
-
-```
-FanappsAuthError: @fanapps/react-native could not load @react-native-firebase/auth:
-Unable to resolve module '@react-native-firebase/auth'
-```
-
-The error code on the thrown `FanappsAuthError` is `peer/load-failed`. Two fixes:
-
-### Option A — `yalc` (recommended)
-
-`yalc` copies files instead of symlinking, so Metro has nothing special to resolve. From the SDK directory:
-
-```sh
-yalc publish
-```
-
-In your app:
-
-```sh
-yalc add @fanapps/react-native
-pnpm install
-```
-
-When you change the SDK: `pnpm build && yalc push` — all linked apps update immediately.
-
-### Option B — Metro config with `extraNodeModules`
-
-If you must keep the symlink (e.g. you want live SDK changes without a push step), tell Metro to always resolve peer deps from the app's `node_modules`:
-
-```js
-// metro.config.js
-const { getDefaultConfig } = require('@react-native/metro-config');
-const path = require('path');
-
-const config = getDefaultConfig(__dirname);
-
-config.resolver.unstable_enableSymlinks = true;
-config.resolver.extraNodeModules = new Proxy(
-  {},
-  { get: (_, name) => path.resolve(__dirname, 'node_modules', String(name)) },
-);
-config.watchFolders = [
-  path.resolve(__dirname, '../path/to/fanapps/resources/sdk/react-native'),
-];
-
-module.exports = config;
-```
-
-Then clear Metro cache: `npx react-native start --reset-cache` (or `expo start -c`).
-
-The `extraNodeModules` Proxy forces every module lookup — including ones originating inside the symlinked SDK — to resolve against your app's `node_modules`. This avoids duplicate copies of `react` / `react-native` / `@react-native-firebase/*` too, which would otherwise cause "Invalid hook call" errors.
+Defaults to `@react-native-async-storage/async-storage` (which the SDK auto-installs). To use `expo-secure-store` or a custom backend, pass it via the `storage` prop wrapped in an adapter.
 
 ## Build
 

package/dist/index.d.mts

@@ -24,11 +24,13 @@ interface Entry {
     locale: Locale;
     available_locales?: Locale[];
 }
+type ArticleStatus = 'draft' | 'scheduled' | 'published';
 interface Article {
     id: string | number;
     title: string;
     content: string;
-    is_published: boolean;
+    status: ArticleStatus;
+    published_at: string | null;
     featured_image_url: string | null;
     created_at: string;
     updated_at: string;
@@ -99,7 +101,7 @@ interface EntryFilters extends PaginationParams {
     published?: boolean;
 }
 interface ArticleFilters extends PaginationParams {
-    is_published?: boolean;
+    status?: ArticleStatus;
 }
 interface HookOptions {
     locale?: Locale;

package/dist/index.d.ts

@@ -24,11 +24,13 @@ interface Entry {
     locale: Locale;
     available_locales?: Locale[];
 }
+type ArticleStatus = 'draft' | 'scheduled' | 'published';
 interface Article {
     id: string | number;
     title: string;
     content: string;
-    is_published: boolean;
+    status: ArticleStatus;
+    published_at: string | null;
     featured_image_url: string | null;
     created_at: string;
     updated_at: string;
@@ -99,7 +101,7 @@ interface EntryFilters extends PaginationParams {
     published?: boolean;
 }
 interface ArticleFilters extends PaginationParams {
-    is_published?: boolean;
+    status?: ArticleStatus;
 }
 interface HookOptions {
     locale?: Locale;

package/dist/index.js

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -42,67 +52,13 @@ module.exports = __toCommonJS(index_exports);
 var import_react_query = require("@tanstack/react-query");
 var import_react2 = require("react");
 
-// src/auth/errors.ts
-var FanappsAuthError = class extends Error {
-  constructor(message, code) {
-    super(message);
-    this.name = "FanappsAuthError";
-    this.code = code;
-  }
-};
-function peerLoadFailed(pkg, cause) {
-  const reason = cause instanceof Error ? cause.message : String(cause);
-  return new FanappsAuthError(
-    `@fanapps/react-native could not load ${pkg}: ${reason}. If the package is installed, Metro may be failing to resolve it from the SDK's location. See the README "Symlinked installs" section for a metro.config.js fix.`,
-    "peer/load-failed"
-  );
-}
-function peerUnexpectedShape(pkg, details) {
-  return new FanappsAuthError(
-    `@fanapps/react-native loaded ${pkg} but its shape was unexpected: ${details}. This usually indicates a bundler/interop mismatch or a duplicate copy of the package.`,
-    "peer/unexpected-shape"
-  );
-}
-
 // src/auth/firebaseApp.ts
-var cachedAuth = null;
+var import_auth = __toESM(require("@react-native-firebase/auth"));
+var cached = null;
 function firebaseAuth() {
-  if (cachedAuth) {
-    return cachedAuth;
-  }
-  let mod;
-  try {
-    mod = require("@react-native-firebase/auth");
-  } catch (e) {
-    throw peerLoadFailed("@react-native-firebase/auth", e);
-  }
-  const factory = resolveFactory(mod);
-  if (!factory) {
-    throw peerUnexpectedShape(
-      "@react-native-firebase/auth",
-      `expected a factory function, got ${describeShape(mod)}`
-    );
-  }
-  cachedAuth = factory();
-  return cachedAuth;
-}
-function resolveFactory(mod) {
-  if (typeof mod === "function") {
-    return mod;
-  }
-  if (mod && typeof mod === "object" && "default" in mod) {
-    const def = mod.default;
-    if (typeof def === "function") {
-      return def;
-    }
-  }
-  return null;
-}
-function describeShape(mod) {
-  if (mod === null) return "null";
-  if (typeof mod !== "object") return typeof mod;
-  const keys = Object.keys(mod).slice(0, 5);
-  return `object with keys [${keys.join(", ")}]`;
+  if (cached) return cached;
+  cached = (0, import_auth.default)();
+  return cached;
 }
 
 // src/auth/authStore.ts
@@ -207,7 +163,9 @@ var FanappsClient = class {
     return response.data;
   }
   async deletePushTarget(targetId) {
-    await this.delete(`/api/account/targets/push/${encodeURIComponent(targetId)}`);
+    await this.delete(
+      `/api/account/targets/push/${encodeURIComponent(targetId)}`
+    );
   }
   async request(method, path, opts) {
     const url = this.buildUrl(path, opts.params);
@@ -250,11 +208,15 @@ function serializeParams(params) {
     if (Array.isArray(value)) {
       for (const item of value) {
         if (item === void 0 || item === null) continue;
-        parts.push(`${encodeURIComponent(key)}[]=${encodeURIComponent(String(item))}`);
+        parts.push(
+          `${encodeURIComponent(key)}[]=${encodeURIComponent(String(item))}`
+        );
       }
       continue;
     }
-    parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+    parts.push(
+      `${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`
+    );
   }
   return parts.join("&");
 }
@@ -280,35 +242,9 @@ function useFanapps() {
 }
 
 // src/push/storage.ts
-var memoryFallbackWarned = false;
+var import_async_storage = __toESM(require("@react-native-async-storage/async-storage"));
 function resolveStorage(explicit) {
-  if (explicit) return explicit;
-  try {
-    const mod = require("@react-native-async-storage/async-storage");
-    return mod.default;
-  } catch {
-    if (!memoryFallbackWarned && typeof __DEV__ !== "undefined" && __DEV__) {
-      console.warn(
-        "[@fanapps/react-native] No storage adapter provided and @react-native-async-storage/async-storage not installed. Push target IDs will be lost on app restart."
-      );
-      memoryFallbackWarned = true;
-    }
-    return createMemoryStorage();
-  }
-}
-function createMemoryStorage() {
-  const store = /* @__PURE__ */ new Map();
-  return {
-    async getItem(key) {
-      return store.get(key) ?? null;
-    },
-    async setItem(key, value) {
-      store.set(key, value);
-    },
-    async removeItem(key) {
-      store.delete(key);
-    }
-  };
+  return explicit ?? import_async_storage.default;
 }
 
 // src/provider.tsx
@@ -353,6 +289,15 @@ function FanappsProvider({
   return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_query.QueryClientProvider, { client: resolvedQueryClient, children: /* @__PURE__ */ (0, import_jsx_runtime.jsx)(FanappsContext.Provider, { value, children }) });
 }
 
+// src/auth/errors.ts
+var FanappsAuthError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.name = "FanappsAuthError";
+    this.code = code;
+  }
+};
+
 // src/hooks/useFanappsClient.ts
 function useFanappsClient() {
   return useFanapps().client;
@@ -362,32 +307,22 @@ function useFanappsClient() {
 var import_react3 = require("react");
 
 // src/auth/providers/google.ts
+var import_auth2 = __toESM(require("@react-native-firebase/auth"));
+var import_google_signin = require("@react-native-google-signin/google-signin");
 async function signInWithGoogle() {
-  let mod;
-  try {
-    mod = require("@react-native-google-signin/google-signin");
-  } catch (e) {
-    throw peerLoadFailed("@react-native-google-signin/google-signin", e);
-  }
-  let authMod;
-  try {
-    authMod = require("@react-native-firebase/auth");
-  } catch (e) {
-    throw peerLoadFailed("@react-native-firebase/auth", e);
-  }
-  await mod.GoogleSignin.hasPlayServices({ showPlayServicesUpdateDialog: true });
-  const result = await mod.GoogleSignin.signIn();
+  await import_google_signin.GoogleSignin.hasPlayServices({ showPlayServicesUpdateDialog: true });
+  const result = await import_google_signin.GoogleSignin.signIn();
   const idToken = "data" in result ? result.data?.idToken ?? null : result.idToken;
   if (!idToken) {
     throw new Error("Google sign-in returned no ID token.");
   }
-  const credential = authMod.GoogleAuthProvider.credential(idToken);
-  return firebaseAuth().signInWithCredential(
-    credential
-  );
+  const credential = import_auth2.default.GoogleAuthProvider.credential(idToken);
+  return firebaseAuth().signInWithCredential(credential);
 }
 
 // src/auth/providers/apple.ts
+var import_auth3 = __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");
 async function signInWithApple() {
   if (import_react_native.Platform.OS !== "ios") {
@@ -396,35 +331,27 @@ async function signInWithApple() {
       "auth/platform-not-supported"
     );
   }
-  let mod;
-  try {
-    mod = require("@invertase/react-native-apple-authentication");
-  } catch (e) {
-    throw peerLoadFailed("@invertase/react-native-apple-authentication", e);
-  }
-  let authMod;
-  try {
-    authMod = require("@react-native-firebase/auth");
-  } catch (e) {
-    throw peerLoadFailed("@react-native-firebase/auth", e);
-  }
-  if (!mod.appleAuth.isSupported) {
-    throw new FanappsAuthError("Apple sign-in not supported on this device.", "auth/not-supported");
+  if (!import_react_native_apple_authentication.appleAuth.isSupported) {
+    throw new FanappsAuthError(
+      "Apple sign-in not supported on this device.",
+      "auth/not-supported"
+    );
   }
-  const result = await mod.appleAuth.performRequest({
-    requestedOperation: mod.appleAuth.Operation.LOGIN,
-    requestedScopes: [mod.appleAuth.Scope.EMAIL, mod.appleAuth.Scope.FULL_NAME]
+  const result = await import_react_native_apple_authentication.appleAuth.performRequest({
+    requestedOperation: import_react_native_apple_authentication.appleAuth.Operation.LOGIN,
+    requestedScopes: [import_react_native_apple_authentication.appleAuth.Scope.EMAIL, import_react_native_apple_authentication.appleAuth.Scope.FULL_NAME]
   });
   if (!result.identityToken) {
-    throw new FanappsAuthError("Apple did not return an identity token.", "auth/no-token");
+    throw new FanappsAuthError(
+      "Apple did not return an identity token.",
+      "auth/no-token"
+    );
   }
-  const credential = authMod.AppleAuthProvider.credential(
+  const credential = import_auth3.default.AppleAuthProvider.credential(
     result.identityToken,
     result.nonce ?? void 0
   );
-  return firebaseAuth().signInWithCredential(
-    credential
-  );
+  return firebaseAuth().signInWithCredential(credential);
 }
 
 // src/hooks/useAuth.ts
@@ -553,42 +480,12 @@ var import_react4 = require("react");
 var import_react_native2 = require("react-native");
 
 // src/push/messaging.ts
-var cached = null;
+var import_messaging = __toESM(require("@react-native-firebase/messaging"));
+var cached2 = null;
 function firebaseMessaging() {
-  if (cached) return cached;
-  let mod;
-  try {
-    mod = require("@react-native-firebase/messaging");
-  } catch (e) {
-    throw peerLoadFailed("@react-native-firebase/messaging", e);
-  }
-  const factory = resolveFactory2(mod);
-  if (!factory) {
-    throw peerUnexpectedShape(
-      "@react-native-firebase/messaging",
-      `expected a factory function, got ${describeShape2(mod)}`
-    );
-  }
-  cached = factory();
-  return cached;
-}
-function resolveFactory2(mod) {
-  if (typeof mod === "function") {
-    return mod;
-  }
-  if (mod && typeof mod === "object" && "default" in mod) {
-    const def = mod.default;
-    if (typeof def === "function") {
-      return def;
-    }
-  }
-  return null;
-}
-function describeShape2(mod) {
-  if (mod === null) return "null";
-  if (typeof mod !== "object") return typeof mod;
-  const keys = Object.keys(mod).slice(0, 5);
-  return `object with keys [${keys.join(", ")}]`;
+  if (cached2) return cached2;
+  cached2 = (0, import_messaging.default)();
+  return cached2;
 }
 
 // src/push/targetIdStore.ts