@statly/observe 0.1.0

package/dist/integrations/fastify.mjs

@@ -0,0 +1,10 @@
+import {
+  createRequestCapture,
+  statlyFastifyPlugin,
+  statlyPlugin
+} from "../chunk-PETWPVHU.mjs";
+export {
+  createRequestCapture,
+  statlyFastifyPlugin,
+  statlyPlugin
+};

package/dist/integrations/nextjs.d.mts

@@ -0,0 +1,179 @@
+/**
+ * Next.js Integration
+ *
+ * Provides error handling for Next.js applications including
+ * API routes and server components.
+ *
+ * @example
+ * ```typescript
+ * // In your error.tsx (App Router)
+ * 'use client';
+ *
+ * import { Statly } from '@statly/observe-sdk';
+ *
+ * export default function Error({
+ *   error,
+ *   reset,
+ * }: {
+ *   error: Error & { digest?: string };
+ *   reset: () => void;
+ * }) {
+ *   useEffect(() => {
+ *     Statly.captureException(error);
+ *   }, [error]);
+ *
+ *   return <ErrorUI error={error} reset={reset} />;
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // In your API route
+ * import { withStatly } from '@statly/observe-sdk/nextjs';
+ *
+ * export const GET = withStatly(async (request) => {
+ *   // Your handler code
+ *   return Response.json({ data: 'ok' });
+ * });
+ * ```
+ */
+type NextApiRequest = {
+    method?: string;
+    url?: string;
+    headers: Record<string, string | string[] | undefined>;
+    query?: Record<string, string | string[]>;
+    body?: unknown;
+};
+type NextApiResponse = {
+    status: (code: number) => NextApiResponse;
+    json: (data: unknown) => void;
+    end: () => void;
+};
+type NextApiHandler<T = unknown> = (req: NextApiRequest, res: NextApiResponse) => Promise<T> | T;
+/**
+ * Wrap a Next.js Pages API route handler with error tracking
+ */
+declare function withStatlyPagesApi<T>(handler: NextApiHandler<T>): NextApiHandler<T>;
+type NextRequest = {
+    method: string;
+    url: string;
+    headers: Headers;
+    nextUrl?: {
+        pathname: string;
+        searchParams: URLSearchParams;
+    };
+    json: () => Promise<unknown>;
+};
+type NextRouteHandler = (request: NextRequest, context?: {
+    params?: Promise<Record<string, string>>;
+}) => Promise<Response> | Response;
+/**
+ * Wrap a Next.js App Router handler with error tracking
+ */
+declare function withStatly<T extends NextRouteHandler>(handler: T): T;
+/**
+ * Capture errors from Next.js error boundaries
+ *
+ * @example
+ * ```typescript
+ * // app/error.tsx
+ * 'use client';
+ *
+ * import { captureNextJsError } from '@statly/observe-sdk/nextjs';
+ *
+ * export default function Error({
+ *   error,
+ *   reset,
+ * }: {
+ *   error: Error & { digest?: string };
+ *   reset: () => void;
+ * }) {
+ *   useEffect(() => {
+ *     captureNextJsError(error);
+ *   }, [error]);
+ *
+ *   return <ErrorUI />;
+ * }
+ * ```
+ */
+declare function captureNextJsError(error: Error & {
+    digest?: string;
+}, context?: Record<string, unknown>): string;
+/**
+ * Capture errors in getServerSideProps
+ *
+ * @example
+ * ```typescript
+ * export const getServerSideProps = withStatlyGetServerSideProps(async (context) => {
+ *   // Your code here
+ *   return { props: {} };
+ * });
+ * ```
+ */
+declare function withStatlyGetServerSideProps<Props extends {
+    [key: string]: unknown;
+}, Context extends {
+    req?: {
+        url?: string;
+    };
+    resolvedUrl?: string;
+}>(handler: (context: Context) => Promise<{
+    props: Props;
+} | {
+    redirect: unknown;
+} | {
+    notFound: boolean;
+}>): (context: Context) => Promise<{
+    props: Props;
+} | {
+    redirect: unknown;
+} | {
+    notFound: boolean;
+}>;
+/**
+ * Capture errors in getStaticProps
+ *
+ * @example
+ * ```typescript
+ * export const getStaticProps = withStatlyGetStaticProps(async (context) => {
+ *   // Your code here
+ *   return { props: {} };
+ * });
+ * ```
+ */
+declare function withStatlyGetStaticProps<Props extends {
+    [key: string]: unknown;
+}, Context extends {
+    params?: Record<string, string>;
+}>(handler: (context: Context) => Promise<{
+    props: Props;
+    revalidate?: number;
+} | {
+    redirect: unknown;
+} | {
+    notFound: boolean;
+}>): (context: Context) => Promise<{
+    props: Props;
+    revalidate?: number;
+} | {
+    redirect: unknown;
+} | {
+    notFound: boolean;
+}>;
+/**
+ * Server Action wrapper for error tracking
+ *
+ * @example
+ * ```typescript
+ * 'use server';
+ *
+ * import { withStatlyServerAction } from '@statly/observe-sdk/nextjs';
+ *
+ * export const submitForm = withStatlyServerAction(async (formData: FormData) => {
+ *   // Your code here
+ * });
+ * ```
+ */
+declare function withStatlyServerAction<Args extends unknown[], Result>(action: (...args: Args) => Promise<Result>, actionName?: string): (...args: Args) => Promise<Result>;
+
+export { captureNextJsError, withStatly, withStatlyGetServerSideProps, withStatlyGetStaticProps, withStatlyPagesApi, withStatlyServerAction };

