mirror of
https://github.com/zap-proto/zip.git
synced 2026-10-19 15:38:57 +00:00
zeekayandHanzo Dev
5f71d2496b
App, Group, Operation. A group is a prefix and what holds under it, an operation
is one typed route declared there, and the verb methods are generic methods —
which Go 1.27 allows on a concrete type and still refuses on an interface. So In
and Out come from the handler and the caller writes no type arguments:
users := app.Group("/v1/users")
users.Post("/", api.Create)
mint := users.Group("/mint").With(middleware.Mint(gate))
mint.Post("/deposit", api.Deposit)
A Group is a CLOSED HANDLE: two unexported fields, and no method that hands back
the app, the parent or the fiber underneath. A subsystem given the group at its
own prefix cannot reach above it, so confinement is a property of the type
instead of a rule something has to police — which is what a host needs in order
to hand out a bounded surface and know what comes back.
That is bought by giving up the router interface, deliberately. Router and
OpTarget are gone, and with them the ability to implement a route table outside
this package: a decorator is no longer a router, a gate is middleware on a group,
and a bound is a path. The five package-level verb functions go the same way —
a registration is a method on the thing it registers into.
Raw carries what is not a typed operation: a stream, an upgrade, a probe, a
foreign subtree. It names its method, and it is the longer spelling because
opting out of the typed model is the exception and should read like one.
Co-authored-by: Hanzo Dev <[email protected]>
54 lines
1.2 KiB
Go
54 lines
1.2 KiB
Go
package tables
|
|
|
|
import (
|
|
"context"
|
|
|
|
"github.com/zap-proto/zip"
|
|
)
|
|
|
|
// ItemIn describes an item input.
|
|
type ItemIn struct {
|
|
// Name of the item.
|
|
Name string `json:"name"`
|
|
// Price in cents.
|
|
Price int64 `json:"price"`
|
|
}
|
|
|
|
// ItemOut describes an item output.
|
|
type ItemOut struct {
|
|
// ID of the created item.
|
|
ID string `json:"id"`
|
|
// OK indicates status.
|
|
OK bool `json:"ok"`
|
|
}
|
|
|
|
type API struct{}
|
|
|
|
// CreateItem creates a new catalog item.
|
|
//
|
|
// Example: {"name": "Widget", "price": 999}
|
|
// Response: {"id": "itm_1", "ok": true}
|
|
func (a *API) CreateItem(_ context.Context, in *ItemIn) (*ItemOut, error) {
|
|
return &ItemOut{ID: "itm_1", OK: true}, nil
|
|
}
|
|
|
|
// LegacyCreate creates a new catalog item via legacy registrar.
|
|
//
|
|
// Example: {"name": "Widget", "price": 999}
|
|
// Response: {"id": "itm_1", "ok": true}
|
|
func LegacyCreate(_ context.Context, in *ItemIn) (*ItemOut, error) {
|
|
return &ItemOut{ID: "itm_1", OK: true}, nil
|
|
}
|
|
|
|
func Register(app *zip.App) {
|
|
// At the root, where the app itself is the table.
|
|
app.Post("/v1/legacy/items", LegacyCreate)
|
|
|
|
// On a group, with a metadata chain after the declaration.
|
|
v1 := app.Group("/v1").Tag("catalog")
|
|
items := v1.Group("/items")
|
|
items.Post("/", (&API{}).CreateItem).
|
|
ID("items.create").
|
|
Summary("Create an item")
|
|
}
|