@businessdash/sdk 0.9.70 → 0.9.80

package/dist/consent-core/index.js

@@ -0,0 +1,157 @@
+/**
+ * `@businessdash/sdk/consent` — tracking consent, per org.
+ *
+ * ## The rule that shapes everything here
+ *
+ * Consent is given to a **controller**, and each org is a separate controller.
+ * It does not travel between them in either direction:
+ *
+ * - A visitor who refuses at org 2 has said nothing to org 1. Org 1 keeps
+ *   collecting.
+ * - A visitor who consents at org 1 has NOT consented at org 2. Org 2 may not
+ *   start collecting on the strength of it.
+ *
+ * The second half is the one that gets skipped, and it is the one with legal
+ * teeth: acting on another controller's consent is processing without a lawful
+ * basis.
+ *
+ * That is why the visitor key lives in a **first-party cookie on the org's own
+ * domain**, and why every call carries the org's own API key. Two sites cannot
+ * see each other's cookies, so the isolation is enforced by the browser rather
+ * than by us remembering to scope a query.
+ *
+ * ## Gate analytics on it
+ *
+ * ```ts
+ * const consent = await loadConsent({ client });
+ * if (consent.allows('analytics')) {
+ *   initBiabAnalytics({ siteId, baseUrl, apiKey });
+ * }
+ * if (consent.mustAsk) showYourBanner(consent);
+ * ```
+ *
+ * `initBiabAnalytics` is deliberately NOT made to call this itself. A gate that
+ * fires implicitly is one nobody can see in review, and the decision of what
+ * happens before consent — render nothing, render a placeholder, collect
+ * essential-only — belongs to the site, not to us.
+ *
+ * @module
+ */
+const VISITOR_COOKIE = "biab_visitor";
+const VISITOR_HEADER = "x-biab-visitor";
+/**
+ * The visitor's id for THIS site, minted on first need.
+ *
+ * A first-party cookie on the org's own domain, which is what makes the
+ * per-org isolation structural: the same person visiting two orgs gets two
+ * unrelated keys, because two domains cannot read each other's cookies. There
+ * is no cross-site identifier here and deliberately no way to add one.
+ *
+ * Returns null on the server, where there is no visitor to identify.
+ */
+export function visitorKey() {
+    if (typeof document === "undefined")
+        return null;
+    const found = document.cookie
+        .split(";")
+        .map((part) => part.trim())
+        .find((part) => part.startsWith(`${VISITOR_COOKIE}=`));
+    if (found)
+        return decodeURIComponent(found.slice(VISITOR_COOKIE.length + 1));
+    const key = typeof crypto !== "undefined" && "randomUUID" in crypto
+        ? crypto.randomUUID()
+        : `v${Date.now()}${Math.floor(Math.random() * 1e9)}`;
+    // SameSite=Lax and no Secure flag would leak on http; Secure is set unless
+    // we are plainly on localhost, where it would stop the cookie working at all.
+    const secure = location.protocol === "https:" ? "; Secure" : "";
+    // biome-ignore lint/suspicious/noDocumentCookie: the suggested CookieStore
+    // API has no Safari or Firefox support. A consent banner has to work in
+    // every browser a visitor might arrive in — that is the entire point of it —
+    // so the universally supported API is the correct one here.
+    document.cookie = `${VISITOR_COOKIE}=${encodeURIComponent(key)}; Path=/; Max-Age=31536000; SameSite=Lax${secure}`;
+    return key;
+}
+/** True when the browser is signalling a global opt-out (DNT or GPC). */
+export function browserOptOut() {
+    if (typeof navigator === "undefined")
+        return false;
+    const nav = navigator;
+    if (nav.globalPrivacyControl === true)
+        return true;
+    const dnt = nav.doNotTrack ??
+        (typeof window === "undefined"
+            ? undefined
+            : window.doNotTrack);
+    return dnt === "1" || dnt === "yes";
+}
+function toState(raw) {
+    const categories = (raw.categories ?? []);
+    const allowed = (raw.allowed ?? []);
+    return {
+        categories,
+        noticeText: raw.noticeText ?? null,
+        noticeVersion: raw.noticeVersion ?? 1,
+        allowed,
+        mustAsk: raw.mustAsk ?? true,
+        reason: (raw.reason ?? "default_deny"),
+        allows: (category) => allowed.includes(category),
+    };
+}
+/**
+ * What this visitor currently allows, at this org.
+ *
+ * On any failure this returns a **deny-everything** state rather than throwing.
+ * A consent gate that fails open collects data nobody agreed to; one that fails
+ * closed loses some analytics. Only one of those is a compliance incident.
+ */
+export async function loadConsent(options) {
+    const key = visitorKey();
+    try {
+        const raw = (await options.client.request({
+            path: "consent",
+            ...(key ? { headers: { [VISITOR_HEADER]: key } } : {}),
+            responseSchema: { parse: (v) => v },
+        }));
+        return toState(raw);
+    }
+    catch {
+        return {
+            categories: [],
+            noticeText: null,
+            noticeVersion: 1,
+            allowed: [],
+            mustAsk: false,
+            reason: "default_deny",
+            allows: () => false,
+        };
+    }
+}
+/**
+ * Record the visitor's answer.
+ *
+ * `granted: []` is a real answer — "asked, refused everything" — and is stored
+ * as one, so the banner does not reappear on the next page.
+ */
+export async function recordConsent(options) {
+    const key = visitorKey();
+    if (!key)
+        return { ok: false };
+    try {
+        await options.client.request({
+            method: "POST",
+            path: "consent",
+            body: {
+                granted: options.granted,
+                noticeVersion: options.noticeVersion,
+                source: options.source ?? "banner",
+            },
+            headers: { [VISITOR_HEADER]: key },
+            responseSchema: { parse: (v) => v },
+        });
+        return { ok: true };
+    }
+    catch {
+        return { ok: false };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/consent-core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/consent-core/index.ts"],"names":[],"mappings":"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"}

package/dist/contracts.d.ts

@@ -3286,6 +3286,217 @@ export declare const customerPortalProfileSchema: z.ZodNullable<z.ZodObject<{
     profile: Record<string, unknown> | null;
     lastSeenAt: string | null;
 }>>;
+/**
+ * One quiz outcome for the signed-in customer. `scoreWithheld` marks an
+ * interview-mode quiz: the attempt exists, the verdict is staff-only —
+ * render "completed" and nothing else.
+ */
+export declare const customerPortalQuizResultSchema: z.ZodObject<{
+    invitationId: z.ZodString;
+    quizName: z.ZodString;
+    competency: z.ZodNullable<z.ZodString>;
+    status: z.ZodString;
+    completedAt: z.ZodNullable<z.ZodString>;
+    scoreWithheld: z.ZodBoolean;
+    result: z.ZodNullable<z.ZodObject<{
+        status: z.ZodString;
+        scorePercent: z.ZodNullable<z.ZodNumber>;
+        provisionalScorePercent: z.ZodNullable<z.ZodNumber>;
+        passed: z.ZodNullable<z.ZodBoolean>;
+        pointsEarned: z.ZodNullable<z.ZodNumber>;
+        pointsPossible: z.ZodNullable<z.ZodNumber>;
+        passingScore: z.ZodNumber;
+        results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+        submittedAt: z.ZodNullable<z.ZodString>;
+        durationSeconds: z.ZodNullable<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        scorePercent: number | null;
+        provisionalScorePercent: number | null;
+        passed: boolean | null;
+        pointsEarned: number | null;
+        pointsPossible: number | null;
+        passingScore: number;
+        results: Record<string, unknown>[];
+        submittedAt: string | null;
+        durationSeconds: number | null;
+    }, {
+        status: string;
+        scorePercent: number | null;
+        provisionalScorePercent: number | null;
+        passed: boolean | null;
+        pointsEarned: number | null;
+        pointsPossible: number | null;
+        passingScore: number;
+        results: Record<string, unknown>[];
+        submittedAt: string | null;
+        durationSeconds: number | null;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    result: {
+        status: string;
+        scorePercent: number | null;
+        provisionalScorePercent: number | null;
+        passed: boolean | null;
+        pointsEarned: number | null;
+        pointsPossible: number | null;
+        passingScore: number;
+        results: Record<string, unknown>[];
+        submittedAt: string | null;
+        durationSeconds: number | null;
+    } | null;
+    invitationId: string;
+    quizName: string;
+    competency: string | null;
+    completedAt: string | null;
+    scoreWithheld: boolean;
+}, {
+    status: string;
+    result: {
+        status: string;
+        scorePercent: number | null;
+        provisionalScorePercent: number | null;
+        passed: boolean | null;
+        pointsEarned: number | null;
+        pointsPossible: number | null;
+        passingScore: number;
+        results: Record<string, unknown>[];
+        submittedAt: string | null;
+        durationSeconds: number | null;
+    } | null;
+    invitationId: string;
+    quizName: string;
+    competency: string | null;
+    completedAt: string | null;
+    scoreWithheld: boolean;
+}>;
+export type CustomerPortalQuizResult = z.infer<typeof customerPortalQuizResultSchema>;
+export declare const customerPortalQuizResultsResponseSchema: z.ZodObject<{
+    items: z.ZodArray<z.ZodObject<{
+        invitationId: z.ZodString;
+        quizName: z.ZodString;
+        competency: z.ZodNullable<z.ZodString>;
+        status: z.ZodString;
+        completedAt: z.ZodNullable<z.ZodString>;
+        scoreWithheld: z.ZodBoolean;
+        result: z.ZodNullable<z.ZodObject<{
+            status: z.ZodString;
+            scorePercent: z.ZodNullable<z.ZodNumber>;
+            provisionalScorePercent: z.ZodNullable<z.ZodNumber>;
+            passed: z.ZodNullable<z.ZodBoolean>;
+            pointsEarned: z.ZodNullable<z.ZodNumber>;
+            pointsPossible: z.ZodNullable<z.ZodNumber>;
+            passingScore: z.ZodNumber;
+            results: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>, "many">;
+            submittedAt: z.ZodNullable<z.ZodString>;
+            durationSeconds: z.ZodNullable<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            status: string;
+            scorePercent: number | null;
+            provisionalScorePercent: number | null;
+            passed: boolean | null;
+            pointsEarned: number | null;
+            pointsPossible: number | null;
+            passingScore: number;
+            results: Record<string, unknown>[];
+            submittedAt: string | null;
+            durationSeconds: number | null;
+        }, {
+            status: string;
+            scorePercent: number | null;
+            provisionalScorePercent: number | null;
+            passed: boolean | null;
+            pointsEarned: number | null;
+            pointsPossible: number | null;
+            passingScore: number;
+            results: Record<string, unknown>[];
+            submittedAt: string | null;
+            durationSeconds: number | null;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        result: {
+            status: string;
+            scorePercent: number | null;
+            provisionalScorePercent: number | null;
+            passed: boolean | null;
+            pointsEarned: number | null;
+            pointsPossible: number | null;
+            passingScore: number;
+            results: Record<string, unknown>[];
+            submittedAt: string | null;
+            durationSeconds: number | null;
+        } | null;
+        invitationId: string;
+        quizName: string;
+        competency: string | null;
+        completedAt: string | null;
+        scoreWithheld: boolean;
+    }, {
+        status: string;
+        result: {
+            status: string;
+            scorePercent: number | null;
+            provisionalScorePercent: number | null;
+            passed: boolean | null;
+            pointsEarned: number | null;
+            pointsPossible: number | null;
+            passingScore: number;
+            results: Record<string, unknown>[];
+            submittedAt: string | null;
+            durationSeconds: number | null;
+        } | null;
+        invitationId: string;
+        quizName: string;
+        competency: string | null;
+        completedAt: string | null;
+        scoreWithheld: boolean;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    items: {
+        status: string;
+        result: {
+            status: string;
+            scorePercent: number | null;
+            provisionalScorePercent: number | null;
+            passed: boolean | null;
+            pointsEarned: number | null;
+            pointsPossible: number | null;
+            passingScore: number;
+            results: Record<string, unknown>[];
+            submittedAt: string | null;
+            durationSeconds: number | null;
+        } | null;
+        invitationId: string;
+        quizName: string;
+        competency: string | null;
+        completedAt: string | null;
+        scoreWithheld: boolean;
+    }[];
+}, {
+    items: {
+        status: string;
+        result: {
+            status: string;
+            scorePercent: number | null;
+            provisionalScorePercent: number | null;
+            passed: boolean | null;
+            pointsEarned: number | null;
+            pointsPossible: number | null;
+            passingScore: number;
+            results: Record<string, unknown>[];
+            submittedAt: string | null;
+            durationSeconds: number | null;
+        } | null;
+        invitationId: string;
+        quizName: string;
+        competency: string | null;
+        completedAt: string | null;
+        scoreWithheld: boolean;
+    }[];
+}>;
+export type CustomerPortalQuizResultsResponse = z.infer<typeof customerPortalQuizResultsResponseSchema>;
 export declare const customerPortalUpdateProfileInputSchema: z.ZodObject<{
     displayName: z.ZodOptional<z.ZodString>;
     profile: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
@@ -7331,21 +7542,21 @@ export declare const customerReviewSummarySchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     status: OpenEnum<"pending" | "published" | "hidden">;
     id: string;
+    submittedAt: string;
     title: string | null;
     publishedAt: string | null;
     rating: number;
     body: string;
     jobId: string | null;
-    submittedAt: string;
 }, {
     status: OpenEnum<"pending" | "published" | "hidden">;
     id: string;
+    submittedAt: string;
     title: string | null;
     publishedAt: string | null;
     rating: number;
     body: string;
     jobId: string | null;
-    submittedAt: string;
 }>;
 export declare const customerReviewListResponseSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
@@ -7361,43 +7572,43 @@ export declare const customerReviewListResponseSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         status: OpenEnum<"pending" | "published" | "hidden">;
         id: string;
+        submittedAt: string;
         title: string | null;
         publishedAt: string | null;
         rating: number;
         body: string;
         jobId: string | null;
-        submittedAt: string;
     }, {
         status: OpenEnum<"pending" | "published" | "hidden">;
         id: string;
+        submittedAt: string;
         title: string | null;
         publishedAt: string | null;
         rating: number;
         body: string;
         jobId: string | null;
-        submittedAt: string;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     items: {
         status: OpenEnum<"pending" | "published" | "hidden">;
         id: string;
+        submittedAt: string;
         title: string | null;
         publishedAt: string | null;
         rating: number;
         body: string;
         jobId: string | null;
-        submittedAt: string;
     }[];
 }, {
     items: {
         status: OpenEnum<"pending" | "published" | "hidden">;
         id: string;
+        submittedAt: string;
         title: string | null;
         publishedAt: string | null;
         rating: number;
         body: string;
         jobId: string | null;
-        submittedAt: string;
     }[];
 }>;
 export declare const customerReviewSubmitInputSchema: z.ZodObject<{
@@ -7589,16 +7800,16 @@ export declare const customerJobEtaResponseSchema: z.ZodObject<{
         completedAt: z.ZodNullable<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         startedAt: string | null;
+        completedAt: string | null;
         scheduledStartAt: string | null;
         enRouteAt: string | null;
         arrivedAt: string | null;
-        completedAt: string | null;
     }, {
         startedAt: string | null;
+        completedAt: string | null;
         scheduledStartAt: string | null;
         enRouteAt: string | null;
         arrivedAt: string | null;
-        completedAt: string | null;
     }>;
     assignments: z.ZodArray<z.ZodObject<{
         displayName: z.ZodString;
@@ -7662,10 +7873,10 @@ export declare const customerJobEtaResponseSchema: z.ZodObject<{
     dispatchStatus: OpenEnum<"completed" | "en_route" | "unscheduled" | "scheduled" | "arrived" | "started">;
     timeline: {
         startedAt: string | null;
+        completedAt: string | null;
         scheduledStartAt: string | null;
         enRouteAt: string | null;
         arrivedAt: string | null;
-        completedAt: string | null;
     };
     assignments: {
         role: string | null;
@@ -7688,10 +7899,10 @@ export declare const customerJobEtaResponseSchema: z.ZodObject<{
     dispatchStatus: OpenEnum<"completed" | "en_route" | "unscheduled" | "scheduled" | "arrived" | "started">;
     timeline: {
         startedAt: string | null;
+        completedAt: string | null;
         scheduledStartAt: string | null;
         enRouteAt: string | null;
         arrivedAt: string | null;
-        completedAt: string | null;
     };
     assignments: {
         role: string | null;