p4a v0.0.0-alpha-6a

##p4a

It is a simple nodejs server integrated with body, cookie parsing, file upload handler, cors connection etc.

####Create simple server:

import { Server } from "p4a";

let server = new Server();
server.listen({port:8080});

Serve static files

Serves static files from the given path

server.serveStatic(__dirname+'/public');

Create Api over http

Make get and post requests

let endpoint = server.Api().endpoint();

endpoint.get('/', (req: Request, res: Response)=>{
    res.success({message: "Simple end point"}); // will send {status: true, data: {message: "Simple end point"}}
})

Access Express Request and Response

you can access express req and res too using req.req and res.res in callback

let endpoint = server.Api().endpoint();

endpoint.get('/', (req: Request, res: Response)=>{
    let expressRequest = req.req;
    res.res.json({message: "Simple end point"}); // will send {status: true, data: {message: "Simple end point"}}
})

Access requested body, cookies, form with files from the request

You can access requested body, cookies, form with files from the request without mounting any middleware

let endpoint = server.Api().endpoint();

endpoint.post('/',(req: Request, res: Response)=>{
         
    let body = req.body();                      // Requested body
    let cookie = req.cookies();                 // Requested cookies
    
    // Requested form with files
    req.form((err, fields, files) => {
     console.log("err: ", err);
     console.log("fields: ", fields);
     console.log("form: ", files);
    });
    
    console.log("body: ", body);
    console.log("cookies: ", cookie);
    
    
    res.cookie("hello", "Hello world");         // Set cookies
    res.success(true);                          // will send {status:1, data: true}
    //res.error(123, true);                     // will send {status:0, type: 123, message: true}
});

Endpoint chaining

let endpoint = server.Api().endpoint();

let college = new Endpoint();

let department = new Endpoint();
let library = new Endpoint();

college.hookup("library", library);
college.hookup("department", department);

endpoint.hookup("college", college)

Establish real time connection over socket

let socket = server.Api().socket();

socket.to('/chat', (connection: SocketConnection)=>{
    console.log("Connected");

    // Emit 'test' to the socket
    connection.socket.emit("message", "new message from p4a server over socket");

    // Handle when clients emits 'test'
    connection.socket.on("message", (d:any)=>{
        console.log(d);
    });
});

Configure filesystem

Configure where to upload the file for more information see the documentation

server.fileSystem.Config({
    uploadDir: 'upload' // File upload directory
});

Allow origins to access server

Allow all origins

server.allowOrigins("*")

Allow single origin

server.allowOrigins("http://localhost:4200")

Allow multiple origins

server.allowOrigins(["http://localhost:4200", "http://localhost:4300", "http://localhost:4400"])

Full example

import {Endpoint, SocketConnection, Response, Request, Server} from "p4a";


let server = new Server();


// Allow origin to access server
server.allowOrigins('http://localhost:4200');


// Configure file system
server.fileSystem.Config({
    uploadDir: 'upload'
});

let endpoint = server.Api().endpoint(); // Handle http requests

// Static form 
endpoint.serveStatic(__dirname+'/docs', {path:'/static'});

//http://localhost:8088/hi
endpoint.get('/hi', (req: Request, res: Response)=>{
        res.success({data: "data"});
    });

endpoint.post('/',(req: Request, res: Response)=>{

    let body = req.body();                      // Requested body
    let cookie = req.cookies();                  // Requested cookies

    // Requested form
    req.form((err, fields, files) => {
        console.log("err: ", err);
        console.log("fields: ", fields);
        console.log("form: ", files);
    });

    console.log("body: ", body);
    console.log("cookies: ", cookie);


    res.cookie("hello", "Hello world");         // Set cookies
    res.success(true);                          // will send {status:1, data: true}
    //res.error(123, true);                     // will send {status:0, type: 123, message: true}
});

let socket = server.Api().socket();     // Handle sockets

//Connect socket.io on http://localhost:8088/namespace
socket.to('/namespace', (connection: SocketConnection)=>{
    console.log("Connected");

    // Emit 'test' to the socket
    connection.socket.emit("test", "test done");

    // Handle when clients emits 'test'
    connection.socket.on("test", (d:any)=>{

        console.log(d);

        connection.socket.emit('test', d.toString()+": received")
    });
});

// start server on port 8088
server.start({port:8088});

Simple static files serving with p4a

Serve static files

import {Server} from "p4a";

let server = new Server();

// Static form 
server.serveStatic(__dirname+'/docs');

// start server on port 8088
server.start({port:8088});