@susilkumar006/widgets-test 1.0.0

package/dist/types/provider.d.cts

@@ -0,0 +1,75 @@
+/**
+ * Contracts of the provider: what the host passes in, and what components
+ * read back through `useFacePe()`.
+ */
+import type { ReactNode } from 'react';
+import type { FacePeProviderEvents, FacePeTokenProvider } from './api.cjs';
+import type { FacePeConfig } from './config.cjs';
+import type { FacePeEvent, FacePeEventHandler } from './events.cjs';
+import type { FacePeColorScheme, FacePeThemeTokens } from './placement.cjs';
+import type { FacePeTelemetry } from './telemetry.cjs';
+/**
+ * Props of `<FacePeProvider>`.
+ *
+ * `config` is per-component configuration. The rest are SDK-wide settings for
+ * this provider only — two providers on one page each have their own.
+ */
+export interface FacePeProviderProps {
+    /** Shared configuration for every FacePe component below the provider. Passed through unchanged. */
+    readonly config: FacePeConfig;
+    readonly children?: ReactNode;
+    /**
+     * Base URL of the FacePe API, e.g. "https://api.example.com/api/v1".
+     * @default none: API requests fail with `API_NOT_CONFIGURED`
+     */
+    readonly apiBaseUrl?: string;
+    /**
+     * Supplies the bearer token for API requests. Asked again, with
+     * `forceRefresh: true`, after a 401. Implement it by calling YOUR server,
+     * which exchanges the user's access key + secret key at
+     * `POST /api/v1/sdk/token` — the secret key must never be in browser code.
+     * @default none: requests are sent without an Authorization header
+     */
+    readonly getToken?: FacePeTokenProvider;
+    /**
+     * The avatar_id `<FacePeAvatar>` uses unless it is given its own. It must be
+     * assigned to the user whose keys the host uses. @default none
+     */
+    readonly avatarId?: string;
+    /** Per-attempt request timeout in milliseconds. @default 15000 */
+    readonly requestTimeoutMs?: number;
+    /**
+     * The backend refused a request even with a freshly fetched token: the
+     * host should sign the user in again.
+     */
+    readonly onSessionExpired?: FacePeEventHandler<FacePeEvent<'sessionExpired', FacePeProviderEvents['sessionExpired']>>;
+    /**
+     * Every navigation request from any component below this provider, so the
+     * host wires its router once. Receives the component's own event (its
+     * `source` names the component). The SDK never changes the URL itself.
+     */
+    readonly onNavigate?: FacePeEventHandler<FacePeEvent<'navigate', FacePeProviderEvents['navigate']>>;
+    /** Design tokens (customization rung L1). @default none: styles inherit from the host */
+    readonly theme?: FacePeThemeTokens;
+    /**
+     * The second token scheme, for dark mode (§7.1): used instead of `theme`
+     * (falling back to it per token) while `colorScheme` is `'dark'`.
+     * @default none
+     */
+    readonly darkTheme?: FacePeThemeTokens;
+    /**
+     * Which token scheme is active. The host switches it; the components never
+     * read the system preference themselves. @default 'light'
+     */
+    readonly colorScheme?: FacePeColorScheme;
+    /**
+     * Receives a record of every component event and API call below this
+     * provider, stamped with the SDK version. @default none: nothing is sent
+     */
+    readonly telemetry?: FacePeTelemetry;
+}
+/** What `useFacePe()` returns. */
+export interface FacePeContextValue {
+    /** The configuration given to the nearest `<FacePeProvider>`, exactly as passed. */
+    readonly config: FacePeConfig;
+}

package/dist/types/provider.d.ts

