raffel 0.1.2

package/dist/server/fs-routes/rest/types.d.ts

@@ -0,0 +1,288 @@
+/**
+ * REST Auto-CRUD Types
+ *
+ * Type definitions for schema-first REST API generation.
+ */
+import type { z } from 'zod';
+import type { Context, Interceptor } from '../../../types/index.js';
+export type RestOperation = 'list' | 'get' | 'create' | 'update' | 'patch' | 'delete' | 'head' | 'options';
+export declare const REST_OPERATIONS: RestOperation[];
+export declare const OPERATION_METHODS: Record<RestOperation, string>;
+export declare const COLLECTION_OPERATIONS: RestOperation[];
+export declare const ITEM_OPERATIONS: RestOperation[];
+/**
+ * Standard REST route ordering for documentation and consistency.
+ * Collection routes first, then item routes.
+ * Within each: GET, HEAD, POST/PUT/PATCH, DELETE, OPTIONS
+ */
+export declare const REST_ROUTE_ORDER: Record<string, number>;
+/**
+ * REST resource file exports.
+ *
+ * @example
+ * ```typescript
+ * // src/rest/users.ts
+ * import { z } from 'zod'
+ *
+ * export const schema = z.object({
+ *   id: z.string().uuid(),
+ *   name: z.string(),
+ *   email: z.string().email(),
+ * })
+ *
+ * export const config = {
+ *   operations: ['list', 'get', 'create', 'update', 'delete'],
+ *   auth: {
+ *     list: 'none',
+ *     create: 'required',
+ *   },
+ * }
+ *
+ * export const adapter = prisma.user
+ * ```
+ */
+export interface RestExports {
+    /** Entity schema (required) */
+    schema: z.ZodObject<z.ZodRawShape>;
+    /** REST configuration */
+    config?: RestConfig;
+    /** Database adapter */
+    adapter?: RestAdapter | DatabaseClient;
+    list?: RestHandler | RestHandlerConfig | false;
+    get?: RestHandler | RestHandlerConfig | false;
+    create?: RestHandler | RestHandlerConfig | false;
+    update?: RestHandler | RestHandlerConfig | false;
+    patch?: RestHandler | RestHandlerConfig | false;
+    delete?: RestHandler | RestHandlerConfig | false;
+    head?: RestHandler | RestHandlerConfig | false;
+    options?: RestHandler | RestHandlerConfig | false;
+    actions?: Record<string, RestActionConfig>;
+}
+export interface RestConfig {
+    /** Primary key field (default: 'id') */
+    primaryKey?: string;
+    /** Operations to enable (default: all) */
+    operations?: RestOperation[];
+    /** Operations to exclude */
+    exclude?: RestOperation[];
+    /** Auth configuration per operation */
+    auth?: Partial<Record<RestOperation, RestAuthConfig>>;
+    /** Global auth for all operations */
+    defaultAuth?: RestAuthConfig;
+    /** Pagination config */
+    pagination?: PaginationConfig;
+    /** Filterable fields (default: all from schema) */
+    filterable?: string[] | boolean;
+    /** Sortable fields */
+    sortable?: string[] | boolean;
+    /** Searchable fields (full-text search) */
+    searchable?: string[];
+    /** Soft delete field (enables soft delete) */
+    softDelete?: string | false;
+    /** Timestamp fields */
+    timestamps?: {
+        createdAt?: string;
+        updatedAt?: string;
+    };
+    /** Custom interceptors */
+    interceptors?: Interceptor[];
+    /** Base path override (default: resource name) */
+    basePath?: string;
+}
+export type RestAuthConfig = 'none' | 'optional' | 'required' | {
+    roles: string[];
+} | {
+    permissions: string[];
+};
+export interface PaginationConfig {
+    /** Default page size */
+    defaultLimit?: number;
+    /** Maximum page size */
+    maxLimit?: number;
+    /** Pagination style */
+    style?: 'offset' | 'cursor';
+    /** Cursor field (for cursor pagination) */
+    cursorField?: string;
+}
+export interface ResolvedPaginationConfig {
+    /** Default page size */
+    defaultLimit: number;
+    /** Maximum page size */
+    maxLimit: number;
+    /** Pagination style */
+    style: 'offset' | 'cursor';
+    /** Cursor field (for cursor pagination) */
+    cursorField?: string;
+}
+export type RestHandler<TInput = unknown, TOutput = unknown> = (input: TInput, ctx: RestContext) => TOutput | Promise<TOutput>;
+export interface RestHandlerConfig<TInput = unknown, TOutput = unknown> {
+    /** Input schema override */
+    input?: z.ZodType<TInput>;
+    /** Output schema override */
+    output?: z.ZodType<TOutput>;
+    /** Auth config */
+    auth?: RestAuthConfig;
+    /** Handler function */
+    handler: RestHandler<TInput, TOutput>;
+}
+export interface RestContext extends Context {
+    /** Resource name */
+    resource: string;
+    /** Operation being performed */
+    operation: RestOperation;
+    /** Parsed query parameters */
+    query: RestQuery;
+    /** URL parameters (e.g., :id) */
+    params: Record<string, string>;
+}
+export interface RestQuery {
+    /** Pagination */
+    limit?: number;
+    offset?: number;
+    cursor?: string;
+    /** Sorting */
+    sort?: string;
+    order?: 'asc' | 'desc';
+    /** Filtering */
+    filters?: Record<string, unknown>;
+    /** Search query */
+    search?: string;
+    /** Field selection */
+    fields?: string[];
+    /** Include relations */
+    include?: string[];
+}
+export interface RestActionConfig {
+    /** HTTP method */
+    method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+    /** Path (relative to resource, e.g., '/:id/activate') */
+    path: string;
+    /** Input schema */
+    input?: z.ZodType;
+    /** Output schema */
+    output?: z.ZodType;
+    /** Auth config */
+    auth?: RestAuthConfig;
+    /** Handler */
+    handler: RestHandler;
+}
+/**
+ * Database adapter interface for auto-CRUD.
+ * Compatible with Prisma, Drizzle, or custom implementations.
+ */
+export interface RestAdapter<T = unknown> {
+    /** List records with query */
+    findMany(query: AdapterQuery): Promise<T[]>;
+    /** Count records */
+    count(query: AdapterCountQuery): Promise<number>;
+    /** Find single record by ID */
+    findUnique(query: AdapterFindQuery): Promise<T | null>;
+    /** Create record */
+    create(data: AdapterCreateData<T>): Promise<T>;
+    /** Update record */
+    update(query: AdapterUpdateQuery<T>): Promise<T>;
+    /** Delete record */
+    delete(query: AdapterDeleteQuery): Promise<T | void>;
+}
+export interface AdapterQuery {
+    where?: Record<string, unknown>;
+    orderBy?: Record<string, 'asc' | 'desc'>;
+    take?: number;
+    skip?: number;
+    cursor?: Record<string, unknown>;
+    select?: Record<string, boolean>;
+    include?: Record<string, boolean>;
+}
+export interface AdapterCountQuery {
+    where?: Record<string, unknown>;
+}
+export interface AdapterFindQuery {
+    where: Record<string, unknown>;
+    select?: Record<string, boolean>;
+    include?: Record<string, boolean>;
+}
+export interface AdapterCreateData<T> {
+    data: Partial<T>;
+}
+export interface AdapterUpdateQuery<T> {
+    where: Record<string, unknown>;
+    data: Partial<T>;
+}
+export interface AdapterDeleteQuery {
+    where: Record<string, unknown>;
+}
+/**
+ * Generic database client (Prisma-like).
+ * Detected by having findMany, create, update, delete methods.
+ */
+export interface DatabaseClient<T = unknown> {
+    findMany: (args?: AdapterQuery) => Promise<T[]>;
+    findUnique: (args: AdapterFindQuery) => Promise<T | null>;
+    findFirst?: (args: AdapterFindQuery) => Promise<T | null>;
+    count: (args?: AdapterCountQuery) => Promise<number>;
+    create: (args: AdapterCreateData<T>) => Promise<T>;
+    update: (args: AdapterUpdateQuery<T>) => Promise<T>;
+    delete: (args: AdapterDeleteQuery) => Promise<T>;
+}
+export interface LoadedRestResource {
+    /** Resource name (from filename) */
+    name: string;
+    /** File path */
+    filePath: string;
+    /** Entity schema */
+    schema: z.ZodObject<z.ZodRawShape>;
+    /** Resolved configuration */
+    config: ResolvedRestConfig;
+    /** Database adapter */
+    adapter?: RestAdapter;
+    /** Generated handlers */
+    handlers: Map<RestOperation, RestHandler>;
+    /** Custom actions */
+    actions: Map<string, RestActionConfig>;
+    /** Generated routes */
+    routes: RestRoute[];
+}
+export interface ResolvedRestConfig extends Omit<Required<Omit<RestConfig, 'exclude' | 'auth' | 'defaultAuth'>>, 'pagination'> {
+    auth: Record<RestOperation, RestAuthConfig>;
+    pagination: ResolvedPaginationConfig;
+}
+export interface RestRoute {
+    /** HTTP method */
+    method: string;
+    /** URL path */
+    path: string;
+    /** Operation or action name */
+    operation: string;
+    /** Handler function */
+    handler: RestHandler;
+    /** Input schema */
+    inputSchema?: z.ZodType;
+    /** Output schema */
+    outputSchema?: z.ZodType;
+    /** Auth config */
+    auth: RestAuthConfig;
+    /** Is collection route */
+    isCollection: boolean;
+}
+export interface RestLoaderOptions {
+    /** Base directory */
+    baseDir: string;
+    /** REST directory path */
+    restDir: string;
+    /** File extensions to load */
+    extensions?: string[];
+    /** Default adapter type */
+    defaultAdapter?: 'prisma' | 'drizzle' | 'custom';
+    /** Global defaults */
+    defaults?: Partial<RestConfig>;
+}
+export interface RestLoaderResult {
+    resources: LoadedRestResource[];
+    stats: {
+        resources: number;
+        routes: number;
+        actions: number;
+        duration: number;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/fs-routes/rest/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/server/fs-routes/rest/types.ts"],"names":[],"mappings":"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"}

package/dist/server/fs-routes/rest/types.js

@@ -0,0 +1,50 @@
+/**
+ * REST Auto-CRUD Types
+ *
+ * Type definitions for schema-first REST API generation.
+ */
+export const REST_OPERATIONS = [
+    'list',
+    'get',
+    'create',
+    'update',
+    'patch',
+    'delete',
+    'head',
+    'options',
+];
+// HTTP method mapping
+export const OPERATION_METHODS = {
+    list: 'GET',
+    get: 'GET',
+    create: 'POST',
+    update: 'PUT',
+    patch: 'PATCH',
+    delete: 'DELETE',
+    head: 'HEAD',
+    options: 'OPTIONS',
+};
+// Operations that work on collection vs item
+// Order follows REST convention: GET, HEAD, POST/PUT/PATCH/DELETE, OPTIONS
+export const COLLECTION_OPERATIONS = ['list', 'head', 'create', 'options'];
+export const ITEM_OPERATIONS = ['get', 'head', 'update', 'patch', 'delete', 'options'];
+/**
+ * Standard REST route ordering for documentation and consistency.
+ * Collection routes first, then item routes.
+ * Within each: GET, HEAD, POST/PUT/PATCH, DELETE, OPTIONS
+ */
+export const REST_ROUTE_ORDER = {
+    // Collection operations (0-99)
+    'list': 0, // GET /resource
+    'head:c': 10, // HEAD /resource (collection)
+    'create': 20, // POST /resource
+    'options:c': 30, // OPTIONS /resource (collection)
+    // Item operations (100-199)
+    'get': 100, // GET /resource/:id
+    'head:i': 110, // HEAD /resource/:id (item)
+    'update': 120, // PUT /resource/:id
+    'patch': 130, // PATCH /resource/:id
+    'delete': 140, // DELETE /resource/:id
+    'options:i': 150, // OPTIONS /resource/:id (item)
+};
+//# sourceMappingURL=types.js.map

package/dist/server/fs-routes/rest/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/server/fs-routes/rest/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH,MAAM,CAAC,MAAM,eAAe,GAAoB;IAC9C,MAAM;IACN,KAAK;IACL,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,MAAM;IACN,SAAS;CACV,CAAA;AAED,sBAAsB;AACtB,MAAM,CAAC,MAAM,iBAAiB,GAAkC;IAC9D,IAAI,EAAE,KAAK;IACX,GAAG,EAAE,KAAK;IACV,MAAM,EAAE,MAAM;IACd,MAAM,EAAE,KAAK;IACb,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;CACnB,CAAA;AAED,6CAA6C;AAC7C,2EAA2E;AAC3E,MAAM,CAAC,MAAM,qBAAqB,GAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAA;AAC3F,MAAM,CAAC,MAAM,eAAe,GAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAA;AAEvG;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA2B;IACtD,+BAA+B;IAC/B,MAAM,EAAE,CAAC,EAAO,gBAAgB;IAChC,QAAQ,EAAE,EAAE,EAAI,8BAA8B;IAC9C,QAAQ,EAAE,EAAE,EAAI,iBAAiB;IACjC,WAAW,EAAE,EAAE,EAAE,iCAAiC;IAClD,4BAA4B;IAC5B,KAAK,EAAE,GAAG,EAAM,oBAAoB;IACpC,QAAQ,EAAE,GAAG,EAAG,4BAA4B;IAC5C,QAAQ,EAAE,GAAG,EAAG,oBAAoB;IACpC,OAAO,EAAE,GAAG,EAAI,sBAAsB;IACtC,QAAQ,EAAE,GAAG,EAAG,uBAAuB;IACvC,WAAW,EAAE,GAAG,EAAE,+BAA+B;CAClD,CAAA"}

package/dist/server/fs-routes/tcp/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * TCP Custom Handlers
+ *
+ * Full control TCP server handlers.
+ */
+export * from './types.js';
+export * from './loader.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/server/fs-routes/tcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/fs-routes/tcp/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA"}

package/dist/server/fs-routes/tcp/index.js

@@ -0,0 +1,8 @@
+/**
+ * TCP Custom Handlers
+ *
+ * Full control TCP server handlers.
+ */
+export * from './types.js';
+export * from './loader.js';
+//# sourceMappingURL=index.js.map

package/dist/server/fs-routes/tcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/server/fs-routes/tcp/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA"}

package/dist/server/fs-routes/tcp/loader.d.ts

@@ -0,0 +1,15 @@
+/**
+ * TCP Custom Handler Loader
+ *
+ * Loads custom TCP handlers from file system and creates servers.
+ */
+import type { TcpLoaderOptions, TcpLoaderResult, LoadedTcpHandler, TcpServerInstance } from './types.js';
+/**
+ * Load TCP handlers from directory.
+ */
+export declare function loadTcpHandlers(options: TcpLoaderOptions): Promise<TcpLoaderResult>;
+/**
+ * Create a TCP server instance from a loaded handler.
+ */
+export declare function createTcpServer(handler: LoadedTcpHandler): TcpServerInstance;
+//# sourceMappingURL=loader.d.ts.map

package/dist/server/fs-routes/tcp/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../../src/server/fs-routes/tcp/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,KAAK,EAKV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAGhB,iBAAiB,EAClB,MAAM,YAAY,CAAA;AAmBnB;;GAEG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,CAAC,CAwDzF;AA8BD;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,iBAAiB,CA8N5E"}