@patientos/website-kit 0.2.1 → 0.2.2

package/dist/index.d.ts

@@ -2,8 +2,9 @@ export { BPOINT_SCRIPT_ORIGIN, BPOINT_SCRIPT_URL, CONSULT_CHUNK_PATH, THIRD_PART
 import * as React from 'react';
 export { ISLAND_ATTR, ISLAND_PROPS_ATTR, Island, IslandProps, IslandRegistry, mountIslandsWith, readIslandProps } from './islands.js';
 export { ISLANDS, IslandName, mountIslands } from './islands-registry.js';
-export { B as BookingBlock, a as BookingBlockMarkerProps, b as BookingBlockProps, c as BookingTypeOption, C as Cart, d as CartMarkerProps, e as CartProps, f as CertificateFunnel, g as CertificateFunnelMarkerProps, h as CertificateFunnelProps, i as Checkout, j as CheckoutMarkerProps, k as CheckoutProps, F as FunnelPublicApi, l as FunnelServiceOption, S as Store, m as StoreMarkerProps, n as StoreProps } from './checkout-block-CrO7OxI9.js';
-export { P as PortalAccount, a as PortalAccountMarkerProps, b as PortalAccountProps, c as PortalAccountSurface, d as PortalPanel, e as PortalPanelMarkerProps, f as PortalPanelProps, g as PortalSurface } from './portal-account-CaK1lqSZ.js';
+import { P as PortalClient, W as WhoAmI, a as PortalPrefill, b as PublicClaim } from './portal-account-pI1cWgsT.js';
+export { F as FetchLike, c as PortalAccount, d as PortalAccountMarkerProps, e as PortalAccountProps, f as PortalAccountSurface, g as PortalClientConfig, h as PortalPanel, i as PortalPanelMarkerProps, j as PortalPanelProps, k as PortalResult, l as PortalSurface, m as createPortalClient } from './portal-account-pI1cWgsT.js';
+export { B as BookingBlock, a as BookingBlockMarkerProps, b as BookingBlockProps, c as BookingTypeOption, C as Cart, d as CartMarkerProps, e as CartProps, f as CertificateFunnel, g as CertificateFunnelMarkerProps, h as CertificateFunnelProps, i as Checkout, j as CheckoutMarkerProps, k as CheckoutProps, F as FunnelPublicApi, l as FunnelServiceOption, S as Store, m as StoreMarkerProps, n as StoreProps } from './checkout-block-Cog4H4I4.js';
 export { PatientSurfaceTheme, patientSurfaceTheme } from './patient-surface-theme.js';
 export { Rgb, contrastRatio, deriveForeground, parseHexColor, relativeLuminance } from './contrast.js';
 export { AnswerValue, Answers, ShowWhenCondition, evaluateShowWhen, visibleQuestions } from './show-when.js';
@@ -184,6 +185,30 @@ type FAQProps = {
 } & React.HTMLAttributes<HTMLDivElement>;
 declare function FAQ({ items, className, ...rest }: FAQProps): React.ReactElement;
 
+interface PortalProviderProps {
+    client: PortalClient;
+    children?: React.ReactNode;
+}
+declare function PortalProvider({ client, children }: PortalProviderProps): React.ReactElement;
+declare function usePortalClient(): PortalClient;
+type PortalSessionStatus = 'loading' | 'anonymous' | 'signedIn';
+interface PortalSession {
+    status: PortalSessionStatus;
+    who: WhoAmI | null;
+    refresh(): Promise<void>;
+    requestSignInLink(email: string, redirect?: string): Promise<boolean>;
+    prefill(): Promise<PortalPrefill | null>;
+    mintClaim(): Promise<PublicClaim | null>;
+}
+/**
+ * Session state plus the four patient-identity actions used by kit components.
+ *
+ * SSR renders the neutral `loading` state. Effects are the only place `whoami` starts:
+ * there is no module-scope request and no request during render. Every method catches as
+ * a second line of defence even though PortalClient is itself total.
+ */
+declare function usePortalSession(): PortalSession;
+
 declare const WEBSITE_KIT_VERSION = "0.1.0";
 
-export { Button, type ButtonProps, type ButtonVariant, Container, type ContainerProps, FAQ, type FAQProps, type FaqItem, Hero, type HeroProps, Hours, type HoursProps, type HoursRow, MapEmbed, type MapEmbedProps, Row, type RowProps, Section, type SectionProps, type Service, ServiceGrid, type ServiceGridProps, Stack, type StackProps, TeamGrid, type TeamGridProps, type TeamMember, ThemeProvider, type ThemeProviderProps, WEBSITE_KIT_VERSION, WebsiteShell, type WebsiteShellProps, type WebsiteTheme, defaultTheme, resolveTheme, themeToCssVars };
+export { Button, type ButtonProps, type ButtonVariant, Container, type ContainerProps, FAQ, type FAQProps, type FaqItem, Hero, type HeroProps, Hours, type HoursProps, type HoursRow, MapEmbed, type MapEmbedProps, PortalClient, PortalPrefill, PortalProvider, type PortalProviderProps, type PortalSession, type PortalSessionStatus, PublicClaim, Row, type RowProps, Section, type SectionProps, type Service, ServiceGrid, type ServiceGridProps, Stack, type StackProps, TeamGrid, type TeamGridProps, type TeamMember, ThemeProvider, type ThemeProviderProps, WEBSITE_KIT_VERSION, WebsiteShell, type WebsiteShellProps, type WebsiteTheme, WhoAmI, defaultTheme, resolveTheme, themeToCssVars, usePortalClient, usePortalSession };

package/dist/index.js

@@ -1,16 +1,19 @@
 import {
   ISLANDS,
   mountIslands
-} from "./chunk-CRYD7EXD.js";
+} from "./chunk-N6IGS47W.js";
 import {
   PortalAccount,
   PortalPanel,
+  PortalProvider,
   getAppointmentTypes,
   getClinic,
   getPublicApi,
   getServices,
-  getThemeTokens
-} from "./chunk-EO64UB5F.js";
+  getThemeTokens,
+  usePortalClient,
+  usePortalSession
+} from "./chunk-UTCKIWE7.js";
 import {
   BPOINT_SCRIPT_ORIGIN,
   BPOINT_SCRIPT_URL,
@@ -30,7 +33,9 @@ import {
   mountIslandsWith,
   readIslandProps
 } from "./chunk-THMT43MV.js";
-import "./chunk-BW7YKCKH.js";
+import {
+  createPortalClient
+} from "./chunk-BHVDY6SC.js";
 import {
   contrastRatio,
   deriveForeground,
@@ -456,6 +461,7 @@ export {
   MapEmbed,
   PortalAccount,
   PortalPanel,
+  PortalProvider,
   Row,
   Section,
   ServiceGrid,
@@ -469,6 +475,7 @@ export {
   WEBSITE_KIT_VERSION,
   WebsiteShell,
   contrastRatio,
+  createPortalClient,
   defaultTheme,
   deriveForeground,
   evaluateShowWhen,
@@ -480,5 +487,7 @@ export {
   relativeLuminance,
   resolveTheme,
   themeToCssVars,
+  usePortalClient,
+  usePortalSession,
   visibleQuestions
 };

package/dist/islands-impl.d.ts

@@ -1,8 +1,7 @@
 import * as React from 'react';
-import { b as BookingBlockProps, h as CertificateFunnelProps, n as StoreProps, e as CartProps, k as CheckoutProps } from './checkout-block-CrO7OxI9.js';
-import { f as PortalPanelProps } from './portal-account-CaK1lqSZ.js';
-import { F as FetchLike } from './portal-account.client-CqnsCCiC.js';
-export { P as PortalAccountClient } from './portal-account.client-CqnsCCiC.js';
+import { b as BookingBlockProps, h as CertificateFunnelProps, n as StoreProps, e as CartProps, k as CheckoutProps } from './checkout-block-Cog4H4I4.js';
+import { j as PortalPanelProps, F as FetchLike } from './portal-account-pI1cWgsT.js';
+export { P as PortalAccountClient } from './portal-account.client-DPRRmfCJ.js';
 
 declare function BookingBlockClient(props: BookingBlockProps): React.ReactElement;
 

package/dist/islands-impl.js

@@ -6,11 +6,11 @@ import {
   PortalAccountClient,
   PortalPanelClient,
   StoreClient
-} from "./chunk-EO64UB5F.js";
+} from "./chunk-UTCKIWE7.js";
 import "./chunk-ZOF22TJA.js";
 import "./chunk-QDO3SJWR.js";
 import "./chunk-THMT43MV.js";
-import "./chunk-BW7YKCKH.js";
+import "./chunk-BHVDY6SC.js";
 import "./chunk-MLKGABMK.js";
 export {
   BookingBlockClient,

package/dist/islands-registry.js

@@ -1,12 +1,12 @@
 import {
   ISLANDS,
   mountIslands
-} from "./chunk-CRYD7EXD.js";
-import "./chunk-EO64UB5F.js";
+} from "./chunk-N6IGS47W.js";
+import "./chunk-UTCKIWE7.js";
 import "./chunk-ZOF22TJA.js";
 import "./chunk-QDO3SJWR.js";
 import "./chunk-THMT43MV.js";
-import "./chunk-BW7YKCKH.js";
+import "./chunk-BHVDY6SC.js";
 import "./chunk-MLKGABMK.js";
 export {
   ISLANDS,

package/dist/{portal-account-CaK1lqSZ.d.ts → portal-account-pI1cWgsT.d.ts}

@@ -1,5 +1,80 @@
 import * as React from 'react';
 
+/** The injectable browser transport. */
+type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
+interface PortalClientConfig {
+    /** The validated app API origin, e.g. https://my.pocketdoc.com.au. */
+    apiOrigin?: string | null;
+    /** The app origin used only to verify whether relative portal API calls belong here. */
+    portalOrigin?: string | null;
+    /** Where to send a patient who cannot use the client at all. */
+    portalUrl?: string | null;
+    /** Injectable for tests. */
+    fetchImpl?: FetchLike;
+}
+/** Who the app says is signed in on this origin. */
+type WhoAmI = {
+    signedIn: false;
+} | {
+    signedIn: true;
+    givenName: string;
+    familyName: string;
+    email: string;
+};
+/** The patient's own details, for prefill. Every field is independently nullable. */
+interface PortalPrefill {
+    givenName: string | null;
+    familyName: string | null;
+    email: string | null;
+    phone: string | null;
+    dateOfBirth: string | null;
+}
+/** A claim token minted for the signed-in patient's corroborated-identity path. */
+interface PublicClaim {
+    contactId: string;
+    claimToken: string;
+    expiresAt: string;
+}
+/** A portal call is always a value, never a thrown transport failure. */
+type PortalResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    status: number | null;
+    error: string | null;
+    body?: unknown;
+};
+interface PortalClient {
+    /** Whether this client can honestly offer an inline portal interaction. */
+    readonly available: boolean;
+    /** The validated app origin, or '' for relative same-origin calls. */
+    readonly apiOrigin: string;
+    /** The configured outbound fallback, or ''. */
+    readonly portalHref: string;
+    /** Resolve a constant path against this client's one configured origin. */
+    url(path: string): string;
+    /** The transport bound when this client was created; injectable for tests. */
+    readonly fetch: FetchLike;
+    /** Who is signed in; unhealthy/unavailable is indistinguishable from signed out. */
+    whoAmI(): Promise<WhoAmI>;
+    /** Ask for an oracle-free magic link. */
+    requestMagicLink(email: string, redirect?: string): Promise<boolean>;
+    /** Read the signed-in patient's details. */
+    prefill(): Promise<PortalPrefill | null>;
+    /** Mint a public claim only for the signed-in patient. */
+    mintPublicClaim(): Promise<PublicClaim | null>;
+    /** Current page callback, using the app-side return hop when cross-origin. */
+    returnPath(): string;
+    /** Back-compat account-surface transport; callers still use constant paths. */
+    get<T>(path: string): Promise<PortalResult<T>>;
+    /** Back-compat account-surface JSON write; callers still use constant paths. */
+    send<T>(path: string, method: 'POST' | 'PUT', body: unknown): Promise<PortalResult<T>>;
+    /** Back-compat account-surface body-less delete. */
+    delete<T>(path: string): Promise<PortalResult<T>>;
+}
+declare function createPortalClient(config?: PortalClientConfig): PortalClient;
+
 /** Which portal surface this panel shows. */
 type PortalSurface = 'appointments' | 'documents' | 'orders' | 'profile';
 /** JSON-safe island configuration. Crosses the build→runtime boundary — see `./islands`. */
@@ -49,6 +124,7 @@ interface PublicApiConfig {
     turnstileSiteKey?: string;
     portalUrl?: string;
     portalOrigin?: string;
+    portalApiOrigin?: string;
 }
 
 /**
@@ -130,4 +206,4 @@ type PortalAccountMarkerProps = PortalAccountProps & {
  */
 declare function PortalAccount({ surface, portalUrl, bookHref, appointmentsHref, funnelHref, portalApiOrigin, className, }: PortalAccountMarkerProps): React.ReactElement;
 
-export { PortalAccount as P, type PortalAccountMarkerProps as a, type PortalAccountProps as b, type PortalAccountSurface as c, PortalPanel as d, type PortalPanelMarkerProps as e, type PortalPanelProps as f, type PortalSurface as g };
+export { type FetchLike as F, type PortalClient as P, type WhoAmI as W, type PortalPrefill as a, type PublicClaim as b, PortalAccount as c, type PortalAccountMarkerProps as d, type PortalAccountProps as e, type PortalAccountSurface as f, type PortalClientConfig as g, PortalPanel as h, type PortalPanelMarkerProps as i, type PortalPanelProps as j, type PortalResult as k, type PortalSurface as l, createPortalClient as m };

package/dist/{portal-account.client-CqnsCCiC.d.ts → portal-account.client-DPRRmfCJ.d.ts}

@@ -1,32 +1,5 @@
 import * as React from 'react';
-import { b as PortalAccountProps } from './portal-account-CaK1lqSZ.js';
-
-/** The injectable fetch. Present so every behaviour here is provable without a DOM. */
-type FetchLike = (input: string, init?: RequestInit) => Promise<Response>;
-/**
- * The outcome of one portal call. A VALUE, never a throw.
- *
- * `status` is the HTTP status when the server answered and refused, and `null` when the
- * transport failed or the body was not JSON — the caller needs that distinction because
- * a 404 means "the clinic turned this off" (a quiet note) while a transport failure means
- * "we cannot answer here" (link out).
- */
-type PortalResult<T> = {
-    ok: true;
-    data: T;
-}
-/**
- * `body` is the parsed error payload when there was one — typed `unknown`, NOT `T`:
- * a refusal is not the success shape, and a caller must narrow it before trusting a
- * field (see `hasPortalIdentity`). Keeping it off `T` also keeps a failed result
- * assignable across surface types, which the callers that pass one through rely on.
- */
- | {
-    ok: false;
-    status: number | null;
-    error: string | null;
-    body?: unknown;
-};
+import { e as PortalAccountProps, F as FetchLike } from './portal-account-pI1cWgsT.js';
 
 type PortalAddress = {
     id: string;
@@ -166,4 +139,4 @@ type PortalAccountClientProps = PortalAccountProps & {
  */
 declare function PortalAccountClient(props: PortalAccountClientProps): React.ReactElement;
 
-export { type FetchLike as F, PortalAccountClient as P, type PortalAppointment as a, type PortalAppointmentsBody as b, type PortalResult as c };
+export { PortalAccountClient as P, type PortalAppointment as a, type PortalAppointmentsBody as b };

package/dist/portal-booking-client.d.ts

@@ -1,6 +1,6 @@
 import * as React from 'react';
-import { a as PortalAppointment, F as FetchLike, b as PortalAppointmentsBody, c as PortalResult } from './portal-account.client-CqnsCCiC.js';
-import './portal-account-CaK1lqSZ.js';
+import { F as FetchLike, k as PortalResult } from './portal-account-pI1cWgsT.js';
+import { a as PortalAppointment, b as PortalAppointmentsBody } from './portal-account.client-DPRRmfCJ.js';
 
 /** One bookable instant, collapsing the practitioners free at the same time. */
 interface TimeSlot {

package/dist/portal-booking-client.js

@@ -22,7 +22,7 @@ import {
   releasePortalHold,
   rescheduleContextTypeId,
   reschedulePortalAppointmentAndReload
-} from "./chunk-BW7YKCKH.js";
+} from "./chunk-BHVDY6SC.js";
 import "./chunk-MLKGABMK.js";
 export {
   AVAILABILITY_FAILED_COPY,

package/dist/website-kit.css

@@ -1372,6 +1372,9 @@ select.sk-identity__input[data-empty] {
   border: 1px solid var(--sk-flow-line, color-mix(in srgb, var(--sk-muted) 30%, transparent));
   border-radius: var(--sk-island-radius);
 }
+.sk-flow .sk-identity__ramp--failed {
+  color: var(--sk-flow-danger, #b3261e);
+}
 .sk-identity__confirm {
   padding: calc(var(--sk-space) * 2.5);
   border: 1px solid var(--sk-flow-line, color-mix(in srgb, var(--sk-muted) 30%, transparent));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@patientos/website-kit",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "PatientOS clinic website components and patient-facing interactive islands.",
   "type": "module",
   "sideEffects": [