@a-tech.jo/auth-sdk 1.0.1 → 1.0.3

package/README.md

@@ -0,0 +1,177 @@
+# `@a-tech/auth-sdk`
+
+A full-stack, customizable authentication SDK providing seamless login, registration, and session management for A-Tech applications.
+
+---
+
+## Quick Start & Integration
+
+### 1. Import Global Styles
+Import the pre-compiled CSS file in your root `layout.tsx` or `_app.tsx`:
+
+```tsx
+import "@a-tech/auth-sdk/styles.css";
+
+```
+
+---
+
+### 2. Wrap Application with `AuthProvider`
+
+Encapsulate your component tree with the `AuthProvider` to manage global authentication state and token expiration.
+
+```tsx
+import { AuthProvider } from "@a-tech/auth-sdk";
+
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>
+        <AuthProvider "local" config="{{" environment: }}>
+          {children}
+        </AuthProvider>
+      </body>
+    </html>
+  );
+}
+
+```
+
+#### Available Environment Configurations
+
+| Environment | Key | Description |
+| --- | --- | --- |
+| **Local** | `"local"` | Targets `http://localhost:3000` / local backend services |
+| **Staging** | `"stage"` | Targets staging auth backend (`https://auth.atech-workspace.com`) |
+| **Production** | `"production"` | *(Default)* Targets production auth services |
+
+---
+
+### 3. Embed Authentication Component
+
+Render the pre-built, responsive authentication card supporting mode toggling (Login, Register, Forgot Password).
+
+```tsx
+import { SDKAuthContainer } from "@a-tech/auth-sdk";
+
+export default function AuthPage() {
+  const handleSuccess = (data: { user: any; token: string }) => {
+    console.log("Authenticated successfully:", data);
+  };
+
+  return (
+    <div className="flex min-h-screen items-center justify-center">
+      <SDKAuthContainer initialMode="login" onSuccess="{handleSuccess}"/>
+    </div>
+  );
+}
+
+```
+
+---
+
+### 4. Access User Session (`useAuth` Hook)
+
+Access the current user profile, JWT token, and session utilities anywhere within the `AuthProvider` scope:
+
+```tsx
+import { useAuth } from "@a-tech/auth-sdk";
+
+export default function Dashboard() {
+  const { user, token, logout, isExpired } = useAuth();
+
+  if (!token || isExpired) {
+    return <p>Please sign in to access this page.</p>;
+  }
+
+  return (
+    <div>
+      <h1>Welcome back, {user?.firstName}!</h1>
+      <p>Logged in as: {user?.email}</p>
+      <button onClick={logout}>Sign Out</button>
+    </div>
+  );
+}
+
+```
+
+---
+
+## How to Update & Publish New Versions
+
+When publishing an update to npm, follow standard Semantic Versioning guidelines:
+
+### 1. Bump Package Version
+
+Choose the appropriate command based on the scope of your changes:
+
+```bash
+# Patch update (Bug fixes: e.g., 1.0.0 -> 1.0.1)
+npm version patch
+
+# Minor update (New backward-compatible features: e.g., 1.0.0 -> 1.1.0)
+npm version minor
+
+# Major update (Breaking changes: e.g., 1.0.0 -> 2.0.0)
+npm version major
+
+```
+
+### 2. Clean, Build, and Publish
+
+Run a fresh build and publish to npm using your Granular Access Token:
+
+```bash
+# Clean build artifacts and build fresh distribution package
+rm -rf dist *.tgz && npm run build
+
+# Publish to npm using your access token
+echo "//registry.npmjs.org/:_authToken=YOUR_NPM_TOKEN" > .npmrc && npm publish --access public ; rm -f .npmrc
+
+
+
+
+---
+
+## Token Verification (`verifyToken`)
+
+Verify any JWT token and retrieve the active user profile using the SDK helper function:
+
+```typescript
+import { verifyToken } from "@a-tech/auth-sdk";
+
+async function validateSession(authToken: string) {
+  // Verifies token and returns session status & user details
+  const result = await verifyToken(authToken, "local");
+
+  if (result.valid) {
+    console.log("Authenticated User:", result.user);
+    console.log("Session Expires At:", result.expiresAt);
+  } else {
+    console.error("Invalid Session:", result.error);
+  }
+}
+
+```
+
+### Parameters & Options
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| `token` | `string` | *(Required)* The JWT authentication token string to verify. |
+| `environment` | `"local" | "stage" | "production"` | *(Optional)* The target environment. Defaults to `"production"`. |
+
+### Return Value (`Promise<VerifyTokenResponse>`)
+
+```typescript
+{
+  valid: boolean;         // True if the token is signature-valid and active
+  user?: {                // User profile details (if valid)
+    id: string | number;
+    email: string;
+    type?: string;
+  };
+  expiresAt?: string;     // ISO expiration timestamp
+  error?: string;         // Error message if invalid or expired
+}
+

