placementt-core 1.400.1133 → 1.400.1135

package/lib/callables/formImport.d.ts

@@ -0,0 +1,78 @@
+import { z } from "zod";
+import { CustomFormSchema } from "../typeDefinitions";
+/**
+ * Contract for AI form import
+ * (`Placementt-Backend/functions/src/formImport.ts`).
+ *
+ * Turns a form that already exists somewhere else (a public Microsoft Forms or
+ * Google Forms link, or a Word document) into a `CustomFormSchema` the form
+ * builder can open. Nothing is saved: the builder opens the result as a draft
+ * and the member of staff saves it the usual way.
+ *
+ * A Word document is read in the browser (mammoth, to HTML) and only its
+ * HTML is sent, so the function never handles the file itself.
+ */
+export declare const formImportCallables: {
+    "formImport-generateFormSchema": {
+        request: z.ZodObject<{
+            /** The organisation the form is for. Staff access is checked. */
+            oId: z.ZodString;
+            source: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"url">;
+                /** A public Microsoft Forms or Google Forms link. */
+                url: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                url: string;
+                kind: "url";
+            }, {
+                url: string;
+                kind: "url";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"document">;
+                fileName: z.ZodString;
+                /** The document as HTML, as mammoth produces it. */
+                html: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                html: string;
+                kind: "document";
+                fileName: string;
+            }, {
+                html: string;
+                kind: "document";
+                fileName: string;
+            }>]>;
+        }, "strip", z.ZodTypeAny, {
+            source: {
+                url: string;
+                kind: "url";
+            } | {
+                html: string;
+                kind: "document";
+                fileName: string;
+            };
+            oId: string;
+        }, {
+            source: {
+                url: string;
+                kind: "url";
+            } | {
+                html: string;
+                kind: "document";
+                fileName: string;
+            };
+            oId: string;
+        }>;
+        response: z.ZodObject<{
+            form: z.ZodType<CustomFormSchema, z.ZodTypeDef, CustomFormSchema>;
+            /** Anything that didn't map across cleanly (file uploads,
+             * multi-select questions, grids), for the user to review. */
+            warnings: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            form: CustomFormSchema;
+            warnings: string[];
+        }, {
+            form: CustomFormSchema;
+            warnings: string[];
+        }>;
+    };
+};

package/lib/callables/formImport.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formImportCallables = void 0;
+const zod_1 = require("zod");
+/**
+ * Contract for AI form import
+ * (`Placementt-Backend/functions/src/formImport.ts`).
+ *
+ * Turns a form that already exists somewhere else (a public Microsoft Forms or
+ * Google Forms link, or a Word document) into a `CustomFormSchema` the form
+ * builder can open. Nothing is saved: the builder opens the result as a draft
+ * and the member of staff saves it the usual way.
+ *
+ * A Word document is read in the browser (mammoth, to HTML) and only its
+ * HTML is sent, so the function never handles the file itself.
+ */
+exports.formImportCallables = {
+    "formImport-generateFormSchema": {
+        request: zod_1.z.object({
+            /** The organisation the form is for. Staff access is checked. */
+            oId: zod_1.z.string(),
+            source: zod_1.z.discriminatedUnion("kind", [
+                zod_1.z.object({
+                    kind: zod_1.z.literal("url"),
+                    /** A public Microsoft Forms or Google Forms link. */
+                    url: zod_1.z.string(),
+                }),
+                zod_1.z.object({
+                    kind: zod_1.z.literal("document"),
+                    fileName: zod_1.z.string(),
+                    /** The document as HTML, as mammoth produces it. */
+                    html: zod_1.z.string(),
+                }),
+            ]),
+        }),
+        response: zod_1.z.object({
+            form: zod_1.z.custom(),
+            /** Anything that didn't map across cleanly (file uploads,
+             * multi-select questions, grids), for the user to review. */
+            warnings: zod_1.z.array(zod_1.z.string()),
+        }),
+    },
+};
+//# sourceMappingURL=formImport.js.map

package/lib/callables/formImport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formImport.js","sourceRoot":"","sources":["../../src/callables/formImport.ts"],"names":[],"mappings":";;;AAAA,6BAAsB;AAItB;;;;;;;;;;;GAWG;AACU,QAAA,mBAAmB,GAAG;IAC/B,+BAA+B,EAAE;QAC7B,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;YACd,iEAAiE;YACjE,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;YACf,MAAM,EAAE,OAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;gBACjC,OAAC,CAAC,MAAM,CAAC;oBACL,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,KAAK,CAAC;oBACtB,qDAAqD;oBACrD,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE;iBAClB,CAAC;gBACF,OAAC,CAAC,MAAM,CAAC;oBACL,IAAI,EAAE,OAAC,CAAC,OAAO,CAAC,UAAU,CAAC;oBAC3B,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE;oBACpB,oDAAoD;oBACpD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE;iBACnB,CAAC;aACL,CAAC;SACL,CAAC;QACF,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,IAAI,EAAE,OAAC,CAAC,MAAM,EAAoB;YAClC;yEAC6D;YAC7D,QAAQ,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC;SAChC,CAAC;KACL;CACoB,CAAC"}

