@appcorp/fusion-storybook 0.1.4

package/utils/pdf-generator.d.ts

@@ -0,0 +1,41 @@
+import { Template } from "@pdfme/common";
+/**
+ * PDF Generation Utility using Vista Templates
+ *
+ * Provides functions to generate PDFs using Vista templates with @pdfme.
+ */
+export interface PDFTemplateData {
+    [key: string]: unknown;
+}
+export interface PDFOptions {
+    template: Template;
+    data: PDFTemplateData;
+    filename?: string;
+    orientation?: "portrait" | "landscape";
+}
+/**
+ * Generate a PDF using a Vista template
+ *
+ * @param options - PDF generation options
+ * @returns Promise<Uint8Array> - PDF as Uint8Array
+ */
+export declare function generatePDF(options: PDFOptions): Promise<Uint8Array>;
+/**
+ * Generate and download a PDF using a Vista template
+ *
+ * @param options - PDF generation options
+ */
+export declare function downloadPDF(options: PDFOptions): Promise<void>;
+/**
+ * Generate a PDF and return as base64 string
+ *
+ * @param options - PDF generation options
+ * @returns Promise<string> - Base64 encoded PDF
+ */
+export declare function generatePDFBase64(options: PDFOptions): Promise<string>;
+/**
+ * Print a PDF directly to printer (client-side printing)
+ *
+ * @param options - PDF generation options
+ */
+export declare function printPDF(options: PDFOptions): Promise<void>;

package/utils/pdf-generator.js

