@arcenpay/react 0.0.1

package/README.md

@@ -0,0 +1,124 @@
+# @arcenpay/react
+
+ArcenPay React SDK for published billing components, customer identification, entitlement-aware UI, metered usage, and hosted payment-link helpers.
+
+## Install
+
+```bash
+npm install @arcenpay/react
+```
+
+## Quick start
+
+Wrap your app:
+
+```tsx
+"use client";
+
+import { ArcenPayProvider } from "@arcenpay/react";
+
+export function Providers({ children }: { children: React.ReactNode }) {
+  return (
+    <ArcenPayProvider
+      publishableKey={process.env.NEXT_PUBLIC_ARCENPAY_PUBLISHABLE_KEY}
+      componentId={process.env.NEXT_PUBLIC_ARCENPAY_COMPONENT_ID}
+    >
+      {children}
+    </ArcenPayProvider>
+  );
+}
+```
+
+Identify the active customer:
+
+```tsx
+import { useEffect } from "react";
+import { useArcenPay } from "@arcenpay/react";
+
+export function BillingIdentity({ wallet }: { wallet: string }) {
+  const { identify } = useArcenPay();
+
+  useEffect(() => {
+    if (!wallet) return;
+    void identify({
+      company: { id: "company_123", wallet },
+      user: { id: "user_123", wallet },
+    });
+  }, [identify, wallet]);
+
+  return null;
+}
+```
+
+Render the billing surface:
+
+```tsx
+import { ArcenEmbed } from "@arcenpay/react";
+
+export function BillingPage() {
+  return <ArcenEmbed mode="modal" />;
+}
+```
+
+## Main exports
+
+- `ArcenPayProvider`
+- `useArcenPay`
+- `ArcenEmbed`
+- `FeatureFlagGuard`
+- `TemplateRenderer`
+- `useFlag`
+- `useFlags`
+- `useEntitlement`
+- `useConsumeEntitlement`
+- `useTrack`
+- `createPaymentLinkCheckoutUrl`
+
+## Common hook usage
+
+```tsx
+import {
+  useConsumeEntitlement,
+  useEntitlement,
+  useFlag,
+  useFlags,
+  useTrack,
+} from "@arcenpay/react";
+
+const scanEnabled = useFlag("scan");
+const flags = useFlags(["scan", "export-pdf"]);
+const entitlement = useEntitlement(walletAddress, "scan");
+const { consume } = useConsumeEntitlement();
+const { track } = useTrack();
+
+await consume("scan");
+await track("scan_started", { source: "dashboard" });
+```
+
+## Optional embed-token path
+
+If you mint a short-lived token on your backend, you can pass it directly to
+`ArcenEmbed`:
+
+```tsx
+<ArcenEmbed accessToken={token} componentId="cmp_123" />
+```
+
+## Environment variables
+
+```bash
+NEXT_PUBLIC_ARCENPAY_PUBLISHABLE_KEY=pk_xxxxxxxxx
+NEXT_PUBLIC_ARCENPAY_COMPONENT_ID=cmp_xxxxxxxxx
+NEXT_PUBLIC_CHAIN_ID=84532
+NEXT_PUBLIC_WALLETCONNECT_PROJECT_ID=xxxxxxxxx
+```
+
+`NEXT_PUBLIC_ARCENPAY_BASE_URL` is optional. The SDK defaults to
+`http://localhost:3000` outside production and `https://app.arcenpay.com` in
+production.
+
+## Boundary
+
+Use `@arcenpay/react` for browser-side billing experiences. Keep secure billing
+decisions, company APIs, activation, and webhook verification in
+`@arcenpay/node`.

package/dist/add-LG363GP4.mjs