@@ -0,0 +1,75 @@
+/**
+ * Contracts of the provider: what the host passes in, and what components
+ * read back through `useFacePe()`.
+ */
+import type { ReactNode } from 'react';
+import type { FacePeProviderEvents, FacePeTokenProvider } from './api.js';
+import type { FacePeConfig } from './config.js';
+import type { FacePeEvent, FacePeEventHandler } from './events.js';
+import type { FacePeColorScheme, FacePeThemeTokens } from './placement.js';
+import type { FacePeTelemetry } from './telemetry.js';
+/**
+ * Props of `<FacePeProvider>`.
+ *
+ * `config` is per-component configuration. The rest are SDK-wide settings for
+ * this provider only — two providers on one page each have their own.
+ */
+export interface FacePeProviderProps {
+    /** Shared configuration for every FacePe component below the provider. Passed through unchanged. */
+    readonly config: FacePeConfig;
+    readonly children?: ReactNode;
+    /**
+     * Base URL of the FacePe API, e.g. "https://api.example.com/api/v1".
+     * @default none: API requests fail with `API_NOT_CONFIGURED`
+     */
+    readonly apiBaseUrl?: string;
+    /**
+     * Supplies the bearer token for API requests. Asked again, with
+     * `forceRefresh: true`, after a 401. Implement it by calling YOUR server,
+     * which exchanges the user's access key + secret key at
+     * `POST /api/v1/sdk/token` — the secret key must never be in browser code.
+     * @default none: requests are sent without an Authorization header
+     */
+    readonly getToken?: FacePeTokenProvider;
+    /**
+     * The avatar_id `<FacePeAvatar>` uses unless it is given its own. It must be
+     * assigned to the user whose keys the host uses. @default none
+     */
+    readonly avatarId?: string;
+    /** Per-attempt request timeout in milliseconds. @default 15000 */
+    readonly requestTimeoutMs?: number;
+    /**
+     * The backend refused a request even with a freshly fetched token: the
+     * host should sign the user in again.
+     */
+    readonly onSessionExpired?: FacePeEventHandler<FacePeEvent<'sessionExpired', FacePeProviderEvents['sessionExpired']>>;
+    /**
+     * Every navigation request from any component below this provider, so the
+     * host wires its router once. Receives the component's own event (its
+     * `source` names the component). The SDK never changes the URL itself.
+     */
+    readonly onNavigate?: FacePeEventHandler<FacePeEvent<'navigate', FacePeProviderEvents['navigate']>>;
+    /** Design tokens (customization rung L1). @default none: styles inherit from the host */
+    readonly theme?: FacePeThemeTokens;
+    /**
+     * The second token scheme, for dark mode (§7.1): used instead of `theme`
+     * (falling back to it per token) while `colorScheme` is `'dark'`.
+     * @default none
+     */
+    readonly darkTheme?: FacePeThemeTokens;
+    /**
+     * Which token scheme is active. The host switches it; the components never
+     * read the system preference themselves. @default 'light'
+     */
+    readonly colorScheme?: FacePeColorScheme;
+    /**
+     * Receives a record of every component event and API call below this
+     * provider, stamped with the SDK version. @default none: nothing is sent
+     */
+    readonly telemetry?: FacePeTelemetry;
+}
+/** What `useFacePe()` returns. */
+export interface FacePeContextValue {
+    /** The configuration given to the nearest `<FacePeProvider>`, exactly as passed. */
+    readonly config: FacePeConfig;
+}

package/dist/types/results.d.cts

@@ -0,0 +1,28 @@
+/**
+ * Results: what imperative actions resolve to.
+ *
+ * No exception crosses the component boundary. Every imperative action resolves
+ * to a `Result`, and the host branches on `success`.
+ */
+import type { FacePeError } from './common.cjs';
+/** A successful outcome carrying `data`. */
+export interface Success<T> {
+    readonly success: true;
+    readonly data: T;
+}
+/** A failed outcome carrying `error`. */
+export interface Failure<E extends FacePeError = FacePeError> {
+    readonly success: false;
+    readonly error: E;
+}
+/**
+ * Outcome of an action: `Success<T>` or `Failure<E>`, told apart by `success`.
+ *
+ * @example
+ * const result = await handle.validate();
+ * if (result.success) use(result.data);
+ * else report(result.error.code);
+ */
+export type Result<T, E extends FacePeError = FacePeError> = Success<T> | Failure<E>;
+/** A `Result` delivered asynchronously. The promise itself never rejects. */
+export type AsyncResult<T, E extends FacePeError = FacePeError> = Promise<Result<T, E>>;