@@ -0,0 +1,107 @@
+import { generate } from "@pdfme/generator";
+import { text, table, image, line } from "@pdfme/schemas";
+/**
+ * Generate a PDF using a Vista template
+ *
+ * @param options - PDF generation options
+ * @returns Promise<Uint8Array> - PDF as Uint8Array
+ */
+export async function generatePDF(options) {
+    try {
+        const { template, data } = options;
+        // Generate PDF using @pdfme/generator
+        const pdf = await generate({
+            template,
+            inputs: [data], // @pdfme expects an array of inputs
+            plugins: {
+                text,
+                table,
+                image,
+                line,
+            },
+        });
+        return pdf;
+    }
+    catch (error) {
+        console.error("Error generating PDF:", error);
+        throw new Error(`Failed to generate PDF: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+}
+/**
+ * Generate and download a PDF using a Vista template
+ *
+ * @param options - PDF generation options
+ */
+export async function downloadPDF(options) {
+    try {
+        const pdf = await generatePDF(options);
+        const { filename = "document.pdf" } = options;
+        // Create blob and download
+        const blob = new Blob([pdf], { type: "application/pdf" });
+        const url = URL.createObjectURL(blob);
+        const link = document.createElement("a");
+        link.href = url;
+        link.download = filename;
+        document.body.appendChild(link);
+        link.click();
+        document.body.removeChild(link);
+        // Clean up
+        URL.revokeObjectURL(url);
+    }
+    catch (error) {
+        console.error("Error downloading PDF:", error);
+        throw error;
+    }
+}
+/**
+ * Generate a PDF and return as base64 string
+ *
+ * @param options - PDF generation options
+ * @returns Promise<string> - Base64 encoded PDF
+ */
+export async function generatePDFBase64(options) {
+    try {
+        const pdf = await generatePDF(options);
+        // Convert Uint8Array to base64
+        const binaryString = Array.from(pdf, (byte) => String.fromCharCode(byte)).join("");
+        return btoa(binaryString);
+    }
+    catch (error) {
+        console.error("Error generating PDF base64:", error);
+        throw error;
+    }
+}
+/**
+ * Print a PDF directly to printer (client-side printing)
+ *
+ * @param options - PDF generation options
+ */
+export async function printPDF(options) {
+    try {
+        const pdf = await generatePDF(options);
+        // Create blob and open in new window for printing
+        const blob = new Blob([pdf], { type: "application/pdf" });
+        const url = URL.createObjectURL(blob);
+        const printWindow = window.open(url, "_blank");
+        if (printWindow) {
+            printWindow.onload = () => {
+                printWindow.print();
+                URL.revokeObjectURL(url);
+            };
+        }
+        else {
+            // Fallback: download if popup blocked
+            const link = document.createElement("a");
+            link.href = url;
+            link.download = options.filename || "document.pdf";
+            document.body.appendChild(link);
+            link.click();
+            document.body.removeChild(link);
+            URL.revokeObjectURL(url);
+        }
+    }
+    catch (error) {
+        console.error("Error printing PDF:", error);
+        throw new Error(`Failed to print PDF: ${error instanceof Error ? error.message : "Unknown error"}`);
+    }
+}

package/utils/resolve-rbac-permissions.d.ts

@@ -0,0 +1,11 @@
+import { USER_ROLE } from "@/type";
+interface ResolveRbacPermissionsParams {
+    userRole: USER_ROLE;
+    moduleName: string;
+}
+/**
+ * Resolves RBAC permissions based on the user role.
+ * Returns true if the user has admin-level permissions, false otherwise.
+ */
+export declare function resolveRbacPermissions({ userRole, moduleName, }: ResolveRbacPermissionsParams): boolean;
+export {};

package/utils/resolve-rbac-permissions.js

@@ -0,0 +1,251 @@
+import { USER_ROLE } from "@/type";
+/**
+ * Resolves RBAC permissions based on the user role.
+ * Returns true if the user has admin-level permissions, false otherwise.
+ */
+export function resolveRbacPermissions({ userRole, moduleName, }) {
+    // dashboard navigation
+    if (moduleName === "Dashboard") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: true,
+            [USER_ROLE.TEACHER]: true,
+            [USER_ROLE.STUDENT]: true,
+            [USER_ROLE.PARENT]: true,
+        }[userRole] || false);
+    }
+    if (moduleName === "Admission") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: true,
+            [USER_ROLE.TEACHER]: false,
+            [USER_ROLE.STUDENT]: false,
+            [USER_ROLE.PARENT]: false,
+        }[userRole] || false);
+    }
+    if (moduleName === "People Management") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: true,
+            [USER_ROLE.TEACHER]: false,
+            [USER_ROLE.STUDENT]: false,
+            [USER_ROLE.PARENT]: false,
+        }[userRole] || false);
+    }
+    if (moduleName === "Academic Structure") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: true,
+            [USER_ROLE.TEACHER]: true,
+            [USER_ROLE.STUDENT]: true,
+            [USER_ROLE.PARENT]: true,
+        }[userRole] || false);
+    }
+    if (moduleName === "Academic Operations") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: true,
+            [USER_ROLE.TEACHER]: true,
+            [USER_ROLE.STUDENT]: true,
+            [USER_ROLE.PARENT]: true,
+        }[userRole] || false);
+    }
+    if (moduleName === "Course") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: true,
+            [USER_ROLE.TEACHER]: true,
+            [USER_ROLE.STUDENT]: true,
+            [USER_ROLE.PARENT]: true,
+        }[userRole] || false);
+    }
+    if (moduleName === "Enrollment") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: true,
+            [USER_ROLE.TEACHER]: true,
+            [USER_ROLE.STUDENT]: true,
+            [USER_ROLE.PARENT]: true,
+        }[userRole] || false);
+    }
+    if (moduleName === "Schedule") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: true,
+            [USER_ROLE.TEACHER]: true,
+            [USER_ROLE.STUDENT]: true,
+            [USER_ROLE.PARENT]: true,
+        }[userRole] || false);
+    }
+    if (moduleName === "Attendance") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: true,
+            [USER_ROLE.TEACHER]: true,
+            [USER_ROLE.STUDENT]: true,
+            [USER_ROLE.PARENT]: true,
+        }[userRole] || false);
+    }
+    if (moduleName === "Grade") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: true,
+            [USER_ROLE.TEACHER]: true,
+            [USER_ROLE.STUDENT]: true,
+            [USER_ROLE.PARENT]: true,
+        }[userRole] || false);
+    }
+    if (moduleName === "Financial Management") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: false,
+            [USER_ROLE.TEACHER]: false,
+            [USER_ROLE.STUDENT]: false,
+            [USER_ROLE.PARENT]: false,
+        }[userRole] || false);
+    }
+    if (moduleName === "Fee Structure") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: false,
+            [USER_ROLE.TEACHER]: false,
+            [USER_ROLE.STUDENT]: false,
+            [USER_ROLE.PARENT]: false,
+        }[userRole] || false);
+    }
+    if (moduleName === "Student Fee") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: false,
+            [USER_ROLE.TEACHER]: false,
+            [USER_ROLE.STUDENT]: false,
+            [USER_ROLE.PARENT]: false,
+        }[userRole] || false);
+    }
+    if (moduleName === "Expense") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: false,
+            [USER_ROLE.TEACHER]: false,
+            [USER_ROLE.STUDENT]: false,
+            [USER_ROLE.PARENT]: false,
+        }[userRole] || false);
+    }
+    if (moduleName === "Fee Agent") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: false,
+            [USER_ROLE.TEACHER]: false,
+            [USER_ROLE.STUDENT]: false,
+            [USER_ROLE.PARENT]: false,
+        }[userRole] || false);
+    }
+    if (moduleName === "Communication") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: true,
+            [USER_ROLE.TEACHER]: false,
+            [USER_ROLE.STUDENT]: false,
+            [USER_ROLE.PARENT]: false,
+        }[userRole] || false);
+    }
+    // dashboard footer
+    if (moduleName === "Workspace") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: true,
+            [USER_ROLE.TEACHER]: false,
+            [USER_ROLE.STUDENT]: false,
+            [USER_ROLE.PARENT]: false,
+        }[userRole] || false);
+    }
+    if (moduleName === "School") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: true,
+            [USER_ROLE.TEACHER]: false,
+            [USER_ROLE.STUDENT]: false,
+            [USER_ROLE.PARENT]: false,
+        }[userRole] || false);
+    }
+    if (moduleName === "User") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: true,
+            [USER_ROLE.TEACHER]: false,
+            [USER_ROLE.STUDENT]: false,
+            [USER_ROLE.PARENT]: false,
+        }[userRole] || false);
+    }
+    if (moduleName === "Workspace User") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: true,
+            [USER_ROLE.TEACHER]: false,
+            [USER_ROLE.STUDENT]: false,
+            [USER_ROLE.PARENT]: false,
+        }[userRole] || false);
+    }
+    if (moduleName === "Discount Codes") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: true,
+            [USER_ROLE.TEACHER]: false,
+            [USER_ROLE.STUDENT]: false,
+            [USER_ROLE.PARENT]: false,
+        }[userRole] || false);
+    }
+    if (moduleName === "Role Based Access Control") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: false,
+            [USER_ROLE.TEACHER]: false,
+            [USER_ROLE.STUDENT]: false,
+            [USER_ROLE.PARENT]: false,
+        }[userRole] || false);
+    }
+    // dashboard apps
+    if (moduleName === "AI Attendance") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: true,
+            [USER_ROLE.TEACHER]: false,
+            [USER_ROLE.STUDENT]: false,
+            [USER_ROLE.PARENT]: false,
+        }[userRole] || false);
+    }
+    if (moduleName === "Reports") {
+        return ({
+            [USER_ROLE.SUPER_ADMIN]: true,
+            [USER_ROLE.SCHOOL_ADMIN]: true,
+            [USER_ROLE.STAFF]: true,
+            [USER_ROLE.TEACHER]: false,
+            [USER_ROLE.STUDENT]: false,
+            [USER_ROLE.PARENT]: false,
+        }[userRole] || false);
+    }
+    return false;
+}