Package Exports

fastapi-next
fastapi-next/build/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (fastapi-next) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Fast Api Next

Fast Api provides to create advanced level api infrastructures without any effort. It's manage sessions, plugins, middleware-functions automatically and creates secure connections between client and api gateway. Also, you can create real-time routers via enabling web socket support.

Would you like to support me?

Start here

Fast Api Start

Guidance

Guidance

Release History

Release History

Entity System (Beta)

Code-first entity & view layer that lets you define:

Entities (logical -> table mapping)
Fields (type, defaults, readonly)
Views (projections, base filters, ordering, search fields, default page size)

Supports OData-like query params at runtime: $select,$filter,$orderby,$top,$skip,$search (mounted onto knex, no DB views created).

Example

import { EntityManager, EntityFieldType, EntityRetrieveManyAction } from 'fastapi-next';

const em = new EntityManager(name => app.context[name]);
em.register({
    name: 'account',
    table: 'accounts',
    fields: [
        { name: 'id', type: EntityFieldType.Guid, primary: true },
        { name: 'name', type: EntityFieldType.String },
        { name: 'isActive', type: EntityFieldType.Boolean, default: true },
        { name: 'createdOn', type: EntityFieldType.DateTime, readonly: true }
    ],
    defaultFields: ['id','name','isActive'],
    views: [
        { name: 'active', where: { isActive: true }, orderBy: [{ field: 'name'}], search: ['name'] }
    ],
    defaultView: 'active'
});
app.registry.registerObject('entities', em);

// In workflow definition
new EntityRetrieveManyAction('entities', 'account', 'active');

Request example

/api/accounts?$select=id,name&$filter={"isActive":true}&$orderby=name desc&$top=20&$skip=0&$search=foo

DB Middleware Auto-Load

Otomatik veritabanı middleware yükleme:

Uygulama ayarına ekleyin:

const app = new NextApplication({
    middleware: {
        db: { enabled: true, pluginName: 'db', dirs: ['src/db-middlewares'] }
    }
});

Relation Upsert (Entity + Relations)

Workflow action: EntityUpsertWithRelationsAction

Örnek:

new EntityUpsertWithRelationsAction(
    'entities',            // entity manager
    'order',               // primary entity
    '$.body.order',        // main order data
    [
        { relation: 'items', mode: 'replace', dataPath: '$.body.items' }
    ]
)

Entity tanımı (özet):

em.register({
    name:'order', table:'orders', fields:[{name:'id',primary:true,type:EntityFieldType.Guid},{name:'orderNo',type:'string'}],
    relations:[{ name:'items', type:'oneToMany', target:'orderItem', foreignKey:'orderId', cascade:{ insert:true, update:true, delete:true } }]
});
em.register({ name:'orderItem', table:'order_items', fields:[{name:'id',primary:true,type:EntityFieldType.Guid},{name:'orderId',type:'guid'},{name:'productId',type:'guid'},{name:'qty',type:'number'}] });

İstek body:

{
    "order": { "id":"...", "orderNo":"O-1001" },
    "items": [ {"productId":"P1","qty":2}, {"productId":"P2","qty":1} ]
}

mode:'replace' eski çocuk kayıtları siler ve yenilerini ekler; 'upsert' mevcutları günceller, yoksa ekler; 'insert' sadece ekler. Klasörde bir middleware dosyası (tenantFilter.ts):

module.exports = {
    name: 'tenantFilter',
    priority: 10,
    before(ctx){
        if(ctx.operation==='select' && ctx.table!=='public_tables') {
            const tenantId = ctx.nextContext.session?.tenantId;
            if(tenantId && !ctx.nextContext.headers['x-bypass-tenant']) {
                ctx.query.where({ tenantId });
            }
            // Soft delete default
            if(!ctx.nextContext.headers['x-bypass-soft-delete']) {
                ctx.query.andWhere({ isDeleted: false });
            }
        }
    }
};

Birden fazla export desteği:

exports.middlewares = [ { name:'a', before(){} }, { name:'b', before(){} } ];