@mj-biz-apps/forms-ng 0.0.0 → 0.2.0

package/dist/lib/dashboard/services/forms-reporting.service.js

@@ -0,0 +1,230 @@
+/**
+ * Forms reporting data service (WP-F).
+ *
+ * Pure RunView/RunViews + snapshot-parsing — NO new infra (FORMS_BUILD_PLAN §8.1).
+ * Loads the reportable forms, then for a selected form version: the published
+ * snapshot (for question labels/options), the responses, and the answers, and
+ * folds them into the `FormReportData` read-model. Stateless and injectable; the
+ * dashboard owns selection state.
+ */
+import { Injectable } from '@angular/core';
+import { RunView } from '@memberjunction/core';
+import { flattenQuestions, buildSummary, buildBreakdowns, buildFunnel, buildResponseRows, buildResponseDetail, } from './reporting-aggregations';
+import * as i0 from "@angular/core";
+/** Entity names (PHASE1_DECOMPOSITION entity-name table). */
+const ENTITY = {
+    forms: 'MJ_BizApps_Forms: Forms',
+    versions: 'MJ_BizApps_Forms: Form Versions',
+    responses: 'MJ_BizApps_Forms: Form Responses',
+    answers: 'MJ_BizApps_Forms: Form Response Answers',
+};
+/** DB schema for the Forms tables/views — the IN-subquery view must be qualified. */
+const FORMS_SCHEMA = '__mj_BizAppsForms';
+/**
+ * Build the answers `ExtraFilter` that scopes to a form's responses across all versions.
+ * The `vwFormResponses` view MUST be schema-qualified: the connection's default schema is
+ * not `__mj_BizAppsForms`, so a bare name resolves against `dbo` and throws
+ * "Invalid object name 'vwFormResponses'". Exported for unit testing.
+ */
+export function answersForFormFilter(formId) {
+    return `ResponseID IN (SELECT ID FROM ${FORMS_SCHEMA}.vwFormResponses WHERE FormID='${formId}')`;
+}
+export class FormsReportingService {
+    rv = new RunView();
+    /**
+     * Lists forms that have at least one published version, with their latest
+     * published version id and COMPLETE response count, for the form picker. Partial
+     * (in-progress) autosaves are excluded from the count.
+     */
+    async loadReportableForms() {
+        const [formsRes, versionsRes, responsesRes] = await this.rv.RunViews([
+            {
+                EntityName: ENTITY.forms,
+                ResultType: 'simple',
+                Fields: ['ID', 'Name'],
+                OrderBy: 'Name',
+            },
+            {
+                EntityName: ENTITY.versions,
+                ExtraFilter: `Status='Published'`,
+                ResultType: 'simple',
+                Fields: ['ID', 'FormID', 'VersionNumber'],
+                OrderBy: 'VersionNumber DESC',
+            },
+            {
+                EntityName: ENTITY.responses,
+                // Headline response count is COMPLETE-only: in-progress Partial autosaves are not
+                // "responses". (Partials still feed the drop-off funnel in loadReport, which reads
+                // its own rows.)
+                ExtraFilter: `Status='Complete'`,
+                ResultType: 'simple',
+                Fields: ['ID', 'FormID', 'Status'],
+            },
+        ]);
+        if (!formsRes.Success || !versionsRes.Success || !responsesRes.Success) {
+            throw new Error(formsRes.ErrorMessage ||
+                versionsRes.ErrorMessage ||
+                responsesRes.ErrorMessage ||
+                'Failed to load reportable forms.');
+        }
+        const latestVersionByForm = new Map();
+        for (const v of versionsRes.Results) {
+            // Versions are ordered DESC, so the first seen per form is the latest.
+            if (!latestVersionByForm.has(v.FormID)) {
+                latestVersionByForm.set(v.FormID, v.ID);
+            }
+        }
+        const responseCountByForm = new Map();
+        for (const r of responsesRes.Results) {
+            responseCountByForm.set(r.FormID, (responseCountByForm.get(r.FormID) ?? 0) + 1);
+        }
+        const out = [];
+        for (const f of formsRes.Results) {
+            const formVersionId = latestVersionByForm.get(f.ID);
+            if (!formVersionId) {
+                continue; // skip forms with no published version
+            }
+            out.push({
+                formId: f.ID,
+                formVersionId,
+                name: f.Name,
+                responseCount: responseCountByForm.get(f.ID) ?? 0,
+            });
+        }
+        return out;
+    }
+    /**
+     * Loads the full report bundle for a form — across ALL its versions.
+     *
+     * Responses are scoped by `FormID`, NOT by a single `FormVersionID`. Every response
+     * pins the form version that was live at submission, so a form with multiple
+     * published versions has responses spread across them; filtering to only the latest
+     * version silently hides every response submitted against an earlier one (the "I
+     * submitted a response but the dashboard shows nothing" bug). Question labels/options
+     * come from the latest published definition; answers map back by `QuestionID`.
+     */
+    async loadReport(form) {
+        const definition = await this.loadDefinition(form.formVersionId);
+        const questions = flattenQuestions(definition);
+        const [responsesRes, answersRes] = await this.rv.RunViews([
+            {
+                EntityName: ENTITY.responses,
+                ExtraFilter: `FormID='${form.formId}'`,
+                ResultType: 'simple',
+                Fields: [
+                    'ID',
+                    'Status',
+                    'StartedAt',
+                    'SubmittedAt',
+                    'RespondentPerson',
+                    'AnonymousSessionID',
+                ],
+                OrderBy: 'SubmittedAt DESC',
+            },
+            {
+                EntityName: ENTITY.answers,
+                ExtraFilter: answersForFormFilter(form.formId),
+                ResultType: 'simple',
+                Fields: [
+                    'ID',
+                    'ResponseID',
+                    'QuestionID',
+                    'TextValue',
+                    'NumericValue',
+                    'DateValue',
+                    'BooleanValue',
+                    'JSONValue',
+                    'FileID',
+                ],
+            },
+        ]);
+        if (!responsesRes.Success || !answersRes.Success) {
+            throw new Error(responsesRes.ErrorMessage ||
+                answersRes.ErrorMessage ||
+                'Failed to load responses.');
+        }
+        const responses = responsesRes.Results;
+        const answers = answersRes.Results;
+        return {
+            form,
+            questions,
+            summary: buildSummary(responses),
+            breakdowns: buildBreakdowns(questions, answers),
+            funnel: buildFunnel(definition, answers),
+            responses: buildResponseRows(responses, answers),
+        };
+    }
+    /**
+     * Loads one response's labelled answers for the detail view.
+     */
+    async loadResponseDetail(responseId, questions) {
+        const [responseRes, answersRes] = await this.rv.RunViews([
+            {
+                EntityName: ENTITY.responses,
+                ExtraFilter: `ID='${responseId}'`,
+                ResultType: 'simple',
+                Fields: ['ID', 'Status', 'StartedAt', 'SubmittedAt', 'RespondentPerson', 'AnonymousSessionID'],
+            },
+            {
+                EntityName: ENTITY.answers,
+                ExtraFilter: `ResponseID='${responseId}'`,
+                ResultType: 'simple',
+                Fields: ['ID', 'ResponseID', 'QuestionID', 'TextValue', 'NumericValue', 'DateValue', 'BooleanValue', 'JSONValue', 'FileID'],
+            },
+        ]);
+        if (!responseRes.Success || !answersRes.Success || responseRes.Results.length === 0) {
+            throw new Error(responseRes.ErrorMessage || answersRes.ErrorMessage || 'Response not found.');
+        }
+        return buildResponseDetail(responseRes.Results[0], answersRes.Results, questions);
+    }
+    /**
+     * Loads all answer rows for a form (across ALL its versions' responses). Used by the
+     * export service to pivot responses into a wide matrix. Scoped by `FormID` for the
+     * same reason as {@link loadReport} — responses span versions.
+     */
+    async loadAnswersForForm(formId) {
+        const res = (await this.rv.RunView({
+            EntityName: ENTITY.answers,
+            ExtraFilter: answersForFormFilter(formId),
+            ResultType: 'simple',
+            Fields: [
+                'ID',
+                'ResponseID',
+                'QuestionID',
+                'TextValue',
+                'NumericValue',
+                'DateValue',
+                'BooleanValue',
+                'JSONValue',
+                'FileID',
+            ],
+        }));
+        if (!res.Success) {
+            throw new Error(res.ErrorMessage || 'Failed to load answers.');
+        }
+        return res.Results;
+    }
+    /** Loads + parses the published `DefinitionSnapshot` for a version. */
+    async loadDefinition(formVersionId) {
+        const res = (await this.rv.RunView({
+            EntityName: ENTITY.versions,
+            ExtraFilter: `ID='${formVersionId}'`,
+            ResultType: 'simple',
+            Fields: ['ID', 'DefinitionSnapshot'],
+        }));
+        if (!res.Success || res.Results.length === 0) {
+            throw new Error(res.ErrorMessage || 'Form version not found.');
+        }
+        const snapshot = res.Results[0].DefinitionSnapshot;
+        if (!snapshot) {
+            throw new Error('This form version has no published definition snapshot.');
+        }
+        return JSON.parse(snapshot);
+    }
+    static ɵfac = function FormsReportingService_Factory(__ngFactoryType__) { return new (__ngFactoryType__ || FormsReportingService)(); };
+    static ɵprov = /*@__PURE__*/ i0.ɵɵdefineInjectable({ token: FormsReportingService, factory: FormsReportingService.ɵfac });
+}
+(() => { (typeof ngDevMode === "undefined" || ngDevMode) && i0.ɵsetClassMetadata(FormsReportingService, [{
+        type: Injectable
+    }], null, null); })();
+//# sourceMappingURL=forms-reporting.service.js.map