package/dist/integrations/nextjs.d.ts

@@ -0,0 +1,179 @@
+/**
+ * Next.js Integration
+ *
+ * Provides error handling for Next.js applications including
+ * API routes and server components.
+ *
+ * @example
+ * ```typescript
+ * // In your error.tsx (App Router)
+ * 'use client';
+ *
+ * import { Statly } from '@statly/observe-sdk';
+ *
+ * export default function Error({
+ *   error,
+ *   reset,
+ * }: {
+ *   error: Error & { digest?: string };
+ *   reset: () => void;
+ * }) {
+ *   useEffect(() => {
+ *     Statly.captureException(error);
+ *   }, [error]);
+ *
+ *   return <ErrorUI error={error} reset={reset} />;
+ * }
+ * ```
+ *
+ * @example
+ * ```typescript
+ * // In your API route
+ * import { withStatly } from '@statly/observe-sdk/nextjs';
+ *
+ * export const GET = withStatly(async (request) => {
+ *   // Your handler code
+ *   return Response.json({ data: 'ok' });
+ * });
+ * ```
+ */
+type NextApiRequest = {
+    method?: string;
+    url?: string;
+    headers: Record<string, string | string[] | undefined>;
+    query?: Record<string, string | string[]>;
+    body?: unknown;
+};
+type NextApiResponse = {
+    status: (code: number) => NextApiResponse;
+    json: (data: unknown) => void;
+    end: () => void;
+};
+type NextApiHandler<T = unknown> = (req: NextApiRequest, res: NextApiResponse) => Promise<T> | T;
+/**
+ * Wrap a Next.js Pages API route handler with error tracking
+ */
+declare function withStatlyPagesApi<T>(handler: NextApiHandler<T>): NextApiHandler<T>;
+type NextRequest = {
+    method: string;
+    url: string;
+    headers: Headers;
+    nextUrl?: {
+        pathname: string;
+        searchParams: URLSearchParams;
+    };
+    json: () => Promise<unknown>;
+};
+type NextRouteHandler = (request: NextRequest, context?: {
+    params?: Promise<Record<string, string>>;
+}) => Promise<Response> | Response;
+/**
+ * Wrap a Next.js App Router handler with error tracking
+ */
+declare function withStatly<T extends NextRouteHandler>(handler: T): T;
+/**
+ * Capture errors from Next.js error boundaries
+ *
+ * @example
+ * ```typescript
+ * // app/error.tsx
+ * 'use client';
+ *
+ * import { captureNextJsError } from '@statly/observe-sdk/nextjs';
+ *
+ * export default function Error({
+ *   error,
+ *   reset,
+ * }: {
+ *   error: Error & { digest?: string };
+ *   reset: () => void;
+ * }) {
+ *   useEffect(() => {
+ *     captureNextJsError(error);
+ *   }, [error]);
+ *
+ *   return <ErrorUI />;
+ * }
+ * ```
+ */
+declare function captureNextJsError(error: Error & {
+    digest?: string;
+}, context?: Record<string, unknown>): string;
+/**
+ * Capture errors in getServerSideProps
+ *
+ * @example
+ * ```typescript
+ * export const getServerSideProps = withStatlyGetServerSideProps(async (context) => {
+ *   // Your code here
+ *   return { props: {} };
+ * });
+ * ```
+ */
+declare function withStatlyGetServerSideProps<Props extends {
+    [key: string]: unknown;
+}, Context extends {
+    req?: {
+        url?: string;
+    };
+    resolvedUrl?: string;
+}>(handler: (context: Context) => Promise<{
+    props: Props;
+} | {
+    redirect: unknown;
+} | {
+    notFound: boolean;
+}>): (context: Context) => Promise<{
+    props: Props;
+} | {
+    redirect: unknown;
+} | {
+    notFound: boolean;
+}>;
+/**
+ * Capture errors in getStaticProps
+ *
+ * @example
+ * ```typescript
+ * export const getStaticProps = withStatlyGetStaticProps(async (context) => {
+ *   // Your code here
+ *   return { props: {} };
+ * });
+ * ```
+ */
+declare function withStatlyGetStaticProps<Props extends {
+    [key: string]: unknown;
+}, Context extends {
+    params?: Record<string, string>;
+}>(handler: (context: Context) => Promise<{
+    props: Props;
+    revalidate?: number;
+} | {
+    redirect: unknown;
+} | {
+    notFound: boolean;
+}>): (context: Context) => Promise<{
+    props: Props;
+    revalidate?: number;
+} | {
+    redirect: unknown;
+} | {
+    notFound: boolean;
+}>;
+/**
+ * Server Action wrapper for error tracking
+ *
+ * @example
+ * ```typescript
+ * 'use server';
+ *
+ * import { withStatlyServerAction } from '@statly/observe-sdk/nextjs';
+ *
+ * export const submitForm = withStatlyServerAction(async (formData: FormData) => {
+ *   // Your code here
+ * });
+ * ```
+ */
+declare function withStatlyServerAction<Args extends unknown[], Result>(action: (...args: Args) => Promise<Result>, actionName?: string): (...args: Args) => Promise<Result>;
+
+export { captureNextJsError, withStatly, withStatlyGetServerSideProps, withStatlyGetStaticProps, withStatlyPagesApi, withStatlyServerAction };