zenstack下載zenstack源代碼下載

zenstack

Ai源碼

v2.10.2

下載

是什麼

ZenStack是一個節點/typescript工具包，可簡化Web應用程序後端的開發。它通過靈活的授權層和自動生成的類型安全的API/鉤子增強了Prisma Orm，從而解開了其全堆棧開發的全部潛力。

我們的目標是讓您節省時間編寫樣板代碼，並專注於構建真實功能！

它如何工作

閱讀完整的文檔？ Zenstack.dev。加入Discord以獲取反饋和問題。

Zenstack通過以下四層逐步擴展Prisma的力量：

1。 Zmodel-擴展的Prisma模式語言

Zenstack引入了一種名為“ Zmodel”的數據建模語言 - Prisma Schema語言的超集。它通過自定義屬性和功能擴展了Prisma模式，並基於此實現了Prisma周圍的靈活訪問控制層。

 // base.zmodel
abstract model Base {
    id String @ id
    author User @ relation ( fields : [ authorId ] , references : [ id ] )
    authorId String

    // ? allow full CRUD by author
    @@ allow ( 'all' , author == auth ( ) )
}

 // schema.zmodel
import "base"
model Post extends Base {
    title String
    published Boolean @ default ( false )

    // ? allow logged-in users to read published posts
    @@ allow ( 'read' , auth ( ) != null && published )
}

zenstack CLI將ZMODEL轉移到標準的Prisma架構中，您可以將其與常規的Prisma工作流程一起使用。

2。對Prisma客戶端的運行時增強功能

在運行時，圍繞Prisma客戶端創建了透明代理，以攔截查詢和突變以執行訪問策略。

 import { enhance } from '@zenstackhq/runtime' ;

// a regular Prisma client
const prisma = new PrismaClient ( ) ;

async function getPosts ( userId : string ) {
    // create an enhanced Prisma client that has access control enabled
    const enhanced = enhance ( prisma , { user : userId } ) ;

    // only posts that're visible to the user will be returned
    return enhanced . post . findMany ( ) ;
}

3。通過服務器適配器自動靜止API

服務器適配器軟件包可幫助您將啟用訪問控制的PRISMA客戶端包裝到可從前端安全調用的後端CRUD API。這是Next.js的一個示例：

 // pages/api/model/[...path].ts

import { requestHandler } from '@zenstackhq/next' ;
import { enhance } from '@zenstackhq/runtime' ;
import { getSessionUser } from '@lib/auth' ;
import { prisma } from '@lib/db' ;

// Mount Prisma-style APIs: "/api/model/post/findMany", "/api/model/post/create", etc.
// Can be configured to provide standard RESTful APIs (using JSON:API) instead.
export default requestHandler ( {
    getPrisma : ( req , res ) => enhance ( prisma , { user : getSessionUser ( req , res ) } ) ,
} ) ;

4。生成的客戶庫（掛鉤）用於數據訪問

插件可以生成與上述API交談的強型客戶庫。這是一個反應的示例：

 // components/MyPosts.tsx

import { useFindManyPost } from '@lib/hooks' ;

const MyPosts = ( ) => {
    // list all posts that're visible to the current user, together with their authors
    const { data : posts } = useFindManyPost ( {
        include : { author : true } ,
        orderBy : { createdAt : 'desc' } ,
    } ) ;

    return (
        < ul >
            { posts ?. map ( ( post ) => (
                < li key = { post . id } >
                    { post . title } by { post . author . name }
                </ li >
            ) ) }
        </ ul >
    ) ;
} ;