package/dist/lib/dashboard/services/forms-reporting.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forms-reporting.service.js","sourceRoot":"","sources":["../../../../src/lib/dashboard/services/forms-reporting.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAiB,MAAM,sBAAsB,CAAC;AAc9D,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,mBAAmB,GACpB,MAAM,0BAA0B,CAAC;;AAElC,6DAA6D;AAC7D,MAAM,MAAM,GAAG;IACb,KAAK,EAAE,yBAAyB;IAChC,QAAQ,EAAE,iCAAiC;IAC3C,SAAS,EAAE,kCAAkC;IAC7C,OAAO,EAAE,yCAAyC;CAC1C,CAAC;AAEX,qFAAqF;AACrF,MAAM,YAAY,GAAG,mBAAmB,CAAC;AAEzC;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAc;IACjD,OAAO,iCAAiC,YAAY,kCAAkC,MAAM,IAAI,CAAC;AACnG,CAAC;AAGD,MAAM,OAAO,qBAAqB;IACf,EAAE,GAAG,IAAI,OAAO,EAAE,CAAC;IAEpC;;;;OAIG;IACI,KAAK,CAAC,mBAAmB;QAC9B,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,YAAY,CAAC,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC;YACnE;gBACE,UAAU,EAAE,MAAM,CAAC,KAAK;gBACxB,UAAU,EAAE,QAAQ;gBACpB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,CAAC;gBACtB,OAAO,EAAE,MAAM;aAChB;YACD;gBACE,UAAU,EAAE,MAAM,CAAC,QAAQ;gBAC3B,WAAW,EAAE,oBAAoB;gBACjC,UAAU,EAAE,QAAQ;gBACpB,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,eAAe,CAAC;gBACzC,OAAO,EAAE,oBAAoB;aAC9B;YACD;gBACE,UAAU,EAAE,MAAM,CAAC,SAAS;gBAC5B,kFAAkF;gBAClF,mFAAmF;gBACnF,iBAAiB;gBACjB,WAAW,EAAE,mBAAmB;gBAChC,UAAU,EAAE,QAAQ;gBACpB,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,CAAC;aACnC;SACF,CAIA,CAAC;QAEF,IAAI,CAAC,QAAQ,CAAC,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,CAAC;YACvE,MAAM,IAAI,KAAK,CACb,QAAQ,CAAC,YAAY;gBACnB,WAAW,CAAC,YAAY;gBACxB,YAAY,CAAC,YAAY;gBACzB,kCAAkC,CACrC,CAAC;QACJ,CAAC;QAED,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAkB,CAAC;QACtD,KAAK,MAAM,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;YACpC,uEAAuE;YACvE,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;gBACvC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAkB,CAAC;QACtD,KAAK,MAAM,CAAC,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;YACrC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAClF,CAAC;QAED,MAAM,GAAG,GAAqB,EAAE,CAAC;QACjC,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;YACjC,MAAM,aAAa,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACpD,IAAI,CAAC,aAAa,EAAE,CAAC;gBACnB,SAAS,CAAC,uCAAuC;YACnD,CAAC;YACD,GAAG,CAAC,IAAI,CAAC;gBACP,MAAM,EAAE,CAAC,CAAC,EAAE;gBACZ,aAAa;gBACb,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,aAAa,EAAE,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC;aAClD,CAAC,CAAC;QACL,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED;;;;;;;;;OASG;IACI,KAAK,CAAC,UAAU,CAAC,IAAoB;QAC1C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;QACjE,MAAM,SAAS,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAE/C,MAAM,CAAC,YAAY,EAAE,UAAU,CAAC,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC;YACxD;gBACE,UAAU,EAAE,MAAM,CAAC,SAAS;gBAC5B,WAAW,EAAE,WAAW,IAAI,CAAC,MAAM,GAAG;gBACtC,UAAU,EAAE,QAAQ;gBACpB,MAAM,EAAE;oBACN,IAAI;oBACJ,QAAQ;oBACR,WAAW;oBACX,aAAa;oBACb,kBAAkB;oBAClB,oBAAoB;iBACrB;gBACD,OAAO,EAAE,kBAAkB;aAC5B;YACD;gBACE,UAAU,EAAE,MAAM,CAAC,OAAO;gBAC1B,WAAW,EAAE,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC;gBAC9C,UAAU,EAAE,QAAQ;gBACpB,MAAM,EAAE;oBACN,IAAI;oBACJ,YAAY;oBACZ,YAAY;oBACZ,WAAW;oBACX,cAAc;oBACd,WAAW;oBACX,cAAc;oBACd,WAAW;oBACX,QAAQ;iBACT;aACF;SACF,CAGA,CAAC;QAEF,IAAI,CAAC,YAAY,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CACb,YAAY,CAAC,YAAY;gBACvB,UAAU,CAAC,YAAY;gBACvB,2BAA2B,CAC9B,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,YAAY,CAAC,OAAO,CAAC;QACvC,MAAM,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC;QAEnC,OAAO;YACL,IAAI;YACJ,SAAS;YACT,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC;YAChC,UAAU,EAAE,eAAe,CAAC,SAAS,EAAE,OAAO,CAAC;YAC/C,MAAM,EAAE,WAAW,CAAC,UAAU,EAAE,OAAO,CAAC;YACxC,SAAS,EAAE,iBAAiB,CAAC,SAAS,EAAE,OAAO,CAAC;SACjD,CAAC;IACJ,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,kBAAkB,CAC7B,UAAkB,EAClB,SAAkC;QAElC,MAAM,CAAC,WAAW,EAAE,UAAU,CAAC,GAAG,MAAM,IAAI,CAAC,EAAE,CAAC,QAAQ,CAAC;YACvD;gBACE,UAAU,EAAE,MAAM,CAAC,SAAS;gBAC5B,WAAW,EAAE,OAAO,UAAU,GAAG;gBACjC,UAAU,EAAE,QAAQ;gBACpB,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,aAAa,EAAE,kBAAkB,EAAE,oBAAoB,CAAC;aAC/F;YACD;gBACE,UAAU,EAAE,MAAM,CAAC,OAAO;gBAC1B,WAAW,EAAE,eAAe,UAAU,GAAG;gBACzC,UAAU,EAAE,QAAQ;gBACpB,MAAM,EAAE,CAAC,IAAI,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,QAAQ,CAAC;aAC5H;SACF,CAGA,CAAC;QAEF,IAAI,CAAC,WAAW,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,IAAI,WAAW,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpF,MAAM,IAAI,KAAK,CACb,WAAW,CAAC,YAAY,IAAI,UAAU,CAAC,YAAY,IAAI,qBAAqB,CAC7E,CAAC;QACJ,CAAC;QAED,OAAO,mBAAmB,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IACpF,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,kBAAkB,CAC7B,MAAc;QAEd,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;YACjC,UAAU,EAAE,MAAM,CAAC,OAAO;YAC1B,WAAW,EAAE,oBAAoB,CAAC,MAAM,CAAC;YACzC,UAAU,EAAE,QAAQ;YACpB,MAAM,EAAE;gBACN,IAAI;gBACJ,YAAY;gBACZ,YAAY;gBACZ,WAAW;gBACX,cAAc;gBACd,WAAW;gBACX,cAAc;gBACd,WAAW;gBACX,QAAQ;aACT;SACF,CAAC,CAA8D,CAAC;QACjE,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,YAAY,IAAI,yBAAyB,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,uEAAuE;IAC/D,KAAK,CAAC,cAAc,CAAC,aAAqB;QAChD,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;YACjC,UAAU,EAAE,MAAM,CAAC,QAAQ;YAC3B,WAAW,EAAE,OAAO,aAAa,GAAG;YACpC,UAAU,EAAE,QAAQ;YACpB,MAAM,EAAE,CAAC,IAAI,EAAE,oBAAoB,CAAC;SACrC,CAAC,CAAuD,CAAC;QAE1D,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,GAAG,CAAC,YAAY,IAAI,yBAAyB,CAAC,CAAC;QACjE,CAAC;QACD,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,kBAAkB,CAAC;QACnD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAA4B,CAAC;IACzD,CAAC;+GApOU,qBAAqB;gEAArB,qBAAqB,WAArB,qBAAqB;;iFAArB,qBAAqB;cADjC,UAAU"}