package/dist/types/results.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Results: what imperative actions resolve to.
+ *
+ * No exception crosses the component boundary. Every imperative action resolves
+ * to a `Result`, and the host branches on `success`.
+ */
+import type { FacePeError } from './common.js';
+/** A successful outcome carrying `data`. */
+export interface Success<T> {
+    readonly success: true;
+    readonly data: T;
+}
+/** A failed outcome carrying `error`. */
+export interface Failure<E extends FacePeError = FacePeError> {
+    readonly success: false;
+    readonly error: E;
+}
+/**
+ * Outcome of an action: `Success<T>` or `Failure<E>`, told apart by `success`.
+ *
+ * @example
+ * const result = await handle.validate();
+ * if (result.success) use(result.data);
+ * else report(result.error.code);
+ */
+export type Result<T, E extends FacePeError = FacePeError> = Success<T> | Failure<E>;
+/** A `Result` delivered asynchronously. The promise itself never rejects. */
+export type AsyncResult<T, E extends FacePeError = FacePeError> = Promise<Result<T, E>>;

package/dist/types/telemetry.d.cts

@@ -0,0 +1,38 @@
+/**
+ * The telemetry contract (architecture §6.1, §6.2): the host supplies the
+ * sink through the provider; the SDK makes no analytics calls of its own.
+ */
+import type { CorrelationId, EntityId } from './common.cjs';
+/** Extra facts about an event. Primitive values only; never user-entered data. */
+export type FacePeTelemetryAttributes = Readonly<Record<string, string | number | boolean>>;
+/**
+ * One telemetry record. Every component event produces one (named after the
+ * event, e.g. `'submit'`), and so does every API call (`'api.request'`).
+ * Event payloads are never included: they can hold what the user typed.
+ */
+export type FacePeTelemetryEvent = {
+    /** The event type (`'ready'`, `'select'`, …) or `'api.request'`. */
+    readonly name: string;
+    /** Who produced it: a component name, or `'FacePeProvider'`. */
+    readonly source: string;
+    /** The same id as the event's `meta.correlationId` / the request's `X-Request-Id`. */
+    readonly correlationId: CorrelationId;
+    /** ISO 8601. */
+    readonly timestamp: string;
+    /** The package version, stamped on every record. */
+    readonly sdkVersion: string;
+    readonly entityId?: EntityId;
+    /**
+     * `api.request`: `method`, `path`, `status` (when a response came back),
+     * `outcome` (`'success'` or the failure code) and `durationMs`.
+     * `error` events: the error `code`. Otherwise absent.
+     */
+    readonly attributes?: FacePeTelemetryAttributes;
+};
+/**
+ * Host-provided telemetry sink. `track` is called synchronously; a sink that
+ * throws is reported and ignored, never breaking the component.
+ */
+export interface FacePeTelemetry {
+    track(event: FacePeTelemetryEvent): void;
+}

package/dist/types/telemetry.d.ts

@@ -0,0 +1,38 @@
+/**
+ * The telemetry contract (architecture §6.1, §6.2): the host supplies the
+ * sink through the provider; the SDK makes no analytics calls of its own.
+ */
+import type { CorrelationId, EntityId } from './common.js';
+/** Extra facts about an event. Primitive values only; never user-entered data. */
+export type FacePeTelemetryAttributes = Readonly<Record<string, string | number | boolean>>;
+/**
+ * One telemetry record. Every component event produces one (named after the
+ * event, e.g. `'submit'`), and so does every API call (`'api.request'`).
+ * Event payloads are never included: they can hold what the user typed.
+ */
+export type FacePeTelemetryEvent = {
+    /** The event type (`'ready'`, `'select'`, …) or `'api.request'`. */
+    readonly name: string;
+    /** Who produced it: a component name, or `'FacePeProvider'`. */
+    readonly source: string;
+    /** The same id as the event's `meta.correlationId` / the request's `X-Request-Id`. */
+    readonly correlationId: CorrelationId;
+    /** ISO 8601. */
+    readonly timestamp: string;
+    /** The package version, stamped on every record. */
+    readonly sdkVersion: string;
+    readonly entityId?: EntityId;
+    /**
+     * `api.request`: `method`, `path`, `status` (when a response came back),
+     * `outcome` (`'success'` or the failure code) and `durationMs`.
+     * `error` events: the error `code`. Otherwise absent.
+     */
+    readonly attributes?: FacePeTelemetryAttributes;
+};
+/**
+ * Host-provided telemetry sink. `track` is called synchronously; a sink that
+ * throws is reported and ignored, never breaking the component.
+ */
+export interface FacePeTelemetry {
+    track(event: FacePeTelemetryEvent): void;
+}

