@ai0x0/utils 0.0.45 → 0.0.46

package/.agents/skills/ai0x0-utils/backend/SKILL.md

@@ -102,6 +102,8 @@ export const getListOperation = createGetListOperation({ db, getSession });
 
 `postOperation` defaults to `contentType: "application/json"`. Pass `contentType: "multipart/form-data"` to read `await req.formData()` as body, or pass both a custom `contentType` and `parseBody(req)` for custom payload parsing.
 
+In `postOperation` and `putOperation`, `onSuccess({ params })` is typed from `bodySchema` plus the injected `creatorId` / `editorId`, so custom action helpers can usually consume `params` directly without reparsing the body schema.
+
 `table` and factory-level `db` are optional for route operations. When `table` is omitted or `db` is not provided, the operation still parses input, applies `setParams` / `setBody`, session-derived fields, and `onSuccess`, but skips the built-in table action (`select` / `insert` / `update` / `delete`). Use this for custom endpoints that want the same OpenAPI and response wiring without a direct table operation.
 
 ## Canonical Examples
@@ -352,7 +354,7 @@ export const { GET } = route({
 
 - Extra server-side filters — `setParams(req) => Promise<Record<string, unknown>>` on GET/GET_LIST; returned keys are merged into the filter.
 - Extra columns on write — `setBody(req) => Promise<Partial<infer<IB>>>` on POST/PUT; returned fields are merged into the body before validation runs against `bodySchema`.
-- Post-processing output — `onSuccess({ params, data, req }) => Promise<data>`; on GET_LIST `data` is `{ data, total }`.
+- Post-processing output — `onSuccess({ params, data, req }) => Promise<data>`; POST/PUT params are inferred from `bodySchema`, and on GET_LIST `data` is `{ data, total }`.
 - Error rewriting — `onError(err) => Promise<Response | undefined>`. Return `undefined` to rethrow.
 
 ## Imports

package/SKILL.md

@@ -81,6 +81,8 @@ export const getListOperation = createGetListOperation({ db, getSession });
 
 `postOperation` defaults to `contentType: "application/json"`. Pass `contentType: "multipart/form-data"` to read `await req.formData()` as body, or pass both a custom `contentType` and `parseBody(req)` for custom payload parsing.
 
+In `postOperation` and `putOperation`, `onSuccess({ params })` is typed from `bodySchema` plus the injected `creatorId` / `editorId`, so custom action helpers can usually consume `params` directly without reparsing the body schema.
+
 `table` and factory-level `db` are optional for route operations. When `table` is omitted or `db` is not provided, the operation still parses input, applies `setParams` / `setBody`, session-derived fields, and `onSuccess`, but skips the built-in table action (`select` / `insert` / `update` / `delete`). Use this for custom endpoints that want the same OpenAPI and response wiring without a direct table operation.
 
 ## Canonical Examples
@@ -331,7 +333,7 @@ export const { GET } = route({
 
 - Extra server-side filters — `setParams(req) => Promise<Record<string, unknown>>` on GET/GET_LIST; returned keys are merged into the filter.
 - Extra columns on write — `setBody(req) => Promise<Partial<infer<IB>>>` on POST/PUT; returned fields are merged into the body before validation runs against `bodySchema`.
-- Post-processing output — `onSuccess({ params, data, req }) => Promise<data>`; on GET_LIST `data` is `{ data, total }`.
+- Post-processing output — `onSuccess({ params, data, req }) => Promise<data>`; POST/PUT params are inferred from `bodySchema`, and on GET_LIST `data` is `{ data, total }`.
 - Error rewriting — `onError(err) => Promise<Response | undefined>`. Return `undefined` to rethrow.
 
 ## Imports

package/es/backend/route-operation/post-operation.d.ts

@@ -3,6 +3,9 @@ import { PgTable } from "drizzle-orm/pg-core";
 import { NextRequest } from "next/server";
 import { TypedNextResponse } from "next-rest-framework";
 import { NodePgDatabase } from "drizzle-orm/node-postgres";
+type PostOperationParams<IB extends ZodSchema> = z.infer<IB> & Record<string, unknown> & {
+    creatorId?: string;
+};
 export interface PostOperationOptions<IB extends ZodSchema, OB extends ZodSchema, TTable extends PgTable> {
     bodySchema: IB;
     contentType?: string;
@@ -13,7 +16,7 @@ export interface PostOperationOptions<IB extends ZodSchema, OB extends ZodSchema
     summary?: string;
     tags?: string[];
     onSuccess?(payload: {
-        params: Record<string, unknown>;
+        params: PostOperationParams<IB>;
         data: z.infer<OB>;
         req: NextRequest;
     }): Promise<z.infer<OB>>;
@@ -26,3 +29,4 @@ export declare const createPostOperation: ({ getSession, db, }: {
         userId?: string;
     } | undefined>;
 }) => <IB extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, OB extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, TTable extends PgTable<import("drizzle-orm/pg-core").TableConfig>>({ bodySchema, contentType, description, outputBodySchema, parseBody, setBody, summary, tags, table, onSuccess, onError, }: PostOperationOptions<IB, OB, TTable>) => import("next-rest-framework").RouteOperationDefinition<"POST">;
+export {};

package/es/backend/route-operation/put-operation.d.ts

@@ -4,6 +4,9 @@ import { TypedNextRequest, TypedNextResponse } from "next-rest-framework";
 import { NodePgDatabase } from "drizzle-orm/node-postgres";
 import { NextRequest } from "next/server";
 import { BaseTable } from "../types.js";
+type PutOperationParams<IB extends ZodSchema> = z.infer<IB> & Record<string, unknown> & {
+    editorId?: string;
+};
 export interface PutOperationOptions<IB extends ZodSchema, OB extends ZodSchema, TTable extends PgTable> {
     bodySchema: IB;
     description?: string;
@@ -13,7 +16,7 @@ export interface PutOperationOptions<IB extends ZodSchema, OB extends ZodSchema,
     tags?: string[];
     setBody?(req: TypedNextRequest<"PUT", "application/json", z.infer<IB>>): Promise<Partial<z.infer<IB>>>;
     onSuccess?(payload: {
-        params: Record<string, unknown>;
+        params: PutOperationParams<IB>;
         data: z.infer<OB>;
     }): Promise<z.infer<OB>>;
     onError?(error: Error): Promise<ReturnType<(typeof TypedNextResponse)["json"]> | undefined>;
@@ -25,3 +28,4 @@ export declare const createPutOperation: ({ getSession, db, }: {
     } | undefined>;
     db?: NodePgDatabase<Record<string, unknown>> | undefined;
 }) => <IB extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, OB extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, TTable extends BaseTable>({ bodySchema, description, outputBodySchema, table, summary, tags, setBody, onSuccess, byCreator, onError, }: PutOperationOptions<IB, OB, TTable>) => import("next-rest-framework").RouteOperationDefinition<"PUT">;
+export {};

package/es/backend/sqlite/route-operation/post-operation.d.ts

@@ -2,6 +2,9 @@ import { z, ZodSchema } from "zod";
 import { SQLiteTable } from "drizzle-orm/sqlite-core";
 import { NextRequest } from "next/server";
 import { TypedNextResponse } from "next-rest-framework";
+type PostOperationParams<IB extends ZodSchema> = z.infer<IB> & Record<string, unknown> & {
+    creatorId?: string;
+};
 export interface PostOperationOptions<IB extends ZodSchema, OB extends ZodSchema, TTable extends SQLiteTable> {
     bodySchema: IB;
     contentType?: string;
@@ -12,7 +15,7 @@ export interface PostOperationOptions<IB extends ZodSchema, OB extends ZodSchema
     summary?: string;
     tags?: string[];
     onSuccess?: (_payload: {
-        params: Record<string, unknown>;
+        params: PostOperationParams<IB>;
         data: z.infer<OB>;
         req: NextRequest;
     }) => Promise<z.infer<OB>>;
@@ -25,3 +28,4 @@ export declare const createPostOperation: ({ getSession, db, }: {
         userId?: string;
     } | undefined>;
 }) => <IB extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, OB extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, TTable extends SQLiteTable<import("drizzle-orm/sqlite-core").TableConfig>>({ bodySchema, contentType, description, outputBodySchema, parseBody, setBody, summary, tags, table, onSuccess, onError, }: PostOperationOptions<IB, OB, TTable>) => import("next-rest-framework").RouteOperationDefinition<"POST">;
+export {};

package/es/backend/sqlite/route-operation/put-operation.d.ts

@@ -3,6 +3,9 @@ import { SQLiteTable } from "drizzle-orm/sqlite-core";
 import { TypedNextRequest, TypedNextResponse } from "next-rest-framework";
 import { NextRequest } from "next/server";
 import { BaseTable } from "../types.js";
+type PutOperationParams<IB extends ZodSchema> = z.infer<IB> & Record<string, unknown> & {
+    editorId?: string;
+};
 export interface PutOperationOptions<IB extends ZodSchema, OB extends ZodSchema, TTable extends SQLiteTable> {
     bodySchema: IB;
     description?: string;
@@ -12,7 +15,7 @@ export interface PutOperationOptions<IB extends ZodSchema, OB extends ZodSchema,
     tags?: string[];
     setBody?: (_req: TypedNextRequest<"PUT", "application/json", z.infer<IB>>) => Promise<Partial<z.infer<IB>>>;
     onSuccess?: (_payload: {
-        params: Record<string, unknown>;
+        params: PutOperationParams<IB>;
         data: z.infer<OB>;
     }) => Promise<z.infer<OB>>;
     onError?: (_error: Error) => Promise<ReturnType<(typeof TypedNextResponse)["json"]> | undefined>;
@@ -24,3 +27,4 @@ export declare const createPutOperation: ({ getSession, db, }: {
     } | undefined>;
     db?: any;
 }) => <IB extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, OB extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, TTable extends BaseTable>({ bodySchema, description, outputBodySchema, table, summary, tags, setBody, onSuccess, byCreator, onError, }: PutOperationOptions<IB, OB, TTable>) => import("next-rest-framework").RouteOperationDefinition<"PUT">;
+export {};

package/lib/backend/route-operation/post-operation.d.ts

@@ -3,6 +3,9 @@ import { PgTable } from "drizzle-orm/pg-core";
 import { NextRequest } from "next/server";
 import { TypedNextResponse } from "next-rest-framework";
 import { NodePgDatabase } from "drizzle-orm/node-postgres";
+type PostOperationParams<IB extends ZodSchema> = z.infer<IB> & Record<string, unknown> & {
+    creatorId?: string;
+};
 export interface PostOperationOptions<IB extends ZodSchema, OB extends ZodSchema, TTable extends PgTable> {
     bodySchema: IB;
     contentType?: string;
@@ -13,7 +16,7 @@ export interface PostOperationOptions<IB extends ZodSchema, OB extends ZodSchema
     summary?: string;
     tags?: string[];
     onSuccess?(payload: {
-        params: Record<string, unknown>;
+        params: PostOperationParams<IB>;
         data: z.infer<OB>;
         req: NextRequest;
     }): Promise<z.infer<OB>>;
@@ -26,3 +29,4 @@ export declare const createPostOperation: ({ getSession, db, }: {
         userId?: string;
     } | undefined>;
 }) => <IB extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, OB extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, TTable extends PgTable<import("drizzle-orm/pg-core").TableConfig>>({ bodySchema, contentType, description, outputBodySchema, parseBody, setBody, summary, tags, table, onSuccess, onError, }: PostOperationOptions<IB, OB, TTable>) => import("next-rest-framework").RouteOperationDefinition<"POST">;
+export {};

package/lib/backend/route-operation/put-operation.d.ts

@@ -4,6 +4,9 @@ import { TypedNextRequest, TypedNextResponse } from "next-rest-framework";
 import { NodePgDatabase } from "drizzle-orm/node-postgres";
 import { NextRequest } from "next/server";
 import { BaseTable } from "../types.js";
+type PutOperationParams<IB extends ZodSchema> = z.infer<IB> & Record<string, unknown> & {
+    editorId?: string;
+};
 export interface PutOperationOptions<IB extends ZodSchema, OB extends ZodSchema, TTable extends PgTable> {
     bodySchema: IB;
     description?: string;
@@ -13,7 +16,7 @@ export interface PutOperationOptions<IB extends ZodSchema, OB extends ZodSchema,
     tags?: string[];
     setBody?(req: TypedNextRequest<"PUT", "application/json", z.infer<IB>>): Promise<Partial<z.infer<IB>>>;
     onSuccess?(payload: {
-        params: Record<string, unknown>;
+        params: PutOperationParams<IB>;
         data: z.infer<OB>;
     }): Promise<z.infer<OB>>;
     onError?(error: Error): Promise<ReturnType<(typeof TypedNextResponse)["json"]> | undefined>;
@@ -25,3 +28,4 @@ export declare const createPutOperation: ({ getSession, db, }: {
     } | undefined>;
     db?: NodePgDatabase<Record<string, unknown>> | undefined;
 }) => <IB extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, OB extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, TTable extends BaseTable>({ bodySchema, description, outputBodySchema, table, summary, tags, setBody, onSuccess, byCreator, onError, }: PutOperationOptions<IB, OB, TTable>) => import("next-rest-framework").RouteOperationDefinition<"PUT">;
+export {};

package/lib/backend/sqlite/route-operation/post-operation.d.ts

@@ -2,6 +2,9 @@ import { z, ZodSchema } from "zod";
 import { SQLiteTable } from "drizzle-orm/sqlite-core";
 import { NextRequest } from "next/server";
 import { TypedNextResponse } from "next-rest-framework";
+type PostOperationParams<IB extends ZodSchema> = z.infer<IB> & Record<string, unknown> & {
+    creatorId?: string;
+};
 export interface PostOperationOptions<IB extends ZodSchema, OB extends ZodSchema, TTable extends SQLiteTable> {
     bodySchema: IB;
     contentType?: string;
@@ -12,7 +15,7 @@ export interface PostOperationOptions<IB extends ZodSchema, OB extends ZodSchema
     summary?: string;
     tags?: string[];
     onSuccess?: (_payload: {
-        params: Record<string, unknown>;
+        params: PostOperationParams<IB>;
         data: z.infer<OB>;
         req: NextRequest;
     }) => Promise<z.infer<OB>>;
@@ -25,3 +28,4 @@ export declare const createPostOperation: ({ getSession, db, }: {
         userId?: string;
     } | undefined>;
 }) => <IB extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, OB extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, TTable extends SQLiteTable<import("drizzle-orm/sqlite-core").TableConfig>>({ bodySchema, contentType, description, outputBodySchema, parseBody, setBody, summary, tags, table, onSuccess, onError, }: PostOperationOptions<IB, OB, TTable>) => import("next-rest-framework").RouteOperationDefinition<"POST">;
+export {};

package/lib/backend/sqlite/route-operation/put-operation.d.ts

@@ -3,6 +3,9 @@ import { SQLiteTable } from "drizzle-orm/sqlite-core";
 import { TypedNextRequest, TypedNextResponse } from "next-rest-framework";
 import { NextRequest } from "next/server";
 import { BaseTable } from "../types.js";
+type PutOperationParams<IB extends ZodSchema> = z.infer<IB> & Record<string, unknown> & {
+    editorId?: string;
+};
 export interface PutOperationOptions<IB extends ZodSchema, OB extends ZodSchema, TTable extends SQLiteTable> {
     bodySchema: IB;
     description?: string;
@@ -12,7 +15,7 @@ export interface PutOperationOptions<IB extends ZodSchema, OB extends ZodSchema,
     tags?: string[];
     setBody?: (_req: TypedNextRequest<"PUT", "application/json", z.infer<IB>>) => Promise<Partial<z.infer<IB>>>;
     onSuccess?: (_payload: {
-        params: Record<string, unknown>;
+        params: PutOperationParams<IB>;
         data: z.infer<OB>;
     }) => Promise<z.infer<OB>>;
     onError?: (_error: Error) => Promise<ReturnType<(typeof TypedNextResponse)["json"]> | undefined>;
@@ -24,3 +27,4 @@ export declare const createPutOperation: ({ getSession, db, }: {
     } | undefined>;
     db?: any;
 }) => <IB extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, OB extends z.ZodType<unknown, unknown, z.core.$ZodTypeInternals<unknown, unknown>>, TTable extends BaseTable>({ bodySchema, description, outputBodySchema, table, summary, tags, setBody, onSuccess, byCreator, onError, }: PutOperationOptions<IB, OB, TTable>) => import("next-rest-framework").RouteOperationDefinition<"PUT">;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai0x0/utils",
-  "version": "0.0.45",
+  "version": "0.0.46",
   "description": "AI0x0 utils",
   "keywords": [
     "ai0x0"