@tramvai/core 2.7.0 → 2.11.0

package/README.md

@@ -83,31 +83,30 @@ class ModulePubSub {
 }
 ```
 
-### createAction
+### declareAction
 
-`createAction` - Method for creating asynchronous actions. It is used both for building chains of sagas and for performing global actions when building a response to a client
+`declareAction` - Method for creating asynchronous actions. It is used both for building chains of sagas and for performing global actions when building a response to a client
 
 [More about actions](concepts/action.md)
 
-#### createAction({ name, fn, deps, conditions })
+#### declareAction({ name, fn, deps, conditions })
 
 - `name` - The name of the action, a unique identifier is expected
-- `fn(context, payload, deps)` - Implementation of the action, this function will be called when the action is used, maybe `async`
-  - `context` - [ConsumerContext](references/tokens/common.md#context-tokens-list)
-  - `payload` - data passed to action
-  - `deps` - provider instances from `deps`
+- `fn(...params)` - Implementation of the action, this function will be called when the action is used, maybe `async`
+  - `this` - action execution context that contains some helper functions and resolved deps
+  - `params` - data passed to action
 - `deps` - List of providers that are needed for the action to work
 - `conditions` - List of restrictions for the execution of the action
 
 #### Usage example
 
 ```tsx
-import { createAction } from '@tramvai/core';
+import { declareAction } from '@tramvai/core';
 
-createAction({
+declareAction({
   name: 'action log error',
-  fn: (context, payload, deps) => {
-    deps.logger.error('ERROR');
+  fn(payload) {
+    this.deps.logger.error('ERROR');
   },
   deps: {
     logger: 'logger',

package/lib/actions/createActions.d.ts

@@ -1,2 +1,5 @@
 import type { ActionParameters, Action } from '@tramvai/tokens-core';
+/**
+ * @deprecated: use `declareAction`
+ */
 export declare function createAction<Result = any, Payload = any, Deps = any>(action: ActionParameters<Payload, Result, Deps>): Action<Payload, Result, Deps>;

package/lib/actions/declareAction.d.ts

@@ -0,0 +1,3 @@
+import type { TramvaiAction, TramvaiActionDefinition } from '@tramvai/types-actions-state-context';
+export declare function declareAction<Params extends any[], Result, Deps = {}>(action: TramvaiActionDefinition<Params, Result, Deps>): TramvaiAction<Params, Result, Deps>;
+export declare function isTramvaiAction<Params extends any[], Result, Deps>(action: any): action is TramvaiAction<Params, Result, Deps>;

package/lib/actions/declareAction.test-types.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/index.d.ts

@@ -1,6 +1,7 @@
 export { createApp, App } from './createApp';
 export { createBundle } from './bundles/createBundle';
 export { createAction } from './actions/createActions';
+export * from './actions/declareAction';
 export { Module, deprecatedModule as module, MODULE_PARAMETERS } from './modules/module';
 export { getModuleParameters } from './modules/getModuleParameters';
 export { walkOfModules } from './modules/walkOfModules';

package/lib/index.es.js

@@ -225,6 +225,9 @@ function createBundle(options) {
     return mergeOptions(presets, options);
 }
 
+/**
+ * @deprecated: use `declareAction`
+ */
 function createAction(action) {
     const result = Object.assign(action.fn, {
         [ACTION_PARAMETERS]: action,
@@ -236,4 +239,14 @@ function createAction(action) {
     return result;
 }
 
-export { App, MODULE_PARAMETERS, Module, createAction, createApp, createBundle, getModuleParameters, isExtendedModule, deprecatedModule as module, walkOfModules };
+function declareAction(action) {
+    return {
+        ...action,
+        tramvaiActionVersion: 2,
+    };
+}
+function isTramvaiAction(action) {
+    return 'tramvaiActionVersion' in action && action.tramvaiActionVersion === 2;
+}
+
+export { App, MODULE_PARAMETERS, Module, createAction, createApp, createBundle, declareAction, getModuleParameters, isExtendedModule, isTramvaiAction, deprecatedModule as module, walkOfModules };

package/lib/index.js

@@ -233,6 +233,9 @@ function createBundle(options) {
     return mergeOptions(presets, options);
 }
 
+/**
+ * @deprecated: use `declareAction`
+ */
 function createAction(action) {
     const result = Object.assign(action.fn, {
         [tokensCore.ACTION_PARAMETERS]: action,
@@ -244,6 +247,16 @@ function createAction(action) {
     return result;
 }
 
+function declareAction(action) {
+    return {
+        ...action,
+        tramvaiActionVersion: 2,
+    };
+}
+function isTramvaiAction(action) {
+    return 'tramvaiActionVersion' in action && action.tramvaiActionVersion === 2;
+}
+
 Object.defineProperty(exports, 'DI_TOKEN', {
     enumerable: true,
     get: function () { return dippy.DI_TOKEN; }
@@ -274,8 +287,10 @@ exports.Module = Module;
 exports.createAction = createAction;
 exports.createApp = createApp;
 exports.createBundle = createBundle;
+exports.declareAction = declareAction;
 exports.getModuleParameters = getModuleParameters;
 exports.isExtendedModule = isExtendedModule;
+exports.isTramvaiAction = isTramvaiAction;
 exports.module = deprecatedModule;
 exports.walkOfModules = walkOfModules;
 Object.keys(tokensCore).forEach(function (k) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tramvai/core",
-  "version": "2.7.0",
+  "version": "2.11.0",
   "description": "",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
@@ -20,10 +20,10 @@
   },
   "dependencies": {
     "@tinkoff/utils": "^2.1.2",
-    "@tramvai/tokens-common": "2.7.0",
-    "@tramvai/tokens-core": "2.7.0",
-    "@tramvai/types-actions-state-context": "2.7.0",
-    "@tinkoff/dippy": "0.7.44",
+    "@tramvai/tokens-common": "2.11.0",
+    "@tramvai/tokens-core": "2.11.0",
+    "@tramvai/types-actions-state-context": "2.11.0",
+    "@tinkoff/dippy": "0.7.45",
     "tslib": "^2.0.3"
   },
   "peerDependencies": {