package/dist/lib/dashboard/services/reporting-aggregations.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Pure aggregation helpers for the Forms reporting dashboard (WP-F).
+ *
+ * Deliberately free of Angular / RunView so they are trivially unit-testable:
+ * each takes already-fetched rows + the published snapshot and returns a piece
+ * of the `FormReportData` read-model. The service layer does the I/O.
+ */
+import type { mjBizAppsFormsFormResponseEntityType, mjBizAppsFormsFormResponseAnswerEntityType, PublishedFormDefinition, PublishedFormQuestion, FormQuestionType } from '@mj-biz-apps/forms-entities';
+import type { FormSummaryStats, QuestionBreakdown, BreakdownKind, FunnelStep, ResponseListRow, ResponseDetail } from '../models/reporting.model';
+type ResponseRow = mjBizAppsFormsFormResponseEntityType;
+type AnswerRow = mjBizAppsFormsFormResponseAnswerEntityType;
+/** Flattens a definition's pages into questions in page/display order. */
+export declare function flattenQuestions(def: PublishedFormDefinition): PublishedFormQuestion[];
+/** Maps a question type to the breakdown visualisation kind. */
+export declare function breakdownKindFor(type: FormQuestionType): BreakdownKind;
+/**
+ * Builds top-line summary stats from response rows.
+ *
+ * The HEADLINE `totalResponses` counts COMPLETE responses only — a Partial row is an
+ * in-progress autosave, not a submitted response, and must never inflate the count a form
+ * owner sees. `partialResponses` still surfaces the in-progress count separately, and
+ * `completionRate` is complete / (complete + partial) so the drop-off signal is preserved.
+ */
+export declare function buildSummary(responses: ResponseRow[]): FormSummaryStats;
+/** Builds per-question breakdowns. */
+export declare function buildBreakdowns(questions: PublishedFormQuestion[], answers: AnswerRow[]): QuestionBreakdown[];
+/** Builds the page completion / drop-off funnel. */
+export declare function buildFunnel(def: PublishedFormDefinition, answers: AnswerRow[]): FunnelStep[];
+/**
+ * Builds the response-list rows. Lists COMPLETE responses only — a Partial is an in-progress
+ * autosave, not a submitted response, so it must not appear in the headline response list
+ * (it is still reflected in the funnel/drop-off metric, which reads all answers).
+ */
+export declare function buildResponseRows(responses: ResponseRow[], answers: AnswerRow[]): ResponseListRow[];
+/** Builds a single response detail with labelled answers. */
+export declare function buildResponseDetail(response: ResponseRow, answers: AnswerRow[], questions: PublishedFormQuestion[]): ResponseDetail;
+/** Renders an answer to a human-readable string, label-mapping choices. */
+export declare function renderAnswer(q: PublishedFormQuestion, a: AnswerRow): string;
+export {};
+//# sourceMappingURL=reporting-aggregations.d.ts.map

