@allstak/react 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 AllStak
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,80 @@
+# @allstak-io/react
+
+AllStak React SDK — `<AllStakErrorBoundary>`, `useAllStak()` hook, and `withAllStakProfiler` HOC.
+
+## Install
+
+> **Auth required:** GitHub Packages requires a token with `read:packages` scope.
+
+### 1. Configure `.npmrc`
+
+```ini
+@allstak-io:registry=https://npm.pkg.github.com
+//npm.pkg.github.com/:_authToken=YOUR_GITHUB_PAT
+```
+
+### 2. Install
+
+```bash
+npm install @allstak-io/react@0.1.1 @allstak-io/browser@0.1.1
+# react >=16.8 is a peer dep — install separately if needed
+```
+
+## Usage
+
+```tsx
+import { AllStak } from '@allstak-io/browser';
+import { AllStakErrorBoundary, useAllStak } from '@allstak-io/react';
+
+// 1. Initialize once at app root
+AllStak.init({
+  apiKey: process.env.ALLSTAK_API_KEY!,
+  environment: 'production',
+  release: 'v1.0.0',
+});
+
+// 2. Wrap your component tree
+function App() {
+  return (
+    <AllStakErrorBoundary fallback={<p>Something went wrong.</p>}>
+      <MyApp />
+    </AllStakErrorBoundary>
+  );
+}
+
+// 3. Manual capture inside components
+function MyComponent() {
+  const allstak = useAllStak();
+
+  const handleClick = () => {
+    try {
+      riskyOperation();
+    } catch (err) {
+      allstak.captureException(err as Error);
+    }
+  };
+
+  return <button onClick={handleClick}>Do risky thing</button>;
+}
+```
+
+## API
+
+| Export | Description |
+|--------|-------------|
+| `AllStak` | Re-exported from `@allstak-io/browser` — use to init |
+| `AllStakErrorBoundary` | React error boundary; catches component-tree errors |
+| `AllStakErrorBoundaryProps` | Props type for the boundary |
+| `useAllStak()` | Hook returning `{ captureException, captureMessage, setUser, setTag }` |
+| `withAllStakProfiler(Component)` | HOC that wraps a component in the profiler |
+
+## GitHub Packages
+
+- **Package:** `@allstak-io/react`
+- **Registry:** `https://npm.pkg.github.com`
+- **Repo:** [github.com/allstak-io/allstak-react](https://github.com/allstak-io/allstak-react)
+- **Releases:** [github.com/allstak-io/allstak-react/releases](https://github.com/allstak-io/allstak-react/releases)
+
+## Versioning
+
+Tags must match `package.json` version exactly (e.g. `v0.1.1`). The release workflow fails if there's a mismatch.

package/dist/index.d.mts

@@ -0,0 +1 @@
+export { AllStak, AllStakErrorBoundary, AllStakErrorBoundaryProps, useAllStak, withAllStakProfiler } from 'allstak-js/react';

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { AllStak, AllStakErrorBoundary, AllStakErrorBoundaryProps, useAllStak, withAllStakProfiler } from 'allstak-js/react';

package/dist/index.js

@@ -0,0 +1,30 @@
+"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, {
+  AllStak: () => import_react.AllStak,
+  AllStakErrorBoundary: () => import_react.AllStakErrorBoundary,
+  useAllStak: () => import_react.useAllStak,
+  withAllStakProfiler: () => import_react.withAllStakProfiler
+});
+module.exports = __toCommonJS(index_exports);
+var import_react = require("allstak-js/react");
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @allstak/react — React-specific public API.\n *\n * Re-exports the React integration from allstak-js/react.\n * Components and hooks all rely on @allstak/browser being initialized first.\n */\nexport {\n  AllStakErrorBoundary,\n  type AllStakErrorBoundaryProps,\n  useAllStak,\n  withAllStakProfiler,\n  AllStak,\n} from 'allstak-js/react';\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,mBAMO;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,14 @@
+// src/index.ts
+import {
+  AllStakErrorBoundary,
+  useAllStak,
+  withAllStakProfiler,
+  AllStak
+} from "allstak-js/react";
+export {
+  AllStak,
+  AllStakErrorBoundary,
+  useAllStak,
+  withAllStakProfiler
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["/**\n * @allstak/react — React-specific public API.\n *\n * Re-exports the React integration from allstak-js/react.\n * Components and hooks all rely on @allstak/browser being initialized first.\n */\nexport {\n  AllStakErrorBoundary,\n  type AllStakErrorBoundaryProps,\n  useAllStak,\n  withAllStakProfiler,\n  AllStak,\n} from 'allstak-js/react';\n"],"mappings":";AAMA;AAAA,EACE;AAAA,EAEA;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@allstak/react",
+  "version": "0.1.1",
+  "description": "AllStak React SDK — <AllStakErrorBoundary>, useAllStak() hook, withAllStakProfiler HOC. Depends on @allstak-io/browser.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/allstak-io/allstak-react.git"
+  },
+  "homepage": "https://allstak.sa",
+  "bugs": {
+    "url": "https://github.com/allstak-io/allstak-react/issues"
+  },
+  "keywords": [
+    "allstak",
+    "observability",
+    "react",
+    "error-boundary"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsup src/index.ts --format esm,cjs --dts --clean --sourcemap --platform browser --external react --external react-dom",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0"
+  },
+  "dependencies": {
+    "@allstak/browser": "^0.1.1",
+    "@allstak/js": "^0.1.1"
+  },
+  "devDependencies": {
+    "@types/react": "^18.3.0",
+    "react": "^18.3.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  }
+}