@codeleap/auth 6.3.0 → 7.0.0

package/dist/AuthErrors/data.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Baseline error-code-to-message map shared across all apps.
+ * `social` keys are intentionally null — canceled/unspecified social flows are silently swallowed rather than surfaced to the user.
+ */
+export declare const DEFAULT_AUTH_ERRORS: {
+    'auth/wrong-password': string;
+    'auth/not-registered': string;
+    'auth/requires-recent-login': string;
+    'auth/invalid-login-credentials': string;
+    'auth/too-many-requests': string;
+    'auth/email-in-use': string;
+    'auth/email-not-found': string;
+    'auth/email-already-in-use': string;
+    'auth/invalid-email': string;
+    'auth/user-disabled': string;
+    'auth/user-not-found': string;
+    'auth/missing-email': string;
+    social: {
+        '12501': null;
+        EUNSPECIFIED: null;
+        'facebook-login-canceled': null;
+        '-5': null;
+        '1001': null;
+    };
+};
+//# sourceMappingURL=data.d.ts.map

package/dist/AuthErrors/data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data.d.ts","sourceRoot":"","sources":["../../src/AuthErrors/data.ts"],"names":[],"mappings":"AACA;;;GAGG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;CAqB/B,CAAA"}

package/dist/AuthErrors/index.d.ts

@@ -0,0 +1,51 @@
+import { AnyFunction } from '@codeleap/types';
+import { DEFAULT_AUTH_ERRORS } from './data';
+import { DefaultAuthError, Err, TAuthError } from './types';
+export * from './types';
+/** Internal Error subclass that carries a typed `code` alongside the human-readable `msg` factory; not exported — consumers interact through `AppAuthErrors`. */
+declare class AuthError extends Error {
+    code: TAuthError['code'];
+    msg: TAuthError['msg'];
+    constructor(message: TAuthError['msg'], code: TAuthError['code']);
+}
+type ErrorHandler<E> = (err: E | null, module?: string, args?: any) => void;
+/**
+ * Registry that merges app-specific error codes with the built-in defaults and wires them to a single `onError` handler.
+ * Social errors are kept in a separate namespace because their codes can collide with base error codes (e.g. numeric strings).
+ */
+export declare class AppAuthErrors<T extends Record<string, string | object | AnyFunction>, F extends ErrorHandler<AuthError>> {
+    errors: Omit<Record<keyof T | keyof typeof DEFAULT_AUTH_ERRORS, AuthError>, 'social'>;
+    social: Omit<Record<keyof T['social'] | keyof typeof DEFAULT_AUTH_ERRORS['social'], AuthError>, 'social'>;
+    onError: ErrorHandler<Err>;
+    defaultErrors: {
+        'auth/wrong-password': string;
+        'auth/not-registered': string;
+        'auth/requires-recent-login': string;
+        'auth/invalid-login-credentials': string;
+        'auth/too-many-requests': string;
+        'auth/email-in-use': string;
+        'auth/email-not-found': string;
+        'auth/email-already-in-use': string;
+        'auth/invalid-email': string;
+        'auth/user-disabled': string;
+        'auth/user-not-found': string;
+        'auth/missing-email': string;
+        social: {
+            '12501': null;
+            EUNSPECIFIED: null;
+            'facebook-login-canceled': null;
+            '-5': null;
+            '1001': null;
+        };
+    };
+    private socialKey;
+    constructor(newErrors: T, errorFunction: F);
+    getError(err: Err): AuthError | null;
+    isError(err: Err, key: Exclude<keyof T | DefaultAuthError, 'social'>): boolean;
+    verifyError(err: Err): boolean;
+    exception(err: Err): void | AuthError;
+    createAuthError(message: TAuthError['msg'], code: TAuthError['code']): AuthError;
+    private registryErrors;
+    private registryErrorFunction;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/AuthErrors/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAA;AAC5C,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAE3D,cAAc,SAAS,CAAA;AAEvB,iKAAiK;AACjK,cAAM,SAAU,SAAQ,KAAK;IAC3B,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAA;IACxB,GAAG,EAAE,UAAU,CAAC,KAAK,CAAC,CAAA;gBAEV,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC;CAOjE;AAED,KAAK,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,IAAI,CAAA;AAE3E;;;GAGG;AACH,qBAAa,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,WAAW,CAAC,EAAE,CAAC,SAAS,YAAY,CAAC,SAAS,CAAC;IAC5G,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,OAAO,mBAAmB,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAA;IAErF,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,GAAG,MAAM,OAAO,mBAAmB,CAAC,QAAQ,CAAC,EAAE,SAAS,CAAC,EAAE,QAAQ,CAAC,CAAA;IAEzG,OAAO,EAAG,YAAY,CAAC,GAAG,CAAC,CAAA;IAE3B,aAAa;;;;;;;;;;;;;;;;;;;;MAAsB;IAE1C,OAAO,CAAC,SAAS,CAAmB;gBAExB,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC;IA8BnC,QAAQ,CAAC,GAAG,EAAE,GAAG,GAAG,SAAS,GAAG,IAAI;IAgBpC,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,gBAAgB,EAAE,QAAQ,CAAC;IAMpE,WAAW,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO;IAI9B,SAAS,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,GAAG,SAAS;IAQrC,eAAe,CAAC,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC;IAI3E,OAAO,CAAC,cAAc;IAgBtB,OAAO,CAAC,qBAAqB;CAM9B"}

package/dist/AuthErrors/types.d.ts

@@ -0,0 +1,11 @@
+import { DEFAULT_AUTH_ERRORS } from './data';
+/** Shape of a resolved auth error — a string error code paired with a lazily-evaluated message factory. */
+export type TAuthError = {
+    code: string;
+    msg: (args?: any) => string | null;
+};
+/** Union of all values accepted as an error argument; unknown allows catch-block values to be passed without casting. */
+export type Err = TAuthError | null | string | unknown;
+/** Union of the built-in error code keys, used to constrain look-ups to known defaults. */
+export type DefaultAuthError = keyof typeof DEFAULT_AUTH_ERRORS;
+//# sourceMappingURL=types.d.ts.map

package/dist/AuthErrors/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/AuthErrors/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,QAAQ,CAAA;AAE5C,2GAA2G;AAC3G,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,MAAM,GAAG,IAAI,CAAA;CACnC,CAAA;AAED,yHAAyH;AACzH,MAAM,MAAM,GAAG,GAAG,UAAU,GAAG,IAAI,GAAG,MAAM,GAAG,OAAO,CAAA;AAEtD,2FAA2F;AAC3F,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,mBAAmB,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './AuthErrors';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAA"}

package/package.json

@@ -1,7 +1,20 @@
 {
   "name": "@codeleap/auth",
-  "version": "6.3.0",
+  "version": "7.0.0",
   "main": "src/index.ts",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
   "license": "UNLICENSED",
   "repository": {
     "url": "https://github.com/codeleap-uk/internal-libs-monorepo.git",
@@ -9,15 +22,16 @@
     "directory": "packages/auth"
   },
   "devDependencies": {
-    "@codeleap/config": "6.3.0",
-    "@codeleap/types": "6.3.0",
+    "@codeleap/config": "7.0.0",
+    "@codeleap/types": "7.0.0",
     "ts-node-dev": "1.1.8"
   },
   "scripts": {
-    "build": "echo 'No build needed'"
+    "build": "tsc --build tsconfig.build.json",
+    "typecheck": "bun tsc --noEmit -p ./tsconfig.json"
   },
   "peerDependencies": {
-    "@codeleap/types": "6.3.0",
+    "@codeleap/types": "7.0.0",
     "typescript": "5.5.2"
   }
-}
+}