package/dist/lib/dashboard/services/reporting-aggregations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reporting-aggregations.d.ts","sourceRoot":"","sources":["../../../../src/lib/dashboard/services/reporting-aggregations.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EACV,oCAAoC,EACpC,0CAA0C,EAC1C,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EACV,gBAAgB,EAChB,iBAAiB,EACjB,aAAa,EAGb,UAAU,EACV,eAAe,EACf,cAAc,EAEf,MAAM,2BAA2B,CAAC;AAEnC,KAAK,WAAW,GAAG,oCAAoC,CAAC;AACxD,KAAK,SAAS,GAAG,0CAA0C,CAAC;AA2B5D,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,uBAAuB,GAAG,qBAAqB,EAAE,CAQtF;AAED,gEAAgE;AAChE,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,aAAa,CAKtE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,WAAW,EAAE,GAAG,gBAAgB,CAsCvE;AAED,sCAAsC;AACtC,wBAAgB,eAAe,CAC7B,SAAS,EAAE,qBAAqB,EAAE,EAClC,OAAO,EAAE,SAAS,EAAE,GACnB,iBAAiB,EAAE,CAqCrB;AAmHD,oDAAoD;AACpD,wBAAgB,WAAW,CACzB,GAAG,EAAE,uBAAuB,EAC5B,OAAO,EAAE,SAAS,EAAE,GACnB,UAAU,EAAE,CAwCd;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,WAAW,EAAE,EACxB,OAAO,EAAE,SAAS,EAAE,GACnB,eAAe,EAAE,CAenB;AAED,6DAA6D;AAC7D,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,WAAW,EACrB,OAAO,EAAE,SAAS,EAAE,EACpB,SAAS,EAAE,qBAAqB,EAAE,GACjC,cAAc,CAuBhB;AAED,2EAA2E;AAC3E,wBAAgB,YAAY,CAAC,CAAC,EAAE,qBAAqB,EAAE,CAAC,EAAE,SAAS,GAAG,MAAM,CAwB3E"}