@@ -0,0 +1,34 @@
+import {
+  b2 as b,
+  init_lit
+} from "./chunk-5MZNFSFK.mjs";
+import {
+  __esm
+} from "./chunk-X2BMVUAF.mjs";
+
+// ../../node_modules/@reown/appkit-ui/dist/esm/src/assets/svg/add.js
+var addSvg;
+var init_add = __esm({
+  "../../node_modules/@reown/appkit-ui/dist/esm/src/assets/svg/add.js"() {
+    init_lit();
+    addSvg = b`<svg
+  width="14"
+  height="14"
+  viewBox="0 0 14 14"
+  fill="none"
+  xmlns="http://www.w3.org/2000/svg"
+>
+  <path
+    fill="currentColor"
+    fill-rule="evenodd"
+    clip-rule="evenodd"
+    d="M7.0023 0.875C7.48571 0.875 7.8776 1.26675 7.8776 1.75V6.125H12.2541C12.7375 6.125 13.1294 6.51675 13.1294 7C13.1294 7.48325 12.7375 7.875 12.2541 7.875H7.8776V12.25C7.8776 12.7332 7.48571 13.125 7.0023 13.125C6.51889 13.125 6.12701 12.7332 6.12701 12.25V7.875H1.75054C1.26713 7.875 0.875244 7.48325 0.875244 7C0.875244 6.51675 1.26713 6.125 1.75054 6.125H6.12701V1.75C6.12701 1.26675 6.51889 0.875 7.0023 0.875Z"
+    fill="#667dff"
+  /></svg
+>`;
+  }
+});
+init_add();
+export {
+  addSvg
+};

package/dist/all-wallets-UW4KSWDQ.mjs

@@ -0,0 +1,25 @@
+import {
+  b2 as b,
+  init_lit
+} from "./chunk-5MZNFSFK.mjs";
+import {
+  __esm
+} from "./chunk-X2BMVUAF.mjs";
+
+// ../../node_modules/@reown/appkit-ui/dist/esm/src/assets/svg/all-wallets.js
+var allWalletsSvg;
+var init_all_wallets = __esm({
+  "../../node_modules/@reown/appkit-ui/dist/esm/src/assets/svg/all-wallets.js"() {
+    init_lit();
+    allWalletsSvg = b`<svg fill="none" viewBox="0 0 24 24">
+  <path
+    style="fill: var(--wui-color-accent-100);"
+    d="M10.2 6.6a3.6 3.6 0 1 1-7.2 0 3.6 3.6 0 0 1 7.2 0ZM21 6.6a3.6 3.6 0 1 1-7.2 0 3.6 3.6 0 0 1 7.2 0ZM10.2 17.4a3.6 3.6 0 1 1-7.2 0 3.6 3.6 0 0 1 7.2 0ZM21 17.4a3.6 3.6 0 1 1-7.2 0 3.6 3.6 0 0 1 7.2 0Z"
+  />
+</svg>`;
+  }
+});
+init_all_wallets();
+export {
+  allWalletsSvg
+};

package/dist/app-store-GOSERMQC.mjs

@@ -0,0 +1,36 @@
+import {
+  b2 as b,
+  init_lit
+} from "./chunk-5MZNFSFK.mjs";
+import {
+  __esm
+} from "./chunk-X2BMVUAF.mjs";
+
+// ../../node_modules/@reown/appkit-ui/dist/esm/src/assets/svg/app-store.js
+var appStoreSvg;
+var init_app_store = __esm({
+  "../../node_modules/@reown/appkit-ui/dist/esm/src/assets/svg/app-store.js"() {
+    init_lit();
+    appStoreSvg = b`
+<svg width="36" height="36">
+  <path
+    d="M28.724 0H7.271A7.269 7.269 0 0 0 0 7.272v21.46A7.268 7.268 0 0 0 7.271 36H28.73A7.272 7.272 0 0 0 36 28.728V7.272A7.275 7.275 0 0 0 28.724 0Z"
+    fill="url(#a)"
+  />
+  <path
+    d="m17.845 8.271.729-1.26a1.64 1.64 0 1 1 2.843 1.638l-7.023 12.159h5.08c1.646 0 2.569 1.935 1.853 3.276H6.434a1.632 1.632 0 0 1-1.638-1.638c0-.909.73-1.638 1.638-1.638h4.176l5.345-9.265-1.67-2.898a1.642 1.642 0 0 1 2.844-1.638l.716 1.264Zm-6.317 17.5-1.575 2.732a1.64 1.64 0 1 1-2.844-1.638l1.17-2.025c1.323-.41 2.398-.095 3.249.931Zm13.56-4.954h4.262c.909 0 1.638.729 1.638 1.638 0 .909-.73 1.638-1.638 1.638h-2.367l1.597 2.772c.45.788.185 1.782-.602 2.241a1.642 1.642 0 0 1-2.241-.603c-2.69-4.666-4.711-8.159-6.052-10.485-1.372-2.367-.391-4.743.576-5.549 1.075 1.846 2.682 4.631 4.828 8.348Z"
+    fill="#fff"
+  />
+  <defs>
+    <linearGradient id="a" x1="18" y1="0" x2="18" y2="36" gradientUnits="userSpaceOnUse">
+      <stop stop-color="#18BFFB" />
+      <stop offset="1" stop-color="#2072F3" />
+    </linearGradient>
+  </defs>
+</svg>`;
+  }
+});
+init_app_store();
+export {
+  appStoreSvg
+};