package/dist/types/timeline.d.cts

@@ -0,0 +1,103 @@
+/**
+ * Contracts of `<FacePeTimeline>`.
+ */
+import type { FacePeComponentProps, FacePeHandleMethod } from './components.cjs';
+import type { FacePeNavigationRequest, FacePeStandardEvents } from './events.cjs';
+import type { FacePeFallbackContext } from './placement.cjs';
+/**
+ * Where an item stands. Each status is shown by a distinct marker shape and a
+ * text label, never by colour alone.
+ */
+export type FacePeTimelineItemStatus = 'completed' | 'current' | 'pending' | 'error';
+/** Extra facts shown under an item as label/value pairs, in the object's key order. */
+export type FacePeTimelineMetadata = Readonly<Record<string, string | number | boolean>>;
+/** One entry on the timeline. */
+export type FacePeTimelineItem = {
+    /** Unique within the timeline. */
+    readonly id: string;
+    readonly title: string;
+    readonly description?: string;
+    /**
+     * When it happened, as an ISO 8601 date-time, e.g. "2026-09-29T10:30:00+05:30".
+     * Shown in the viewer's time zone and the configured locale.
+     */
+    readonly timestamp: string;
+    readonly status: FacePeTimelineItemStatus;
+    readonly metadata?: FacePeTimelineMetadata;
+    /**
+     * Where "View details" leads. Raised as a `navigate` event for the host's
+     * router; the timeline never changes the URL. @default none (no link shown)
+     */
+    readonly link?: FacePeNavigationRequest;
+};
+/** Payload of the `select` event and of a successful `select()` call. */
+export type FacePeTimelineSelection = {
+    readonly id: string;
+    readonly title: string;
+    readonly status: FacePeTimelineItemStatus;
+    /** The item selected before this one, or `null` if there was none. */
+    readonly previousId: string | null;
+};
+/** Events `<FacePeTimeline>` emits. `ready` carries no data (`null`). */
+export type FacePeTimelineEvents = {
+    readonly ready: null;
+    readonly select: FacePeTimelineSelection;
+    readonly navigate: FacePeStandardEvents['navigate'];
+    readonly error: FacePeStandardEvents['error'];
+};
+/** What the `item` slot's render function receives. */
+export type FacePeTimelineItemSlotContext = {
+    readonly item: FacePeTimelineItem;
+    readonly selected: boolean;
+    /** The timestamp as displayed, already formatted for the locale. */
+    readonly formattedTimestamp: string;
+};
+/**
+ * Host-rendered regions: `item` replaces an item's description and metadata
+ * (title, status and time stay, so the timeline keeps its structure);
+ * `emptyState` replaces the message shown when there are no items;
+ * `fallback` replaces the timeline if it fails to render. @default none
+ */
+export type FacePeTimelineSlots = {
+    readonly item: FacePeTimelineItemSlotContext;
+    readonly emptyState: void;
+    readonly fallback: FacePeFallbackContext;
+};
+/**
+ * Props of `<FacePeTimeline>`. Configuration props override the provider's;
+ * `featureFlags` are merged per flag, the timeline's own winning.
+ *
+ * Feature flags read: `timeline.relativeTime` (also show "2 hours ago").
+ */
+export type FacePeTimelineProps = FacePeComponentProps<FacePeTimelineEvents, FacePeTimelineSlots> & {
+    /**
+     * The items to show. Leave out to pass the entity by reference instead:
+     * with an `entityId` (an order id) the timeline fetches that order's status
+     * history through the gateway (architecture §7.5).
+     * @default fetched by `entityId`; none without one
+     */
+    readonly items?: readonly FacePeTimelineItem[];
+    /** The timeline's accessible name. @default 'Timeline' */
+    readonly label?: string;
+    /**
+     * Display order. `'none'` keeps the given order (preferred: pass items
+     * already in order). Sorting is by `timestamp`, stable, with unparseable
+     * timestamps last; the `items` array itself is never modified.
+     * @default 'none'
+     */
+    readonly sort?: 'none' | 'ascending' | 'descending';
+    /** Shows a loading message instead of the items (also shown while fetching). @default false */
+    readonly loading?: boolean;
+};
+/** Imperative handle of `<FacePeTimeline>`, reached through a React `ref`. */
+export interface FacePeTimelineHandle {
+    /** Moves keyboard focus to the selected item, else the first; needs interactive items. */
+    readonly focus: FacePeHandleMethod;
+    /** Clears the selection. Emits nothing. */
+    readonly reset: FacePeHandleMethod;
+    /**
+     * Scrolls the item (section) with this id into view, and focuses it when
+     * items are interactive.
+     */
+    readonly scrollToSection: FacePeHandleMethod<[id: string]>;
+}

