@appsupportkit/support-sdk 0.1.0 → 0.1.2

package/lib/typescript/api.d.ts

@@ -1,4 +1,4 @@
-import type { QueryType, ThreadsResponse } from './types';
+import type { PushPermissionStatus, QueryType, ThreadsResponse } from './types';
 export interface ApiConfig {
     supabaseUrl: string;
     apiKey: string;
@@ -11,6 +11,22 @@ export declare class SupportApiError extends Error {
     constructor(message: string, status: number | null, offline?: boolean);
 }
 export declare function getThreads(config: ApiConfig, revenuecatId: string): Promise<ThreadsResponse>;
+/**
+ * Badge-only endpoint (~18 bytes) used for idle polling, instead of
+ * re-fetching every thread and message just to check for new replies.
+ */
+export declare function getUnreadCount(config: ApiConfig, revenuecatId: string): Promise<{
+    total_unread: number;
+}>;
+/** Reports the OS notification permission outcome (including denials). */
+export declare function registerPush(config: ApiConfig, input: {
+    revenuecatId: string;
+    permissionStatus: PushPermissionStatus;
+    expoPushToken: string | null;
+    asked: boolean;
+}): Promise<{
+    ok: boolean;
+}>;
 export declare function submitQuery(config: ApiConfig, input: {
     queryType: QueryType;
     message: string;

package/lib/typescript/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE1D,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;gBAEL,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,UAAQ;CAMpE;AA2CD,wBAAgB,UAAU,CACxB,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,CAAC,CAK1B;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE;IACL,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAa/B;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAChE,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CASjC;AAED,wBAAgB,QAAQ,CACtB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC/C,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAA;CAAE,CAAC,CAQ1B"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/api.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,SAAS,EACT,eAAe,EAChB,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,wDAAwD;IACxD,OAAO,EAAE,OAAO,CAAC;gBAEL,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,UAAQ;CAMpE;AA2CD,wBAAgB,UAAU,CACxB,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,CAAC,CAK1B;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,SAAS,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC,CAKnC;AAED,0EAA0E;AAC1E,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE;IACL,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,oBAAoB,CAAC;IACvC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,OAAO,CAAC;CAChB,GACA,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAA;CAAE,CAAC,CAW1B;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE;IACL,SAAS,EAAE,SAAS,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,OAAO,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB,GACA,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAa/B;AAED,wBAAgB,WAAW,CACzB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAChE,OAAO,CAAC;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CASjC;AAED,wBAAgB,QAAQ,CACtB,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAC/C,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAA;CAAE,CAAC,CAQ1B"}

package/lib/typescript/components/SupportButton.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SupportButton.d.ts","sourceRoot":"","sources":["../../../src/components/SupportButton.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAa,kBAAkB,EAAU,MAAM,UAAU,CAAC;AAatE;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,sCAkPtD"}
+{"version":3,"file":"SupportButton.d.ts","sourceRoot":"","sources":["../../../src/components/SupportButton.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAa,kBAAkB,EAAU,MAAM,UAAU,CAAC;AAsBtE;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,sCAiUtD"}

package/lib/typescript/components/screens/ComposeScreen.d.ts

@@ -4,7 +4,7 @@ export declare function ComposeScreen({ theme, type, onBack, onSubmit, }: {
     theme: SupportTheme;
     type: QueryType;
     onBack: () => void;
-    /** Resolves true on success. */
-    onSubmit: (message: string) => Promise<boolean>;
+    /** Resolves null on success, or a user-facing error message. */
+    onSubmit: (message: string) => Promise<string | null>;
 }): import("react").JSX.Element;
 //# sourceMappingURL=ComposeScreen.d.ts.map

package/lib/typescript/components/screens/ComposeScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ComposeScreen.d.ts","sourceRoot":"","sources":["../../../../src/components/screens/ComposeScreen.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAK7C,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,IAAI,EACJ,MAAM,EACN,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,gCAAgC;IAChC,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACjD,+BA+IA"}
+{"version":3,"file":"ComposeScreen.d.ts","sourceRoot":"","sources":["../../../../src/components/screens/ComposeScreen.tsx"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAK7C,wBAAgB,aAAa,CAAC,EAC5B,KAAK,EACL,IAAI,EACJ,MAAM,EACN,QAAQ,GACT,EAAE;IACD,KAAK,EAAE,YAAY,CAAC;IACpB,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,gEAAgE;IAChE,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACvD,+BA+IA"}

package/lib/typescript/components/screens/HomeScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HomeScreen.d.ts","sourceRoot":"","sources":["../../../../src/components/screens/HomeScreen.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA+ErD,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,OAAO,EACP,OAAO,EACP,KAAK,EACL,OAAO,EACP,SAAS,EACT,YAAY,EACZ,OAAO,GACR,EAAE;IACD,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACrC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,+BAsIA"}
+{"version":3,"file":"HomeScreen.d.ts","sourceRoot":"","sources":["../../../../src/components/screens/HomeScreen.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AA+ErD,wBAAgB,UAAU,CAAC,EACzB,KAAK,EACL,OAAO,EACP,OAAO,EACP,KAAK,EACL,OAAO,EACP,SAAS,EACT,YAAY,EACZ,OAAO,GACR,EAAE;IACD,KAAK,EAAE,YAAY,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,SAAS,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;IACrC,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,+BAwIA"}

package/lib/typescript/components/screens/ThreadScreen.d.ts

@@ -4,7 +4,7 @@ export declare function ThreadScreen({ theme, thread, onBack, onSend, }: {
     theme: SupportTheme;
     thread: Thread;
     onBack: () => void;
-    /** Resolves true on success. */
-    onSend: (message: string) => Promise<boolean>;
+    /** Resolves null on success, or a user-facing error message. */
+    onSend: (message: string) => Promise<string | null>;
 }): import("react").JSX.Element;
 //# sourceMappingURL=ThreadScreen.d.ts.map

package/lib/typescript/components/screens/ThreadScreen.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ThreadScreen.d.ts","sourceRoot":"","sources":["../../../../src/components/screens/ThreadScreen.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAY1C,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,MAAM,EACN,MAAM,EACN,MAAM,GACP,EAAE;IACD,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,gCAAgC;IAChC,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CAC/C,+BAiMA"}
+{"version":3,"file":"ThreadScreen.d.ts","sourceRoot":"","sources":["../../../../src/components/screens/ThreadScreen.tsx"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAY1C,wBAAgB,YAAY,CAAC,EAC3B,KAAK,EACL,MAAM,EACN,MAAM,EACN,MAAM,GACP,EAAE;IACD,KAAK,EAAE,YAAY,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,gEAAgE;IAChE,MAAM,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CACrD,+BAiMA"}

package/lib/typescript/index.d.ts

@@ -1,6 +1,7 @@
 export { SupportButton } from './components/SupportButton';
 export { supportDarkTheme, supportLightTheme, resolveTheme, type SupportTheme, } from './theme';
 export { SupportApiError } from './api';
-export type { MessageSender, QueryStatus, QueryType, SupportButtonProps, SupportUser, Thread, ThreadMessage, ThreadsResponse, ThemeName, } from './types';
+export { isPushAvailable } from './push';
+export type { MessageSender, PushPermissionStatus, QueryStatus, QueryType, SupportButtonProps, SupportUser, Thread, ThreadMessage, ThreadsResponse, ThemeName, } from './types';
 export { QUERY_TYPE_LABEL, USER_MESSAGE_MAX, USER_MESSAGE_MIN, } from './types';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AACxC,YAAY,EACV,aAAa,EACb,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,WAAW,EACX,MAAM,EACN,aAAa,EACb,eAAe,EACf,SAAS,GACV,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,YAAY,EACZ,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,eAAe,EAAE,MAAM,OAAO,CAAC;AACxC,OAAO,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AACzC,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,WAAW,EACX,SAAS,EACT,kBAAkB,EAClB,WAAW,EACX,MAAM,EACN,aAAa,EACb,eAAe,EACf,SAAS,GACV,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,SAAS,CAAC"}

package/lib/typescript/push.d.ts

@@ -0,0 +1,18 @@
+import type { PushPermissionStatus } from './types';
+/** True when the host app has expo-notifications installed. */
+export declare const isPushAvailable: boolean;
+export interface PushRegistration {
+    status: PushPermissionStatus;
+    /** Whether the OS prompt was actually presented during this call. */
+    asked: boolean;
+    token: string | null;
+}
+/**
+ * Ensures notification permission has been requested, and returns the
+ * outcome plus an Expo push token when one is obtainable.
+ *
+ * Never throws: any failure resolves to an 'undetermined' registration so
+ * callers can report it and move on.
+ */
+export declare function ensurePushPermission(expoProjectId?: string): Promise<PushRegistration>;
+//# sourceMappingURL=push.d.ts.map

package/lib/typescript/push.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push.d.ts","sourceRoot":"","sources":["../../src/push.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAuBpD,+DAA+D;AAC/D,eAAO,MAAM,eAAe,SAAyB,CAAC;AAEtD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,qEAAqE;IACrE,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAQD;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,aAAa,CAAC,EAAE,MAAM,GACrB,OAAO,CAAC,gBAAgB,CAAC,CAoC3B"}

package/lib/typescript/types.d.ts

@@ -2,6 +2,7 @@ export type QueryType = 'feedback' | 'feature_request' | 'bug_report';
 export type QueryStatus = 'open' | 'resolved';
 export type MessageSender = 'user' | 'admin';
 export type ThemeName = 'dark' | 'light';
+export type PushPermissionStatus = 'undetermined' | 'granted' | 'denied';
 export interface SupportUser {
     /** Display name shown to the support team. */
     name: string;
@@ -27,6 +28,23 @@ export interface SupportButtonProps {
     supabaseUrl: string;
     /** Visual theme. Matches the admin dashboard tokens. Default "dark". */
     theme?: ThemeName;
+    /**
+     * Idle poll interval (ms) — how often the unread badge is refreshed while
+     * the sheet is CLOSED, using a lightweight count-only endpoint. Default
+     * 60000; set 0 to disable idle polling (mount / sheet-open / foreground
+     * refreshes still happen).
+     *
+     * While the sheet is open the SDK polls faster on its own: every 15s on
+     * the thread list and every 5s inside a thread, where latency is felt.
+     */
+    pollIntervalMs?: number;
+    /**
+     * Optional EAS project id, forwarded to expo-notifications when minting a
+     * push token. Only needed if the host app's config doesn't already
+     * provide one. Push is skipped entirely when expo-notifications isn't
+     * installed — it is an optional peer dependency.
+     */
+    expoProjectId?: string;
 }
 export interface ThreadMessage {
     id: string;

package/lib/typescript/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,iBAAiB,GAAG,YAAY,CAAC;AACtE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,CAAC;AAC9C,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC;AAC7C,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAEzC,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,IAAI,EAAE,WAAW,CAAC;IAClB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,aAAa,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI,CAAC;IACT,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAItD,CAAC;AAEF,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,gBAAgB,MAAM,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,iBAAiB,GAAG,YAAY,CAAC;AACtE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,UAAU,CAAC;AAC9C,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,CAAC;AAC7C,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AACzC,MAAM,MAAM,oBAAoB,GAAG,cAAc,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEzE,MAAM,WAAW,WAAW;IAC1B,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,8DAA8D;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,0EAA0E;IAC1E,MAAM,EAAE,MAAM,CAAC;IACf,sCAAsC;IACtC,IAAI,EAAE,WAAW,CAAC;IAClB;;;;OAIG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,wEAAwE;IACxE,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB;;;;;;;;OAQG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB;;;;;OAKG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,CAAC;IAChB,MAAM,EAAE,WAAW,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,aAAa,CAAC;QACtB,UAAU,EAAE,MAAM,CAAC;KACpB,GAAG,IAAI,CAAC;IACT,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,CAItD,CAAC;AAEF,eAAO,MAAM,gBAAgB,KAAK,CAAC;AACnC,eAAO,MAAM,gBAAgB,MAAM,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@appsupportkit/support-sdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "In-app customer support for React Native: feedback, feature requests, and bug reports with two-way threads.",
   "main": "./lib/commonjs/index.js",
   "module": "./lib/module/index.js",
@@ -22,10 +22,16 @@
     "@appsupportkit/design-tokens": "^0.1.0"
   },
   "peerDependencies": {
+    "expo-notifications": ">=0.27.0",
     "react": ">=18.0.0",
     "react-native": ">=0.73.0",
     "react-native-safe-area-context": ">=4.0.0"
   },
+  "peerDependenciesMeta": {
+    "expo-notifications": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@types/react": "^19.0.2",
     "react": "19.0.0",

package/src/api.ts

@@ -1,6 +1,10 @@
 // Thin client for the Supabase Edge Functions. Every call authenticates with
 // the per-app x-api-key header; no Supabase JS client is needed on-device.
-import type { QueryType, ThreadsResponse } from './types';
+import type {
+  PushPermissionStatus,
+  QueryType,
+  ThreadsResponse,
+} from './types';
 
 export interface ApiConfig {
   supabaseUrl: string;
@@ -72,6 +76,42 @@ export function getThreads(
   });
 }
 
+/**
+ * Badge-only endpoint (~18 bytes) used for idle polling, instead of
+ * re-fetching every thread and message just to check for new replies.
+ */
+export function getUnreadCount(
+  config: ApiConfig,
+  revenuecatId: string,
+): Promise<{ total_unread: number }> {
+  const params = new URLSearchParams({ revenuecat_id: revenuecatId });
+  return request(config, `get-unread-count?${params.toString()}`, {
+    method: 'GET',
+  });
+}
+
+/** Reports the OS notification permission outcome (including denials). */
+export function registerPush(
+  config: ApiConfig,
+  input: {
+    revenuecatId: string;
+    permissionStatus: PushPermissionStatus;
+    expoPushToken: string | null;
+    asked: boolean;
+  },
+): Promise<{ ok: boolean }> {
+  return request(config, 'register-push', {
+    method: 'POST',
+    body: JSON.stringify({
+      app_name: config.appName,
+      revenuecat_id: input.revenuecatId,
+      permission_status: input.permissionStatus,
+      expo_push_token: input.expoPushToken,
+      asked: input.asked,
+    }),
+  });
+}
+
 export function submitQuery(
   config: ApiConfig,
   input: {

package/src/components/SupportButton.tsx

@@ -1,6 +1,16 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
-import { Pressable, Text, View } from 'react-native';
-import { getThreads, markRead, postMessage, submitQuery, SupportApiError, type ApiConfig } from '../api';
+import { AppState, Pressable, Text, View } from 'react-native';
+import {
+  getThreads,
+  getUnreadCount,
+  markRead,
+  postMessage,
+  registerPush,
+  submitQuery,
+  SupportApiError,
+  type ApiConfig,
+} from '../api';
+import { ensurePushPermission, isPushAvailable } from '../push';
 import { resolveTheme } from '../theme';
 import type { QueryType, SupportButtonProps, Thread } from '../types';
 import { validateProps } from '../utils';
@@ -15,6 +25,15 @@ type Screen =
   | { name: 'compose'; type: QueryType }
   | { name: 'thread'; threadId: string };
 
+// Poll cadence by context: fast where latency is felt (staring at a thread
+// waiting for a reply), slow when the sheet is closed — and the idle tick
+// uses the count-only endpoint, so it costs ~18 bytes instead of the full
+// thread list.
+const THREAD_POLL_MS = 5_000;
+const SHEET_POLL_MS = 15_000;
+const IDLE_POLL_MS = 60_000;
+const MIN_POLL_MS = 3_000;
+
 /**
  * The single entry point of the SDK: a button with an unread badge that
  * opens the support bottom sheet. Polls get-threads on mount and whenever
@@ -69,16 +88,81 @@ export function SupportButton(props: SupportButtonProps) {
     }
   }, [config, props.user.revenuecatId, validationError]);
 
+  /** Badge-only refresh — the cheap endpoint used while idle. */
+  const refreshBadge = useCallback(async () => {
+    if (validationError) return;
+    try {
+      const data = await getUnreadCount(config, props.user.revenuecatId);
+      if (mounted.current) setTotalUnread(data.total_unread);
+    } catch {
+      // Best-effort: the next tick or the next sheet open reconciles.
+    }
+  }, [config, props.user.revenuecatId, validationError]);
+
   // Poll on mount…
   useEffect(() => {
     void refresh();
   }, [refresh]);
 
+  // …then adapt the cadence to what the user is looking at, and refresh
+  // whenever the app returns to the foreground.
+  const idlePollMs = props.pollIntervalMs ?? IDLE_POLL_MS;
+  const screenName = screen.name;
+  useEffect(() => {
+    const idle = !sheetOpen;
+    const intervalMs = idle
+      ? idlePollMs
+      : screenName === 'thread'
+        ? THREAD_POLL_MS
+        : SHEET_POLL_MS;
+
+    // While idle only the badge matters, so use the count-only endpoint.
+    const tick = () => void (idle ? refreshBadge() : refresh());
+
+    // Clamped so a typo like `pollIntervalMs={30}` can't hammer the API;
+    // 0 (or negative) disables idle polling entirely.
+    const timer =
+      intervalMs > 0 ? setInterval(tick, Math.max(intervalMs, MIN_POLL_MS)) : null;
+
+    const appStateSub = AppState.addEventListener('change', (state) => {
+      if (state === 'active') tick();
+    });
+
+    return () => {
+      if (timer !== null) clearInterval(timer);
+      appStateSub.remove();
+    };
+  }, [sheetOpen, screenName, idlePollMs, refresh, refreshBadge]);
+
+  /**
+   * Asks for notification permission the moment the sheet opens, then
+   * reports the outcome (including denials) so the dashboard knows whether
+   * this user is reachable. Deliberately fire-and-forget: nothing in the
+   * support flow waits on it or breaks if it fails.
+   */
+  const syncPushPermission = useCallback(async () => {
+    if (validationError || !isPushAvailable) return;
+    try {
+      const registration = await ensurePushPermission(props.expoProjectId);
+      await registerPush(config, {
+        revenuecatId: props.user.revenuecatId,
+        permissionStatus: registration.status,
+        expoPushToken: registration.token,
+        asked: registration.asked,
+      });
+    } catch {
+      // Push is an enhancement — never surfaced to the user as an error.
+    }
+  }, [config, props.user.revenuecatId, props.expoProjectId, validationError]);
+
   // …and on sheet open.
   function openSheet() {
     setScreen({ name: 'home' });
     setSheetOpen(true);
     void refresh();
+    // The OS prompt appears right as the sheet opens; if the user declines,
+    // everything below carries on exactly as before.
+    void syncPushPermission();
   }
 
   function closeSheet() {
@@ -129,7 +213,18 @@ export function SupportButton(props: SupportButtonProps) {
     }
   }
 
-  async function handleSubmit(type: QueryType, message: string) {
+  function writeErrorMessage(e: unknown): string {
+    if (e instanceof SupportApiError) {
+      if (e.status === 429) return 'Too many requests — try again later';
+      if (e.offline) return "You're offline — check your connection";
+    }
+    return "Couldn't send — try again";
+  }
+
+  async function handleSubmit(
+    type: QueryType,
+    message: string,
+  ): Promise<string | null> {
     try {
       await submitQuery(config, {
         queryType: type,
@@ -140,13 +235,16 @@ export function SupportButton(props: SupportButtonProps) {
         appVersion: props.user.appVersion,
       });
       void refresh();
-      return true;
-    } catch {
-      return false;
+      return null;
+    } catch (e) {
+      return writeErrorMessage(e);
     }
   }
 
-  async function handleSend(threadId: string, message: string) {
+  async function handleSend(
+    threadId: string,
+    message: string,
+  ): Promise<string | null> {
     try {
       await postMessage(config, {
         queryId: threadId,
@@ -154,9 +252,9 @@ export function SupportButton(props: SupportButtonProps) {
         message,
       });
       await refresh();
-      return true;
-    } catch {
-      return false;
+      return null;
+    } catch (e) {
+      return writeErrorMessage(e);
     }
   }
 

package/src/components/screens/ComposeScreen.tsx

@@ -15,12 +15,12 @@ export function ComposeScreen({
   theme: SupportTheme;
   type: QueryType;
   onBack: () => void;
-  /** Resolves true on success. */
-  onSubmit: (message: string) => Promise<boolean>;
+  /** Resolves null on success, or a user-facing error message. */
+  onSubmit: (message: string) => Promise<string | null>;
 }) {
   const [message, setMessage] = useState('');
   const [submitting, setSubmitting] = useState(false);
-  const [failed, setFailed] = useState(false);
+  const [failedMessage, setFailedMessage] = useState<string | null>(null);
   const [sent, setSent] = useState(false);
 
   const trimmed = message.trim();
@@ -31,11 +31,11 @@ export function ComposeScreen({
   async function handleSubmit() {
     if (!valid || submitting) return;
     setSubmitting(true);
-    setFailed(false);
-    const ok = await onSubmit(trimmed);
+    setFailedMessage(null);
+    const errorMessage = await onSubmit(trimmed);
     setSubmitting(false);
-    if (ok) setSent(true);
-    else setFailed(true);
+    if (errorMessage === null) setSent(true);
+    else setFailedMessage(errorMessage);
   }
 
   if (sent) {
@@ -96,7 +96,7 @@ export function ComposeScreen({
           value={message}
           onChangeText={(v) => {
             setMessage(v);
-            setFailed(false);
+            setFailedMessage(null);
           }}
           multiline
           autoFocus
@@ -143,9 +143,9 @@ export function ComposeScreen({
               At least {USER_MESSAGE_MIN} characters
             </Text>
           )}
-          {failed && (
+          {failedMessage !== null && (
             <Text style={{ fontSize: 11, color: theme.colors.statusDanger }}>
-              Couldn&apos;t send — try again
+              {failedMessage}
             </Text>
           )}
           <View style={{ marginLeft: 'auto' }}>

package/src/components/screens/HomeScreen.tsx

@@ -161,7 +161,9 @@ export function HomeScreen({
         </View>
 
         {/* Threads */}
-        {error ? (
+        {error && threads === null ? (
+          // Only take over the screen when there's nothing cached to show —
+          // a failed background poll shouldn't hide an already-loaded list.
           <ErrorState message={error} onRetry={onRetry} theme={theme} />
         ) : loading && threads === null ? (
           <View style={{ paddingHorizontal: 16, paddingTop: 24, gap: 14 }}>

package/src/components/screens/ThreadScreen.tsx

@@ -29,12 +29,12 @@ export function ThreadScreen({
   theme: SupportTheme;
   thread: Thread;
   onBack: () => void;
-  /** Resolves true on success. */
-  onSend: (message: string) => Promise<boolean>;
+  /** Resolves null on success, or a user-facing error message. */
+  onSend: (message: string) => Promise<string | null>;
 }) {
   const [draft, setDraft] = useState('');
   const [sending, setSending] = useState(false);
-  const [failed, setFailed] = useState(false);
+  const [failedMessage, setFailedMessage] = useState<string | null>(null);
   const scrollRef = useRef<ScrollView>(null);
 
   const resolved = thread.status === 'resolved';
@@ -49,11 +49,11 @@ export function ThreadScreen({
   async function handleSend() {
     if (!valid || sending || resolved) return;
     setSending(true);
-    setFailed(false);
-    const ok = await onSend(trimmed);
+    setFailedMessage(null);
+    const errorMessage = await onSend(trimmed);
     setSending(false);
-    if (ok) setDraft('');
-    else setFailed(true);
+    if (errorMessage === null) setDraft('');
+    else setFailedMessage(errorMessage);
   }
 
   return (
@@ -168,7 +168,7 @@ export function ThreadScreen({
               value={draft}
               onChangeText={(v) => {
                 setDraft(v);
-                setFailed(false);
+                setFailedMessage(null);
               }}
               multiline
               placeholder="Reply"
@@ -205,9 +205,9 @@ export function ThreadScreen({
               >
                 {draft.length}/{USER_MESSAGE_MAX}
               </Text>
-              {failed && (
+              {failedMessage !== null && (
                 <Text style={{ fontSize: 11, color: theme.colors.statusDanger }}>
-                  Couldn&apos;t send — try again
+                  {failedMessage}
                 </Text>
               )}
               <View style={{ marginLeft: 'auto' }}>

package/src/index.tsx

@@ -6,8 +6,10 @@ export {
   type SupportTheme,
 } from './theme';
 export { SupportApiError } from './api';
+export { isPushAvailable } from './push';
 export type {
   MessageSender,
+  PushPermissionStatus,
   QueryStatus,
   QueryType,
   SupportButtonProps,

package/src/push.ts

@@ -0,0 +1,97 @@
+// Optional push-notification support.
+//
+// expo-notifications is an OPTIONAL peer dependency: if the host app has it
+// installed we ask for permission and mint a token, otherwise every function
+// here degrades to "undetermined" and the support flow is unaffected. The
+// require is wrapped in try/catch so bundling succeeds either way.
+//
+// Nothing in the support experience is gated on the result — a user who
+// denies notifications keeps full use of threads, replies, and unread
+// badges. The status is reported purely so the dashboard can show whether
+// the user is reachable.
+
+import type { PushPermissionStatus } from './types';
+
+/** The slice of expo-notifications this SDK uses. */
+interface ExpoNotificationsModule {
+  getPermissionsAsync(): Promise<{ status: string; canAskAgain: boolean }>;
+  requestPermissionsAsync(): Promise<{ status: string; canAskAgain: boolean }>;
+  getExpoPushTokenAsync(options?: {
+    projectId?: string;
+  }): Promise<{ data: string }>;
+}
+
+function loadNotifications(): ExpoNotificationsModule | null {
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const mod = require('expo-notifications') as ExpoNotificationsModule;
+    return typeof mod?.getPermissionsAsync === 'function' ? mod : null;
+  } catch {
+    return null;
+  }
+}
+
+const notifications = loadNotifications();
+
+/** True when the host app has expo-notifications installed. */
+export const isPushAvailable = notifications !== null;
+
+export interface PushRegistration {
+  status: PushPermissionStatus;
+  /** Whether the OS prompt was actually presented during this call. */
+  asked: boolean;
+  token: string | null;
+}
+
+function normalizeStatus(status: string): PushPermissionStatus {
+  if (status === 'granted') return 'granted';
+  if (status === 'denied') return 'denied';
+  return 'undetermined';
+}
+
+/**
+ * Ensures notification permission has been requested, and returns the
+ * outcome plus an Expo push token when one is obtainable.
+ *
+ * Never throws: any failure resolves to an 'undetermined' registration so
+ * callers can report it and move on.
+ */
+export async function ensurePushPermission(
+  expoProjectId?: string,
+): Promise<PushRegistration> {
+  if (!notifications) {
+    return { status: 'undetermined', asked: false, token: null };
+  }
+
+  try {
+    const current = await notifications.getPermissionsAsync();
+    let status = normalizeStatus(current.status);
+    let asked = false;
+
+    // Only prompt when the OS will actually show something. Re-prompting a
+    // user who already decided is impossible on iOS and annoying on Android.
+    if (status === 'undetermined' && current.canAskAgain) {
+      const requested = await notifications.requestPermissionsAsync();
+      status = normalizeStatus(requested.status);
+      asked = true;
+    }
+
+    if (status !== 'granted') {
+      return { status, asked, token: null };
+    }
+
+    // Token minting needs a dev/production build with push credentials —
+    // it fails in Expo Go. A granted permission with no token is still
+    // useful information for the dashboard, so report it either way.
+    try {
+      const token = await notifications.getExpoPushTokenAsync(
+        expoProjectId ? { projectId: expoProjectId } : undefined,
+      );
+      return { status, asked, token: token.data };
+    } catch {
+      return { status, asked, token: null };
+    }
+  } catch {
+    return { status: 'undetermined', asked: false, token: null };
+  }
+}