@cas-system/nextjs-cas-client 1.0.0

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,aAAa,EACb,aAAa,EACb,eAAe,EACf,WAAW,EACX,wBAAwB,GACzB,MAAM,QAAQ,CAAC;AAEhB,YAAY,EACV,SAAS,EACT,eAAe,EACf,OAAO,EACP,cAAc,EACd,gBAAgB,GACjB,MAAM,UAAU,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,11 @@
+/**
+ * @module @cas-system/nextjs-cas-client/server
+ * @description Server-only entry point for the Next.js CAS Client SDK.
+ *
+ * Exposes the {@link CasClient} (token validation / generation / logout) and
+ * the cookie-based session helpers.  These modules require the
+ * `clientSecret` / cookie signing secret and must never run in the browser.
+ */
+export { CasClient } from './cas-client';
+export { getCasSession, setCasSession, clearCasSession, withCasAuth, getCasSessionFromRequest, } from './auth';
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,aAAa,EACb,aAAa,EACb,eAAe,EACf,WAAW,EACX,wBAAwB,GACzB,MAAM,QAAQ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,170 @@
+/**
+ * @module @cas-system/nextjs-cas-client/types
+ * @description Core TypeScript type definitions for the CAS Client SDK.
+ */
+/**
+ * Base configuration for connecting to the CAS server.
+ *
+ * @example
+ * ```ts
+ * const config: CasConfig = {
+ *   serverUrl: 'https://cas.example.com',
+ *   clientId: 'my-app',
+ *   callbackUrl: 'https://myapp.com/api/cas/callback',
+ * };
+ * ```
+ */
+export interface CasConfig {
+    /** Base URL of the CAS server (no trailing slash). */
+    serverUrl: string;
+    /** OAuth / SSO client identifier registered on the CAS server. */
+    clientId: string;
+    /**
+     * URL the CAS server redirects to after login.
+     * Defaults to `{origin}/api/cas/callback` when omitted.
+     */
+    callbackUrl?: string;
+}
+/**
+ * Server-side CAS configuration — extends {@link CasConfig} with the
+ * client secret that **must never be exposed to the browser**.
+ *
+ * @example
+ * ```ts
+ * const serverConfig: CasServerConfig = {
+ *   serverUrl: process.env.CAS_SERVER_URL!,
+ *   clientId: process.env.CAS_CLIENT_ID!,
+ *   clientSecret: process.env.CAS_CLIENT_SECRET!,
+ * };
+ * ```
+ */
+export interface CasServerConfig extends CasConfig {
+    /** Secret key used for server-to-server token validation & generation. */
+    clientSecret: string;
+}
+/**
+ * Authenticated user object returned by the CAS server after token validation.
+ *
+ * @example
+ * ```ts
+ * const user: CasUser = {
+ *   id: '550e8400-e29b-41d4-a716-446655440000',
+ *   username: 'jdoe',
+ *   email: 'jdoe@example.com',
+ *   roles: ['admin', 'editor'],
+ * };
+ * ```
+ */
+export interface CasUser {
+    /** Unique identifier of the user. */
+    id: string;
+    /** Login username. */
+    username: string;
+    /** E-mail address. */
+    email: string;
+    /** Optional list of role names assigned to the user. */
+    roles?: string[];
+}
+/**
+ * Shape of the data persisted in the encrypted session cookie.
+ * @internal
+ */
+export interface CasSessionData {
+    /** The authenticated user. */
+    user: CasUser;
+    /** Raw JWT token issued by the CAS server. */
+    token: string;
+    /** Unix-ms timestamp when the session was created. */
+    createdAt: number;
+}
+/**
+ * Configuration for the Next.js CAS authentication middleware.
+ *
+ * @example
+ * ```ts
+ * const mwConfig: CasMiddlewareConfig = {
+ *   protectedPaths: ['/dashboard', '/admin'],
+ *   publicPaths: ['/', '/about', '/api/health'],
+ *   loginPath: '/login',
+ * };
+ * ```
+ */
+export interface CasMiddlewareConfig {
+    /**
+     * Path prefixes that require authentication.
+     * A request whose `pathname` starts with any of these strings will be
+     * checked for a valid CAS session cookie.
+     */
+    protectedPaths: string[];
+    /**
+     * Custom path for the login page within the app.
+     * When provided, unauthenticated users are redirected here instead of
+     * directly to the CAS server login URL.
+     * @default undefined — redirects straight to CAS server
+     */
+    loginPath?: string;
+    /**
+     * Paths that are explicitly public even if they match a protected prefix.
+     * Useful for health-check endpoints nested under a protected prefix.
+     */
+    publicPaths?: string[];
+}
+/**
+ * Shape of the value provided by `CasProvider` through React Context.
+ */
+export interface CasAuthContext {
+    /** The current user, or `null` when not authenticated. */
+    user: CasUser | null;
+    /** `true` while the initial session fetch is in progress. */
+    isLoading: boolean;
+    /** `true` when a valid session exists. */
+    isAuthenticated: boolean;
+    /** Error from the last session fetch, if any. */
+    error: Error | null;
+    /** Redirect the browser to the CAS login page. */
+    login: (returnUrl?: string) => void;
+    /** Clear the session and redirect to CAS logout. */
+    logout: () => Promise<void>;
+    /** Re-fetch the session from the server. */
+    refresh: () => Promise<void>;
+}
+/**
+ * Configuration for the API route handlers.
+ */
+export interface CasHandlerConfig {
+    /** Server-side CAS configuration. */
+    cas: CasServerConfig;
+    /**
+     * URL to redirect to after successful login callback.
+     * @default '/'
+     */
+    afterLoginUrl?: string;
+    /**
+     * URL to redirect to after logout.
+     * @default '/'
+     */
+    afterLogoutUrl?: string;
+}
+/**
+ * Response shape returned by `POST {CAS_BASE}/api/validate-token`.
+ * Success: `{ valid: true, user: { id, username, email }, expires_at }`.
+ * Failure: HTTP 401 with `{ error }`.
+ * @internal
+ */
+export interface CasValidateResponse {
+    valid?: boolean;
+    user?: CasUser;
+    expires_at?: string;
+    error?: string;
+}
+/**
+ * Response shape returned by `POST {CAS_BASE}/api/sso/token`.
+ * Success: `{ redirect_url, token }`.
+ * @internal
+ */
+export interface CasTokenResponse {
+    redirect_url?: string;
+    token?: string;
+    error?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,SAAS;IACxB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;IAElB,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAgB,SAAQ,SAAS;IAChD,0EAA0E;IAC1E,YAAY,EAAE,MAAM,CAAC;CACtB;AAMD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,OAAO;IACtB,qCAAqC;IACrC,EAAE,EAAE,MAAM,CAAC;IAEX,sBAAsB;IACtB,QAAQ,EAAE,MAAM,CAAC;IAEjB,sBAAsB;IACtB,KAAK,EAAE,MAAM,CAAC;IAEd,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAMD;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,8BAA8B;IAC9B,IAAI,EAAE,OAAO,CAAC;IAEd,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IAEd,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;CACnB;AAMD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB;AAMD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,IAAI,EAAE,OAAO,GAAG,IAAI,CAAC;IAErB,6DAA6D;IAC7D,SAAS,EAAE,OAAO,CAAC;IAEnB,0CAA0C;IAC1C,eAAe,EAAE,OAAO,CAAC;IAEzB,iDAAiD;IACjD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAEpB,kDAAkD;IAClD,KAAK,EAAE,CAAC,SAAS,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAEpC,oDAAoD;IACpD,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B,4CAA4C;IAC5C,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAMD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,GAAG,EAAE,eAAe,CAAC;IAErB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/types.js

@@ -0,0 +1,6 @@
+/**
+ * @module @cas-system/nextjs-cas-client/types
+ * @description Core TypeScript type definitions for the CAS Client SDK.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/package.json

@@ -0,0 +1,73 @@
+{
+  "name": "@cas-system/nextjs-cas-client",
+  "version": "1.0.0",
+  "description": "Next.js CAS (Central Authentication System) Client SDK \u2014 App Router, Server Components, Middleware, and Client Hooks",
+  "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"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.mjs",
+      "require": "./dist/server/index.js"
+    },
+    "./middleware": {
+      "types": "./dist/middleware.d.ts",
+      "import": "./dist/middleware.mjs",
+      "require": "./dist/middleware.js"
+    },
+    "./handlers": {
+      "types": "./dist/handlers/index.d.ts",
+      "import": "./dist/handlers/index.mjs",
+      "require": "./dist/handlers/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "next": ">=14",
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^18.0.0",
+    "next": "^14.0.0",
+    "react": "^18.0.0",
+    "react-dom": "^18.0.0",
+    "typescript": "^5.0.0"
+  },
+  "keywords": [
+    "nextjs",
+    "cas",
+    "sso",
+    "authentication",
+    "central-authentication",
+    "app-router",
+    "server-components",
+    "middleware"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/InSol-2021/one-system.git",
+    "directory": "packages/nextjs-cas-client"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}