package/dist/types/timeline.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Contracts of `<FacePeTimeline>`.
+ */
+import type { FacePeComponentProps, FacePeHandleMethod } from './components.js';
+import type { FacePeNavigationRequest, FacePeStandardEvents } from './events.js';
+import type { FacePeFallbackContext } from './placement.js';
+/**
+ * Where an item stands. Each status is shown by a distinct marker shape and a
+ * text label, never by colour alone.
+ */
+export type FacePeTimelineItemStatus = 'completed' | 'current' | 'pending' | 'error';
+/** Extra facts shown under an item as label/value pairs, in the object's key order. */
+export type FacePeTimelineMetadata = Readonly<Record<string, string | number | boolean>>;
+/** One entry on the timeline. */
+export type FacePeTimelineItem = {
+    /** Unique within the timeline. */
+    readonly id: string;
+    readonly title: string;
+    readonly description?: string;
+    /**
+     * When it happened, as an ISO 8601 date-time, e.g. "2026-09-29T10:30:00+05:30".
+     * Shown in the viewer's time zone and the configured locale.
+     */
+    readonly timestamp: string;
+    readonly status: FacePeTimelineItemStatus;
+    readonly metadata?: FacePeTimelineMetadata;
+    /**
+     * Where "View details" leads. Raised as a `navigate` event for the host's
+     * router; the timeline never changes the URL. @default none (no link shown)
+     */
+    readonly link?: FacePeNavigationRequest;
+};
+/** Payload of the `select` event and of a successful `select()` call. */
+export type FacePeTimelineSelection = {
+    readonly id: string;
+    readonly title: string;
+    readonly status: FacePeTimelineItemStatus;
+    /** The item selected before this one, or `null` if there was none. */
+    readonly previousId: string | null;
+};
+/** Events `<FacePeTimeline>` emits. `ready` carries no data (`null`). */
+export type FacePeTimelineEvents = {
+    readonly ready: null;
+    readonly select: FacePeTimelineSelection;
+    readonly navigate: FacePeStandardEvents['navigate'];
+    readonly error: FacePeStandardEvents['error'];
+};
+/** What the `item` slot's render function receives. */
+export type FacePeTimelineItemSlotContext = {
+    readonly item: FacePeTimelineItem;
+    readonly selected: boolean;
+    /** The timestamp as displayed, already formatted for the locale. */
+    readonly formattedTimestamp: string;
+};
+/**
+ * Host-rendered regions: `item` replaces an item's description and metadata
+ * (title, status and time stay, so the timeline keeps its structure);
+ * `emptyState` replaces the message shown when there are no items;
+ * `fallback` replaces the timeline if it fails to render. @default none
+ */
+export type FacePeTimelineSlots = {
+    readonly item: FacePeTimelineItemSlotContext;
+    readonly emptyState: void;
+    readonly fallback: FacePeFallbackContext;
+};
+/**
+ * Props of `<FacePeTimeline>`. Configuration props override the provider's;
+ * `featureFlags` are merged per flag, the timeline's own winning.
+ *
+ * Feature flags read: `timeline.relativeTime` (also show "2 hours ago").
+ */
+export type FacePeTimelineProps = FacePeComponentProps<FacePeTimelineEvents, FacePeTimelineSlots> & {
+    /**
+     * The items to show. Leave out to pass the entity by reference instead:
+     * with an `entityId` (an order id) the timeline fetches that order's status
+     * history through the gateway (architecture §7.5).
+     * @default fetched by `entityId`; none without one
+     */
+    readonly items?: readonly FacePeTimelineItem[];
+    /** The timeline's accessible name. @default 'Timeline' */
+    readonly label?: string;
+    /**
+     * Display order. `'none'` keeps the given order (preferred: pass items
+     * already in order). Sorting is by `timestamp`, stable, with unparseable
+     * timestamps last; the `items` array itself is never modified.
+     * @default 'none'
+     */
+    readonly sort?: 'none' | 'ascending' | 'descending';
+    /** Shows a loading message instead of the items (also shown while fetching). @default false */
+    readonly loading?: boolean;
+};
+/** Imperative handle of `<FacePeTimeline>`, reached through a React `ref`. */
+export interface FacePeTimelineHandle {
+    /** Moves keyboard focus to the selected item, else the first; needs interactive items. */
+    readonly focus: FacePeHandleMethod;
+    /** Clears the selection. Emits nothing. */
+    readonly reset: FacePeHandleMethod;
+    /**
+     * Scrolls the item (section) with this id into view, and focuses it when
+     * items are interactive.
+     */
+    readonly scrollToSection: FacePeHandleMethod<[id: string]>;
+}

