@apso/cli 0.35.0 → 0.37.0

package/dist/lib/templates/go/handlers/handler.eta

@@ -51,14 +51,48 @@ func (h *<%= it.entityName %>Handler) RegisterRoutes(r *gin.RouterGroup) {
 // @Param        join     query    string  false  "Join: relation or relation||field1,field2 (repeatable)"
 // @Param        limit    query    int     false  "Page size (max 200)"  default(25)
 // @Param        page     query    int     false  "Page number"          default(1)
+// @Param        select   query    string  false  "PostgREST projection: col,alias:col"
+// @Param        order    query    string  false  "PostgREST order: col.asc|desc[.nullsfirst|nullslast]"
+// @Param        offset   query    int     false  "PostgREST row offset (bare-array response)"
 // @Success      200  {object}  dto.<%= it.entityName %>PaginatedResponse
+// @Failure      400  {object}  map[string]string
 // @Failure      500  {object}  map[string]string
 // @Router       /<%= it.kebabPluralName %> [get]
+//
+// Dual-dialect: the nestjsx dialect (filter/sort/join/fields/or) returns the
+// {data,count,total,page,pageCount} envelope; the PostgREST dialect
+// (select/order/col=op.value/or=()/and=()) returns a bare JSON array. The
+// dialect is chosen by the X-Crud-Dialect header or the query-param shape.
 func (h *<%= it.entityName %>Handler) FindAll(c *gin.Context) {
-	opts := utils.ParseQueryParams(c.Request.URL.Query())
+	opts, err := utils.ParseQuery(c.Request.URL.Query(), c.GetHeader("X-Crud-Dialect"))
+	if err != nil {
+		// A malformed dialect request (bad header, ambiguous mix, bad operator)
+		// is a client error, not a 500 (apso #60).
+		c.JSON(http.StatusBadRequest, gin.H{"error": err.Error()})
+		return
+	}
+
+	// PostgREST dialect => bare JSON array (no envelope) — apso #58.
+	if opts.Bare {
+		rows, err := h.service.FindAllBare(c.Request.Context(), opts)
+		if err != nil {
+			if qe, ok := utils.AsQueryError(err); ok {
+				c.JSON(http.StatusBadRequest, gin.H{"error": qe.Error()})
+				return
+			}
+			c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
+			return
+		}
+		c.JSON(http.StatusOK, rows)
+		return
+	}
 
 	result, err := h.service.FindAll(c.Request.Context(), opts)
 	if err != nil {
+		if qe, ok := utils.AsQueryError(err); ok {
+			c.JSON(http.StatusBadRequest, gin.H{"error": qe.Error()})
+			return
+		}
 		c.JSON(http.StatusInternalServerError, gin.H{"error": err.Error()})
 		return
 	}

package/dist/lib/templates/go/services/service.eta

@@ -39,6 +39,7 @@ func New<%= it.entityName %>Service(db *gorm.DB) *<%= it.entityName %>Service {
 }
 
 // FindAll retrieves a paginated list of <%= it.pluralName %> with filtering, sorting, and joins.
+// Used by the nestjsx dialect ({data,count,total,page,pageCount} envelope).
 func (s *<%= it.entityName %>Service) FindAll(ctx context.Context, opts utils.QueryOptions) (*dto.<%= it.entityName %>PaginatedResponse, error) {
 	var items []models.<%= it.entityName %>
 
@@ -47,7 +48,10 @@ func (s *<%= it.entityName %>Service) FindAll(ctx context.Context, opts utils.Qu
 	query = query.Preload("<%= assoc.referenceName || assoc.name %>")
 <% }) %>
 
-	query, total, pageCount := utils.ApplyQuery(query, opts, AllowedFields<%= it.entityName %>)
+	query, total, pageCount, err := utils.ApplyQueryE(query, opts, AllowedFields<%= it.entityName %>)
+	if err != nil {
+		return nil, err
+	}
 
 	if err := query.Find(&items).Error; err != nil {
 		return nil, err
@@ -67,6 +71,34 @@ func (s *<%= it.entityName %>Service) FindAll(ctx context.Context, opts utils.Qu
 	}, nil
 }
 
+// FindAllBare retrieves <%= it.pluralName %> as a bare slice (no pagination
+// envelope), used by the PostgREST dialect (apso #58). An unknown filter/sort/
+// select column surfaces as a *utils.QueryError so the handler answers 400
+// rather than 500 (apso #60).
+func (s *<%= it.entityName %>Service) FindAllBare(ctx context.Context, opts utils.QueryOptions) ([]dto.<%= it.entityName %>Response, error) {
+	var items []models.<%= it.entityName %>
+
+	query := s.db.WithContext(ctx).Model(&models.<%= it.entityName %>{})
+<% it.associations.filter(a => a.eager).forEach((assoc) => { %>
+	query = query.Preload("<%= assoc.referenceName || assoc.name %>")
+<% }) %>
+
+	query, _, _, err := utils.ApplyQueryE(query, opts, AllowedFields<%= it.entityName %>)
+	if err != nil {
+		return nil, err
+	}
+
+	if err := query.Find(&items).Error; err != nil {
+		return nil, err
+	}
+
+	response := make([]dto.<%= it.entityName %>Response, len(items))
+	for i, item := range items {
+		response[i] = s.toResponse(&item)
+	}
+	return response, nil
+}
+
 // FindOne retrieves a single <%= it.entityName %> by ID
 func (s *<%= it.entityName %>Service) FindOne(ctx context.Context, id string) (*dto.<%= it.entityName %>Response, error) {
 	var item models.<%= it.entityName %>