@jay-framework/fullstack-component 0.16.0 → 0.16.1

package/dist/index.d.ts

@@ -445,6 +445,34 @@ type ServiceResolver = (markers: any[]) => any[];
 declare global {
     var __JAY_SERVICE_RESOLVER__: ServiceResolver | undefined;
 }
+/**
+ * Represents a file in a Jay action.
+ *
+ * On the **client**, browser `File` and `Blob` objects are assignable to this type
+ * (they have `name`, `type`, `size`). The framework converts them to FormData automatically.
+ *
+ * On the **server**, the framework populates `path` with a temp file location.
+ * The temp file is cleaned up after the handler returns.
+ */
+interface JayFile {
+    /** Original filename */
+    name: string;
+    /** MIME type */
+    type: string;
+    /** File size in bytes */
+    size: number;
+    /** Absolute path to the temp file on disk (server-side only, always present in handlers) */
+    path?: string;
+}
+/**
+ * Options for file upload support.
+ */
+interface FileUploadOptions {
+    /** Maximum file size in bytes (default: 10MB) */
+    maxFileSize?: number;
+    /** Maximum number of files (default: 10) */
+    maxFiles?: number;
+}
 /**
  * Supported HTTP methods for actions and queries.
  */
@@ -499,6 +527,10 @@ interface JayActionDefinition<Input, Output, Services extends any[]> {
     cacheOptions?: CacheOptions;
     /** Service markers for dependency injection */
     services: ServiceMarkers<Services>;
+    /** Whether this action accepts file uploads (DL#131) */
+    acceptsFiles?: boolean;
+    /** File upload options (DL#131) */
+    fileOptions?: FileUploadOptions;
     /** The handler function */
     handler: (input: Input, ...services: Services) => Promise<Output>;
 }
@@ -518,6 +550,11 @@ interface JayActionBuilder<Services extends any[], Input, Output, DefaultMethod
      * Enable caching (typically for GET requests).
      */
     withCaching(options?: CacheOptions): JayActionBuilder<Services, Input, Output, DefaultMethod>;
+    /**
+     * Mark this action as accepting file uploads (DL#131).
+     * The handler will receive JayFile objects for file fields.
+     */
+    withFiles(options?: FileUploadOptions): JayActionBuilder<Services, Input, Output, DefaultMethod>;
     /**
      * Define the handler function. Input and output types are inferred from the handler signature.
      */
@@ -594,6 +631,10 @@ interface JayStreamActionDefinition<Input, Chunk, Services extends any[]> {
     method: 'POST';
     isStreaming: true;
     services: ServiceMarkers<Services>;
+    /** Whether this action accepts file uploads (DL#131) */
+    acceptsFiles?: boolean;
+    /** File upload options (DL#131) */
+    fileOptions?: FileUploadOptions;
     handler: (input: Input, ...services: Services) => AsyncIterable<Chunk>;
 }
 /**
@@ -601,6 +642,10 @@ interface JayStreamActionDefinition<Input, Chunk, Services extends any[]> {
  */
 interface JayStreamBuilder<Services extends any[]> {
     withServices<NewServices extends any[]>(...services: ServiceMarkers<NewServices>): JayStreamBuilder<NewServices>;
+    /**
+     * Mark this streaming action as accepting file uploads (DL#131).
+     */
+    withFiles(options?: FileUploadOptions): JayStreamBuilder<Services>;
     withHandler<I, C>(handler: (input: I, ...services: Services) => AsyncIterable<C>): JayStreamAction<I, C> & JayStreamActionDefinition<I, C, Services>;
 }
 /**
@@ -736,4 +781,4 @@ declare function makeJayInit(key?: string): JayInitBuilder<void>;
  */
 declare function isJayInit(obj: unknown): obj is JayInit<any>;
 