package/dist/version.d.cts

@@ -0,0 +1,2 @@
+/** The version of this SDK build, taken from package.json at build time. */
+export declare const SDK_VERSION: string;

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+/** The version of this SDK build, taken from package.json at build time. */
+export declare const SDK_VERSION: string;

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "@susilkumar006/widgets-test",
+  "version": "1.0.0",
+  "description": "FacePe SDK: embeddable React + TypeScript components for host applications.",
+  "license": "UNLICENSED",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.cts",
+        "default": "./dist/index.cjs"
+      }
+    },
+    "./styles.css": "./dist/styles.css",
+    "./schemas/*": "./dist/schemas/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "scripts": {
+    "build": "node scripts/lint-css.mjs && vite build && tsc -p tsconfig.json && node scripts/emit-cjs-types.mjs && node scripts/emit-schemas.mjs",
+    "lint:css": "node scripts/lint-css.mjs",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "npm run build && node tests/run.mjs",
+    "test:only": "node tests/run.mjs",
+    "api:check": "api-extractor run",
+    "api:update": "api-extractor run --local",
+    "size": "node scripts/size-check.mjs",
+    "prepublishOnly": "node scripts/release-guard.mjs"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0"
+  },
+  "devDependencies": {
+    "@microsoft/api-extractor": "^7.59.3",
+    "@types/react": "^18.3.0",
+    "@types/react-dom": "^18.3.0",
+    "css-loader": "^7.1.5",
+    "jsdom": "^24.1.3",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "style-loader": "^4.0.0",
+    "ts-json-schema-generator": "^2.9.0",
+    "tsx": "^4.23.15",
+    "typescript": "~5.9.3",
+    "vite": "^7.0.0",
+    "webpack": "^5.111.1"
+  },
+  "engines": {
+    "node": ">=20.19"
+  },
+  "dependencies": {
+    "@anam-ai/js-sdk": "^4.27.1",
+    "livekit-client": "^2.22.3"
+  }
+}