@getnori/rewards 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/NOTICE

@@ -0,0 +1,6 @@
+Nori SDK
+Copyright 2026 The Nori authors
+
+This product is licensed under the Apache License, Version 2.0 (see LICENSE).
+"Nori" and the Nori logo are trademarks of their owner and are not licensed
+under the Apache License; see section 6 of the License.

package/README.md

@@ -1,3 +1,33 @@
-# Temporary Holding Version
+# @getnori/rewards
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Show viewers what they earn for watching: a points badge, a "+10 points"
+toast when a view is rewarded, and their earning history.
+
+```sh
+npm install @getnori/core @getnori/rewards
+```
+
+```tsx
+import { NoriFeed } from "@getnori/feed";
+import { PointsBadge, RewardToasts } from "@getnori/rewards";
+
+<View style={{ flex: 1 }}>
+  <NoriFeed client={nori} />
+  <PointsBadge client={nori} style={{ position: "absolute", top: 56, right: 16 }} />
+  <RewardToasts client={nori} />
+</View>
+```
+
+- **Rewards are decided on the server**, from the views `@getnori/feed`
+  reports and your reward rules (points per view, minimum watch, daily cap).
+  The SDK only displays the decisions.
+- **Points are paid in your loyalty currency.** Nori sends each reward to your
+  backend by signed webhook; your loyalty system holds the balance. The badge
+  shows what the viewer earned **through Nori** (`client.rewards()`), not
+  their loyalty balance.
+- `RewardToasts` also tells the viewer once per session when they reach the
+  daily cap (`showDailyCapNotice`).
+
+Hooks for your own UI: `useRewards(client)` returns `{ summary, loading, error, refresh }`
+(totals, today's progress, history) and updates the moment a view is rewarded;
+`useRewardDecisions(client, fn)` calls `fn` for every server decision.

package/dist/index.cjs

@@ -0,0 +1,203 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  PointsBadge: () => PointsBadge,
+  RewardToasts: () => RewardToasts,
+  useRewardDecisions: () => useRewardDecisions,
+  useRewards: () => useRewards
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/PointsBadge.tsx
+var import_react_native = require("react-native");
+
+// src/useRewards.ts
+var import_react = require("react");
+function useRewardDecisions(client, listener) {
+  const ref = (0, import_react.useRef)(listener);
+  ref.current = listener;
+  (0, import_react.useEffect)(
+    () => client.on("reward", (decisions) => {
+      for (const d of decisions) ref.current(d);
+    }),
+    [client]
+  );
+}
+function useRewards(client, { historyLimit = 20, refreshDelayMs = 1500 } = {}) {
+  const [summary, setSummary] = (0, import_react.useState)(null);
+  const [loading, setLoading] = (0, import_react.useState)(true);
+  const [error, setError] = (0, import_react.useState)(null);
+  const live = (0, import_react.useRef)(true);
+  const timer = (0, import_react.useRef)(null);
+  const refresh = (0, import_react.useCallback)(async () => {
+    try {
+      const next = await client.rewards({ limit: historyLimit });
+      if (!live.current) return;
+      setSummary(next);
+      setError(null);
+    } catch (e) {
+      if (live.current) setError(e);
+    } finally {
+      if (live.current) setLoading(false);
+    }
+  }, [client, historyLimit]);
+  (0, import_react.useEffect)(() => {
+    live.current = true;
+    void refresh();
+    return () => {
+      live.current = false;
+      if (timer.current) clearTimeout(timer.current);
+    };
+  }, [refresh]);
+  useRewardDecisions(client, (decision) => {
+    if (decision.status !== "rewarded") return;
+    setSummary(
+      (prev) => prev ? {
+        ...prev,
+        total_points: prev.total_points + decision.points,
+        today: {
+          ...prev.today,
+          points: prev.today.points + decision.points,
+          remaining: Math.max(0, prev.today.remaining - decision.points)
+        }
+      } : prev
+    );
+    if (timer.current) clearTimeout(timer.current);
+    timer.current = setTimeout(() => void refresh(), refreshDelayMs);
+  });
+  return { summary, loading, error, refresh };
+}
+
+// src/PointsBadge.tsx
+var import_jsx_runtime = require("react/jsx-runtime");
+function PointsBadge({
+  client,
+  show = "total",
+  onPress,
+  backgroundColor = "rgba(0,0,0,0.55)",
+  textColor = "#ffffff",
+  style
+}) {
+  const { summary } = useRewards(client);
+  if (!summary) return null;
+  const points = show === "today" ? summary.today.points : summary.total_points;
+  const label = `${points.toLocaleString()} ${summary.currency_name}${show === "today" ? " today" : ""}`;
+  const content = /* @__PURE__ */ (0, import_jsx_runtime.jsxs)(import_react_native.View, { style: [styles.badge, { backgroundColor }, style], testID: "nori-points-badge", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native.Text, { style: [styles.star, { color: textColor }], children: "\u2605" }),
+    /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native.Text, { style: [styles.text, { color: textColor }], children: label })
+  ] });
+  return onPress ? /* @__PURE__ */ (0, import_jsx_runtime.jsx)(import_react_native.Pressable, { onPress, accessibilityRole: "button", accessibilityLabel: label, children: content }) : content;
+}
+var styles = import_react_native.StyleSheet.create({
+  badge: { flexDirection: "row", alignItems: "center", alignSelf: "flex-start", borderRadius: 16, paddingHorizontal: 12, paddingVertical: 6 },
+  star: { fontSize: 13, marginRight: 6 },
+  text: { fontSize: 13, fontWeight: "700" }
+});
+
+// src/RewardToasts.tsx
+var import_react2 = require("react");
+var import_react_native2 = require("react-native");
+var import_jsx_runtime2 = require("react/jsx-runtime");
+function RewardToasts({
+  client,
+  format = (d) => `+${d.points} ${d.currency_name}`,
+  showDailyCapNotice = true,
+  durationMs = 2500,
+  backgroundColor = "rgba(17,17,17,0.9)",
+  textColor = "#ffffff",
+  style
+}) {
+  const [toast, setToast] = (0, import_react2.useState)(null);
+  const capShown = (0, import_react2.useRef)(false);
+  const counter = (0, import_react2.useRef)(0);
+  useRewardDecisions(client, (decision) => {
+    if (decision.status === "rewarded" && decision.points > 0) {
+      setToast({ key: ++counter.current, text: format(decision) });
+    } else if (decision.reason === "daily_cap" && showDailyCapNotice && !capShown.current) {
+      capShown.current = true;
+      setToast({ key: ++counter.current, text: `You've earned today's maximum ${decision.currency_name}. Come back tomorrow!` });
+    }
+  });
+  if (!toast) return null;
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+    ToastView,
+    {
+      text: toast.text,
+      durationMs,
+      backgroundColor,
+      textColor,
+      style,
+      onDone: () => setToast((t) => t?.key === toast.key ? null : t)
+    },
+    toast.key
+  );
+}
+function ToastView({
+  text,
+  durationMs,
+  backgroundColor,
+  textColor,
+  style,
+  onDone
+}) {
+  const opacity = (0, import_react2.useRef)(new import_react_native2.Animated.Value(0)).current;
+  const onDoneRef = (0, import_react2.useRef)(onDone);
+  onDoneRef.current = onDone;
+  (0, import_react2.useEffect)(() => {
+    import_react_native2.Animated.timing(opacity, { toValue: 1, duration: 180, useNativeDriver: true }).start();
+    const timer = setTimeout(() => {
+      import_react_native2.Animated.timing(opacity, { toValue: 0, duration: 220, useNativeDriver: true }).start(() => onDoneRef.current());
+    }, durationMs);
+    return () => clearTimeout(timer);
+  }, [durationMs, opacity]);
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(
+    import_react_native2.Animated.View,
+    {
+      pointerEvents: "none",
+      style: [styles2.toast, { backgroundColor, opacity }, style],
+      accessibilityLiveRegion: "polite",
+      accessibilityRole: "alert",
+      testID: "nori-reward-toast",
+      children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(import_react_native2.Text, { style: [styles2.text, { color: textColor }], children: text })
+    }
+  );
+}
+var styles2 = import_react_native2.StyleSheet.create({
+  toast: {
+    position: "absolute",
+    top: 56,
+    alignSelf: "center",
+    maxWidth: "86%",
+    borderRadius: 20,
+    paddingHorizontal: 16,
+    paddingVertical: 10
+  },
+  text: { fontSize: 15, fontWeight: "700", textAlign: "center" }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  PointsBadge,
+  RewardToasts,
+  useRewardDecisions,
+  useRewards
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/PointsBadge.tsx","../src/useRewards.ts","../src/RewardToasts.tsx"],"sourcesContent":["export { PointsBadge } from \"./PointsBadge\";\nexport type { PointsBadgeProps } from \"./PointsBadge\";\nexport { RewardToasts } from \"./RewardToasts\";\nexport type { RewardToastsProps } from \"./RewardToasts\";\nexport { useRewards, useRewardDecisions } from \"./useRewards\";\nexport type { RewardsState, UseRewardsOptions } from \"./useRewards\";\n","import React from \"react\";\nimport { Pressable, StyleSheet, Text, View, type StyleProp, type ViewStyle } from \"react-native\";\nimport type { NoriClient } from \"@getnori/core\";\nimport { useRewards } from \"./useRewards\";\n\nexport interface PointsBadgeProps {\n  client: NoriClient;\n  /** What to show: all-time Nori earnings or today's. Default \"total\". */\n  show?: \"total\" | \"today\";\n  onPress?: () => void;\n  backgroundColor?: string;\n  textColor?: string;\n  style?: StyleProp<ViewStyle>;\n}\n\n/** A small pill with the viewer's points, e.g. in the feed's corner. Hidden until loaded. */\nexport function PointsBadge({\n  client,\n  show = \"total\",\n  onPress,\n  backgroundColor = \"rgba(0,0,0,0.55)\",\n  textColor = \"#ffffff\",\n  style,\n}: PointsBadgeProps) {\n  const { summary } = useRewards(client);\n  if (!summary) return null;\n\n  const points = show === \"today\" ? summary.today.points : summary.total_points;\n  const label = `${points.toLocaleString()} ${summary.currency_name}${show === \"today\" ? \" today\" : \"\"}`;\n  const content = (\n    <View style={[styles.badge, { backgroundColor }, style]} testID=\"nori-points-badge\">\n      <Text style={[styles.star, { color: textColor }]}>★</Text>\n      <Text style={[styles.text, { color: textColor }]}>{label}</Text>\n    </View>\n  );\n  return onPress ? (\n    <Pressable onPress={onPress} accessibilityRole=\"button\" accessibilityLabel={label}>\n      {content}\n    </Pressable>\n  ) : (\n    content\n  );\n}\n\nconst styles = StyleSheet.create({\n  badge: { flexDirection: \"row\", alignItems: \"center\", alignSelf: \"flex-start\", borderRadius: 16, paddingHorizontal: 12, paddingVertical: 6 },\n  star: { fontSize: 13, marginRight: 6 },\n  text: { fontSize: 13, fontWeight: \"700\" },\n});\n","import { useCallback, useEffect, useRef, useState } from \"react\";\nimport type { NoriClient, NoriError, RewardDecision, RewardsSummary } from \"@getnori/core\";\n\nexport interface UseRewardsOptions {\n  /** History entries to load. Default 20. */\n  historyLimit?: number;\n  /** Re-read the summary this long after a reward, to pick up credited status. Default 1500 ms. */\n  refreshDelayMs?: number;\n}\n\nexport interface RewardsState {\n  summary: RewardsSummary | null;\n  loading: boolean;\n  error: NoriError | Error | null;\n  refresh: () => Promise<void>;\n}\n\n/** Calls `listener` with each reward the server grants this viewer. */\nexport function useRewardDecisions(client: Pick<NoriClient, \"on\">, listener: (decision: RewardDecision) => void): void {\n  const ref = useRef(listener);\n  ref.current = listener;\n  useEffect(\n    () =>\n      client.on(\"reward\", (decisions) => {\n        for (const d of decisions) ref.current(d);\n      }),\n    [client],\n  );\n}\n\n/**\n * The viewer's Nori earnings. Updates the moment a view is rewarded, then\n * re-reads the server for the authoritative numbers.\n */\nexport function useRewards(client: NoriClient, { historyLimit = 20, refreshDelayMs = 1500 }: UseRewardsOptions = {}): RewardsState {\n  const [summary, setSummary] = useState<RewardsSummary | null>(null);\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<NoriError | Error | null>(null);\n  const live = useRef(true);\n  const timer = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  const refresh = useCallback(async () => {\n    try {\n      const next = await client.rewards({ limit: historyLimit });\n      if (!live.current) return;\n      setSummary(next);\n      setError(null);\n    } catch (e) {\n      if (live.current) setError(e as Error);\n    } finally {\n      if (live.current) setLoading(false);\n    }\n  }, [client, historyLimit]);\n\n  useEffect(() => {\n    live.current = true;\n    void refresh();\n    return () => {\n      live.current = false;\n      if (timer.current) clearTimeout(timer.current);\n    };\n  }, [refresh]);\n\n  useRewardDecisions(client, (decision) => {\n    if (decision.status !== \"rewarded\") return;\n    setSummary((prev) =>\n      prev\n        ? {\n            ...prev,\n            total_points: prev.total_points + decision.points,\n            today: {\n              ...prev.today,\n              points: prev.today.points + decision.points,\n              remaining: Math.max(0, prev.today.remaining - decision.points),\n            },\n          }\n        : prev,\n    );\n    if (timer.current) clearTimeout(timer.current);\n    timer.current = setTimeout(() => void refresh(), refreshDelayMs);\n  });\n\n  return { summary, loading, error, refresh };\n}\n","import React, { useEffect, useRef, useState } from \"react\";\nimport { Animated, StyleSheet, Text, type StyleProp, type ViewStyle } from \"react-native\";\nimport type { NoriClient, RewardDecision } from \"@getnori/core\";\nimport { useRewardDecisions } from \"./useRewards\";\n\nexport interface RewardToastsProps {\n  client: NoriClient;\n  /** Text for a reward. Default \"+10 points\". */\n  format?: (decision: RewardDecision) => string;\n  /** Tell the viewer once per session when they hit the daily cap. Default true. */\n  showDailyCapNotice?: boolean;\n  /** How long each toast stays. Default 2500 ms. */\n  durationMs?: number;\n  backgroundColor?: string;\n  textColor?: string;\n  style?: StyleProp<ViewStyle>;\n}\n\ninterface Toast {\n  key: number;\n  text: string;\n}\n\n/**\n * Shows \"+10 points\" when the server rewards a view. Mount it once, above\n * the feed (it positions itself at the top of its parent).\n */\nexport function RewardToasts({\n  client,\n  format = (d) => `+${d.points} ${d.currency_name}`,\n  showDailyCapNotice = true,\n  durationMs = 2500,\n  backgroundColor = \"rgba(17,17,17,0.9)\",\n  textColor = \"#ffffff\",\n  style,\n}: RewardToastsProps) {\n  const [toast, setToast] = useState<Toast | null>(null);\n  const capShown = useRef(false);\n  const counter = useRef(0);\n\n  useRewardDecisions(client, (decision) => {\n    if (decision.status === \"rewarded\" && decision.points > 0) {\n      setToast({ key: ++counter.current, text: format(decision) });\n    } else if (decision.reason === \"daily_cap\" && showDailyCapNotice && !capShown.current) {\n      capShown.current = true;\n      setToast({ key: ++counter.current, text: `You've earned today's maximum ${decision.currency_name}. Come back tomorrow!` });\n    }\n  });\n\n  if (!toast) return null;\n  return (\n    <ToastView\n      key={toast.key}\n      text={toast.text}\n      durationMs={durationMs}\n      backgroundColor={backgroundColor}\n      textColor={textColor}\n      style={style}\n      onDone={() => setToast((t) => (t?.key === toast.key ? null : t))}\n    />\n  );\n}\n\nfunction ToastView({\n  text,\n  durationMs,\n  backgroundColor,\n  textColor,\n  style,\n  onDone,\n}: {\n  text: string;\n  durationMs: number;\n  backgroundColor: string;\n  textColor: string;\n  style?: StyleProp<ViewStyle>;\n  onDone: () => void;\n}) {\n  const opacity = useRef(new Animated.Value(0)).current;\n  const onDoneRef = useRef(onDone);\n  onDoneRef.current = onDone;\n\n  useEffect(() => {\n    Animated.timing(opacity, { toValue: 1, duration: 180, useNativeDriver: true }).start();\n    const timer = setTimeout(() => {\n      Animated.timing(opacity, { toValue: 0, duration: 220, useNativeDriver: true }).start(() => onDoneRef.current());\n    }, durationMs);\n    return () => clearTimeout(timer);\n  }, [durationMs, opacity]);\n\n  return (\n    <Animated.View\n      pointerEvents=\"none\"\n      style={[styles.toast, { backgroundColor, opacity }, style]}\n      accessibilityLiveRegion=\"polite\"\n      accessibilityRole=\"alert\"\n      testID=\"nori-reward-toast\"\n    >\n      <Text style={[styles.text, { color: textColor }]}>{text}</Text>\n    </Animated.View>\n  );\n}\n\nconst styles = StyleSheet.create({\n  toast: {\n    position: \"absolute\", top: 56, alignSelf: \"center\", maxWidth: \"86%\",\n    borderRadius: 20, paddingHorizontal: 16, paddingVertical: 10,\n  },\n  text: { fontSize: 15, fontWeight: \"700\", textAlign: \"center\" },\n});\n"],"mappings":"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","names":["import_react","import_react_native","import_jsx_runtime","styles"]}

