@diphyx/harlemify 6.1.0 → 6.2.0

package/README.md

@@ -23,9 +23,11 @@ If you are an AI coding agent working on a project that uses `@diphyx/harlemify`
 ## Install
 
 ```bash
-npm install @diphyx/harlemify
+npm install @diphyx/harlemify zod
 ```
 
+> `zod` is a peer dependency — install it in your project.
+
 ```typescript
 // nuxt.config.ts
 export default defineNuxtConfig({

package/dist/module.json

@@ -4,7 +4,7 @@
   "compatibility": {
     "nuxt": "^3.14.0 || ^4.0.0"
   },
-  "version": "6.1.0",
+  "version": "6.2.0",
   "builder": {
     "@nuxt/module-builder": "0.8.4",
     "unbuild": "unknown"

package/dist/runtime/core/store.js

@@ -1,3 +1,4 @@
+import { effectScope } from "vue";
 import { createConsola } from "consola";
 import { createStore as createStoreSource } from "@harlem/core";
 import { runtimeConfig } from "../config.js";
@@ -37,10 +38,13 @@ export function createStore(config) {
   }
   if (config.lazy) {
     let instance;
+    const scope = effectScope(true);
     return new Proxy({}, {
       get(_, prop) {
         if (!instance) {
-          instance = init();
+          scope.run(() => {
+            instance = init();
+          });
         }
         return instance[prop];
       }

package/dist/runtime/core/types/action.d.ts

@@ -46,16 +46,26 @@ export interface ActionApiRequest<MD extends ModelDefinitions, VD extends ViewDe
     concurrent?: ActionConcurrent;
 }
 export type ActionApiRequestShortcut<MD extends ModelDefinitions, VD extends ViewDefinitions<MD>> = Omit<ActionApiRequest<MD, VD>, "method">;
-export interface ActionApiCommit<MD extends ModelDefinitions, K extends keyof MD = keyof MD> {
+export interface ActionApiCommitContext<MD extends ModelDefinitions, VD extends ViewDefinitions<MD>> {
+    request: Readonly<{
+        url: string;
+        method: ActionApiMethod;
+        headers: Readonly<Record<string, string>>;
+        query: Readonly<Record<string, unknown>>;
+        body: unknown;
+    }>;
+    view: DeepReadonly<StoreView<MD, VD>>;
+}
+export interface ActionApiCommit<MD extends ModelDefinitions, VD extends ViewDefinitions<MD>, K extends keyof MD = keyof MD> {
     model: K;
     mode: ModelOneMode | ModelManyMode;
-    value?: (data: unknown) => unknown;
+    transform?: (data: unknown, context: ActionApiCommitContext<MD, VD>) => unknown;
     options?: ModelOneCommitOptions | ModelManyCommitOptions;
 }
-export type ActionApiCommitReturn<MD extends ModelDefinitions, C extends readonly ActionApiCommit<MD>[]> = C extends readonly [] ? unknown : {
+export type ActionApiCommitReturn<MD extends ModelDefinitions, VD extends ViewDefinitions<MD>, C extends readonly ActionApiCommit<MD, VD>[]> = C extends readonly [] ? unknown : {
     [E in C[number] as E["model"] & string]: E["model"] extends keyof MD ? ModelDefinitionInfer<MD, E["model"]> : never;
 };
-export interface ActionApiDefinition<MD extends ModelDefinitions, VD extends ViewDefinitions<MD>, C extends readonly ActionApiCommit<MD>[] = readonly ActionApiCommit<MD>[]> extends BaseDefinition {
+export interface ActionApiDefinition<MD extends ModelDefinitions, VD extends ViewDefinitions<MD>, C extends readonly ActionApiCommit<MD, VD>[] = readonly ActionApiCommit<MD, VD>[]> extends BaseDefinition {
     request: ActionApiRequest<MD, VD>;
     commits: C;
 }
@@ -74,25 +84,25 @@ export interface ActionHandlerDefinition<MD extends ModelDefinitions, VD extends
 }
 export type ActionDefinition<MD extends ModelDefinitions, VD extends ViewDefinitions<MD>> = ActionApiDefinition<MD, VD, any> | ActionHandlerDefinition<MD, VD, any, any>;
 export type ActionDefinitions<MD extends ModelDefinitions, VD extends ViewDefinitions<MD>> = Record<string, ActionDefinition<MD, VD>>;
-type ActionApiCommitTuple<MD extends ModelDefinitions> = readonly [
-    ActionApiCommit<MD, keyof MD>,
-    ...ActionApiCommit<MD, keyof MD>[]
+type ActionApiCommitTuple<MD extends ModelDefinitions, VD extends ViewDefinitions<MD>> = readonly [
+    ActionApiCommit<MD, VD, keyof MD>,
+    ...ActionApiCommit<MD, VD, keyof MD>[]
 ];
 export interface ActionApiFactory<MD extends ModelDefinitions, VD extends ViewDefinitions<MD>> {
     (request: ActionApiRequest<MD, VD>): ActionApiDefinition<MD, VD, []>;
-    <const C extends ActionApiCommitTuple<MD>>(request: ActionApiRequest<MD, VD>, ...commits: C): ActionApiDefinition<MD, VD, C>;
+    <const C extends ActionApiCommitTuple<MD, VD>>(request: ActionApiRequest<MD, VD>, ...commits: C): ActionApiDefinition<MD, VD, C>;
     get(request: ActionApiRequestShortcut<MD, VD>): ActionApiDefinition<MD, VD, []>;
-    get<const C extends ActionApiCommitTuple<MD>>(request: ActionApiRequestShortcut<MD, VD>, ...commits: C): ActionApiDefinition<MD, VD, C>;
+    get<const C extends ActionApiCommitTuple<MD, VD>>(request: ActionApiRequestShortcut<MD, VD>, ...commits: C): ActionApiDefinition<MD, VD, C>;
     head(request: ActionApiRequestShortcut<MD, VD>): ActionApiDefinition<MD, VD, []>;
-    head<const C extends ActionApiCommitTuple<MD>>(request: ActionApiRequestShortcut<MD, VD>, ...commits: C): ActionApiDefinition<MD, VD, C>;
+    head<const C extends ActionApiCommitTuple<MD, VD>>(request: ActionApiRequestShortcut<MD, VD>, ...commits: C): ActionApiDefinition<MD, VD, C>;
     post(request: ActionApiRequestShortcut<MD, VD>): ActionApiDefinition<MD, VD, []>;
-    post<const C extends ActionApiCommitTuple<MD>>(request: ActionApiRequestShortcut<MD, VD>, ...commits: C): ActionApiDefinition<MD, VD, C>;
+    post<const C extends ActionApiCommitTuple<MD, VD>>(request: ActionApiRequestShortcut<MD, VD>, ...commits: C): ActionApiDefinition<MD, VD, C>;
     put(request: ActionApiRequestShortcut<MD, VD>): ActionApiDefinition<MD, VD, []>;
-    put<const C extends ActionApiCommitTuple<MD>>(request: ActionApiRequestShortcut<MD, VD>, ...commits: C): ActionApiDefinition<MD, VD, C>;
+    put<const C extends ActionApiCommitTuple<MD, VD>>(request: ActionApiRequestShortcut<MD, VD>, ...commits: C): ActionApiDefinition<MD, VD, C>;
     patch(request: ActionApiRequestShortcut<MD, VD>): ActionApiDefinition<MD, VD, []>;
-    patch<const C extends ActionApiCommitTuple<MD>>(request: ActionApiRequestShortcut<MD, VD>, ...commits: C): ActionApiDefinition<MD, VD, C>;
+    patch<const C extends ActionApiCommitTuple<MD, VD>>(request: ActionApiRequestShortcut<MD, VD>, ...commits: C): ActionApiDefinition<MD, VD, C>;
     delete(request: ActionApiRequestShortcut<MD, VD>): ActionApiDefinition<MD, VD, []>;
-    delete<const C extends ActionApiCommitTuple<MD>>(request: ActionApiRequestShortcut<MD, VD>, ...commits: C): ActionApiDefinition<MD, VD, C>;
+    delete<const C extends ActionApiCommitTuple<MD, VD>>(request: ActionApiRequestShortcut<MD, VD>, ...commits: C): ActionApiDefinition<MD, VD, C>;
 }
 export interface ActionHandlerFactory<MD extends ModelDefinitions, VD extends ViewDefinitions<MD>> {
     <P = unknown, R = void>(callback: ActionHandlerCallback<MD, VD, P, R>, options?: ActionHandlerOptions<P>): ActionHandlerDefinition<MD, VD, P, R>;
@@ -160,6 +170,6 @@ export interface ActionHandlerCall<P = unknown, T = void> extends ActionCallBase
 }
 export type ActionCall<T = void> = ActionApiCall<T> | ActionHandlerCall<any, T>;
 export type StoreAction<MD extends ModelDefinitions, VD extends ViewDefinitions<MD>, AD extends ActionDefinitions<MD, VD>> = {
-    [K in keyof AD]: AD[K] extends ActionApiDefinition<MD, VD, infer C> ? C extends readonly ActionApiCommit<MD>[] ? ActionApiCall<ActionApiCommitReturn<MD, C>> : ActionApiCall : AD[K] extends ActionHandlerDefinition<MD, VD, infer P, infer R> ? ActionHandlerCall<P, R> : never;
+    [K in keyof AD]: AD[K] extends ActionApiDefinition<MD, VD, infer C> ? C extends readonly ActionApiCommit<MD, VD>[] ? ActionApiCall<ActionApiCommitReturn<MD, VD, C>> : ActionApiCall : AD[K] extends ActionHandlerDefinition<MD, VD, infer P, infer R> ? ActionHandlerCall<P, R> : never;
 };
 export {};

package/dist/runtime/core/utils/action.js

@@ -97,9 +97,9 @@ function resolveCommitMode(commit, options) {
   }
   return commit.mode;
 }
-function resolveCommitValue(commit, data) {
-  if (typeof commit.value === "function") {
-    return commit.value(data);
+function resolveCommitTransform(commit, data, context) {
+  if (typeof commit.transform === "function") {
+    return commit.transform(data, context);
   }
   return data;
 }
@@ -177,7 +177,7 @@ async function executeHandler(definition, handler) {
     throw handlerError;
   }
 }
-function executeCommit(definition, model, data, options) {
+function executeCommit(definition, model, data, context, options) {
   const commits = definition.commits;
   if (!commits || commits.length === 0) {
     return data;
@@ -192,7 +192,7 @@ function executeCommit(definition, model, data, options) {
         });
       }
       const mode = resolveCommitMode(commit, options);
-      let value = resolveCommitValue(commit, data);
+      let value = resolveCommitTransform(commit, data, context);
       if (!isEmptyRecord(target.aliases())) {
         value = resolveAliasInbound(value, target.aliases());
       }
@@ -296,7 +296,11 @@ export function createAction(definition, model, view) {
             },
             options
           );
-          data = executeCommit(definition, model, response, options);
+          const context = {
+            request: { url, method, headers, query, body },
+            view
+          };
+          data = executeCommit(definition, model, response, context, options);
         } else if (isHandlerDefinition(definition)) {
           const payload = resolveHandlerPayload(definition, options);
           data = await executeHandler(definition, {

package/dist/runtime/index.d.ts

@@ -7,7 +7,7 @@ export type { ModelOneCommitOptions, ModelManyCommitOptions } from "./core/types
 export { ViewClone } from "./core/types/view.js";
 export type { ViewDefinitionOptions } from "./core/types/view.js";
 export { ActionStatus, ActionConcurrent, ActionType, ActionApiMethod } from "./core/types/action.js";
-export type { ActionCall, ActionApiCall, ActionHandlerCall, ActionCallOptions, ActionCallBaseOptions, ActionApiCallOptions, ActionHandlerCallOptions, ActionCallTransformerOptions, ActionCallBindOptions, ActionCallCommitOptions, ActionHandlerOptions, ActionResolvedApi, } from "./core/types/action.js";
+export type { ActionCall, ActionApiCall, ActionApiCommitContext, ActionHandlerCall, ActionCallOptions, ActionCallBaseOptions, ActionApiCallOptions, ActionHandlerCallOptions, ActionCallTransformerOptions, ActionCallBindOptions, ActionCallCommitOptions, ActionHandlerOptions, ActionResolvedApi, } from "./core/types/action.js";
 export { ActionApiError, ActionHandlerError, ActionCommitError, ActionConcurrentError, isError, toError } from "./core/utils/error.js";
 export type { ComposeCallback, ComposeCall, ComposeDefinitions, ComposeContext, StoreCompose, } from "./core/types/compose.js";
 export { useStoreCompose } from "./composables/compose.js";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@diphyx/harlemify",
-    "version": "6.1.0",
+    "version": "6.2.0",
     "description": "API state management for Nuxt powered by Harlem",
     "keywords": [
         "nuxt",
@@ -49,25 +49,28 @@
         "test": "vitest run",
         "test:e2e": "playwright test"
     },
+    "peerDependencies": {
+        "zod": "^4.4.3"
+    },
     "dependencies": {
         "@harlem/core": "^3.1.8",
-        "@nuxt/kit": "^3.14.0 || ^4.0.0",
+        "@nuxt/kit": "^4.4.6",
         "consola": "^3.4.2",
-        "defu": "^6.1.4",
-        "zod": "^4.3.6"
+        "defu": "^6.1.7"
     },
     "devDependencies": {
         "@nuxt/eslint-config": "^0.6.2",
         "@nuxt/module-builder": "^0.8.4",
-        "@nuxt/schema": "^4.3.1",
+        "@nuxt/schema": "^4.4.6",
         "@nuxt/test-utils": "^3.23.0",
-        "@playwright/test": "^1.58.2",
-        "@types/node": "^22.19.11",
+        "@playwright/test": "^1.60.0",
+        "@types/node": "^22.19.19",
         "@vitest/coverage-v8": "^2.1.9",
-        "eslint": "^9.39.2",
-        "nuxt": "^4.3.1",
+        "eslint": "^9.39.4",
+        "nuxt": "^4.4.6",
         "typescript": "^5.9.3",
         "vitest": "^2.1.9",
-        "vue": "^3.5.28"
+        "vue": "^3.5.34",
+        "zod": "^4.4.3"
     }
 }