@auth0/auth0-acul-react 1.0.0-alpha.0

package/dist/state/error-store.d.ts

@@ -0,0 +1,47 @@
+import type { Error as Auth0Error } from '@auth0/auth0-acul-js';
+export interface ErrorItem extends Auth0Error {
+    id: string;
+    label?: string;
+    kind?: ErrorKind;
+}
+export type ErrorKind = 'server' | 'client' | 'developer';
+export declare const ERROR_KINDS: ErrorKind[];
+type Bucket = {
+    server: ReadonlyArray<ErrorItem>;
+    client: ReadonlyArray<ErrorItem>;
+    developer: ReadonlyArray<ErrorItem>;
+};
+type Listener = () => void;
+/**
+ * Global error store for ACUL (one screen per page).
+ * - Holds a single bucket of errors across the current page.
+ * - Generates stable ids for every inserted error.
+ * - Emits immutable snapshots to subscribers.
+ */
+declare class ErrorStore {
+    private bucket;
+    private listeners;
+    subscribe(cb: Listener): () => void;
+    snapshot(): Readonly<Bucket>;
+    /** Add ids and freeze an array of ErrorItem-like objects. */
+    private normalize;
+    /** Replace an entire kind with a new list (generating ids if needed). */
+    replace(kind: ErrorKind, list: Array<Omit<ErrorItem, 'id'> | ErrorItem>): void;
+    /**
+     * Replace only errors for a specific field within a kind.
+     * - Keeps all existing errors for other fields.
+     * - Normalizes incoming errors and replaces matching field ones.
+     */
+    replacePartial(kind: ErrorKind, list: Array<Omit<ErrorItem, 'id'> | ErrorItem>, field: string): void;
+    /** Append one or more items to a kind. */
+    push(kind: ErrorKind, list: Omit<ErrorItem, 'id'> | ErrorItem | Array<Omit<ErrorItem, 'id'> | ErrorItem>): void;
+    /** Clear one or more kinds (default: all kinds). */
+    clear(kinds?: ErrorKind[]): void;
+    /**
+     * Remove errors that match a given id or predicate from specified kinds.
+     */
+    remove(kinds: ErrorKind[] | undefined, test: string | ((e: ErrorItem) => boolean)): void;
+    private notify;
+}
+export declare const errorStore: ErrorStore;
+export {};

package/dist/state/error-store.js

@@ -0,0 +1,2 @@
+const e=["server","client","developer"];function t(e,t){if(e===t)return!0;if(e.length!==t.length)return!1;for(let r=0;r<e.length;r++)if(e[r].id!==t[r].id)return!1;return!0}const r=Object.freeze({server:Object.freeze([]),client:Object.freeze([]),developer:Object.freeze([])});let s=0;const i=new class{constructor(){this.bucket=r,this.listeners=new Set}subscribe(e){return this.listeners.add(e),()=>this.listeners.delete(e)}snapshot(){return this.bucket}normalize(e){return Object.freeze(e.map(e=>Object.freeze({...e,id:e.id??`${Date.now()}-${s++}`})))}replace(e,r){const s=this.normalize(r);t(this.bucket[e],s)||(this.bucket=Object.freeze({...this.bucket,[e]:s}),this.notify())}replacePartial(e,r,s){const i=this.normalize(r),c=this.bucket[e].filter(e=>e.field!==s),n=Object.freeze([...c,...i]);t(this.bucket[e],n)||(this.bucket=Object.freeze({...this.bucket,[e]:n}),this.notify())}push(e,t){const r=Array.isArray(t)?t:[t];if(0===r.length)return;const s=Object.freeze([...this.bucket[e],...this.normalize(r)]);this.bucket=Object.freeze({...this.bucket,[e]:s}),this.notify()}clear(t=e){let r=!1;const s={...this.bucket};for(const e of t)this.bucket[e].length>0&&(s[e]=Object.freeze([]),r=!0);r&&(this.bucket=Object.freeze(s),this.notify())}remove(t=e,r){const s="string"==typeof r?e=>e.id===r:r;let i=!1;const c={...this.bucket};for(const e of t){const t=this.bucket[e].filter(e=>!s(e));t.length!==this.bucket[e].length&&(c[e]=Object.freeze(t),i=!0)}i&&(this.bucket=Object.freeze(c),this.notify())}notify(){for(const e of this.listeners)e()}};export{e as ERROR_KINDS,i as errorStore};
+//# sourceMappingURL=error-store.js.map

