@numbunch/react 0.0.0-stage → 0.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/dist/compat.d.ts +12 -0
- package/dist/compat.d.ts.map +1 -0
- package/dist/compat.js +40 -0
- package/dist/compat.js.map +1 -0
- package/dist/index.d.ts +56 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +87 -0
- package/dist/index.js.map +1 -0
- package/dist/server.d.ts +25 -0
- package/dist/server.d.ts.map +1 -0
- package/dist/server.js +23 -0
- package/dist/server.js.map +1 -0
- package/package.json +60 -3
- package/README.md +0 -3
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Numbunch contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/dist/compat.d.ts
ADDED
|
@@ -0,0 +1,12 @@
|
|
|
1
|
+
import { type PostHog } from '@numbunch/browser/compat';
|
|
2
|
+
import type { FlagValue } from '@numbunch/browser';
|
|
3
|
+
import { type ReactNode } from 'react';
|
|
4
|
+
export declare function PostHogProvider({ client, children }: {
|
|
5
|
+
client?: PostHog;
|
|
6
|
+
children?: ReactNode;
|
|
7
|
+
}): import("react").JSX.Element;
|
|
8
|
+
export declare function usePostHog(): PostHog;
|
|
9
|
+
export declare function useFeatureFlagEnabled(key: string): boolean | undefined;
|
|
10
|
+
export declare function useFeatureFlagVariantKey(key: string): FlagValue | undefined;
|
|
11
|
+
export declare function useFeatureFlagPayload(key: string): unknown;
|
|
12
|
+
//# sourceMappingURL=compat.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"compat.d.ts","sourceRoot":"","sources":["../src/compat.tsx"],"names":[],"mappings":"AAIA,OAAO,EAA8B,KAAK,OAAO,EAAE,MAAM,0BAA0B,CAAA;AACnF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAClD,OAAO,EAAkD,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAItF,wBAAgB,eAAe,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE;IAAE,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,+BAE/F;AAED,wBAAgB,UAAU,IAAI,OAAO,CAEpC;AAeD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAGtE;AAED,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAE3E;AAED,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAI1D"}
|
package/dist/compat.js
ADDED
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
'use client';
|
|
2
|
+
import { jsx as _jsx } from "react/jsx-runtime";
|
|
3
|
+
// posthog-js/react compatible hooks over @numbunch/browser/compat, so `import { usePostHog } from 'posthog-js/react'`
|
|
4
|
+
// becomes `import { usePostHog } from '@numbunch/react/compat'`.
|
|
5
|
+
import { posthog as defaultInstance } from '@numbunch/browser/compat';
|
|
6
|
+
import { createContext, useContext, useEffect, useState } from 'react';
|
|
7
|
+
const PostHogContext = createContext(defaultInstance);
|
|
8
|
+
export function PostHogProvider({ client, children }) {
|
|
9
|
+
return _jsx(PostHogContext.Provider, { value: client ?? defaultInstance, children: children });
|
|
10
|
+
}
|
|
11
|
+
export function usePostHog() {
|
|
12
|
+
return useContext(PostHogContext);
|
|
13
|
+
}
|
|
14
|
+
function useFlagValue(key) {
|
|
15
|
+
const posthog = usePostHog();
|
|
16
|
+
const [value, setValue] = useState(() => (posthog.__loaded ? posthog.getFeatureFlag(key, { send_event: false }) : undefined));
|
|
17
|
+
useEffect(() => {
|
|
18
|
+
if (!posthog.__loaded)
|
|
19
|
+
return;
|
|
20
|
+
return posthog.onFeatureFlags(() => setValue(posthog.getFeatureFlag(key, { send_event: false })));
|
|
21
|
+
}, [posthog, key]);
|
|
22
|
+
useEffect(() => {
|
|
23
|
+
if (value !== undefined)
|
|
24
|
+
posthog.getFeatureFlag(key);
|
|
25
|
+
}, [posthog, key, value]);
|
|
26
|
+
return value;
|
|
27
|
+
}
|
|
28
|
+
export function useFeatureFlagEnabled(key) {
|
|
29
|
+
const value = useFlagValue(key);
|
|
30
|
+
return value === undefined ? undefined : value !== false;
|
|
31
|
+
}
|
|
32
|
+
export function useFeatureFlagVariantKey(key) {
|
|
33
|
+
return useFlagValue(key);
|
|
34
|
+
}
|
|
35
|
+
export function useFeatureFlagPayload(key) {
|
|
36
|
+
const posthog = usePostHog();
|
|
37
|
+
useFlagValue(key);
|
|
38
|
+
return posthog.getFeatureFlagPayload(key);
|
|
39
|
+
}
|
|
40
|
+
//# sourceMappingURL=compat.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"compat.js","sourceRoot":"","sources":["../src/compat.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAA;;AACZ,sHAAsH;AACtH,iEAAiE;AAEjE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAgB,MAAM,0BAA0B,CAAA;AAEnF,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAkB,MAAM,OAAO,CAAA;AAEtF,MAAM,cAAc,GAAG,aAAa,CAAU,eAAe,CAAC,CAAA;AAE9D,MAAM,UAAU,eAAe,CAAC,EAAE,MAAM,EAAE,QAAQ,EAA8C;IAC9F,OAAO,KAAC,cAAc,CAAC,QAAQ,IAAC,KAAK,EAAE,MAAM,IAAI,eAAe,YAAG,QAAQ,GAA2B,CAAA;AACxG,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,OAAO,UAAU,CAAC,cAAc,CAAC,CAAA;AACnC,CAAC;AAED,SAAS,YAAY,CAAC,GAAW;IAC/B,MAAM,OAAO,GAAG,UAAU,EAAE,CAAA;IAC5B,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAA;IAC7H,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,CAAC,QAAQ;YAAE,OAAM;QAC7B,OAAO,OAAO,CAAC,cAAc,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,GAAG,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAA;IACnG,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAA;IAClB,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,cAAc,CAAC,GAAG,CAAC,CAAA;IACtD,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAA;IACzB,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAA;IAC/B,OAAO,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,KAAK,KAAK,CAAA;AAC1D,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,GAAW;IAClD,OAAO,YAAY,CAAC,GAAG,CAAC,CAAA;AAC1B,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAW;IAC/C,MAAM,OAAO,GAAG,UAAU,EAAE,CAAA;IAC5B,YAAY,CAAC,GAAG,CAAC,CAAA;IACjB,OAAO,OAAO,CAAC,qBAAqB,CAAC,GAAG,CAAC,CAAA;AAC3C,CAAC"}
|
package/dist/index.d.ts
ADDED
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
import { Numbunch, type Bootstrap, type FlagValue, type NumbunchOptions, type Properties } from '@numbunch/browser';
|
|
2
|
+
import { Component, type ErrorInfo, type ReactNode } from 'react';
|
|
3
|
+
export interface NumbunchProviderProps {
|
|
4
|
+
/** An existing client; otherwise one is created from `token` and `options`. */
|
|
5
|
+
client?: Numbunch;
|
|
6
|
+
token?: string;
|
|
7
|
+
options?: NumbunchOptions;
|
|
8
|
+
/** Server-rendered flag values (for example from `@numbunch/node` `getBootstrap`), read before any request. */
|
|
9
|
+
bootstrap?: Bootstrap;
|
|
10
|
+
children?: ReactNode;
|
|
11
|
+
}
|
|
12
|
+
/** Provides one Numbunch client to the tree. The client is created once, on the first render. */
|
|
13
|
+
export declare function NumbunchProvider({ client, token, options, bootstrap, children }: NumbunchProviderProps): import("react").JSX.Element;
|
|
14
|
+
/** The client from the nearest {@link NumbunchProvider}. */
|
|
15
|
+
export declare function useNumbunch(): Numbunch;
|
|
16
|
+
/**
|
|
17
|
+
* The flag's value (variant key or boolean), `undefined` while unknown. Read synchronously on the first render, so
|
|
18
|
+
* a bootstrapped or locally evaluated flag never flickers. Records one exposure once the value is known.
|
|
19
|
+
*/
|
|
20
|
+
export declare function useVariant(key: string, options?: {
|
|
21
|
+
sendEvent?: boolean;
|
|
22
|
+
}): FlagValue | undefined;
|
|
23
|
+
/** Whether the flag is on (any variant counts). False while unknown. */
|
|
24
|
+
export declare function useFlag(key: string, options?: {
|
|
25
|
+
sendEvent?: boolean;
|
|
26
|
+
}): boolean;
|
|
27
|
+
/** The flag's payload, if it has one. */
|
|
28
|
+
export declare function useFlagPayload(key: string): unknown;
|
|
29
|
+
/** A stable `capture(event, properties)` function. */
|
|
30
|
+
export declare function useCapture(): (event: string, properties?: Properties) => void;
|
|
31
|
+
export interface NumbunchErrorBoundaryProps {
|
|
32
|
+
fallback?: ReactNode | ((error: unknown) => ReactNode);
|
|
33
|
+
/** Extra properties on the `$exception` event. */
|
|
34
|
+
properties?: Properties;
|
|
35
|
+
children?: ReactNode;
|
|
36
|
+
}
|
|
37
|
+
/** Reports render errors to error tracking (`$exception`) and shows `fallback`. */
|
|
38
|
+
export declare class NumbunchErrorBoundary extends Component<NumbunchErrorBoundaryProps, {
|
|
39
|
+
error: unknown;
|
|
40
|
+
failed: boolean;
|
|
41
|
+
}> {
|
|
42
|
+
static contextType: import("react").Context<Numbunch | null>;
|
|
43
|
+
context: Numbunch | null;
|
|
44
|
+
state: {
|
|
45
|
+
error: unknown;
|
|
46
|
+
failed: boolean;
|
|
47
|
+
};
|
|
48
|
+
static getDerivedStateFromError(error: unknown): {
|
|
49
|
+
error: unknown;
|
|
50
|
+
failed: boolean;
|
|
51
|
+
};
|
|
52
|
+
componentDidCatch(error: unknown, info: ErrorInfo): void;
|
|
53
|
+
render(): ReactNode;
|
|
54
|
+
}
|
|
55
|
+
export type { Bootstrap, FlagValue, NumbunchOptions, Properties };
|
|
56
|
+
//# sourceMappingURL=index.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"AAIA,OAAO,EAAE,QAAQ,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAA;AACnH,OAAO,EAAE,SAAS,EAAsG,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAA;AAMrK,MAAM,WAAW,qBAAqB;IACpC,+EAA+E;IAC/E,MAAM,CAAC,EAAE,QAAQ,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,eAAe,CAAA;IACzB,+GAA+G;IAC/G,SAAS,CAAC,EAAE,SAAS,CAAA;IACrB,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB;AAED,iGAAiG;AACjG,wBAAgB,gBAAgB,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,EAAE,qBAAqB,+BAYtG;AAED,4DAA4D;AAC5D,wBAAgB,WAAW,IAAI,QAAQ,CAItC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,SAAS,GAAG,SAAS,CAUpG;AAED,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAG/E;AAED,yCAAyC;AACzC,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAInD;AAED,sDAAsD;AACtD,wBAAgB,UAAU,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,UAAU,KAAK,IAAI,CAG7E;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,OAAO,KAAK,SAAS,CAAC,CAAA;IACtD,kDAAkD;IAClD,UAAU,CAAC,EAAE,UAAU,CAAA;IACvB,QAAQ,CAAC,EAAE,SAAS,CAAA;CACrB;AAED,mFAAmF;AACnF,qBAAa,qBAAsB,SAAQ,SAAS,CAAC,0BAA0B,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CAAC;IACnH,MAAM,CAAC,WAAW,2CAAkB;IAC5B,OAAO,EAAE,QAAQ,GAAG,IAAI,CAAA;IAChC,KAAK;eAAyB,OAAO;;MAAiB;IAEtD,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,OAAO;;;;IAI9C,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS;IASjD,MAAM;CAKP;AAED,YAAY,EAAE,SAAS,EAAE,SAAS,EAAE,eAAe,EAAE,UAAU,EAAE,CAAA"}
|
package/dist/index.js
ADDED
|
@@ -0,0 +1,87 @@
|
|
|
1
|
+
'use client';
|
|
2
|
+
import { jsx as _jsx } from "react/jsx-runtime";
|
|
3
|
+
// @numbunch/react (MIT): React bindings for @numbunch/browser.
|
|
4
|
+
import { exceptionList } from '@numbunch/browser/exceptions';
|
|
5
|
+
import { Numbunch } from '@numbunch/browser';
|
|
6
|
+
import { Component, createContext, useCallback, useContext, useEffect, useLayoutEffect, useState, useSyncExternalStore } from 'react';
|
|
7
|
+
const useMountEffect = typeof window === 'undefined' ? useEffect : useLayoutEffect;
|
|
8
|
+
const NumbunchContext = createContext(null);
|
|
9
|
+
/** Provides one Numbunch client to the tree. The client is created once, on the first render. */
|
|
10
|
+
export function NumbunchProvider({ client, token, options, bootstrap, children }) {
|
|
11
|
+
const [nb] = useState(() => {
|
|
12
|
+
if (client)
|
|
13
|
+
return client;
|
|
14
|
+
if (!token)
|
|
15
|
+
throw new Error('NumbunchProvider needs a client or a token');
|
|
16
|
+
return new Numbunch(token, { ...options, bootstrap: bootstrap ?? options?.bootstrap }, true);
|
|
17
|
+
});
|
|
18
|
+
useMountEffect(() => {
|
|
19
|
+
if (client)
|
|
20
|
+
return;
|
|
21
|
+
nb.start();
|
|
22
|
+
return () => nb.stop();
|
|
23
|
+
}, [nb, client]);
|
|
24
|
+
return _jsx(NumbunchContext.Provider, { value: nb, children: children });
|
|
25
|
+
}
|
|
26
|
+
/** The client from the nearest {@link NumbunchProvider}. */
|
|
27
|
+
export function useNumbunch() {
|
|
28
|
+
const nb = useContext(NumbunchContext);
|
|
29
|
+
if (!nb)
|
|
30
|
+
throw new Error('useNumbunch must be used inside <NumbunchProvider>');
|
|
31
|
+
return nb;
|
|
32
|
+
}
|
|
33
|
+
/**
|
|
34
|
+
* The flag's value (variant key or boolean), `undefined` while unknown. Read synchronously on the first render, so
|
|
35
|
+
* a bootstrapped or locally evaluated flag never flickers. Records one exposure once the value is known.
|
|
36
|
+
*/
|
|
37
|
+
export function useVariant(key, options = {}) {
|
|
38
|
+
const nb = useNumbunch();
|
|
39
|
+
const subscribe = useCallback((changed) => nb.onFlags(changed), [nb]);
|
|
40
|
+
const read = () => nb.flags.value(key);
|
|
41
|
+
const value = useSyncExternalStore(subscribe, read, read);
|
|
42
|
+
const sendEvent = options.sendEvent !== false;
|
|
43
|
+
useEffect(() => {
|
|
44
|
+
if (value !== undefined && sendEvent)
|
|
45
|
+
nb.getVariant(key);
|
|
46
|
+
}, [nb, key, value, sendEvent]);
|
|
47
|
+
return value;
|
|
48
|
+
}
|
|
49
|
+
/** Whether the flag is on (any variant counts). False while unknown. */
|
|
50
|
+
export function useFlag(key, options) {
|
|
51
|
+
const value = useVariant(key, options);
|
|
52
|
+
return value !== undefined && value !== false;
|
|
53
|
+
}
|
|
54
|
+
/** The flag's payload, if it has one. */
|
|
55
|
+
export function useFlagPayload(key) {
|
|
56
|
+
const nb = useNumbunch();
|
|
57
|
+
useVariant(key, { sendEvent: false });
|
|
58
|
+
return nb.getFlagPayload(key);
|
|
59
|
+
}
|
|
60
|
+
/** A stable `capture(event, properties)` function. */
|
|
61
|
+
export function useCapture() {
|
|
62
|
+
const nb = useNumbunch();
|
|
63
|
+
return useCallback((event, properties) => void nb.capture(event, properties), [nb]);
|
|
64
|
+
}
|
|
65
|
+
/** Reports render errors to error tracking (`$exception`) and shows `fallback`. */
|
|
66
|
+
export class NumbunchErrorBoundary extends Component {
|
|
67
|
+
static contextType = NumbunchContext;
|
|
68
|
+
state = { error: undefined, failed: false };
|
|
69
|
+
static getDerivedStateFromError(error) {
|
|
70
|
+
return { error, failed: true };
|
|
71
|
+
}
|
|
72
|
+
componentDidCatch(error, info) {
|
|
73
|
+
this.context?.capture('$exception', {
|
|
74
|
+
$exception_list: exceptionList(error, 'react_error_boundary', false),
|
|
75
|
+
$exception_level: 'error',
|
|
76
|
+
$react_component_stack: info.componentStack ?? undefined,
|
|
77
|
+
...this.props.properties,
|
|
78
|
+
});
|
|
79
|
+
}
|
|
80
|
+
render() {
|
|
81
|
+
if (!this.state.failed)
|
|
82
|
+
return this.props.children;
|
|
83
|
+
const { fallback } = this.props;
|
|
84
|
+
return typeof fallback === 'function' ? fallback(this.state.error) : (fallback ?? null);
|
|
85
|
+
}
|
|
86
|
+
}
|
|
87
|
+
//# sourceMappingURL=index.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.tsx"],"names":[],"mappings":"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"}
|
package/dist/server.d.ts
ADDED
|
@@ -0,0 +1,25 @@
|
|
|
1
|
+
import type { Bootstrap } from '@numbunch/browser';
|
|
2
|
+
/** Anything with `getBootstrap`, such as `@numbunch/node`'s client. */
|
|
3
|
+
export interface BootstrapSource {
|
|
4
|
+
getBootstrap(distinctId: string, options?: {
|
|
5
|
+
isIdentified?: boolean;
|
|
6
|
+
personProperties?: Record<string, unknown>;
|
|
7
|
+
}): Promise<Bootstrap>;
|
|
8
|
+
}
|
|
9
|
+
/** Evaluates every flag for `distinctId` on the server; `{distinctId}` alone if evaluation fails. */
|
|
10
|
+
export declare function loadBootstrap(source: BootstrapSource, distinctId: string, options?: {
|
|
11
|
+
isIdentified?: boolean;
|
|
12
|
+
personProperties?: Record<string, unknown>;
|
|
13
|
+
}): Promise<Bootstrap>;
|
|
14
|
+
/** JSON safe to place inside a `<script>` element. */
|
|
15
|
+
export declare function serializeBootstrap(bootstrap: Bootstrap): string;
|
|
16
|
+
/** `<script type="application/json" id="__numbunch_bootstrap">`, read by `bootstrapFromDocument()`. */
|
|
17
|
+
export declare function NumbunchBootstrapScript({ bootstrap, id }: {
|
|
18
|
+
bootstrap: Bootstrap;
|
|
19
|
+
id?: string;
|
|
20
|
+
}): import("react").JSX.Element;
|
|
21
|
+
/** `<meta name="traceparent">` with the server span's context, which the browser SDK adopts as its trace. */
|
|
22
|
+
export declare function TraceparentMeta({ traceparent }: {
|
|
23
|
+
traceparent: string | undefined;
|
|
24
|
+
}): import("react").JSX.Element | null;
|
|
25
|
+
//# sourceMappingURL=server.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.tsx"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAElD,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAAA;CACvI;AAED,qGAAqG;AACrG,wBAAsB,aAAa,CAAC,MAAM,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,SAAS,CAAC,CAMrL;AAED,sDAAsD;AACtD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,SAAS,GAAG,MAAM,CAE/D;AAED,uGAAuG;AACvG,wBAAgB,uBAAuB,CAAC,EAAE,SAAS,EAAE,EAA2B,EAAE,EAAE;IAAE,SAAS,EAAE,SAAS,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,+BAExH;AAED,6GAA6G;AAC7G,wBAAgB,eAAe,CAAC,EAAE,WAAW,EAAE,EAAE;IAAE,WAAW,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,sCAEnF"}
|
package/dist/server.js
ADDED
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
import { jsx as _jsx } from "react/jsx-runtime";
|
|
2
|
+
/** Evaluates every flag for `distinctId` on the server; `{distinctId}` alone if evaluation fails. */
|
|
3
|
+
export async function loadBootstrap(source, distinctId, options) {
|
|
4
|
+
try {
|
|
5
|
+
return await source.getBootstrap(distinctId, options);
|
|
6
|
+
}
|
|
7
|
+
catch {
|
|
8
|
+
return { distinctId, isIdentified: options?.isIdentified };
|
|
9
|
+
}
|
|
10
|
+
}
|
|
11
|
+
/** JSON safe to place inside a `<script>` element. */
|
|
12
|
+
export function serializeBootstrap(bootstrap) {
|
|
13
|
+
return JSON.stringify(bootstrap).replace(/</g, '\\u003c').replace(/\u2028/g, '\\u2028').replace(/\u2029/g, '\\u2029');
|
|
14
|
+
}
|
|
15
|
+
/** `<script type="application/json" id="__numbunch_bootstrap">`, read by `bootstrapFromDocument()`. */
|
|
16
|
+
export function NumbunchBootstrapScript({ bootstrap, id = '__numbunch_bootstrap' }) {
|
|
17
|
+
return _jsx("script", { type: "application/json", id: id, dangerouslySetInnerHTML: { __html: serializeBootstrap(bootstrap) } });
|
|
18
|
+
}
|
|
19
|
+
/** `<meta name="traceparent">` with the server span's context, which the browser SDK adopts as its trace. */
|
|
20
|
+
export function TraceparentMeta({ traceparent }) {
|
|
21
|
+
return traceparent ? _jsx("meta", { name: "traceparent", content: traceparent }) : null;
|
|
22
|
+
}
|
|
23
|
+
//# sourceMappingURL=server.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.tsx"],"names":[],"mappings":";AAeA,qGAAqG;AACrG,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAuB,EAAE,UAAkB,EAAE,OAAgF;IAC/J,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;IACvD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,CAAA;IAC5D,CAAC;AACH,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,kBAAkB,CAAC,SAAoB;IACrD,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,SAAS,CAAC,CAAA;AACvH,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,uBAAuB,CAAC,EAAE,SAAS,EAAE,EAAE,GAAG,sBAAsB,EAAyC;IACvH,OAAO,iBAAQ,IAAI,EAAC,kBAAkB,EAAC,EAAE,EAAE,EAAE,EAAE,uBAAuB,EAAE,EAAE,MAAM,EAAE,kBAAkB,CAAC,SAAS,CAAC,EAAE,GAAI,CAAA;AACvH,CAAC;AAED,6GAA6G;AAC7G,MAAM,UAAU,eAAe,CAAC,EAAE,WAAW,EAAuC;IAClF,OAAO,WAAW,CAAC,CAAC,CAAC,eAAM,IAAI,EAAC,aAAa,EAAC,OAAO,EAAE,WAAW,GAAI,CAAC,CAAC,CAAC,IAAI,CAAA;AAC/E,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,63 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@numbunch/react",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"
|
|
5
|
-
"
|
|
3
|
+
"version": "0.1.1",
|
|
4
|
+
"description": "React bindings for the Numbunch browser SDK: provider, flag and capture hooks, error boundary",
|
|
5
|
+
"license": "MIT",
|
|
6
|
+
"repository": {
|
|
7
|
+
"type": "git",
|
|
8
|
+
"url": "git+https://github.com/MidgardAI/numbunch.git",
|
|
9
|
+
"directory": "sdk/react"
|
|
10
|
+
},
|
|
11
|
+
"type": "module",
|
|
12
|
+
"sideEffects": false,
|
|
13
|
+
"files": [
|
|
14
|
+
"dist",
|
|
15
|
+
"LICENSE"
|
|
16
|
+
],
|
|
17
|
+
"main": "./dist/index.js",
|
|
18
|
+
"types": "./dist/index.d.ts",
|
|
19
|
+
"exports": {
|
|
20
|
+
".": {
|
|
21
|
+
"types": "./dist/index.d.ts",
|
|
22
|
+
"default": "./dist/index.js"
|
|
23
|
+
},
|
|
24
|
+
"./server": {
|
|
25
|
+
"types": "./dist/server.d.ts",
|
|
26
|
+
"default": "./dist/server.js"
|
|
27
|
+
},
|
|
28
|
+
"./compat": {
|
|
29
|
+
"types": "./dist/compat.d.ts",
|
|
30
|
+
"default": "./dist/compat.js"
|
|
31
|
+
},
|
|
32
|
+
"./package.json": "./package.json"
|
|
33
|
+
},
|
|
34
|
+
"peerDependencies": {
|
|
35
|
+
"react": ">=18",
|
|
36
|
+
"@numbunch/browser": "^0.1.1"
|
|
37
|
+
},
|
|
38
|
+
"devDependencies": {
|
|
39
|
+
"@eslint/js": "10.0.1",
|
|
40
|
+
"@testing-library/react": "16.3.3",
|
|
41
|
+
"@types/node": "22.20.5",
|
|
42
|
+
"@types/react": "19.3.0",
|
|
43
|
+
"@types/react-dom": "19.3.0",
|
|
44
|
+
"eslint": "10.15.0",
|
|
45
|
+
"globals": "17.14.0",
|
|
46
|
+
"jsdom": "31.0.1",
|
|
47
|
+
"react": "19.3.1",
|
|
48
|
+
"react-dom": "19.3.1",
|
|
49
|
+
"typescript": "6.0.3",
|
|
50
|
+
"typescript-eslint": "8.72.2",
|
|
51
|
+
"vitest": "5.1.0",
|
|
52
|
+
"@numbunch/browser": "0.1.1"
|
|
53
|
+
},
|
|
54
|
+
"publishConfig": {
|
|
55
|
+
"access": "public"
|
|
56
|
+
},
|
|
57
|
+
"scripts": {
|
|
58
|
+
"build": "tsc -p tsconfig.build.json",
|
|
59
|
+
"typecheck": "tsc --noEmit -p tsconfig.json",
|
|
60
|
+
"lint": "eslint .",
|
|
61
|
+
"test": "vitest run"
|
|
62
|
+
}
|
|
6
63
|
}
|
package/README.md
DELETED