package/lib/callables/index.d.ts

@@ -14,3 +14,4 @@ export * from "./wonde";
 export * from "./misSync";
 export * from "./userManagement";
 export * from "./outreach";
+export * from "./formImport";

package/lib/callables/index.js

@@ -30,4 +30,5 @@ __exportStar(require("./wonde"), exports);
 __exportStar(require("./misSync"), exports);
 __exportStar(require("./userManagement"), exports);
 __exportStar(require("./outreach"), exports);
+__exportStar(require("./formImport"), exports);
 //# sourceMappingURL=index.js.map

package/lib/callables/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/callables/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,6CAA2B;AAC3B,uDAAqC;AACrC,8CAA4B;AAC5B,2CAAyB;AACzB,6CAA2B;AAC3B,oDAAkC;AAClC,uCAAqB;AACrB,oDAAkC;AAClC,4CAA0B;AAC1B,oDAAkC;AAClC,wCAAsB;AACtB,0CAAwB;AACxB,4CAA0B;AAC1B,mDAAiC;AACjC,6CAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/callables/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0CAAwB;AACxB,6CAA2B;AAC3B,uDAAqC;AACrC,8CAA4B;AAC5B,2CAAyB;AACzB,6CAA2B;AAC3B,oDAAkC;AAClC,uCAAqB;AACrB,oDAAkC;AAClC,4CAA0B;AAC1B,oDAAkC;AAClC,wCAAsB;AACtB,0CAAwB;AACxB,4CAA0B;AAC1B,mDAAiC;AACjC,6CAA2B;AAC3B,+CAA6B"}

package/lib/callables/registry.d.ts

@@ -11,6 +11,63 @@ import { z } from "zod";
  * equals the sum of the group key counts.
  */
 export declare const allCallables: {
+    "formImport-generateFormSchema": {
+        request: z.ZodObject<{
+            oId: z.ZodString;
+            source: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                kind: z.ZodLiteral<"url">;
+                url: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                url: string;
+                kind: "url";
+            }, {
+                url: string;
+                kind: "url";
+            }>, z.ZodObject<{
+                kind: z.ZodLiteral<"document">;
+                fileName: z.ZodString;
+                html: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                html: string;
+                kind: "document";
+                fileName: string;
+            }, {
+                html: string;
+                kind: "document";
+                fileName: string;
+            }>]>;
+        }, "strip", z.ZodTypeAny, {
+            source: {
+                url: string;
+                kind: "url";
+            } | {
+                html: string;
+                kind: "document";
+                fileName: string;
+            };
+            oId: string;
+        }, {
+            source: {
+                url: string;
+                kind: "url";
+            } | {
+                html: string;
+                kind: "document";
+                fileName: string;
+            };
+            oId: string;
+        }>;
+        response: z.ZodObject<{
+            form: z.ZodType<import("..").CustomFormSchema, z.ZodTypeDef, import("..").CustomFormSchema>;
+            warnings: z.ZodArray<z.ZodString, "many">;
+        }, "strip", z.ZodTypeAny, {
+            form: import("..").CustomFormSchema;
+            warnings: string[];
+        }, {
+            form: import("..").CustomFormSchema;
+            warnings: string[];
+        }>;
+    };
     "outreach-upsertContacts": {
         request: z.ZodObject<{
             rows: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodOptional<z.ZodString>>, "many">;
@@ -3977,4 +4034,63 @@ export declare const callableGroups: {
             }>;
         };
     };
+    formImportCallables: {
+        "formImport-generateFormSchema": {
+            request: z.ZodObject<{
+                oId: z.ZodString;
+                source: z.ZodDiscriminatedUnion<"kind", [z.ZodObject<{
+                    kind: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    url: string;
+                    kind: "url";
+                }, {
+                    url: string;
+                    kind: "url";
+                }>, z.ZodObject<{
+                    kind: z.ZodLiteral<"document">;
+                    fileName: z.ZodString;
+                    html: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    html: string;
+                    kind: "document";
+                    fileName: string;
+                }, {
+                    html: string;
+                    kind: "document";
+                    fileName: string;
+                }>]>;
+            }, "strip", z.ZodTypeAny, {
+                source: {
+                    url: string;
+                    kind: "url";
+                } | {
+                    html: string;
+                    kind: "document";
+                    fileName: string;
+                };
+                oId: string;
+            }, {
+                source: {
+                    url: string;
+                    kind: "url";
+                } | {
+                    html: string;
+                    kind: "document";
+                    fileName: string;
+                };
+                oId: string;
+            }>;
+            response: z.ZodObject<{
+                form: z.ZodType<import("..").CustomFormSchema, z.ZodTypeDef, import("..").CustomFormSchema>;
+                warnings: z.ZodArray<z.ZodString, "many">;
+            }, "strip", z.ZodTypeAny, {
+                form: import("..").CustomFormSchema;
+                warnings: string[];
+            }, {
+                form: import("..").CustomFormSchema;
+                warnings: string[];
+            }>;
+        };
+    };
 };