package/dist/index.d.cts

@@ -0,0 +1,55 @@
+import React from 'react';
+import { StyleProp, ViewStyle } from 'react-native';
+import { NoriClient, RewardDecision, RewardsSummary, NoriError } from '@getnori/core';
+
+interface PointsBadgeProps {
+    client: NoriClient;
+    /** What to show: all-time Nori earnings or today's. Default "total". */
+    show?: "total" | "today";
+    onPress?: () => void;
+    backgroundColor?: string;
+    textColor?: string;
+    style?: StyleProp<ViewStyle>;
+}
+/** A small pill with the viewer's points, e.g. in the feed's corner. Hidden until loaded. */
+declare function PointsBadge({ client, show, onPress, backgroundColor, textColor, style, }: PointsBadgeProps): React.JSX.Element | null;
+
+interface RewardToastsProps {
+    client: NoriClient;
+    /** Text for a reward. Default "+10 points". */
+    format?: (decision: RewardDecision) => string;
+    /** Tell the viewer once per session when they hit the daily cap. Default true. */
+    showDailyCapNotice?: boolean;
+    /** How long each toast stays. Default 2500 ms. */
+    durationMs?: number;
+    backgroundColor?: string;
+    textColor?: string;
+    style?: StyleProp<ViewStyle>;
+}
+/**
+ * Shows "+10 points" when the server rewards a view. Mount it once, above
+ * the feed (it positions itself at the top of its parent).
+ */
+declare function RewardToasts({ client, format, showDailyCapNotice, durationMs, backgroundColor, textColor, style, }: RewardToastsProps): React.JSX.Element | null;
+
+interface UseRewardsOptions {
+    /** History entries to load. Default 20. */
+    historyLimit?: number;
+    /** Re-read the summary this long after a reward, to pick up credited status. Default 1500 ms. */
+    refreshDelayMs?: number;
+}
+interface RewardsState {
+    summary: RewardsSummary | null;
+    loading: boolean;
+    error: NoriError | Error | null;
+    refresh: () => Promise<void>;
+}
+/** Calls `listener` with each reward the server grants this viewer. */
+declare function useRewardDecisions(client: Pick<NoriClient, "on">, listener: (decision: RewardDecision) => void): void;
+/**
+ * The viewer's Nori earnings. Updates the moment a view is rewarded, then
+ * re-reads the server for the authoritative numbers.
+ */
+declare function useRewards(client: NoriClient, { historyLimit, refreshDelayMs }?: UseRewardsOptions): RewardsState;
+
+export { PointsBadge, type PointsBadgeProps, RewardToasts, type RewardToastsProps, type RewardsState, type UseRewardsOptions, useRewardDecisions, useRewards };

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+import React from 'react';
+import { StyleProp, ViewStyle } from 'react-native';
+import { NoriClient, RewardDecision, RewardsSummary, NoriError } from '@getnori/core';
+
+interface PointsBadgeProps {
+    client: NoriClient;
+    /** What to show: all-time Nori earnings or today's. Default "total". */
+    show?: "total" | "today";
+    onPress?: () => void;
+    backgroundColor?: string;
+    textColor?: string;
+    style?: StyleProp<ViewStyle>;
+}
+/** A small pill with the viewer's points, e.g. in the feed's corner. Hidden until loaded. */
+declare function PointsBadge({ client, show, onPress, backgroundColor, textColor, style, }: PointsBadgeProps): React.JSX.Element | null;
+
+interface RewardToastsProps {
+    client: NoriClient;
+    /** Text for a reward. Default "+10 points". */
+    format?: (decision: RewardDecision) => string;
+    /** Tell the viewer once per session when they hit the daily cap. Default true. */
+    showDailyCapNotice?: boolean;
+    /** How long each toast stays. Default 2500 ms. */
+    durationMs?: number;
+    backgroundColor?: string;
+    textColor?: string;
+    style?: StyleProp<ViewStyle>;
+}
+/**
+ * Shows "+10 points" when the server rewards a view. Mount it once, above
+ * the feed (it positions itself at the top of its parent).
+ */
+declare function RewardToasts({ client, format, showDailyCapNotice, durationMs, backgroundColor, textColor, style, }: RewardToastsProps): React.JSX.Element | null;
+
+interface UseRewardsOptions {
+    /** History entries to load. Default 20. */
+    historyLimit?: number;
+    /** Re-read the summary this long after a reward, to pick up credited status. Default 1500 ms. */
+    refreshDelayMs?: number;
+}
+interface RewardsState {
+    summary: RewardsSummary | null;
+    loading: boolean;
+    error: NoriError | Error | null;
+    refresh: () => Promise<void>;
+}
+/** Calls `listener` with each reward the server grants this viewer. */
+declare function useRewardDecisions(client: Pick<NoriClient, "on">, listener: (decision: RewardDecision) => void): void;
+/**
+ * The viewer's Nori earnings. Updates the moment a view is rewarded, then
+ * re-reads the server for the authoritative numbers.
+ */
+declare function useRewards(client: NoriClient, { historyLimit, refreshDelayMs }?: UseRewardsOptions): RewardsState;
+
+export { PointsBadge, type PointsBadgeProps, RewardToasts, type RewardToastsProps, type RewardsState, type UseRewardsOptions, useRewardDecisions, useRewards };

