syntro-js-client 1.0.0 → 1.0.2

package/index.d.ts

@@ -0,0 +1,68 @@
+export declare class Syntro {
+    constructor(apiKey: string);
+
+    /** JWT token obtained after login */
+    readonly _token: string | null;
+
+    /** Log in with email and password. Stores the JWT token internally. */
+    login(email: string, password: string): Promise<{
+        accessToken: string;
+        [key: string]: unknown;
+    }>;
+
+    /** Register a new user. */
+    register(
+        email: string,
+        password: string,
+        extra?: Record<string, unknown>
+    ): Promise<unknown>;
+
+    /**
+     * Returns a redirect URL for social OAuth login.
+     * @param provider - 'google' | 'github'
+     */
+    socialLogin(provider: 'google' | 'github'): Promise<{ redirectUrl: string }>;
+
+    /** Send a forgot-password email. */
+    forgotPassword(email: string): Promise<unknown>;
+
+    /** Reset password using a token from the forgot-password email. */
+    resetPassword(token: string, password: string): Promise<unknown>;
+
+    /** Fetch the currently authenticated user (requires prior login). */
+    me(): Promise<unknown>;
+
+    /**
+     * Create a billing / payment session.
+     * @param name        - Product / plan name
+     * @param description - Short description shown to the customer
+     * @param amount      - Amount in the smallest currency unit (e.g. cents)
+     * @param methods     - Payment methods to accept, default ['card']
+     * @param options     - Extra options: currency, successUrl, cancelUrl
+     */
+    createBilling(
+        name: string,
+        description: string,
+        amount: number,
+        methods?: string[],
+        options?: {
+            currency?: string;
+            successUrl?: string;
+            cancelUrl?: string;
+        }
+    ): Promise<unknown>;
+
+    /** Track a custom analytics event. */
+    trackEvent(type: string, payload?: Record<string, unknown>): Promise<unknown>;
+
+    /** Retrieve tracked events, optionally filtered by query params. */
+    getEvents(params?: Record<string, string>): Promise<unknown>;
+
+    /** Get aggregated stats for the current project. */
+    getStats(): Promise<unknown>;
+
+    /** Update / increment a specific stat metric. */
+    updateStat(metric: string, value: number): Promise<unknown>;
+}
+
+export default Syntro;

package/index.js

@@ -96,4 +96,6 @@ class Syntro {
     }
 }
 
-module.exports = { Syntro };
+// Support both: import { Syntro } from '...' AND import Syntro from '...'
+module.exports = Syntro;
+module.exports.Syntro = Syntro;

package/package.json

@@ -1,8 +1,19 @@
 {
   "name": "syntro-js-client",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Official Node.js SDK for Syntro — plug-and-play auth, billing, and analytics for your SaaS.",
   "main": "index.js",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "require": "./index.js",
+      "types": "./index.d.ts"
+    },
+    "./react": {
+      "require": "./react.js",
+      "types": "./react.d.ts"
+    }
+  },
   "keywords": [
     "syntro",
     "auth",
@@ -18,4 +29,4 @@
   "peerDependencies": {
     "react": ">=16.8.0"
   }
-}
+}

package/react.d.ts

@@ -0,0 +1,35 @@
+import * as React from 'react';
+import { Syntro } from './index';
+
+// ─── Context value shape ──────────────────────────────────────────────────────
+
+export interface SyntroContextValue {
+    client: Syntro | null;
+    user: unknown | null;
+    loading: boolean;
+}
+
+// ─── SyntroProvider ───────────────────────────────────────────────────────────
+
+export interface SyntroProviderProps {
+    client: Syntro;
+    children?: React.ReactNode;
+}
+
+export declare const SyntroProvider: React.FC<SyntroProviderProps>;
+
+// ─── useSyntro ────────────────────────────────────────────────────────────────
+
+export declare function useSyntro(): SyntroContextValue;
+
+// ─── SyntroProtected ─────────────────────────────────────────────────────────
+
+export interface SyntroProtectedProps {
+    /** Content to render when the user is not authenticated */
+    fallback?: React.ReactNode;
+    /** If provided, redirects unauthenticated users to this URL */
+    redirectTo?: string;
+    children?: React.ReactNode;
+}
+
+export declare const SyntroProtected: React.FC<SyntroProtectedProps>;