@jay-framework/fullstack-component 0.11.0 → 0.13.0

package/dist/index.d.ts

@@ -31,30 +31,30 @@ type ServiceMarkers<T extends any[]> = {
     [K in keyof T]: ServiceMarker<T[K]>;
 };
 /**
- * Contract metadata passed to dynamic contract components.
- * Contains the contract name and original YAML definition.
- */
-interface DynamicContractMetadata {
-    contractName: string;
-    contractYaml: string;
-}
-/**
- * Built-in service for dynamic contract metadata.
- * Used by plugin system to pass contract metadata to shared components.
+ * Props passed to components that work with dynamic contracts.
+ * The runtime automatically populates these when a headless component
+ * is used with a dynamic contract.
+ *
+ * @typeParam TMetadata - The metadata type from the generator (defaults to Record<string, unknown>)
  *
  * @example
  * ```typescript
- * export const cmsCollection = makeJayStackComponent<DynamicContract>()
- *   .withServices(DYNAMIC_CONTRACT_SERVICE)
- *   .withFastRender(async (props, metadata: DynamicContractMetadata) => {
- *     // metadata.contractName contains the full contract name (e.g., "BlogPostsList")
- *     const collectionName = deriveCollectionName(metadata.contractName);
- *     const items = await fetchCollection(collectionName);
- *     return partialRender({ items }, {});
+ * interface MyMetadata { collectionId: string }
+ *
+ * export const collectionList = makeJayStackComponent<MyContract, DynamicContractProps<MyMetadata>>()
+ *   .withServices(MY_DATA_SERVICE)
+ *   .withSlowlyRender(async (props, dataService) => {
+ *     const { collectionId } = props.metadata!; // Typed correctly
+ *     // ...
  *   });
  * ```
  */
-declare const DYNAMIC_CONTRACT_SERVICE: ServiceMarker<DynamicContractMetadata>;
+interface DynamicContractProps<TMetadata = Record<string, unknown>> {
+    /** Contract name (e.g., "RecipesList" or "list/recipes-list") */
+    contractName: string;
+    /** Metadata from the generator */
+    metadata?: TMetadata;
+}
 interface PageProps {
     language: string;
     url: string;
@@ -118,11 +118,26 @@ type AnyJayStackComponentDefinition = JayStackComponentDefinition<object, object
  *
  * This avoids dependency on compiler types - generators output contract YAML,
  * which the compiler parses using its own type system.
+ *
+ * @example
+ * ```typescript
+ * return {
+ *   name: 'RecipesList',
+ *   yaml: buildContractYaml(schema),
+ *   description: 'List page for recipes',
+ *   metadata: { collectionId: 'Recipes' }, // Passed to component via props.metadata
+ * };
+ * ```
  */
 interface GeneratedContractYaml {
+    /** Contract name (PascalCase, e.g., "BlogPostsList") */
     name: string;
+    /** Contract definition in YAML format */
     yaml: string;
+    /** Optional description for the contract */
     description?: string;
+    /** Optional metadata passed to component via DynamicContractProps.metadata */
+    metadata?: Record<string, unknown>;
 }
 /**
  * Function that generates contracts dynamically at build time.
@@ -384,6 +399,15 @@ declare class RenderPipeline<T, TargetVS extends object = object, TargetCF exten
     isError(): boolean;
 }
 
+/**
+ * Service resolver function type.
+ * Registered by stack-server-runtime to enable automatic service injection
+ * when actions are called from server-side code.
+ */
+type ServiceResolver = (markers: any[]) => any[];
+declare global {
+    var __JAY_SERVICE_RESOLVER__: ServiceResolver | undefined;
+}
 /**
  * Supported HTTP methods for actions and queries.
  */
@@ -612,4 +636,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, DYNAMIC_CONTRACT_SERVICE, type DynamicContractGenerator, type DynamicContractMetadata, type FastRenderResult, type GeneratedContractYaml, type HttpMethod, type JayAction, type JayActionBuilder, type JayActionDefinition, type JayInit, type JayInitBuilder, type JayInitBuilderWithServer, type JayStackComponentDefinition, type LoadParams, type PageProps, type PartialRender, type PhaseOutput, type PipelineFactory, type Redirect3xx, type RenderFast, type RenderOutcome, RenderPipeline, type RenderSlowly, type ServerError5xx, type ServiceInstances, type ServiceMarker, type ServiceMarkers, type Signals, type SlowlyRenderResult, type UrlParams, badRequest, clientError4xx, createJayService, forbidden, isJayAction, isJayInit, makeContractGenerator, makeJayAction, makeJayInit, makeJayQuery, makeJayStackComponent, 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 GeneratedContractYaml, type HttpMethod, type JayAction, type JayActionBuilder, type JayActionDefinition, type JayInit, type JayInitBuilder, type JayInitBuilderWithServer, type JayStackComponentDefinition, type LoadParams, type PageProps, type PartialRender, type PhaseOutput, type PipelineFactory, type Redirect3xx, type RenderFast, type RenderOutcome, RenderPipeline, type RenderSlowly, type ServerError5xx, type ServiceInstances, type ServiceMarker, type ServiceMarkers, type Signals, type SlowlyRenderResult, type UrlParams, badRequest, clientError4xx, createJayService, forbidden, isJayAction, isJayInit, makeContractGenerator, makeJayAction, makeJayInit, makeJayQuery, makeJayStackComponent, notFound, partialRender, phaseOutput, redirect3xx, serverError5xx, unauthorized };

package/dist/index.js

@@ -49,7 +49,6 @@ function partialRender(rendered, carryForward) {
 function createJayService(name) {
   return Symbol(name);
 }
-const DYNAMIC_CONTRACT_SERVICE = createJayService("DynamicContract");
 class BuilderImplementation {
   constructor() {
     __publicField(this, "services", []);
@@ -370,14 +369,18 @@ class JayActionBuilderImpl {
     const actionName = this._actionName;
     const method = this._method;
     const cacheOptions = this._cacheOptions;
-    const services = this._services;
+    const serviceMarkers = this._services;
     const action = Object.assign(
-      (input) => handler(input, ...[]),
+      (input) => {
+        const resolver = globalThis.__JAY_SERVICE_RESOLVER__;
+        const resolvedServices = resolver ? resolver(serviceMarkers) : [];
+        return handler(input, ...resolvedServices);
+      },
       {
         actionName,
         method,
         cacheOptions,
-        services,
+        services: serviceMarkers,
         handler,
         _brand: "JayAction"
       }
@@ -431,7 +434,6 @@ function isJayInit(obj) {
 }
 export {
   ActionError,
-  DYNAMIC_CONTRACT_SERVICE,
   RenderPipeline,
   badRequest,
   clientError4xx,

package/package.json

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