package/dist/index.js

@@ -0,0 +1,173 @@
+// src/PointsBadge.tsx
+import { Pressable, StyleSheet, Text, View } from "react-native";
+
+// src/useRewards.ts
+import { useCallback, useEffect, useRef, useState } from "react";
+function useRewardDecisions(client, listener) {
+  const ref = useRef(listener);
+  ref.current = listener;
+  useEffect(
+    () => client.on("reward", (decisions) => {
+      for (const d of decisions) ref.current(d);
+    }),
+    [client]
+  );
+}
+function useRewards(client, { historyLimit = 20, refreshDelayMs = 1500 } = {}) {
+  const [summary, setSummary] = useState(null);
+  const [loading, setLoading] = useState(true);
+  const [error, setError] = useState(null);
+  const live = useRef(true);
+  const timer = useRef(null);
+  const refresh = useCallback(async () => {
+    try {
+      const next = await client.rewards({ limit: historyLimit });
+      if (!live.current) return;
+      setSummary(next);
+      setError(null);
+    } catch (e) {
+      if (live.current) setError(e);
+    } finally {
+      if (live.current) setLoading(false);
+    }
+  }, [client, historyLimit]);
+  useEffect(() => {
+    live.current = true;
+    void refresh();
+    return () => {
+      live.current = false;
+      if (timer.current) clearTimeout(timer.current);
+    };
+  }, [refresh]);
+  useRewardDecisions(client, (decision) => {
+    if (decision.status !== "rewarded") return;
+    setSummary(
+      (prev) => prev ? {
+        ...prev,
+        total_points: prev.total_points + decision.points,
+        today: {
+          ...prev.today,
+          points: prev.today.points + decision.points,
+          remaining: Math.max(0, prev.today.remaining - decision.points)
+        }
+      } : prev
+    );
+    if (timer.current) clearTimeout(timer.current);
+    timer.current = setTimeout(() => void refresh(), refreshDelayMs);
+  });
+  return { summary, loading, error, refresh };
+}
+
+// src/PointsBadge.tsx
+import { jsx, jsxs } from "react/jsx-runtime";
+function PointsBadge({
+  client,
+  show = "total",
+  onPress,
+  backgroundColor = "rgba(0,0,0,0.55)",
+  textColor = "#ffffff",
+  style
+}) {
+  const { summary } = useRewards(client);
+  if (!summary) return null;
+  const points = show === "today" ? summary.today.points : summary.total_points;
+  const label = `${points.toLocaleString()} ${summary.currency_name}${show === "today" ? " today" : ""}`;
+  const content = /* @__PURE__ */ jsxs(View, { style: [styles.badge, { backgroundColor }, style], testID: "nori-points-badge", children: [
+    /* @__PURE__ */ jsx(Text, { style: [styles.star, { color: textColor }], children: "\u2605" }),
+    /* @__PURE__ */ jsx(Text, { style: [styles.text, { color: textColor }], children: label })
+  ] });
+  return onPress ? /* @__PURE__ */ jsx(Pressable, { onPress, accessibilityRole: "button", accessibilityLabel: label, children: content }) : content;
+}
+var styles = StyleSheet.create({
+  badge: { flexDirection: "row", alignItems: "center", alignSelf: "flex-start", borderRadius: 16, paddingHorizontal: 12, paddingVertical: 6 },
+  star: { fontSize: 13, marginRight: 6 },
+  text: { fontSize: 13, fontWeight: "700" }
+});
+
+// src/RewardToasts.tsx
+import { useEffect as useEffect2, useRef as useRef2, useState as useState2 } from "react";
+import { Animated, StyleSheet as StyleSheet2, Text as Text2 } from "react-native";
+import { jsx as jsx2 } from "react/jsx-runtime";
+function RewardToasts({
+  client,
+  format = (d) => `+${d.points} ${d.currency_name}`,
+  showDailyCapNotice = true,
+  durationMs = 2500,
+  backgroundColor = "rgba(17,17,17,0.9)",
+  textColor = "#ffffff",
+  style
+}) {
+  const [toast, setToast] = useState2(null);
+  const capShown = useRef2(false);
+  const counter = useRef2(0);
+  useRewardDecisions(client, (decision) => {
+    if (decision.status === "rewarded" && decision.points > 0) {
+      setToast({ key: ++counter.current, text: format(decision) });
+    } else if (decision.reason === "daily_cap" && showDailyCapNotice && !capShown.current) {
+      capShown.current = true;
+      setToast({ key: ++counter.current, text: `You've earned today's maximum ${decision.currency_name}. Come back tomorrow!` });
+    }
+  });
+  if (!toast) return null;
+  return /* @__PURE__ */ jsx2(
+    ToastView,
+    {
+      text: toast.text,
+      durationMs,
+      backgroundColor,
+      textColor,
+      style,
+      onDone: () => setToast((t) => t?.key === toast.key ? null : t)
+    },
+    toast.key
+  );
+}
+function ToastView({
+  text,
+  durationMs,
+  backgroundColor,
+  textColor,
+  style,
+  onDone
+}) {
+  const opacity = useRef2(new Animated.Value(0)).current;
+  const onDoneRef = useRef2(onDone);
+  onDoneRef.current = onDone;
+  useEffect2(() => {
+    Animated.timing(opacity, { toValue: 1, duration: 180, useNativeDriver: true }).start();
+    const timer = setTimeout(() => {
+      Animated.timing(opacity, { toValue: 0, duration: 220, useNativeDriver: true }).start(() => onDoneRef.current());
+    }, durationMs);
+    return () => clearTimeout(timer);
+  }, [durationMs, opacity]);
+  return /* @__PURE__ */ jsx2(
+    Animated.View,
+    {
+      pointerEvents: "none",
+      style: [styles2.toast, { backgroundColor, opacity }, style],
+      accessibilityLiveRegion: "polite",
+      accessibilityRole: "alert",
+      testID: "nori-reward-toast",
+      children: /* @__PURE__ */ jsx2(Text2, { style: [styles2.text, { color: textColor }], children: text })
+    }
+  );
+}
+var styles2 = StyleSheet2.create({
+  toast: {
+    position: "absolute",
+    top: 56,
+    alignSelf: "center",
+    maxWidth: "86%",
+    borderRadius: 20,
+    paddingHorizontal: 16,
+    paddingVertical: 10
+  },
+  text: { fontSize: 15, fontWeight: "700", textAlign: "center" }
+});
+export {
+  PointsBadge,
+  RewardToasts,
+  useRewardDecisions,
+  useRewards
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/PointsBadge.tsx","../src/useRewards.ts","../src/RewardToasts.tsx"],"sourcesContent":["import React from \"react\";\nimport { Pressable, StyleSheet, Text, View, type StyleProp, type ViewStyle } from \"react-native\";\nimport type { NoriClient } from \"@getnori/core\";\nimport { useRewards } from \"./useRewards\";\n\nexport interface PointsBadgeProps {\n  client: NoriClient;\n  /** What to show: all-time Nori earnings or today's. Default \"total\". */\n  show?: \"total\" | \"today\";\n  onPress?: () => void;\n  backgroundColor?: string;\n  textColor?: string;\n  style?: StyleProp<ViewStyle>;\n}\n\n/** A small pill with the viewer's points, e.g. in the feed's corner. Hidden until loaded. */\nexport function PointsBadge({\n  client,\n  show = \"total\",\n  onPress,\n  backgroundColor = \"rgba(0,0,0,0.55)\",\n  textColor = \"#ffffff\",\n  style,\n}: PointsBadgeProps) {\n  const { summary } = useRewards(client);\n  if (!summary) return null;\n\n  const points = show === \"today\" ? summary.today.points : summary.total_points;\n  const label = `${points.toLocaleString()} ${summary.currency_name}${show === \"today\" ? \" today\" : \"\"}`;\n  const content = (\n    <View style={[styles.badge, { backgroundColor }, style]} testID=\"nori-points-badge\">\n      <Text style={[styles.star, { color: textColor }]}>★</Text>\n      <Text style={[styles.text, { color: textColor }]}>{label}</Text>\n    </View>\n  );\n  return onPress ? (\n    <Pressable onPress={onPress} accessibilityRole=\"button\" accessibilityLabel={label}>\n      {content}\n    </Pressable>\n  ) : (\n    content\n  );\n}\n\nconst styles = StyleSheet.create({\n  badge: { flexDirection: \"row\", alignItems: \"center\", alignSelf: \"flex-start\", borderRadius: 16, paddingHorizontal: 12, paddingVertical: 6 },\n  star: { fontSize: 13, marginRight: 6 },\n  text: { fontSize: 13, fontWeight: \"700\" },\n});\n","import { useCallback, useEffect, useRef, useState } from \"react\";\nimport type { NoriClient, NoriError, RewardDecision, RewardsSummary } from \"@getnori/core\";\n\nexport interface UseRewardsOptions {\n  /** History entries to load. Default 20. */\n  historyLimit?: number;\n  /** Re-read the summary this long after a reward, to pick up credited status. Default 1500 ms. */\n  refreshDelayMs?: number;\n}\n\nexport interface RewardsState {\n  summary: RewardsSummary | null;\n  loading: boolean;\n  error: NoriError | Error | null;\n  refresh: () => Promise<void>;\n}\n\n/** Calls `listener` with each reward the server grants this viewer. */\nexport function useRewardDecisions(client: Pick<NoriClient, \"on\">, listener: (decision: RewardDecision) => void): void {\n  const ref = useRef(listener);\n  ref.current = listener;\n  useEffect(\n    () =>\n      client.on(\"reward\", (decisions) => {\n        for (const d of decisions) ref.current(d);\n      }),\n    [client],\n  );\n}\n\n/**\n * The viewer's Nori earnings. Updates the moment a view is rewarded, then\n * re-reads the server for the authoritative numbers.\n */\nexport function useRewards(client: NoriClient, { historyLimit = 20, refreshDelayMs = 1500 }: UseRewardsOptions = {}): RewardsState {\n  const [summary, setSummary] = useState<RewardsSummary | null>(null);\n  const [loading, setLoading] = useState(true);\n  const [error, setError] = useState<NoriError | Error | null>(null);\n  const live = useRef(true);\n  const timer = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  const refresh = useCallback(async () => {\n    try {\n      const next = await client.rewards({ limit: historyLimit });\n      if (!live.current) return;\n      setSummary(next);\n      setError(null);\n    } catch (e) {\n      if (live.current) setError(e as Error);\n    } finally {\n      if (live.current) setLoading(false);\n    }\n  }, [client, historyLimit]);\n\n  useEffect(() => {\n    live.current = true;\n    void refresh();\n    return () => {\n      live.current = false;\n      if (timer.current) clearTimeout(timer.current);\n    };\n  }, [refresh]);\n\n  useRewardDecisions(client, (decision) => {\n    if (decision.status !== \"rewarded\") return;\n    setSummary((prev) =>\n      prev\n        ? {\n            ...prev,\n            total_points: prev.total_points + decision.points,\n            today: {\n              ...prev.today,\n              points: prev.today.points + decision.points,\n              remaining: Math.max(0, prev.today.remaining - decision.points),\n            },\n          }\n        : prev,\n    );\n    if (timer.current) clearTimeout(timer.current);\n    timer.current = setTimeout(() => void refresh(), refreshDelayMs);\n  });\n\n  return { summary, loading, error, refresh };\n}\n","import React, { useEffect, useRef, useState } from \"react\";\nimport { Animated, StyleSheet, Text, type StyleProp, type ViewStyle } from \"react-native\";\nimport type { NoriClient, RewardDecision } from \"@getnori/core\";\nimport { useRewardDecisions } from \"./useRewards\";\n\nexport interface RewardToastsProps {\n  client: NoriClient;\n  /** Text for a reward. Default \"+10 points\". */\n  format?: (decision: RewardDecision) => string;\n  /** Tell the viewer once per session when they hit the daily cap. Default true. */\n  showDailyCapNotice?: boolean;\n  /** How long each toast stays. Default 2500 ms. */\n  durationMs?: number;\n  backgroundColor?: string;\n  textColor?: string;\n  style?: StyleProp<ViewStyle>;\n}\n\ninterface Toast {\n  key: number;\n  text: string;\n}\n\n/**\n * Shows \"+10 points\" when the server rewards a view. Mount it once, above\n * the feed (it positions itself at the top of its parent).\n */\nexport function RewardToasts({\n  client,\n  format = (d) => `+${d.points} ${d.currency_name}`,\n  showDailyCapNotice = true,\n  durationMs = 2500,\n  backgroundColor = \"rgba(17,17,17,0.9)\",\n  textColor = \"#ffffff\",\n  style,\n}: RewardToastsProps) {\n  const [toast, setToast] = useState<Toast | null>(null);\n  const capShown = useRef(false);\n  const counter = useRef(0);\n\n  useRewardDecisions(client, (decision) => {\n    if (decision.status === \"rewarded\" && decision.points > 0) {\n      setToast({ key: ++counter.current, text: format(decision) });\n    } else if (decision.reason === \"daily_cap\" && showDailyCapNotice && !capShown.current) {\n      capShown.current = true;\n      setToast({ key: ++counter.current, text: `You've earned today's maximum ${decision.currency_name}. Come back tomorrow!` });\n    }\n  });\n\n  if (!toast) return null;\n  return (\n    <ToastView\n      key={toast.key}\n      text={toast.text}\n      durationMs={durationMs}\n      backgroundColor={backgroundColor}\n      textColor={textColor}\n      style={style}\n      onDone={() => setToast((t) => (t?.key === toast.key ? null : t))}\n    />\n  );\n}\n\nfunction ToastView({\n  text,\n  durationMs,\n  backgroundColor,\n  textColor,\n  style,\n  onDone,\n}: {\n  text: string;\n  durationMs: number;\n  backgroundColor: string;\n  textColor: string;\n  style?: StyleProp<ViewStyle>;\n  onDone: () => void;\n}) {\n  const opacity = useRef(new Animated.Value(0)).current;\n  const onDoneRef = useRef(onDone);\n  onDoneRef.current = onDone;\n\n  useEffect(() => {\n    Animated.timing(opacity, { toValue: 1, duration: 180, useNativeDriver: true }).start();\n    const timer = setTimeout(() => {\n      Animated.timing(opacity, { toValue: 0, duration: 220, useNativeDriver: true }).start(() => onDoneRef.current());\n    }, durationMs);\n    return () => clearTimeout(timer);\n  }, [durationMs, opacity]);\n\n  return (\n    <Animated.View\n      pointerEvents=\"none\"\n      style={[styles.toast, { backgroundColor, opacity }, style]}\n      accessibilityLiveRegion=\"polite\"\n      accessibilityRole=\"alert\"\n      testID=\"nori-reward-toast\"\n    >\n      <Text style={[styles.text, { color: textColor }]}>{text}</Text>\n    </Animated.View>\n  );\n}\n\nconst styles = StyleSheet.create({\n  toast: {\n    position: \"absolute\", top: 56, alignSelf: \"center\", maxWidth: \"86%\",\n    borderRadius: 20, paddingHorizontal: 16, paddingVertical: 10,\n  },\n  text: { fontSize: 15, fontWeight: \"700\", textAlign: \"center\" },\n});\n"],"mappings":"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","names":["useEffect","useRef","useState","StyleSheet","Text","jsx","useState","useRef","useEffect","styles","Text","StyleSheet"]}

package/package.json

@@ -1,6 +1,50 @@
 {
   "name": "@getnori/rewards",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Nori Rewards SDK: points badges, reward toasts and earning history for Nori viewers.",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ad-yuta/nori-sdk.git",
+    "directory": "packages/rewards"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "react-native": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "react-native": "./dist/index.js",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "NOTICE"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@getnori/core": "^0.1.0"
+  },
+  "devDependencies": {
+    "react": "19.2.3",
+    "react-native": "0.86.3"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-native": ">=0.74"
+  },
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run"
+  }
 }