package/lib/callables/registry.js

@@ -18,6 +18,7 @@ const wonde_1 = require("./wonde");
 const misSync_1 = require("./misSync");
 const userManagement_1 = require("./userManagement");
 const outreach_1 = require("./outreach");
+const formImport_1 = require("./formImport");
 /**
  * The single source of truth for every typed callable. Add a feature group's
  * spread here and its callables are automatically covered by:
@@ -47,6 +48,7 @@ exports.allCallables = {
     ...misSync_1.misSyncCallables,
     ...userManagement_1.userManagementCallables,
     ...outreach_1.outreachCallables,
+    ...formImport_1.formImportCallables,
 };
 /** The per-group maps, exported so tests can assert no key collisions. */
 exports.callableGroups = {
@@ -67,5 +69,6 @@ exports.callableGroups = {
     misSyncCallables: misSync_1.misSyncCallables,
     userManagementCallables: userManagement_1.userManagementCallables,
     outreachCallables: outreach_1.outreachCallables,
+    formImportCallables: formImport_1.formImportCallables,
 };
 //# sourceMappingURL=registry.js.map

package/lib/callables/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/callables/registry.ts"],"names":[],"mappings":";;;AAEA,6DAAiE;AACjE,2CAA+C;AAC/C,qCAAyC;AACzC,uCAA0C;AAC1C,qCAAyC;AACzC,6CAAiD;AACjD,uDAA2D;AAC3D,6BAAiC;AACjC,uDAAyD;AACzD,uCAA2C;AAC3C,yCAA6C;AAC7C,uDAA2D;AAC3D,+BAAmC;AACnC,mCAAuC;AACvC,uCAA2C;AAC3C,qDAAyD;AACzD,yCAA6C;AAE7C;;;;;;;;;;GAUG;AACU,QAAA,YAAY,GAAG;IACxB,GAAG,gDAA2B;IAC9B,GAAG,8BAAkB;IACrB,GAAG,wBAAe;IAClB,GAAG,yBAAe;IAClB,GAAG,wBAAe;IAClB,GAAG,gCAAmB;IACtB,GAAG,0CAAwB;IAC3B,GAAG,gBAAW;IACd,GAAG,wCAAsB;IACzB,GAAG,0BAAgB;IACnB,GAAG,4BAAiB;IACpB,GAAG,0CAAwB;IAC3B,GAAG,kBAAY;IACf,GAAG,sBAAc;IACjB,GAAG,0BAAgB;IACnB,GAAG,wCAAuB;IAC1B,GAAG,4BAAiB;CACC,CAAC;AAiB1B,0EAA0E;AAC7D,QAAA,cAAc,GAAG;IAC1B,2BAA2B,EAA3B,gDAA2B;IAC3B,kBAAkB,EAAlB,8BAAkB;IAClB,eAAe,EAAf,wBAAe;IACf,eAAe,EAAf,yBAAe;IACf,eAAe,EAAf,wBAAe;IACf,mBAAmB,EAAnB,gCAAmB;IACnB,wBAAwB,EAAxB,0CAAwB;IACxB,WAAW,EAAX,gBAAW;IACX,sBAAsB,EAAtB,wCAAsB;IACtB,gBAAgB,EAAhB,0BAAgB;IAChB,iBAAiB,EAAjB,4BAAiB;IACjB,wBAAwB,EAAxB,0CAAwB;IACxB,YAAY,EAAZ,kBAAY;IACZ,cAAc,EAAd,sBAAc;IACd,gBAAgB,EAAhB,0BAAgB;IAChB,uBAAuB,EAAvB,wCAAuB;IACvB,iBAAiB,EAAjB,4BAAiB;CACpB,CAAC"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/callables/registry.ts"],"names":[],"mappings":";;;AAEA,6DAAiE;AACjE,2CAA+C;AAC/C,qCAAyC;AACzC,uCAA0C;AAC1C,qCAAyC;AACzC,6CAAiD;AACjD,uDAA2D;AAC3D,6BAAiC;AACjC,uDAAyD;AACzD,uCAA2C;AAC3C,yCAA6C;AAC7C,uDAA2D;AAC3D,+BAAmC;AACnC,mCAAuC;AACvC,uCAA2C;AAC3C,qDAAyD;AACzD,yCAA6C;AAC7C,6CAAiD;AAEjD;;;;;;;;;;GAUG;AACU,QAAA,YAAY,GAAG;IACxB,GAAG,gDAA2B;IAC9B,GAAG,8BAAkB;IACrB,GAAG,wBAAe;IAClB,GAAG,yBAAe;IAClB,GAAG,wBAAe;IAClB,GAAG,gCAAmB;IACtB,GAAG,0CAAwB;IAC3B,GAAG,gBAAW;IACd,GAAG,wCAAsB;IACzB,GAAG,0BAAgB;IACnB,GAAG,4BAAiB;IACpB,GAAG,0CAAwB;IAC3B,GAAG,kBAAY;IACf,GAAG,sBAAc;IACjB,GAAG,0BAAgB;IACnB,GAAG,wCAAuB;IAC1B,GAAG,4BAAiB;IACpB,GAAG,gCAAmB;CACD,CAAC;AAiB1B,0EAA0E;AAC7D,QAAA,cAAc,GAAG;IAC1B,2BAA2B,EAA3B,gDAA2B;IAC3B,kBAAkB,EAAlB,8BAAkB;IAClB,eAAe,EAAf,wBAAe;IACf,eAAe,EAAf,yBAAe;IACf,eAAe,EAAf,wBAAe;IACf,mBAAmB,EAAnB,gCAAmB;IACnB,wBAAwB,EAAxB,0CAAwB;IACxB,WAAW,EAAX,gBAAW;IACX,sBAAsB,EAAtB,wCAAsB;IACtB,gBAAgB,EAAhB,0BAAgB;IAChB,iBAAiB,EAAjB,4BAAiB;IACjB,wBAAwB,EAAxB,0CAAwB;IACxB,YAAY,EAAZ,kBAAY;IACZ,cAAc,EAAd,sBAAc;IACd,gBAAgB,EAAhB,0BAAgB;IAChB,uBAAuB,EAAvB,wCAAuB;IACvB,iBAAiB,EAAjB,4BAAiB;IACjB,mBAAmB,EAAnB,gCAAmB;CACtB,CAAC"}