package/dist/state/error-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-store.js","sources":["../../src/state/error-store.ts"],"sourcesContent":["import type { Error as Auth0Error } from '@auth0/auth0-acul-js';\n\nexport interface ErrorItem extends Auth0Error {\n  id: string;\n  label?: string;\n  kind?: ErrorKind;\n}\n\nexport type ErrorKind = 'server' | 'client' | 'developer';\n\nexport const ERROR_KINDS: ErrorKind[] = ['server', 'client', 'developer'];\n\ntype Bucket = {\n  server: ReadonlyArray<ErrorItem>;\n  client: ReadonlyArray<ErrorItem>;\n  developer: ReadonlyArray<ErrorItem>;\n};\n\ntype Listener = () => void;\n\n/** Compare two error lists by id only for maximal speed. */\nfunction listsEqual(a: ReadonlyArray<ErrorItem>, b: ReadonlyArray<ErrorItem>) {\n  if (a === b) return true;\n  if (a.length !== b.length) return false;\n  for (let i = 0; i < a.length; i++) {\n    if (a[i].id !== b[i].id) return false;\n  }\n  return true;\n}\n\nconst EMPTY_BUCKET: Bucket = Object.freeze({\n  server: Object.freeze([]),\n  client: Object.freeze([]),\n  developer: Object.freeze([]),\n});\n\nlet nextId = 0;\nconst genId = () => `${Date.now()}-${nextId++}`;\n\n/**\n * Global error store for ACUL (one screen per page).\n * - Holds a single bucket of errors across the current page.\n * - Generates stable ids for every inserted error.\n * - Emits immutable snapshots to subscribers.\n */\nclass ErrorStore {\n  private bucket: Bucket = EMPTY_BUCKET;\n  private listeners: Set<Listener> = new Set();\n\n  subscribe(cb: Listener): () => void {\n    this.listeners.add(cb);\n    return () => this.listeners.delete(cb);\n  }\n\n  snapshot(): Readonly<Bucket> {\n    return this.bucket;\n  }\n\n  /** Add ids and freeze an array of ErrorItem-like objects. */\n  private normalize(\n    list: Array<Omit<ErrorItem, 'id'> & { id?: string }>\n  ): ReadonlyArray<ErrorItem> {\n    return Object.freeze(\n      list.map((e) =>\n        Object.freeze({\n          ...e,\n          id: e.id ?? genId(),\n        })\n      )\n    );\n  }\n\n  /** Replace an entire kind with a new list (generating ids if needed). */\n  replace(kind: ErrorKind, list: Array<Omit<ErrorItem, 'id'> | ErrorItem>) {\n    const nextList = this.normalize(list);\n    if (listsEqual(this.bucket[kind], nextList)) return;\n\n    this.bucket = Object.freeze({\n      ...this.bucket,\n      [kind]: nextList,\n    });\n    this.notify();\n  }\n\n  /**\n   * Replace only errors for a specific field within a kind.\n   * - Keeps all existing errors for other fields.\n   * - Normalizes incoming errors and replaces matching field ones.\n   */\n  replacePartial(kind: ErrorKind, list: Array<Omit<ErrorItem, 'id'> | ErrorItem>, field: string) {\n    const incoming = this.normalize(list);\n    const existing = this.bucket[kind].filter((e) => e.field !== field);\n    const nextKindList = Object.freeze([...existing, ...incoming]);\n\n    if (listsEqual(this.bucket[kind], nextKindList)) return;\n\n    this.bucket = Object.freeze({\n      ...this.bucket,\n      [kind]: nextKindList,\n    });\n    this.notify();\n  }\n\n  /** Append one or more items to a kind. */\n  push(\n    kind: ErrorKind,\n    list: Omit<ErrorItem, 'id'> | ErrorItem | Array<Omit<ErrorItem, 'id'> | ErrorItem>\n  ) {\n    const arr = Array.isArray(list) ? list : [list];\n    if (arr.length === 0) return;\n\n    const nextKindList = Object.freeze([...this.bucket[kind], ...this.normalize(arr)]);\n    this.bucket = Object.freeze({\n      ...this.bucket,\n      [kind]: nextKindList,\n    });\n    this.notify();\n  }\n\n  /** Clear one or more kinds (default: all kinds). */\n  clear(kinds: ErrorKind[] = ERROR_KINDS) {\n    let changed = false;\n    const next: Bucket = { ...this.bucket };\n\n    for (const k of kinds) {\n      if (this.bucket[k].length > 0) {\n        next[k] = Object.freeze([]);\n        changed = true;\n      }\n    }\n\n    if (!changed) return;\n    this.bucket = Object.freeze(next);\n    this.notify();\n  }\n\n  /**\n   * Remove errors that match a given id or predicate from specified kinds.\n   */\n  remove(kinds: ErrorKind[] = ERROR_KINDS, test: string | ((e: ErrorItem) => boolean)) {\n    const isMatch = typeof test === 'string' ? (e: ErrorItem) => e.id === test : test;\n\n    let changed = false;\n    const next: Bucket = { ...this.bucket };\n\n    for (const k of kinds) {\n      const filtered = this.bucket[k].filter((e) => !isMatch(e));\n      if (filtered.length !== this.bucket[k].length) {\n        next[k] = Object.freeze(filtered);\n        changed = true;\n      }\n    }\n\n    if (!changed) return;\n    this.bucket = Object.freeze(next);\n    this.notify();\n  }\n\n  private notify() {\n    for (const cb of this.listeners) cb();\n  }\n}\n\nexport const errorStore = new ErrorStore();\n"],"names":["ERROR_KINDS","listsEqual","a","b","length","i","id","EMPTY_BUCKET","Object","freeze","server","client","developer","nextId","errorStore","constructor","this","bucket","listeners","Set","subscribe","cb","add","delete","snapshot","normalize","list","map","e","Date","now","replace","kind","nextList","notify","replacePartial","field","incoming","existing","filter","nextKindList","push","arr","Array","isArray","clear","kinds","changed","next","k","remove","test","isMatch","filtered"],"mappings":"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"}

