@tonzxz/government-forms 0.1.0

package/dist/gam/purchase-order-flow.d.ts

@@ -0,0 +1,146 @@
+import type { PrRequestType } from "./purchase-request/workflow.js";
+export type PurchaseOrderStatus = "For Delivery" | "Delivered" | "Cancelled";
+export type PurchaseOrderItem = {
+    itemId?: number | null;
+    stockNo?: string | null;
+    unit?: string | null;
+    description: string;
+    quantity: string;
+    unitCost: string;
+    totalCost?: string | null;
+};
+export type PurchaseOrderRecord = {
+    id: string;
+    poNo: string;
+    prNo: string;
+    supplier: string;
+    supplierAddress?: string | null;
+    supplierTin?: string | null;
+    modeOfProcurement?: string | null;
+    entityName: string;
+    fundCluster: string;
+    fundSource?: string | null;
+    fundType?: string | null;
+    responsibilityCenterCode?: string | null;
+    purpose?: string | null;
+    poDate: string;
+    placeOfDelivery?: string | null;
+    expectedDeliveryDate: string;
+    deliveryTerm?: string | null;
+    paymentTerm?: string | null;
+    amountInWords?: string | null;
+    supplierConforme?: string | null;
+    conformeDate?: string | null;
+    authorizedOfficial?: string | null;
+    fundsAvailable?: string | null;
+    orsBursNo?: string | null;
+    orsBursDate?: string | null;
+    orsBursAmount?: string | null;
+    chiefAccountantName?: string | null;
+    dateCreated: string;
+    totalAmount: string;
+    stocked: boolean;
+    status: PurchaseOrderStatus;
+    items: PurchaseOrderItem[];
+    createdById?: string | null;
+    requestorName?: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+export type DeliveryTrackingStatus = "For Delivery" | "Documents Uploaded" | "Received" | "IAR Created" | "Delivered";
+export type DeliveryDocumentAttachment = {
+    fileName: string;
+    fileType: string;
+    fileSize: number;
+    referenceNo: string;
+    documentDate: string;
+    uploadedAt: string;
+    s3Key?: string | null;
+    url?: string | null;
+    bucket?: string | null;
+};
+export type DeliveryDocumentField = "salesInvoice" | "deliveryReceipts" | "receivedPurchaseOrder" | "billingStatement" | "extensionLetterRequest";
+export type DeliveryDocumentGroup = {
+    field: DeliveryDocumentField;
+    label: string;
+    documents: DeliveryDocumentAttachment[];
+    required: boolean;
+};
+export type PurchaseOrderDeliveryRecord = {
+    id: string;
+    sourceType: "PO";
+    poNo: string;
+    prNo: string;
+    supplier: string;
+    entityName: string;
+    fundCluster: string;
+    responsibilityCenterCode?: string | null;
+    requestorName?: string | null;
+    deliveryDate: string;
+    status: DeliveryTrackingStatus;
+    documentsComplete: boolean;
+    salesInvoice?: DeliveryDocumentAttachment | null;
+    deliveryReceipt?: DeliveryDocumentAttachment | null;
+    deliveryReceipts?: DeliveryDocumentAttachment[];
+    receivedPurchaseOrder?: DeliveryDocumentAttachment | null;
+    billingStatement?: DeliveryDocumentAttachment | null;
+    extensionLetterRequest?: DeliveryDocumentAttachment | null;
+    items: PurchaseOrderItem[];
+    iarNo?: string | null;
+    iarCreatedAt?: string | null;
+    receivedAt?: string | null;
+    createdAt: string;
+    updatedAt: string;
+};
+export type PurchaseRequestForPo = {
+    prNo: string;
+    entityName: string;
+    fundCluster: string;
+    fundSource?: string | null;
+    fundType?: string | null;
+    responsibilityCenterCode?: string | null;
+    purpose?: string | null;
+    requestType?: PrRequestType | null;
+    requestSubtype?: string | null;
+    requestedByName?: string | null;
+    items: PurchaseOrderItem[];
+};
+export declare const PURCHASE_ORDER_MODULE_KEY = "supply-purchase-order";
+export declare const PURCHASE_ORDER_DELIVERY_MODULE_KEY = "supply-delivery-tracking";
+export declare const PURCHASE_ORDER_COLLECTION_KEY = "rows";
+export declare function getPurchaseOrderTotal(items: PurchaseOrderItem[]): number;
+export declare function formatPesoAmount(value: number | string): string;
+export declare function buildPoNo(prNo: string): string;
+export declare function buildPurchaseOrderFromPurchaseRequest(pr: PurchaseRequestForPo, params: {
+    supplier: string;
+    supplierAddress?: string | null;
+    supplierTin?: string | null;
+    modeOfProcurement?: string | null;
+    expectedDeliveryDate: string;
+    placeOfDelivery?: string | null;
+    deliveryTerm?: string | null;
+    paymentTerm?: string | null;
+    amountInWords?: string | null;
+    supplierConforme?: string | null;
+    conformeDate?: string | null;
+    authorizedOfficial?: string | null;
+    fundsAvailable?: string | null;
+    orsBursNo?: string | null;
+    orsBursDate?: string | null;
+    orsBursAmount?: string | null;
+    chiefAccountantName?: string | null;
+    createdById?: string | null;
+    now?: string;
+}): PurchaseOrderRecord;
+export declare function buildDeliveryRecordFromPurchaseOrder(order: PurchaseOrderRecord, now?: string): PurchaseOrderDeliveryRecord;
+export declare function makeDeliveryAttachment(file: File, params: {
+    referenceNo: string;
+    documentDate: string;
+    s3Key?: string | null;
+    url?: string | null;
+    bucket?: string | null;
+    now?: string;
+}): DeliveryDocumentAttachment;
+export declare function getDeliveryReceipts(record: PurchaseOrderDeliveryRecord | undefined | null): DeliveryDocumentAttachment[];
+export declare function getDeliveryDocumentGroups(record: PurchaseOrderDeliveryRecord | undefined | null): DeliveryDocumentGroup[];
+export declare function hasCompleteDeliveryDocuments(record: PurchaseOrderDeliveryRecord | undefined | null): boolean;

package/dist/gam/purchase-order-flow.js

@@ -0,0 +1,173 @@
+export const PURCHASE_ORDER_MODULE_KEY = "supply-purchase-order";
+export const PURCHASE_ORDER_DELIVERY_MODULE_KEY = "supply-delivery-tracking";
+export const PURCHASE_ORDER_COLLECTION_KEY = "rows";
+export function getPurchaseOrderTotal(items) {
+    return items.reduce((sum, item) => {
+        const explicitTotal = Number(item.totalCost);
+        if (Number.isFinite(explicitTotal) && explicitTotal > 0)
+            return sum + explicitTotal;
+        const quantity = Number(item.quantity) || 0;
+        const unitCost = Number(item.unitCost) || 0;
+        return sum + quantity * unitCost;
+    }, 0);
+}
+export function formatPesoAmount(value) {
+    const amount = typeof value === "string" ? Number(value) : value;
+    return new Intl.NumberFormat("en-PH", {
+        style: "currency",
+        currency: "PHP",
+        minimumFractionDigits: 2,
+    }).format(Number.isFinite(amount) ? amount : 0);
+}
+export function buildPoNo(prNo) {
+    const token = prNo
+        .trim()
+        .toUpperCase()
+        .replace(/[^A-Z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(-32);
+    return `PO-${token || Date.now()}`;
+}
+export function buildPurchaseOrderFromPurchaseRequest(pr, params) {
+    const now = params.now ?? new Date().toISOString();
+    const poNo = buildPoNo(pr.prNo);
+    const total = getPurchaseOrderTotal(pr.items);
+    return {
+        id: poNo,
+        poNo,
+        prNo: pr.prNo,
+        supplier: params.supplier.trim(),
+        supplierAddress: params.supplierAddress?.trim() || null,
+        supplierTin: params.supplierTin?.trim() || null,
+        modeOfProcurement: params.modeOfProcurement?.trim() || "Small Value Procurement",
+        entityName: pr.entityName,
+        fundCluster: pr.fundCluster,
+        fundSource: pr.fundSource,
+        fundType: pr.fundType,
+        responsibilityCenterCode: pr.responsibilityCenterCode,
+        purpose: pr.purpose,
+        poDate: now.slice(0, 10),
+        placeOfDelivery: params.placeOfDelivery?.trim() || "",
+        expectedDeliveryDate: params.expectedDeliveryDate,
+        deliveryTerm: params.deliveryTerm?.trim() || null,
+        paymentTerm: params.paymentTerm?.trim() || null,
+        amountInWords: params.amountInWords?.trim() || null,
+        supplierConforme: params.supplierConforme?.trim() || null,
+        conformeDate: params.conformeDate || null,
+        authorizedOfficial: params.authorizedOfficial?.trim() || null,
+        fundsAvailable: params.fundsAvailable?.trim() || null,
+        orsBursNo: params.orsBursNo?.trim() || null,
+        orsBursDate: params.orsBursDate || null,
+        orsBursAmount: params.orsBursAmount?.trim() || null,
+        chiefAccountantName: params.chiefAccountantName?.trim() || null,
+        dateCreated: now,
+        totalAmount: total.toFixed(2),
+        stocked: false,
+        status: "For Delivery",
+        items: pr.items.map(item => ({
+            itemId: item.itemId ?? null,
+            stockNo: item.stockNo ?? "",
+            unit: item.unit ?? "",
+            description: item.description,
+            quantity: String(item.quantity ?? "0"),
+            unitCost: String(item.unitCost ?? "0"),
+            totalCost: item.totalCost ?? (Number(item.quantity) * Number(item.unitCost)).toFixed(2),
+        })),
+        createdById: params.createdById ?? null,
+        requestorName: pr.requestedByName?.trim() || null,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+export function buildDeliveryRecordFromPurchaseOrder(order, now = new Date().toISOString()) {
+    return {
+        id: `DEL-${order.poNo}`,
+        sourceType: "PO",
+        poNo: order.poNo,
+        prNo: order.prNo,
+        supplier: order.supplier,
+        entityName: order.entityName,
+        fundCluster: order.fundCluster,
+        responsibilityCenterCode: order.responsibilityCenterCode,
+        requestorName: order.requestorName ?? null,
+        deliveryDate: order.expectedDeliveryDate,
+        status: "For Delivery",
+        documentsComplete: false,
+        salesInvoice: null,
+        deliveryReceipt: null,
+        deliveryReceipts: [],
+        receivedPurchaseOrder: null,
+        billingStatement: null,
+        extensionLetterRequest: null,
+        items: order.items,
+        iarNo: null,
+        iarCreatedAt: null,
+        createdAt: now,
+        updatedAt: now,
+    };
+}
+export function makeDeliveryAttachment(file, params) {
+    return {
+        fileName: file.name,
+        fileType: file.type || "application/octet-stream",
+        fileSize: file.size,
+        referenceNo: params.referenceNo.trim(),
+        documentDate: params.documentDate,
+        uploadedAt: params.now ?? new Date().toISOString(),
+        s3Key: params.s3Key ?? null,
+        url: params.url ?? null,
+        bucket: params.bucket ?? null,
+    };
+}
+export function getDeliveryReceipts(record) {
+    if (!record)
+        return [];
+    const uploadedReceipts = Array.isArray(record.deliveryReceipts)
+        ? record.deliveryReceipts.filter(receipt => Boolean(receipt?.fileName))
+        : [];
+    if (uploadedReceipts.length > 0)
+        return uploadedReceipts;
+    return record.deliveryReceipt?.fileName ? [record.deliveryReceipt] : [];
+}
+export function getDeliveryDocumentGroups(record) {
+    return [
+        {
+            field: "salesInvoice",
+            label: "Sales Invoice",
+            documents: record?.salesInvoice?.fileName ? [record.salesInvoice] : [],
+            required: false,
+        },
+        {
+            field: "deliveryReceipts",
+            label: "Delivery Receipts",
+            documents: getDeliveryReceipts(record),
+            required: false,
+        },
+        {
+            field: "receivedPurchaseOrder",
+            label: "Received Purchase Order",
+            documents: record?.receivedPurchaseOrder?.fileName ? [record.receivedPurchaseOrder] : [],
+            required: true,
+        },
+        {
+            field: "billingStatement",
+            label: "Billing Statement",
+            documents: record?.billingStatement?.fileName ? [record.billingStatement] : [],
+            required: false,
+        },
+        {
+            field: "extensionLetterRequest",
+            label: "Letter Request for Extension",
+            documents: record?.extensionLetterRequest?.fileName ? [record.extensionLetterRequest] : [],
+            required: false,
+        },
+    ];
+}
+export function hasCompleteDeliveryDocuments(record) {
+    if (!record)
+        return false;
+    if (record.documentsComplete)
+        return true;
+    const requiredGroups = getDeliveryDocumentGroups(record).filter(group => group.required);
+    return requiredGroups.length > 0 && requiredGroups.every(group => group.documents.length > 0);
+}

package/dist/gam/purchase-request/workflow.d.ts

@@ -0,0 +1,19 @@
+export declare const PR_REQUEST_TYPES: readonly ["Supplies", "Others", "PPE", "Semi-Expandable", "Services"];
+export type PrRequestType = (typeof PR_REQUEST_TYPES)[number];
+export type PrRequestTypeInput = PrRequestType | "";
+type PrRoutingInput = {
+    requestType?: PrRequestTypeInput | null;
+    requestSubtype?: string | null;
+};
+export declare const PR_OTHER_SUBTYPES: readonly ["Meals", "Common Use Supplies", "Transportation / Logistics", "Semi-Expandable", "Less valuable PPE"];
+export declare const PR_SERVICE_SUBTYPES: readonly ["Rental", "Subscription", "Repair"];
+export declare function getPrSubtypeOptions(requestType?: PrRequestTypeInput | null): never[] | readonly ["Meals", "Common Use Supplies", "Transportation / Logistics", "Semi-Expandable", "Less valuable PPE"] | readonly ["Rental", "Subscription", "Repair"];
+export declare function requiresPrSubtype(requestType?: PrRequestTypeInput | null): requestType is "Others" | "Services";
+export declare function getInventoryCategoryForPr(requestType?: PrRequestTypeInput | null): "Supplies" | "Semi-Expendable" | "PPE" | null;
+export declare function isPurchaseOrderEligiblePr(input: PrRoutingInput): boolean;
+export declare function shouldBypassPrForIar(input: PrRoutingInput): boolean;
+export declare function isRepairServicePurchaseRequest(input: {
+    requestType?: string | null;
+    requestSubtype?: string | null;
+}): boolean;
+export {};

package/dist/gam/purchase-request/workflow.js

@@ -0,0 +1,45 @@
+export const PR_REQUEST_TYPES = [
+    "Supplies",
+    "Others",
+    "PPE",
+    "Semi-Expandable",
+    "Services",
+];
+export const PR_OTHER_SUBTYPES = [
+    "Meals",
+    "Common Use Supplies",
+    "Transportation / Logistics",
+    "Semi-Expandable",
+    "Less valuable PPE",
+];
+export const PR_SERVICE_SUBTYPES = ["Rental", "Subscription", "Repair"];
+export function getPrSubtypeOptions(requestType) {
+    if (requestType === "Others")
+        return PR_OTHER_SUBTYPES;
+    if (requestType === "Services")
+        return PR_SERVICE_SUBTYPES;
+    return [];
+}
+export function requiresPrSubtype(requestType) {
+    return requestType === "Others" || requestType === "Services";
+}
+export function getInventoryCategoryForPr(requestType) {
+    if (requestType === "Supplies")
+        return "Supplies";
+    if (requestType === "Semi-Expandable")
+        return "Semi-Expendable";
+    if (requestType === "PPE")
+        return "PPE";
+    return null;
+}
+export function isPurchaseOrderEligiblePr(input) {
+    if (!input.requestType)
+        return true;
+    return PR_REQUEST_TYPES.includes(input.requestType);
+}
+export function shouldBypassPrForIar(input) {
+    return !isPurchaseOrderEligiblePr(input);
+}
+export function isRepairServicePurchaseRequest(input) {
+    return input.requestType === "Services" && input.requestSubtype?.trim().toLowerCase() === "repair";
+}

package/dist/gam/types/ris-types.d.ts

@@ -0,0 +1,37 @@
+export interface RISRow {
+    stockNo: string;
+    unit: string;
+    description: string;
+    quantity: string;
+    stockYes: string;
+    stockNo_: string;
+    issueQuantity: string;
+    remarks: string;
+}
+export interface RISFormData {
+    entityName: string;
+    fundCluster: string;
+    division: string;
+    office: string;
+    rcCode: string;
+    risNo: string;
+    purpose: string;
+    requestedBy: string;
+    approvedBy: string;
+    issuedBy: string;
+    receivedBy: string;
+    requestedByDesig: string;
+    approvedByDesig: string;
+    issuedByDesig: string;
+    receivedByDesig: string;
+    requestedByDate: string;
+    approvedByDate: string;
+    issuedByDate: string;
+    receivedByDate: string;
+}
+export interface RISSignatory {
+    sig: string;
+    name: string;
+    desig: string;
+    date: string;
+}

package/dist/gam/types/ris-types.js

@@ -0,0 +1 @@
+export {};

package/dist/gam/utils/export-ics-xlsx.d.ts

@@ -0,0 +1,28 @@
+export type IcsXlsxItem = {
+    quantity?: string;
+    unit?: string;
+    unitCost?: string;
+    totalCost?: string;
+    description?: string;
+    inventoryItemNo?: string;
+    estimatedUsefulLife?: string;
+};
+export type IcsXlsxValues = {
+    entityName?: string;
+    fundCluster?: string;
+    icsNo?: string;
+    purchaseOrderNo?: string;
+    purchaseRequestRef?: string;
+    supplierName?: string;
+    invoiceNo?: string;
+    deliveryReceiptNo?: string;
+    procurementRemarks?: string;
+    items?: IcsXlsxItem[];
+    receivedByName?: string;
+    receivedByPosition?: string;
+    receivedByDate?: string;
+    receivedFromName?: string;
+    receivedFromPosition?: string;
+    receivedFromDate?: string;
+};
+export declare function exportIcsXlsx(values: IcsXlsxValues): void;