package/dist/index.d.ts

@@ -3,4 +3,5 @@ export * from "./config";
 export * from "./client";
 export * from "./AuthContext";
 export * from "./components/AuthContainer";
+export { verifyToken } from "./services/auth";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,eAAe,CAAC;AAC9B,cAAc,4BAA4B,CAAA;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -29,7 +29,8 @@ __export(index_exports, {
   DEFAULT_THEME: () => DEFAULT_THEME,
   SDKAuthContainer: () => SDKAuthContainer,
   getSDKConfig: () => getSDKConfig,
-  useAuth: () => useAuth
+  useAuth: () => useAuth,
+  verifyToken: () => verifyToken
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -752,6 +753,40 @@ var SDKAuthContainer = ({
     )
   ] });
 };
+
+// src/services/auth.ts
+async function verifyToken(token, environment = "production") {
+  const baseUrlMap = {
+    local: "http://localhost:3000",
+    stage: "https://auth.atech-workspace.com",
+    production: "https://sso.a-tech.dev"
+    // Replace with your production URL
+  };
+  const baseUrl = baseUrlMap[environment] || baseUrlMap.production;
+  try {
+    const response = await fetch(`${baseUrl}/api/auth/verify`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${token}`
+      },
+      body: JSON.stringify({ token })
+    });
+    const data = await response.json();
+    if (!response.ok) {
+      return {
+        valid: false,
+        error: data.error || "Token verification failed."
+      };
+    }
+    return data;
+  } catch (error) {
+    return {
+      valid: false,
+      error: error.message || "Network error while verifying token."
+    };
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AuthClient,
@@ -763,5 +798,6 @@ var SDKAuthContainer = ({
   DEFAULT_THEME,
   SDKAuthContainer,
   getSDKConfig,
-  useAuth
+  useAuth,
+  verifyToken
 });

package/dist/index.mjs

@@ -717,6 +717,40 @@ var SDKAuthContainer = ({
     )
   ] });
 };
+
+// src/services/auth.ts
+async function verifyToken(token, environment = "production") {
+  const baseUrlMap = {
+    local: "http://localhost:3000",
+    stage: "https://auth.atech-workspace.com",
+    production: "https://sso.a-tech.dev"
+    // Replace with your production URL
+  };
+  const baseUrl = baseUrlMap[environment] || baseUrlMap.production;
+  try {
+    const response = await fetch(`${baseUrl}/api/auth/verify`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Authorization: `Bearer ${token}`
+      },
+      body: JSON.stringify({ token })
+    });
+    const data = await response.json();
+    if (!response.ok) {
+      return {
+        valid: false,
+        error: data.error || "Token verification failed."
+      };
+    }
+    return data;
+  } catch (error) {
+    return {
+      valid: false,
+      error: error.message || "Network error while verifying token."
+    };
+  }
+}
 export {
   AuthClient,
   AuthProvider,
@@ -727,5 +761,6 @@ export {
   DEFAULT_THEME,
   SDKAuthContainer,
   getSDKConfig,
-  useAuth
+  useAuth,
+  verifyToken
 };

package/dist/services/auth.d.ts

@@ -0,0 +1,10 @@
+import { VerifyTokenResponse } from "../types";
+/**
+ * Verifies a JWT token against the A-Tech Auth API.
+ *
+ * @param token - The JWT string to verify.
+ * @param environment - Optional environment override ('local' | 'stage' | 'production').
+ * @returns Promise containing verification status and user details.
+ */
+export declare function verifyToken(token: string, environment?: "local" | "stage" | "production"): Promise<VerifyTokenResponse>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/services/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/services/auth.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAE/C;;;;;;GAMG;AACH,wBAAsB,WAAW,CAC7B,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,OAAO,GAAG,OAAO,GAAG,YAA2B,GAC7D,OAAO,CAAC,mBAAmB,CAAC,CAmC9B"}

package/dist/types.d.ts

@@ -99,4 +99,15 @@ export interface SDKOptions {
     onSuccess?: (data: any) => void;
     onError?: (error: Error) => void;
 }
+export interface VerifyTokenResponse {
+    valid: boolean;
+    user?: {
+        id: string | number;
+        email: string;
+        type?: string;
+        [key: string]: any;
+    };
+    expiresAt?: string;
+    error?: string;
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a-tech.jo/auth-sdk",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "A-Tech Authentication SDK for React and Next.js",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -30,7 +30,8 @@
     "example": "npm run dev --workspace=example",
     "pack": "npm pack",
     "clean": "rm -rf dist node_modules/.cache *.tgz example/.next",
-    "prepublishOnly": "npm run clean && npm run build"
+    "prepublishOnly": "npm run clean && npm run build",
+    "publish": "npm publish --access public"
   },
   "peerDependencies": {
     "react": ">=18.0.0",