package/dist/state/instance-store.d.ts

@@ -0,0 +1,19 @@
+type ScreenConstructor<T> = {
+    new (): T;
+    screenIdentifier: string;
+};
+/**
+ * Register a screen class. If its identifier matches the current screen,
+ * instantiate it immediately and store as the singleton.
+ * Returns the instance if created, or null otherwise.
+ */
+export declare function registerScreen<T>(Constructor: ScreenConstructor<T>): T | null;
+/**
+ * Get the current screen instance (throws if not initialized).
+ */
+export declare function getScreen<T>(): T;
+/**
+ * Clear the current instance.
+ */
+export declare function clearScreen(): void;
+export {};

package/dist/state/instance-store.js

@@ -0,0 +1,2 @@
+import{getCurrentScreenOptions as e}from"@auth0/auth0-acul-js";let n=null;function r(r){const t=e();return t.screen?.name===r.screenIdentifier?(n||(n=new r),n):null}function t(){if(!n)throw new Error("No active screen instance has been initialized");return n}export{t as getScreen,r as registerScreen};
+//# sourceMappingURL=instance-store.js.map

package/dist/state/instance-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instance-store.js","sources":["../../src/state/instance-store.ts"],"sourcesContent":["import { getCurrentScreenOptions } from '@auth0/auth0-acul-js';\n\nlet instance: unknown = null;\n\ntype ScreenConstructor<T> = { new (): T; screenIdentifier: string };\n\n/**\n * Register a screen class. If its identifier matches the current screen,\n * instantiate it immediately and store as the singleton.\n * Returns the instance if created, or null otherwise.\n */\nexport function registerScreen<T>(Constructor: ScreenConstructor<T>): T | null {\n  const current = getCurrentScreenOptions();\n\n  if (current.screen?.name === Constructor.screenIdentifier) {\n    if (!instance) {\n      instance = new Constructor();\n    }\n    return instance as T;\n  }\n\n  // Not the active screen, just ignore\n  return null;\n}\n\n/**\n * Get the current screen instance (throws if not initialized).\n */\nexport function getScreen<T>(): T {\n  if (!instance) {\n    throw new Error('No active screen instance has been initialized');\n  }\n  return instance as T;\n}\n\n/**\n * Clear the current instance.\n */\nexport function clearScreen(): void {\n  instance = null;\n}\n"],"names":["instance","registerScreen","Constructor","current","getCurrentScreenOptions","screen","name","screenIdentifier","getScreen","Error"],"mappings":"+DAEA,IAAIA,EAAoB,KASlB,SAAUC,EAAkBC,GAChC,MAAMC,EAAUC,IAEhB,OAAID,EAAQE,QAAQC,OAASJ,EAAYK,kBAClCP,IACHA,EAAW,IAAIE,GAEVF,GAIF,IACT,UAKgBQ,IACd,IAAKR,EACH,MAAM,IAAIS,MAAM,kDAElB,OAAOT,CACT"}

package/dist/telemetry.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Telemetry initialization for Auth0 ACUL React SDK
+ *
+ * Sets global telemetry values that the Core SDK will use at runtime.
+ * This must run BEFORE any Core SDK screens are imported.
+ *
+ * Note: __SDK_NAME__ and __SDK_VERSION__ are replaced at build time by rollup
+ */

package/dist/telemetry.js

@@ -0,0 +1,2 @@
+globalThis.__ACUL_SDK_NAME__="@auth0/auth0-acul-react",globalThis.__ACUL_SDK_VERSION__="1.0.0-alpha.0";
+//# sourceMappingURL=telemetry.js.map

package/dist/telemetry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.js","sources":["../src/telemetry.ts"],"sourcesContent":["/**\n * Telemetry initialization for Auth0 ACUL React SDK\n *\n * Sets global telemetry values that the Core SDK will use at runtime.\n * This must run BEFORE any Core SDK screens are imported.\n *\n * Note: __SDK_NAME__ and __SDK_VERSION__ are replaced at build time by rollup\n */\n\n// Set global telemetry values for Core SDK to pick up\n// eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access\n(globalThis as any).__ACUL_SDK_NAME__ = __SDK_NAME__;\n// eslint-disable-next-line @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-member-access\n(globalThis as any).__ACUL_SDK_VERSION__ = __SDK_VERSION__;\n"],"names":["globalThis","__ACUL_SDK_NAME__","__ACUL_SDK_VERSION__"],"mappings":"AAWCA,WAAmBC,kBAAoB,0BAEvCD,WAAmBE,qBAAuB"}

package/dist/types/index.d.ts

@@ -0,0 +1,2 @@
+export type * from '@auth0/auth0-acul-js/types';
+export type * from '../hooks';

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@auth0/auth0-acul-react",
+  "version": "1.0.0-alpha.0",
+  "main": "dist/index.js",
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "npm run clean && npm run lint && npm run test && rollup -c rollup.config.mjs",
+    "clean": "rm -rf dist",
+    "test": "jest --verbose tests/**/* --coverage",
+    "generate:sdk": "tsx ./scripts/generate-sdk/index.ts",
+    "generate:examples": "tsx ./scripts/generate-examples.ts",
+    "generate:screen-tests": "tsx ./scripts/generate-screen-tests.ts",
+    "lint": "eslint src --ext .ts,.tsx",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix",
+    "docs": "typedoc --options typedoc.js",
+    "postbuild": "npm run docs"
+  },
+  "author": "Auth0",
+  "license": "MIT",
+  "description": "The Auth0 ACUL React SDK enables you to build Advanced Customization for Universal Login with React hooks and components.",
+  "repository": {
+    "type": "git"
+  },
+  "peerDependencies": {
+    "react": "^18.3.1"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts"
+    },
+    "./*": {
+      "import": "./dist/screens/*.js",
+      "types": "./dist/screens/*.d.ts"
+    }
+  },
+  "devDependencies": {
+    "@rollup/plugin-replace": "^6.0.2",
+    "@testing-library/jest-dom": "^6.0.0",
+    "@testing-library/react": "^14.0.0",
+    "@types/react": "^18.3.24",
+    "eslint-plugin-react": "^7.37.5",
+    "ts-node": "^10.9.2"
+  },
+  "dependencies": {
+    "@auth0/auth0-acul-js": "1.0.0-alpha.0"
+  },
+  "files": [
+    "dist",
+    "package.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}