-export { ActionError, type ActionInput, type ActionOutput, type AnyFastRenderResult, type AnyJayStackComponentDefinition, type AnySlowlyRenderResult, type Builder, type CacheOptions, type ClientError4xx, type ContractGeneratorFunction, type DynamicContractGenerator, type DynamicContractProps, type FastRenderResult, type GeneratedContractYaml, type HeadTag, type HttpMethod, type JayAction, type JayActionBuilder, type JayActionDefinition, type JayInit, type JayInitBuilder, type JayInitBuilderWithServer, type JayStackComponentDefinition, type JayStreamAction, type JayStreamActionDefinition, type JayStreamBuilder, type LoadParams, type PageProps, type PartialRender, type PhaseOutput, type PipelineFactory, type Redirect3xx, type RenderFast, type RenderOutcome, RenderPipeline, type RenderSlowly, type RequestQuery, type ServerError5xx, type ServiceInstances, type ServiceMarker, type ServiceMarkers, type Signals, type SlowlyRenderResult, type StreamChunk, type UrlParams, badRequest, clientError4xx, createJayService, forbidden, isJayAction, isJayInit, isJayStreamAction, makeContractGenerator, makeJayAction, makeJayInit, makeJayQuery, makeJayStackComponent, makeJayStream, notFound, partialRender, phaseOutput, redirect3xx, serverError5xx, unauthorized };
+export { ActionError, type ActionInput, type ActionOutput, type AnyFastRenderResult, type AnyJayStackComponentDefinition, type AnySlowlyRenderResult, type Builder, type CacheOptions, type ClientError4xx, type ContractGeneratorFunction, type DynamicContractGenerator, type DynamicContractProps, type FastRenderResult, type FileUploadOptions, type GeneratedContractYaml, type HeadTag, type HttpMethod, type JayAction, type JayActionBuilder, type JayActionDefinition, type JayFile, type JayInit, type JayInitBuilder, type JayInitBuilderWithServer, type JayStackComponentDefinition, type JayStreamAction, type JayStreamActionDefinition, type JayStreamBuilder, type LoadParams, type PageProps, type PartialRender, type PhaseOutput, type PipelineFactory, type Redirect3xx, type RenderFast, type RenderOutcome, RenderPipeline, type RenderSlowly, type RequestQuery, type ServerError5xx, type ServiceInstances, type ServiceMarker, type ServiceMarkers, type Signals, type SlowlyRenderResult, type StreamChunk, type UrlParams, badRequest, clientError4xx, createJayService, forbidden, isJayAction, isJayInit, isJayStreamAction, makeContractGenerator, makeJayAction, makeJayInit, makeJayQuery, makeJayStackComponent, makeJayStream, notFound, partialRender, phaseOutput, redirect3xx, serverError5xx, unauthorized };

package/dist/index.js

@@ -364,6 +364,8 @@ class JayActionBuilderImpl {
     __publicField(this, "_services", []);
     __publicField(this, "_method");
     __publicField(this, "_cacheOptions");
+    __publicField(this, "_acceptsFiles", false);
+    __publicField(this, "_fileOptions");
     this._actionName = _actionName;
     this._method = defaultMethod;
   }
@@ -379,11 +381,18 @@ class JayActionBuilderImpl {
     this._cacheOptions = options ?? { maxAge: 60 };
     return this;
   }
+  withFiles(options) {
+    this._acceptsFiles = true;
+    this._fileOptions = options;
+    return this;
+  }
   withHandler(handler) {
     const actionName = this._actionName;
     const method = this._method;
     const cacheOptions = this._cacheOptions;
     const serviceMarkers = this._services;
+    const acceptsFiles = this._acceptsFiles;
+    const fileOptions = this._fileOptions;
     const action = Object.assign(
       (input) => {
         const resolver = globalThis.__JAY_SERVICE_RESOLVER__;
@@ -396,7 +405,9 @@ class JayActionBuilderImpl {
         cacheOptions,
         services: serviceMarkers,
         handler,
-        _brand: "JayAction"
+        _brand: "JayAction",
+        ...acceptsFiles && { acceptsFiles: true },
+        ...fileOptions && { fileOptions }
       }
     );
     return action;
@@ -414,15 +425,24 @@ function isJayAction(value) {
 class JayStreamBuilderImpl {
   constructor(_actionName) {
     __publicField(this, "_services", []);
+    __publicField(this, "_acceptsFiles", false);
+    __publicField(this, "_fileOptions");
     this._actionName = _actionName;
   }
   withServices(...services) {
     this._services = services;
     return this;
   }
+  withFiles(options) {
+    this._acceptsFiles = true;
+    this._fileOptions = options;
+    return this;
+  }
   withHandler(handler) {
     const actionName = this._actionName;
     const serviceMarkers = this._services;
+    const acceptsFiles = this._acceptsFiles;
+    const fileOptions = this._fileOptions;
     const action = Object.assign(
       (input) => {
         const resolver = globalThis.__JAY_SERVICE_RESOLVER__;
@@ -435,7 +455,9 @@ class JayStreamBuilderImpl {
         isStreaming: true,
         services: serviceMarkers,
         handler,
-        _brand: "JayStreamAction"
+        _brand: "JayStreamAction",
+        ...acceptsFiles && { acceptsFiles: true },
+        ...fileOptions && { fileOptions }
       }
     );
     return action;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/fullstack-component",
-  "version": "0.16.0",
+  "version": "0.16.1",
   "type": "module",
   "license": "Apache-2.0",
   "main": "dist/index.js",
@@ -26,12 +26,12 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@jay-framework/component": "^0.16.0",
-    "@jay-framework/runtime": "^0.16.0"
+    "@jay-framework/component": "^0.16.1",
+    "@jay-framework/runtime": "^0.16.1"
   },
   "devDependencies": {
-    "@jay-framework/dev-environment": "^0.16.0",
-    "@jay-framework/jay-cli": "^0.16.0",
+    "@jay-framework/dev-environment": "^0.16.1",
+    "@jay-framework/jay-cli": "^0.16.1",
     "@types/express": "^5.0.2",
     "@types/node": "^22.15.21",
     "nodemon": "^3.0.3",