package/dist/lib/dashboard/services/reporting-aggregations.js

@@ -0,0 +1,379 @@
+/** Max free-text answers surfaced in a breakdown card before truncation. */
+const FREE_TEXT_CAP = 200;
+/** Question types whose answers are visualised as a choice distribution. */
+const CHOICE_TYPES = new Set([
+    'SingleChoice',
+    'MultiChoice',
+    'Dropdown',
+]);
+/** Question types aggregated numerically. */
+const NUMERIC_TYPES = new Set([
+    'Number',
+    'Rating',
+    'NPS',
+]);
+/** Free-text-style types listed verbatim. */
+const TEXT_TYPES = new Set([
+    'ShortText',
+    'LongText',
+    'Email',
+    'Phone',
+]);
+/** Flattens a definition's pages into questions in page/display order. */
+export function flattenQuestions(def) {
+    const out = [];
+    const pages = [...def.pages].sort((a, b) => a.displayOrder - b.displayOrder);
+    for (const p of pages) {
+        const qs = [...p.questions].sort((a, b) => a.displayOrder - b.displayOrder);
+        out.push(...qs);
+    }
+    return out;
+}
+/** Maps a question type to the breakdown visualisation kind. */
+export function breakdownKindFor(type) {
+    if (type === 'YesNo')
+        return 'boolean';
+    if (CHOICE_TYPES.has(type))
+        return 'distribution';
+    if (NUMERIC_TYPES.has(type))
+        return 'numeric';
+    return 'freeText';
+}
+/**
+ * Builds top-line summary stats from response rows.
+ *
+ * The HEADLINE `totalResponses` counts COMPLETE responses only — a Partial row is an
+ * in-progress autosave, not a submitted response, and must never inflate the count a form
+ * owner sees. `partialResponses` still surfaces the in-progress count separately, and
+ * `completionRate` is complete / (complete + partial) so the drop-off signal is preserved.
+ */
+export function buildSummary(responses) {
+    let complete = 0;
+    let partial = 0;
+    let durationSum = 0;
+    let durationCount = 0;
+    let lastSubmitted = null;
+    for (const r of responses) {
+        if (r.Status !== 'Complete') {
+            partial++;
+            continue;
+        }
+        complete++;
+        const submitted = toDate(r.SubmittedAt);
+        const started = toDate(r.StartedAt);
+        if (submitted && started) {
+            const secs = (submitted.getTime() - started.getTime()) / 1000;
+            if (secs >= 0) {
+                durationSum += secs;
+                durationCount++;
+            }
+        }
+        if (submitted && (!lastSubmitted || submitted > lastSubmitted)) {
+            lastSubmitted = submitted;
+        }
+    }
+    const started = complete + partial;
+    return {
+        // Headline count is Complete-only (Partials are in-progress, not responses).
+        totalResponses: complete,
+        completeResponses: complete,
+        partialResponses: partial,
+        // Completion rate keeps the started (complete + partial) denominator as the drop-off signal.
+        completionRate: started > 0 ? complete / started : 0,
+        averageCompletionSeconds: durationCount > 0 ? durationSum / durationCount : null,
+        lastSubmittedAt: lastSubmitted,
+    };
+}
+/** Builds per-question breakdowns. */
+export function buildBreakdowns(questions, answers) {
+    const byQuestion = groupBy(answers, (a) => a.QuestionID);
+    return questions
+        .filter((q) => q.type !== 'Statement') // display-only, nothing to aggregate
+        .map((q) => {
+        const qAnswers = byQuestion.get(q.id) ?? [];
+        const kind = breakdownKindFor(q.type);
+        const base = {
+            questionId: q.id,
+            prompt: q.prompt,
+            type: q.type,
+            kind,
+            answeredCount: qAnswers.length,
+            buckets: [],
+            numeric: null,
+            textAnswers: [],
+        };
+        switch (kind) {
+            case 'distribution':
+                base.buckets = choiceBuckets(q, qAnswers);
+                break;
+            case 'boolean':
+                base.buckets = booleanBuckets(qAnswers);
+                break;
+            case 'numeric':
+                base.numeric = numericAggregate(q.type, qAnswers);
+                break;
+            case 'freeText':
+                base.textAnswers = qAnswers
+                    .map((a) => (a.TextValue ?? '').trim())
+                    .filter((t) => t.length > 0)
+                    .slice(0, FREE_TEXT_CAP);
+                break;
+        }
+        return base;
+    });
+}
+/** Distribution buckets for choice questions, seeded from the option list. */
+function choiceBuckets(question, answers) {
+    const counts = new Map();
+    const labelByValue = new Map();
+    for (const opt of question.options) {
+        counts.set(opt.value, 0);
+        labelByValue.set(opt.value, opt.label);
+    }
+    let totalSelections = 0;
+    for (const a of answers) {
+        for (const value of extractChoiceValues(a)) {
+            counts.set(value, (counts.get(value) ?? 0) + 1);
+            if (!labelByValue.has(value)) {
+                labelByValue.set(value, value); // value not in option list (legacy/free)
+            }
+            totalSelections++;
+        }
+    }
+    const buckets = [];
+    for (const [value, count] of counts) {
+        buckets.push({
+            label: labelByValue.get(value) ?? value,
+            count,
+            fraction: totalSelections > 0 ? count / totalSelections : 0,
+        });
+    }
+    return buckets.sort((a, b) => b.count - a.count);
+}
+/** Extracts selected values from an answer (single value or multi JSON array). */
+function extractChoiceValues(a) {
+    if (a.JSONValue) {
+        try {
+            const parsed = JSON.parse(a.JSONValue);
+            if (Array.isArray(parsed)) {
+                return parsed.map((v) => String(v));
+            }
+        }
+        catch {
+            // fall through to TextValue
+        }
+    }
+    if (a.TextValue !== null && a.TextValue !== undefined && a.TextValue !== '') {
+        return [a.TextValue];
+    }
+    return [];
+}
+/** Yes/No distribution. */
+function booleanBuckets(answers) {
+    let yes = 0;
+    let no = 0;
+    for (const a of answers) {
+        if (a.BooleanValue === true)
+            yes++;
+        else if (a.BooleanValue === false)
+            no++;
+    }
+    const total = yes + no;
+    return [
+        { label: 'Yes', count: yes, fraction: total > 0 ? yes / total : 0 },
+        { label: 'No', count: no, fraction: total > 0 ? no / total : 0 },
+    ];
+}
+/** Numeric aggregate, with NPS scoring when applicable. */
+function numericAggregate(type, answers) {
+    const values = [];
+    for (const a of answers) {
+        if (a.NumericValue !== null && a.NumericValue !== undefined) {
+            values.push(a.NumericValue);
+        }
+    }
+    const answered = values.length;
+    if (answered === 0) {
+        return { answered: 0, min: null, max: null, average: null, npsScore: null };
+    }
+    let min = values[0];
+    let max = values[0];
+    let sum = 0;
+    for (const v of values) {
+        if (v < min)
+            min = v;
+        if (v > max)
+            max = v;
+        sum += v;
+    }
+    const agg = {
+        answered,
+        min,
+        max,
+        average: sum / answered,
+        npsScore: null,
+    };
+    if (type === 'NPS') {
+        let detractors = 0;
+        let passives = 0;
+        let promoters = 0;
+        for (const v of values) {
+            if (v <= 6)
+                detractors++;
+            else if (v <= 8)
+                passives++;
+            else
+                promoters++;
+        }
+        agg.npsSegments = { detractors, passives, promoters };
+        agg.npsScore = Math.round(((promoters - detractors) / answered) * 100);
+    }
+    return agg;
+}
+/** Builds the page completion / drop-off funnel. */
+export function buildFunnel(def, answers) {
+    const answeredQuestionByResponse = new Map();
+    for (const a of answers) {
+        let set = answeredQuestionByResponse.get(a.ResponseID);
+        if (!set) {
+            set = new Set();
+            answeredQuestionByResponse.set(a.ResponseID, set);
+        }
+        set.add(a.QuestionID);
+    }
+    const pages = [...def.pages].sort((a, b) => a.displayOrder - b.displayOrder);
+    const steps = [];
+    let firstReached = 0;
+    let prevReached = 0;
+    for (let i = 0; i < pages.length; i++) {
+        const page = pages[i];
+        const pageQuestionIds = new Set(page.questions.map((q) => q.id));
+        let reached = 0;
+        for (const answered of answeredQuestionByResponse.values()) {
+            if (hasIntersection(answered, pageQuestionIds)) {
+                reached++;
+            }
+        }
+        if (i === 0) {
+            firstReached = reached;
+        }
+        steps.push({
+            pageId: page.id,
+            title: page.title || `Page ${i + 1}`,
+            displayOrder: page.displayOrder,
+            reached,
+            retention: firstReached > 0 ? reached / firstReached : 0,
+            dropOff: prevReached > 0 ? Math.max(0, (prevReached - reached) / prevReached) : 0,
+        });
+        prevReached = reached;
+    }
+    return steps;
+}
+/**
+ * Builds the response-list rows. Lists COMPLETE responses only — a Partial is an in-progress
+ * autosave, not a submitted response, so it must not appear in the headline response list
+ * (it is still reflected in the funnel/drop-off metric, which reads all answers).
+ */
+export function buildResponseRows(responses, answers) {
+    const answerCountByResponse = new Map();
+    for (const a of answers) {
+        answerCountByResponse.set(a.ResponseID, (answerCountByResponse.get(a.ResponseID) ?? 0) + 1);
+    }
+    return responses
+        .filter((r) => r.Status === 'Complete')
+        .map((r) => ({
+        responseId: r.ID,
+        status: r.Status,
+        startedAt: toDate(r.StartedAt),
+        submittedAt: toDate(r.SubmittedAt),
+        respondent: respondentLabel(r),
+        answeredCount: answerCountByResponse.get(r.ID) ?? 0,
+    }));
+}
+/** Builds a single response detail with labelled answers. */
+export function buildResponseDetail(response, answers, questions) {
+    const questionById = new Map(questions.map((q) => [q.id, q]));
+    const answerViews = [];
+    for (const a of answers) {
+        const q = questionById.get(a.QuestionID);
+        if (!q || q.type === 'Statement') {
+            continue;
+        }
+        answerViews.push({
+            questionId: q.id,
+            prompt: q.prompt,
+            type: q.type,
+            displayValue: renderAnswer(q, a),
+        });
+    }
+    return {
+        responseId: response.ID,
+        status: response.Status,
+        startedAt: toDate(response.StartedAt),
+        submittedAt: toDate(response.SubmittedAt),
+        respondent: respondentLabel(response),
+        answers: answerViews,
+    };
+}
+/** Renders an answer to a human-readable string, label-mapping choices. */
+export function renderAnswer(q, a) {
+    if (q.type === 'YesNo') {
+        return a.BooleanValue === true ? 'Yes' : a.BooleanValue === false ? 'No' : '';
+    }
+    if (CHOICE_TYPES.has(q.type)) {
+        const labelByValue = new Map(q.options.map((o) => [o.value, o.label]));
+        return extractChoiceValues(a)
+            .map((v) => labelByValue.get(v) ?? v)
+            .join(', ');
+    }
+    if (NUMERIC_TYPES.has(q.type)) {
+        return a.NumericValue !== null && a.NumericValue !== undefined ? String(a.NumericValue) : '';
+    }
+    if (q.type === 'Date' || q.type === 'Time') {
+        const d = toDate(a.DateValue);
+        return d ? d.toISOString() : '';
+    }
+    if (q.type === 'FileUpload') {
+        return a.FileID ? `File: ${a.FileID}` : '';
+    }
+    if (TEXT_TYPES.has(q.type)) {
+        return a.TextValue ?? '';
+    }
+    return a.TextValue ?? a.JSONValue ?? '';
+}
+/** Respondent display label: person name, else anonymous session marker. */
+function respondentLabel(r) {
+    if (r.RespondentPerson)
+        return r.RespondentPerson;
+    if (r.AnonymousSessionID)
+        return 'Anonymous';
+    return 'Anonymous';
+}
+/** Coerces a possibly-string datetime into a Date, or null. */
+function toDate(value) {
+    if (value === null || value === undefined)
+        return null;
+    const d = value instanceof Date ? value : new Date(value);
+    return isNaN(d.getTime()) ? null : d;
+}
+function groupBy(items, key) {
+    const map = new Map();
+    for (const item of items) {
+        const k = key(item);
+        const arr = map.get(k);
+        if (arr)
+            arr.push(item);
+        else
+            map.set(k, [item]);
+    }
+    return map;
+}
+function hasIntersection(a, b) {
+    const [small, large] = a.size <= b.size ? [a, b] : [b, a];
+    for (const v of small) {
+        if (large.has(v))
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=reporting-aggregations.js.map