package/src/AuthErrors/data.ts

@@ -1,4 +1,8 @@
 
+/**
+ * Baseline error-code-to-message map shared across all apps.
+ * `social` keys are intentionally null — canceled/unspecified social flows are silently swallowed rather than surfaced to the user.
+ */
 export const DEFAULT_AUTH_ERRORS = {
   'auth/wrong-password': 'Email or password is incorrect',
   'auth/not-registered': 'This user is not registered',

package/src/AuthErrors/index.ts

@@ -4,6 +4,7 @@ import { DefaultAuthError, Err, TAuthError } from './types'
 
 export * from './types'
 
+/** Internal Error subclass that carries a typed `code` alongside the human-readable `msg` factory; not exported — consumers interact through `AppAuthErrors`. */
 class AuthError extends Error {
   code: TAuthError['code']
   msg: TAuthError['msg']
@@ -19,12 +20,16 @@ class AuthError extends Error {
 
 type ErrorHandler<E> = (err: E | null, module?: string, args?: any) => void
 
+/**
+ * Registry that merges app-specific error codes with the built-in defaults and wires them to a single `onError` handler.
+ * Social errors are kept in a separate namespace because their codes can collide with base error codes (e.g. numeric strings).
+ */
 export class AppAuthErrors<T extends Record<string, string | object | AnyFunction>, F extends ErrorHandler<AuthError>> {
   public errors: Omit<Record<keyof T | keyof typeof DEFAULT_AUTH_ERRORS, AuthError>, 'social'>
 
   public social: Omit<Record<keyof T['social'] | keyof typeof DEFAULT_AUTH_ERRORS['social'], AuthError>, 'social'>
 
-  public onError: ErrorHandler<Err>
+  public onError!: ErrorHandler<Err>
 
   public defaultErrors = DEFAULT_AUTH_ERRORS
 
@@ -34,7 +39,7 @@ export class AppAuthErrors<T extends Record<string, string | object | AnyFunctio
     const defaultErrors = DEFAULT_AUTH_ERRORS
     
     const socialAuthErrors = {
-      ...defaultErrors[this.socialKey],
+      ...(defaultErrors as Record<string, any>)[this.socialKey],
       ...(newErrors?.[this.socialKey] as object ?? {}),
     } as any
 
@@ -45,8 +50,8 @@ export class AppAuthErrors<T extends Record<string, string | object | AnyFunctio
       delete newErrors['social']
     }
 
-    if (!!defaultErrors['social']) {
-      delete defaultErrors['social']
+    if (!!(defaultErrors as Record<string, any>)['social']) {
+      (defaultErrors as Record<string, any>)['social'] = undefined
     }
 
     const baseAuthErrors = {
@@ -64,13 +69,13 @@ export class AppAuthErrors<T extends Record<string, string | object | AnyFunctio
     if (!err) return null
 
     if (typeof err == 'string') {
-      return this.errors?.[err] ?? this.social?.[err]
+      return (this.errors as Record<string, AuthError>)?.[err] ?? (this.social as Record<string, AuthError>)?.[err]
     }
 
     const authError = err as TAuthError
 
     if (!!authError?.code) {
-      return this.errors?.[authError?.code] ?? this.social?.[authError?.code]
+      return (this.errors as Record<string, AuthError>)?.[authError?.code] ?? (this.social as Record<string, AuthError>)?.[authError?.code]
     }
 
     return null
@@ -99,10 +104,10 @@ export class AppAuthErrors<T extends Record<string, string | object | AnyFunctio
   }
 
   private registryErrors(unregisteredErrors: T): any {
-    const state = {}
+    const state: Record<string, AuthError> = {}
 
     for (const errorKey in (unregisteredErrors as object)) {
-      const errorMsg = unregisteredErrors[errorKey] as string
+      const errorMsg = (unregisteredErrors as Record<string, any>)[errorKey] as string
 
       if (typeof errorMsg === 'string' || errorMsg == null) {
         state[errorKey] = new AuthError(() => errorMsg, errorKey)
@@ -115,7 +120,7 @@ export class AppAuthErrors<T extends Record<string, string | object | AnyFunctio
   }
 
   private registryErrorFunction(pureErrorFunction: Function) {
-    this.onError = (err, module = null, args = {}) => {
+    this.onError = (err, module = undefined, args = {}) => {
       const authError = this.getError(err)
       pureErrorFunction?.(authError, module, args)
     }

package/src/AuthErrors/types.ts

@@ -1,10 +1,13 @@
 import { DEFAULT_AUTH_ERRORS } from './data'
 
+/** Shape of a resolved auth error — a string error code paired with a lazily-evaluated message factory. */
 export type TAuthError = {
   code: string
   msg: (args?: any) => string | null
 }
 
+/** Union of all values accepted as an error argument; unknown allows catch-block values to be passed without casting. */
 export type Err = TAuthError | null | string | unknown
 
+/** Union of the built-in error code keys, used to constrain look-ups to known defaults. */
 export type DefaultAuthError = keyof typeof DEFAULT_AUTH_ERRORS

package/package.json.bak

@@ -1,23 +0,0 @@
-{
-  "name": "@codeleap/auth",
-  "version": "6.3.0",
-  "main": "src/index.ts",
-  "license": "UNLICENSED",
-  "repository": {
-    "url": "https://github.com/codeleap-uk/internal-libs-monorepo.git",
-    "type": "git",
-    "directory": "packages/auth"
-  },
-  "devDependencies": {
-    "@codeleap/config": "workspace:*",
-    "@codeleap/types": "workspace:*",
-    "ts-node-dev": "1.1.8"
-  },
-  "scripts": {
-    "build": "echo 'No build needed'"
-  },
-  "peerDependencies": {
-    "@codeleap/types": "workspace:*",
-    "typescript": "5.5.2"
-  }
-}