package/lib/config.js

@@ -13,8 +13,10 @@ const contactsSlice_1 = __importDefault(require("./features/contacts/contactsSli
 const activePlacement_1 = __importDefault(require("./features/placements/studentPlacements/activePlacement"));
 const logsSlice_1 = __importDefault(require("./features/logs/logsSlice"));
 const async_storage_1 = __importDefault(require("@react-native-async-storage/async-storage"));
+const firebaseConfig_1 = require("./firebase/firebaseConfig");
 const persistConfig = {
-    key: "root",
+    // The admin popout is signed in as someone else, so keep its cached state apart.
+    key: firebaseConfig_1.isAdminPopoutWindow ? "adminPopoutRoot" : "root",
     version: 1,
     storage: async_storage_1.default,
 };

package/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;;;;AAAA,8CAAgE;AAChE,iDAA4C;AAC5C,0EAAmD;AACnD,4IAAqH;AACrH,8IAAuH;AACvH,sFAA+D;AAC/D,8GAA4F;AAC5F,0EAAmD;AACnD,8FAAoE;AAGpE,MAAM,aAAa,GAAG;IAClB,GAAG,EAAE,MAAM;IACX,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,uBAAY;CACtB,CAAA;AAEH,MAAM,QAAQ,GAAG,IAAA,yBAAe,EAAC;IAC/B,yBAAyB,EAAE,wCAAgC;IAC3D,0BAA0B,EAAE,yCAAiC;IAC7D,QAAQ,EAAE,uBAAe;IACzB,eAAe,EAAE,yBAAsB;IACvC,IAAI,EAAE,mBAAW;IACjB,IAAI,EAAE,mBAAW;CAClB,CAAC,CAAC;AAGH,MAAM,iBAAiB,GAAG,IAAA,8BAAc,EAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;AAGrD,QAAA,KAAK,GAAG,IAAA,wBAAc,EAAC;IAClC,OAAO,EAAE,iBAAiB;IAC1B,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;IAC/C,UAAU,EAAE,CAAC,oBAAoB,EAAE,EAAE,CACrC,oBAAoB,CAAC;QACnB,cAAc,EAAE,KAAK;QACrB,iBAAiB,EAAE,KAAK;KACzB,CAAC;CAEH,CAAC,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;;;;;AAAA,8CAAgE;AAChE,iDAA4C;AAC5C,0EAAmD;AACnD,4IAAqH;AACrH,8IAAuH;AACvH,sFAA+D;AAC/D,8GAA4F;AAC5F,0EAAmD;AACnD,8FAAoE;AACpE,8DAA6D;AAG7D,MAAM,aAAa,GAAG;IAClB,iFAAiF;IACjF,GAAG,EAAE,oCAAmB,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,MAAM;IACrD,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,uBAAY;CACtB,CAAA;AAEH,MAAM,QAAQ,GAAG,IAAA,yBAAe,EAAC;IAC/B,yBAAyB,EAAE,wCAAgC;IAC3D,0BAA0B,EAAE,yCAAiC;IAC7D,QAAQ,EAAE,uBAAe;IACzB,eAAe,EAAE,yBAAsB;IACvC,IAAI,EAAE,mBAAW;IACjB,IAAI,EAAE,mBAAW;CAClB,CAAC,CAAC;AAGH,MAAM,iBAAiB,GAAG,IAAA,8BAAc,EAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;AAGrD,QAAA,KAAK,GAAG,IAAA,wBAAc,EAAC;IAClC,OAAO,EAAE,iBAAiB;IAC1B,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;IAC/C,UAAU,EAAE,CAAC,oBAAoB,EAAE,EAAE,CACrC,oBAAoB,CAAC;QACnB,cAAc,EAAE,KAAK;QACrB,iBAAiB,EAAE,KAAK;KACzB,CAAC;CAEH,CAAC,CAAC"}

package/lib/firebase/firebaseConfig.d.ts

@@ -16,7 +16,11 @@ export declare const credentialsProd: {
     appId: string;
     measurementId: string;
 };
+export declare const ADMIN_POPOUT_PATH = "/admin/institute-popup";
+export declare const isAdminPopoutWindow: boolean;
 export declare const auth: import("@firebase/auth").Auth;
 export declare const db: import("@firebase/firestore").Firestore;
 export declare const functions: import("@firebase/functions").Functions;
 export declare const storage: import("@firebase/storage").FirebaseStorage;
+export declare const stashAdminSessionForPopout: () => Promise<void>;
+export declare const clearAdminPopoutSession: () => Promise<void>;

package/lib/firebase/firebaseConfig.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.storage = exports.functions = exports.db = exports.auth = exports.credentialsProd = exports.credentialsDev = void 0;
+exports.clearAdminPopoutSession = exports.stashAdminSessionForPopout = exports.storage = exports.functions = exports.db = exports.auth = exports.isAdminPopoutWindow = exports.ADMIN_POPOUT_PATH = exports.credentialsProd = exports.credentialsDev = void 0;
 /* eslint-disable no-multiple-empty-lines */
 const async_storage_1 = __importDefault(require("@react-native-async-storage/async-storage"));
 const app_1 = require("firebase/app");
@@ -31,8 +31,20 @@ exports.credentialsProd = {
     measurementId: "G-NW5YMC6JN8",
 };
 const firebaseConfig = !(0, app_1.getApps)().length ? (0, app_1.initializeApp)(exports.credentialsDev) : (0, app_1.getApp)();
+// The admin panel's institute popout (opened while an admin is signed in as a
+// staff user) keeps its own auth session under prefixed keys, so it stays
+// signed in as the admin without touching the impersonated session every
+// other window shares.
+exports.ADMIN_POPOUT_PATH = "/admin/institute-popup";
+const ADMIN_POPOUT_PREFIX = "adminPopout:";
+exports.isAdminPopoutWindow = typeof window !== "undefined" && window.location?.pathname === exports.ADMIN_POPOUT_PATH;
+const prefixedStorage = (prefix) => ({
+    setItem: (key, value) => async_storage_1.default.setItem(prefix + key, value),
+    getItem: (key) => async_storage_1.default.getItem(prefix + key),
+    removeItem: (key) => async_storage_1.default.removeItem(prefix + key),
+});
 (0, auth_1.initializeAuth)(firebaseConfig, {
-    persistence: (0, persistence_1.getReactNativePersistence)(async_storage_1.default),
+    persistence: (0, persistence_1.getReactNativePersistence)(exports.isAdminPopoutWindow ? prefixedStorage(ADMIN_POPOUT_PREFIX) : async_storage_1.default),
 });
 (0, firestore_1.initializeFirestore)(firebaseConfig, {
     ignoreUndefinedProperties: true,
@@ -42,5 +54,17 @@ exports.auth = (0, auth_1.getAuth)(firebaseConfig);
 exports.db = (0, firestore_1.getFirestore)(firebaseConfig);
 exports.functions = (0, functions_1.getFunctions)(firebaseConfig, "europe-west2");
 exports.storage = (0, storage_1.getStorage)(firebaseConfig);
+// Firebase auth's own persistence key for the signed-in user.
+const authUserKey = `firebase:authUser:${firebaseConfig.options.apiKey}:${firebaseConfig.name}`;
+// Copies the current (admin) session to the popout window's keys. Call it
+// before signing in as another user, while the stored session is still the admin's.
+const stashAdminSessionForPopout = async () => {
+    const session = await async_storage_1.default.getItem(authUserKey);
+    if (session)
+        await async_storage_1.default.setItem(ADMIN_POPOUT_PREFIX + authUserKey, session);
+};
+exports.stashAdminSessionForPopout = stashAdminSessionForPopout;
+const clearAdminPopoutSession = () => async_storage_1.default.removeItem(ADMIN_POPOUT_PREFIX + authUserKey);
+exports.clearAdminPopoutSession = clearAdminPopoutSession;
 // connectFunctionsEmulator(functions, "localhost", 5001);
 //# sourceMappingURL=firebaseConfig.js.map

package/lib/firebase/firebaseConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"firebaseConfig.js","sourceRoot":"","sources":["../../src/firebase/firebaseConfig.tsx"],"names":[],"mappings":";;;;;;AAAA,4CAA4C;AAC5C,8FAAqE;AACrE,sCAA4D;AAC5D,wCAAsD;AACtD,kDAAqE;AACrE,kDAAgD;AAChD,8CAA4C;AAC5C,+CAAwD;AAE3C,QAAA,cAAc,GAAG;IAC1B,MAAM,EAAE,yCAAyC;IACjD,UAAU,EAAE,gCAAgC;IAC5C,SAAS,EAAE,gBAAgB;IAC3B,aAAa,EAAE,4BAA4B;IAC3C,iBAAiB,EAAE,cAAc;IACjC,KAAK,EAAE,2CAA2C;IAClD,aAAa,EAAE,cAAc;CAChC,CAAC;AAEW,QAAA,eAAe,GAAG;IAC3B,MAAM,EAAE,yCAAyC;IACjD,UAAU,EAAE,kCAAkC;IAC9C,SAAS,EAAE,kBAAkB;IAC7B,aAAa,EAAE,8BAA8B;IAC7C,iBAAiB,EAAE,cAAc;IACjC,KAAK,EAAE,2CAA2C;IAClD,aAAa,EAAE,cAAc;CAChC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,IAAA,aAAO,GAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAA,mBAAa,EAAC,sBAAc,CAAC,CAAC,CAAC,CAAC,IAAA,YAAM,GAAE,CAAC;AAEpF,IAAA,qBAAc,EAAC,cAAc,EAAE;IAC3B,WAAW,EAAE,IAAA,uCAAyB,EAAC,uBAAY,CAAC;CACvD,CAAC,CAAC;AAEH,IAAA,+BAAmB,EAAC,cAAc,EAAE;IAChC,yBAAyB,EAAE,IAAI;IAC/B,iCAAiC,EAAE,IAAI;CAC1C,CAAC,CAAC;AAEU,QAAA,IAAI,GAAG,IAAA,cAAO,EAAC,cAAc,CAAC,CAAC;AAC/B,QAAA,EAAE,GAAG,IAAA,wBAAY,EAAC,cAAc,CAAC,CAAC;AAClC,QAAA,SAAS,GAAG,IAAA,wBAAY,EAAC,cAAc,EAAE,cAAc,CAAC,CAAC;AACzD,QAAA,OAAO,GAAG,IAAA,oBAAU,EAAC,cAAc,CAAC,CAAC;AAElD,0DAA0D"}
+{"version":3,"file":"firebaseConfig.js","sourceRoot":"","sources":["../../src/firebase/firebaseConfig.tsx"],"names":[],"mappings":";;;;;;AAAA,4CAA4C;AAC5C,8FAAqE;AACrE,sCAA4D;AAC5D,wCAA+E;AAC/E,kDAAqE;AACrE,kDAAgD;AAChD,8CAA4C;AAC5C,+CAAwD;AAE3C,QAAA,cAAc,GAAG;IAC1B,MAAM,EAAE,yCAAyC;IACjD,UAAU,EAAE,gCAAgC;IAC5C,SAAS,EAAE,gBAAgB;IAC3B,aAAa,EAAE,4BAA4B;IAC3C,iBAAiB,EAAE,cAAc;IACjC,KAAK,EAAE,2CAA2C;IAClD,aAAa,EAAE,cAAc;CAChC,CAAC;AAEW,QAAA,eAAe,GAAG;IAC3B,MAAM,EAAE,yCAAyC;IACjD,UAAU,EAAE,kCAAkC;IAC9C,SAAS,EAAE,kBAAkB;IAC7B,aAAa,EAAE,8BAA8B;IAC7C,iBAAiB,EAAE,cAAc;IACjC,KAAK,EAAE,2CAA2C;IAClD,aAAa,EAAE,cAAc;CAChC,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,IAAA,aAAO,GAAE,CAAC,MAAM,CAAC,CAAC,CAAC,IAAA,mBAAa,EAAC,sBAAc,CAAC,CAAC,CAAC,CAAC,IAAA,YAAM,GAAE,CAAC;AAEpF,8EAA8E;AAC9E,0EAA0E;AAC1E,yEAAyE;AACzE,uBAAuB;AACV,QAAA,iBAAiB,GAAG,wBAAwB,CAAC;AAC1D,MAAM,mBAAmB,GAAG,cAAc,CAAC;AAC9B,QAAA,mBAAmB,GAAG,OAAO,MAAM,KAAK,WAAW,IAAI,MAAM,CAAC,QAAQ,EAAE,QAAQ,KAAK,yBAAiB,CAAC;AAEpH,MAAM,eAAe,GAAG,CAAC,MAAc,EAA2B,EAAE,CAAC,CAAC;IAClE,OAAO,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,uBAAY,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,EAAE,KAAK,CAAC;IAClE,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,uBAAY,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC;IACpD,UAAU,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,uBAAY,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC;CAC7D,CAAC,CAAC;AAEH,IAAA,qBAAc,EAAC,cAAc,EAAE;IAC3B,WAAW,EAAE,IAAA,uCAAyB,EAAC,2BAAmB,CAAC,CAAC,CAAC,eAAe,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,uBAAY,CAAC;CACpH,CAAC,CAAC;AAEH,IAAA,+BAAmB,EAAC,cAAc,EAAE;IAChC,yBAAyB,EAAE,IAAI;IAC/B,iCAAiC,EAAE,IAAI;CAC1C,CAAC,CAAC;AAEU,QAAA,IAAI,GAAG,IAAA,cAAO,EAAC,cAAc,CAAC,CAAC;AAC/B,QAAA,EAAE,GAAG,IAAA,wBAAY,EAAC,cAAc,CAAC,CAAC;AAClC,QAAA,SAAS,GAAG,IAAA,wBAAY,EAAC,cAAc,EAAE,cAAc,CAAC,CAAC;AACzD,QAAA,OAAO,GAAG,IAAA,oBAAU,EAAC,cAAc,CAAC,CAAC;AAElD,8DAA8D;AAC9D,MAAM,WAAW,GAAG,qBAAqB,cAAc,CAAC,OAAO,CAAC,MAAM,IAAI,cAAc,CAAC,IAAI,EAAE,CAAC;AAEhG,0EAA0E;AAC1E,oFAAoF;AAC7E,MAAM,0BAA0B,GAAG,KAAK,IAAI,EAAE;IACjD,MAAM,OAAO,GAAG,MAAM,uBAAY,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACxD,IAAI,OAAO;QAAE,MAAM,uBAAY,CAAC,OAAO,CAAC,mBAAmB,GAAG,WAAW,EAAE,OAAO,CAAC,CAAC;AACxF,CAAC,CAAC;AAHW,QAAA,0BAA0B,8BAGrC;AAEK,MAAM,uBAAuB,GAAG,GAAG,EAAE,CAAC,uBAAY,CAAC,UAAU,CAAC,mBAAmB,GAAG,WAAW,CAAC,CAAC;AAA3F,QAAA,uBAAuB,2BAAoE;AAExG,0DAA0D"}

package/package.json

@@ -2,7 +2,7 @@
   "private": false,
   "name": "placementt-core",
   "author": "Placementt",
-  "version": "1.400.1133",
+  "version": "1.400.1135",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "scripts": {

package/src/callables/formImport.ts

@@ -0,0 +1,43 @@
+import {z} from "zod";
+import {CallableGroup} from "./types";
+import {CustomFormSchema} from "../typeDefinitions";
+
+/**
+ * Contract for AI form import
+ * (`Placementt-Backend/functions/src/formImport.ts`).
+ *
+ * Turns a form that already exists somewhere else (a public Microsoft Forms or
+ * Google Forms link, or a Word document) into a `CustomFormSchema` the form
+ * builder can open. Nothing is saved: the builder opens the result as a draft
+ * and the member of staff saves it the usual way.
+ *
+ * A Word document is read in the browser (mammoth, to HTML) and only its
+ * HTML is sent, so the function never handles the file itself.
+ */
+export const formImportCallables = {
+    "formImport-generateFormSchema": {
+        request: z.object({
+            /** The organisation the form is for. Staff access is checked. */
+            oId: z.string(),
+            source: z.discriminatedUnion("kind", [
+                z.object({
+                    kind: z.literal("url"),
+                    /** A public Microsoft Forms or Google Forms link. */
+                    url: z.string(),
+                }),
+                z.object({
+                    kind: z.literal("document"),
+                    fileName: z.string(),
+                    /** The document as HTML, as mammoth produces it. */
+                    html: z.string(),
+                }),
+            ]),
+        }),
+        response: z.object({
+            form: z.custom<CustomFormSchema>(),
+            /** Anything that didn't map across cleanly (file uploads,
+             * multi-select questions, grids), for the user to review. */
+            warnings: z.array(z.string()),
+        }),
+    },
+} satisfies CallableGroup;

package/src/callables/index.ts

@@ -14,3 +14,4 @@ export * from "./wonde";
 export * from "./misSync";
 export * from "./userManagement";
 export * from "./outreach";
+export * from "./formImport";

package/src/callables/registry.ts

@@ -17,6 +17,7 @@ import {wondeCallables} from "./wonde";
 import {misSyncCallables} from "./misSync";
 import {userManagementCallables} from "./userManagement";
 import {outreachCallables} from "./outreach";
+import {formImportCallables} from "./formImport";
 
 /**
  * The single source of truth for every typed callable. Add a feature group's
@@ -47,6 +48,7 @@ export const allCallables = {
     ...misSyncCallables,
     ...userManagementCallables,
     ...outreachCallables,
+    ...formImportCallables,
 } satisfies CallableGroup;
 
 /** Every registered callable name. */
@@ -83,4 +85,5 @@ export const callableGroups = {
     misSyncCallables,
     userManagementCallables,
     outreachCallables,
+    formImportCallables,
 };

package/src/config.ts

@@ -7,10 +7,12 @@ import contactsReducer from "./features/contacts/contactsSlice"
 import activePlacementReducer from "./features/placements/studentPlacements/activePlacement"
 import logsReducer from "./features/logs/logsSlice"
 import AsyncStorage from '@react-native-async-storage/async-storage'
+import {isAdminPopoutWindow} from "./firebase/firebaseConfig"
 
 
 const persistConfig = {
-    key: "root",
+    // The admin popout is signed in as someone else, so keep its cached state apart.
+    key: isAdminPopoutWindow ? "adminPopoutRoot" : "root",
     version: 1,
     storage: AsyncStorage,
   }

package/src/firebase/firebaseConfig.tsx

@@ -1,7 +1,7 @@
 /* eslint-disable no-multiple-empty-lines */
 import AsyncStorage from "@react-native-async-storage/async-storage";
 import {getApp, getApps, initializeApp} from "firebase/app";
-import {getAuth, initializeAuth} from "firebase/auth";
+import {ReactNativeAsyncStorage, getAuth, initializeAuth} from "firebase/auth";
 import {getFirestore, initializeFirestore} from "firebase/firestore";
 import {getFunctions} from "firebase/functions";
 import {getStorage} from "firebase/storage";
@@ -29,8 +29,22 @@ export const credentialsProd = {
 
 const firebaseConfig = !getApps().length ? initializeApp(credentialsDev) : getApp();
 
+// The admin panel's institute popout (opened while an admin is signed in as a
+// staff user) keeps its own auth session under prefixed keys, so it stays
+// signed in as the admin without touching the impersonated session every
+// other window shares.
+export const ADMIN_POPOUT_PATH = "/admin/institute-popup";
+const ADMIN_POPOUT_PREFIX = "adminPopout:";
+export const isAdminPopoutWindow = typeof window !== "undefined" && window.location?.pathname === ADMIN_POPOUT_PATH;
+
+const prefixedStorage = (prefix: string): ReactNativeAsyncStorage => ({
+    setItem: (key, value) => AsyncStorage.setItem(prefix + key, value),
+    getItem: (key) => AsyncStorage.getItem(prefix + key),
+    removeItem: (key) => AsyncStorage.removeItem(prefix + key),
+});
+
 initializeAuth(firebaseConfig, {
-    persistence: getReactNativePersistence(AsyncStorage),
+    persistence: getReactNativePersistence(isAdminPopoutWindow ? prefixedStorage(ADMIN_POPOUT_PREFIX) : AsyncStorage),
 });
 
 initializeFirestore(firebaseConfig, {
@@ -43,6 +57,18 @@ export const db = getFirestore(firebaseConfig);
 export const functions = getFunctions(firebaseConfig, "europe-west2");
 export const storage = getStorage(firebaseConfig);
 
+// Firebase auth's own persistence key for the signed-in user.
+const authUserKey = `firebase:authUser:${firebaseConfig.options.apiKey}:${firebaseConfig.name}`;
+
+// Copies the current (admin) session to the popout window's keys. Call it
+// before signing in as another user, while the stored session is still the admin's.
+export const stashAdminSessionForPopout = async () => {
+    const session = await AsyncStorage.getItem(authUserKey);
+    if (session) await AsyncStorage.setItem(ADMIN_POPOUT_PREFIX + authUserKey, session);
+};
+
+export const clearAdminPopoutSession = () => AsyncStorage.removeItem(ADMIN_POPOUT_PREFIX + authUserKey);
+
 // connectFunctionsEmulator(functions, "localhost", 5001);