package/dist/apple-Y34SY63H.mjs

@@ -0,0 +1,37 @@
+import {
+  b2 as b,
+  init_lit
+} from "./chunk-5MZNFSFK.mjs";
+import {
+  __esm
+} from "./chunk-X2BMVUAF.mjs";
+
+// ../../node_modules/@reown/appkit-ui/dist/esm/src/assets/svg/apple.js
+var appleSvg;
+var init_apple = __esm({
+  "../../node_modules/@reown/appkit-ui/dist/esm/src/assets/svg/apple.js"() {
+    init_lit();
+    appleSvg = b`<svg fill="none" viewBox="0 0 40 40">
+  <g clip-path="url(#a)">
+    <g clip-path="url(#b)">
+      <circle cx="20" cy="19.89" r="20" fill="#000" />
+      <g clip-path="url(#c)">
+        <path
+          fill="#fff"
+          d="M28.77 23.3c-.69 1.99-2.75 5.52-4.87 5.56-1.4.03-1.86-.84-3.46-.84-1.61 0-2.12.81-3.45.86-2.25.1-5.72-5.1-5.72-9.62 0-4.15 2.9-6.2 5.42-6.25 1.36-.02 2.64.92 3.47.92.83 0 2.38-1.13 4.02-.97.68.03 2.6.28 3.84 2.08-3.27 2.14-2.76 6.61.75 8.25ZM24.2 7.88c-2.47.1-4.49 2.69-4.2 4.84 2.28.17 4.47-2.39 4.2-4.84Z"
+        />
+      </g>
+    </g>
+  </g>
+  <defs>
+    <clipPath id="a"><rect width="40" height="40" fill="#fff" rx="20" /></clipPath>
+    <clipPath id="b"><path fill="#fff" d="M0 0h40v40H0z" /></clipPath>
+    <clipPath id="c"><path fill="#fff" d="M8 7.89h24v24H8z" /></clipPath>
+  </defs>
+</svg>`;
+  }
+});
+init_apple();
+export {
+  appleSvg
+};

package/dist/arrow-bottom-YDRRJYRC.mjs

@@ -0,0 +1,27 @@
+import {
+  b2 as b,
+  init_lit
+} from "./chunk-5MZNFSFK.mjs";
+import {
+  __esm
+} from "./chunk-X2BMVUAF.mjs";
+
+// ../../node_modules/@reown/appkit-ui/dist/esm/src/assets/svg/arrow-bottom.js
+var arrowBottomSvg;
+var init_arrow_bottom = __esm({
+  "../../node_modules/@reown/appkit-ui/dist/esm/src/assets/svg/arrow-bottom.js"() {
+    init_lit();
+    arrowBottomSvg = b`<svg fill="none" viewBox="0 0 14 15">
+  <path
+    fill="currentColor"
+    fill-rule="evenodd"
+    d="M7 1.99a1 1 0 0 1 1 1v7.58l2.46-2.46a1 1 0 0 1 1.41 1.42L7.7 13.69a1 1 0 0 1-1.41 0L2.12 9.53A1 1 0 0 1 3.54 8.1L6 10.57V3a1 1 0 0 1 1-1Z"
+    clip-rule="evenodd"
+  />
+</svg>`;
+  }
+});
+init_arrow_bottom();
+export {
+  arrowBottomSvg
+};

package/dist/arrow-bottom-circle-XSCE7Y52.mjs

@@ -0,0 +1,30 @@
+import {
+  b2 as b,
+  init_lit
+} from "./chunk-5MZNFSFK.mjs";
+import {
+  __esm
+} from "./chunk-X2BMVUAF.mjs";
+
+// ../../node_modules/@reown/appkit-ui/dist/esm/src/assets/svg/arrow-bottom-circle.js
+var arrowBottomCircleSvg;
+var init_arrow_bottom_circle = __esm({
+  "../../node_modules/@reown/appkit-ui/dist/esm/src/assets/svg/arrow-bottom-circle.js"() {
+    init_lit();
+    arrowBottomCircleSvg = b`<svg
+  fill="none"
+  viewBox="0 0 21 20"
+>
+  <path
+    fill="currentColor"
+    fill-rule="evenodd"
+    d="M10.5 2.42908C6.31875 2.42908 2.92859 5.81989 2.92859 10.0034C2.92859 14.1869 6.31875 17.5777 10.5 17.5777C14.6813 17.5777 18.0714 14.1869 18.0714 10.0034C18.0714 5.81989 14.6813 2.42908 10.5 2.42908ZM0.928589 10.0034C0.928589 4.71596 5.21355 0.429077 10.5 0.429077C15.7865 0.429077 20.0714 4.71596 20.0714 10.0034C20.0714 15.2908 15.7865 19.5777 10.5 19.5777C5.21355 19.5777 0.928589 15.2908 0.928589 10.0034ZM10.5 5.75003C11.0523 5.75003 11.5 6.19774 11.5 6.75003L11.5 10.8343L12.7929 9.54137C13.1834 9.15085 13.8166 9.15085 14.2071 9.54137C14.5976 9.9319 14.5976 10.5651 14.2071 10.9556L11.2071 13.9556C10.8166 14.3461 10.1834 14.3461 9.79291 13.9556L6.79291 10.9556C6.40239 10.5651 6.40239 9.9319 6.79291 9.54137C7.18343 9.15085 7.8166 9.15085 8.20712 9.54137L9.50002 10.8343L9.50002 6.75003C9.50002 6.19774 9.94773 5.75003 10.5 5.75003Z"
+    clip-rule="evenodd"
+  /></svg
+>`;
+  }
+});
+init_arrow_bottom_circle();
+export {
+  arrowBottomCircleSvg
+};

package/dist/arrow-left-VMP4J3ME.mjs

@@ -0,0 +1,27 @@
+import {
+  b2 as b,
+  init_lit
+} from "./chunk-5MZNFSFK.mjs";
+import {
+  __esm
+} from "./chunk-X2BMVUAF.mjs";
+
+// ../../node_modules/@reown/appkit-ui/dist/esm/src/assets/svg/arrow-left.js
+var arrowLeftSvg;
+var init_arrow_left = __esm({
+  "../../node_modules/@reown/appkit-ui/dist/esm/src/assets/svg/arrow-left.js"() {
+    init_lit();
+    arrowLeftSvg = b`<svg fill="none" viewBox="0 0 14 15">
+  <path
+    fill="currentColor"
+    fill-rule="evenodd"
+    d="M13 7.99a1 1 0 0 1-1 1H4.4l2.46 2.46a1 1 0 1 1-1.41 1.41L1.29 8.7a1 1 0 0 1 0-1.41L5.46 3.1a1 1 0 0 1 1.41 1.42L4.41 6.99H12a1 1 0 0 1 1 1Z"
+    clip-rule="evenodd"
+  />
+</svg>`;
+  }
+});
+init_arrow_left();
+export {
+  arrowLeftSvg
+};

package/dist/arrow-right-FSU7ZETV.mjs

@@ -0,0 +1,27 @@
+import {
+  b2 as b,
+  init_lit
+} from "./chunk-5MZNFSFK.mjs";
+import {
+  __esm
+} from "./chunk-X2BMVUAF.mjs";
+
+// ../../node_modules/@reown/appkit-ui/dist/esm/src/assets/svg/arrow-right.js
+var arrowRightSvg;
+var init_arrow_right = __esm({
+  "../../node_modules/@reown/appkit-ui/dist/esm/src/assets/svg/arrow-right.js"() {
+    init_lit();
+    arrowRightSvg = b`<svg fill="none" viewBox="0 0 14 15">
+  <path
+    fill="currentColor"
+    fill-rule="evenodd"
+    d="M1 7.99a1 1 0 0 1 1-1h7.58L7.12 4.53A1 1 0 1 1 8.54 3.1l4.16 4.17a1 1 0 0 1 0 1.41l-4.16 4.17a1 1 0 1 1-1.42-1.41l2.46-2.46H2a1 1 0 0 1-1-1Z"
+    clip-rule="evenodd"
+  />
+</svg>`;
+  }
+});
+init_arrow_right();
+export {
+  arrowRightSvg
+};

package/dist/arrow-top-SQNMDYUF.mjs

@@ -0,0 +1,27 @@
+import {
+  b2 as b,
+  init_lit
+} from "./chunk-5MZNFSFK.mjs";
+import {
+  __esm
+} from "./chunk-X2BMVUAF.mjs";
+
+// ../../node_modules/@reown/appkit-ui/dist/esm/src/assets/svg/arrow-top.js
+var arrowTopSvg;
+var init_arrow_top = __esm({
+  "../../node_modules/@reown/appkit-ui/dist/esm/src/assets/svg/arrow-top.js"() {
+    init_lit();
+    arrowTopSvg = b`<svg fill="none" viewBox="0 0 14 15">
+  <path
+    fill="currentColor"
+    fill-rule="evenodd"
+    d="M7 13.99a1 1 0 0 1-1-1V5.4L3.54 7.86a1 1 0 0 1-1.42-1.41L6.3 2.28a1 1 0 0 1 1.41 0l4.17 4.17a1 1 0 1 1-1.41 1.41L8 5.4v7.59a1 1 0 0 1-1 1Z"
+    clip-rule="evenodd"
+  />
+</svg>`;
+  }
+});
+init_arrow_top();
+export {
+  arrowTopSvg
+};

package/dist/bank-DO6DNPBT.mjs

@@ -0,0 +1,33 @@
+import {
+  b2 as b,
+  init_lit
+} from "./chunk-5MZNFSFK.mjs";
+import {
+  __esm
+} from "./chunk-X2BMVUAF.mjs";
+
+// ../../node_modules/@reown/appkit-ui/dist/esm/src/assets/svg/bank.js
+var bankSvg;
+var init_bank = __esm({
+  "../../node_modules/@reown/appkit-ui/dist/esm/src/assets/svg/bank.js"() {
+    init_lit();
+    bankSvg = b`<svg
+  xmlns="http://www.w3.org/2000/svg"
+  width="12"
+  height="13"
+  viewBox="0 0 12 13"
+  fill="none"
+>
+  <path
+    fill-rule="evenodd"
+    clip-rule="evenodd"
+    d="M5.61391 1.57124C5.85142 1.42873 6.14813 1.42873 6.38564 1.57124L11.0793 4.38749C11.9179 4.89067 11.5612 6.17864 10.5832 6.17864H9.96398V10.0358H10.2854C10.6996 10.0358 11.0354 10.3716 11.0354 10.7858C11.0354 11.2 10.6996 11.5358 10.2854 11.5358H1.71416C1.29995 11.5358 0.964172 11.2 0.964172 10.7858C0.964172 10.3716 1.29995 10.0358 1.71416 10.0358H2.03558L2.03558 6.17864H1.41637C0.438389 6.17864 0.0816547 4.89066 0.920263 4.38749L5.61391 1.57124ZM3.53554 6.17864V10.0358H5.24979V6.17864H3.53554ZM6.74976 6.17864V10.0358H8.46401V6.17864H6.74976ZM8.64913 4.67864H3.35043L5.99978 3.089L8.64913 4.67864Z"
+    fill="currentColor"
+  /></svg
+>`;
+  }
+});
+init_bank();
+export {
+  bankSvg
+};