@cosmwasm/ts-codegen 0.6.1 → 0.7.2

package/README.md

@@ -21,36 +21,163 @@ npm install -g @cosmwasm/ts-codegen
 
 The quickest and easiest way to interact with CosmWasm Contracts. `@cosmwasm/ts-codegen` converts your CosmWasm smart contracts into dev-friendly TypeScript classes so you can focus on shipping code.
 
+## Table of contents
+
+- [@cosmwasm/ts-codegen](#cosmwasmts-codegen)
+  - [Table of contents](#table-of-contents)
+- [QuickStart](#quickstart)
+- [Usage](#usage)
+    - [Generate TS Clients](#generate)
+    - [React Query](#react-query)
+    - [Recoil](#recoil)
+    - [From Partial](#from-partial)
+- [Example Output](#example-output)
+- [JSON Schema](#json-schema)
+    - [JSON Schema Generation](#json-schema-generation)
+    - [Exporting Schemas](#exporting-schemas)
+- [Developing](#developing)
+- [Related](#related)
+### Quickstart 
+
+Clone your project and `cd` into your contracts folder
+
+```sh
+git clone git@github.com:public-awesome/stargaze-contracts.git
+cd stargaze-contracts/contracts/sg721/
+```
+
+Run `cosmwasm-ts-codegen` to generate your code.
+
+```sh
+cosmwasm-ts-codegen generate --schema ./schema --out ./ts --name SG721
+```
+
+The output will be in the folder specified by `--out`, enjoy!
+
 ## usage
 
+Get started quickly using our `cli` by globally installing via npm:
+
+```
+npm install -g @cosmwasm/ts-codegen
 ```
- cosmwasm-ts-codegen generate \
+### generate
+
+Generate a basic TS client for your contracts. The `generate` command will make types which will be essential for your bindings.
+
+This command also generates a `QueryClient` for queries as well as a `Client` for queries and mutations. 
+
+[see example output code](https://gist.github.com/pyramation/ba67ec56e4e2a39cadea55430f9993e5)
+
+
+```sh
+cosmwasm-ts-codegen generate \
     --schema ./schema \
-    --out ./src \
+    --out ./ts \
     --name MyContractName
  ```
 
-### example 
+for programmatic usage, you can use the `tsClient` function:
 
+```ts
+import { tsClient } from '@cosmwasm/ts-codegen';
+declare const tsClient = (name: string, schemas: any[], outPath: string) => Promise<void>;
 ```
-git clone git@github.com:public-awesome/stargaze-contracts.git
-cd stargaze-contracts/contracts/sg721/
-cosmwasm-ts-codegen generate --schema ./schema --out ./ts --name SG721
+
+### react query
+
+Generate [react-query v3](https://react-query-v3.tanstack.com/) or [react-query v4](https://tanstack.com/query/v4/) bindings for your contracts with the `react-query` command.
+
+[see example output code](https://gist.github.com/pyramation/a3bf4aa7b60a31287d0720ca1bb5473b)
+
+
+Example without optional client, using v3, without mutations:
+
+```sh
+cosmwasm-ts-codegen react-query \
+    --schema ./schema \
+    --out ./ts \
+    --name MyContractName \
+    --no-optionalClient \
+    --no-v4 \
+    --no-mutations
 ```
 
-### JSON Schema Generation
+Example with optional client, using v4, with mutations:
+
+```sh
+cosmwasm-ts-codegen react-query \
+    --schema ./schema \
+    --out ./ts \
+    --name MyContractName \
+    --optionalClient \
+    --v4 \
+    --mutations
+```
+
+For programmatic usage, you can use the `reactQuery` function:
+
+```ts
+import { reactQuery } from '@cosmwasm/ts-codegen';
+declare const reactQuery = (
+  contractName: string,
+  schemas: any[],
+  outPath: string,
+  reactQueryOptions?: ReactQueryOptions
+) => Promise<void>;
+```
+
+#### React Query Options
+
+  | option                         | description                                                         |
+  | ------------------------------ | ------------------------------------------------------------------- |
+  | `reactQuery.optionalClient`    | allows contract client to be undefined as the component renders     |
+  | `reactQuery.v4`                | uses `@tanstack/react-query` and syntax instead of v3 `react-query` |
+  | `reactQuery.mutations`         | also generate mutations                                             |
+  | `reactQuery.camelize`          | use camelCase style for property names                            |
+
+### recoil
+
+Generate [recoil](https://recoiljs.org/) bindings for your contracts with the `recoil` command.
+
+[see example output code](https://gist.github.com/pyramation/48b28a75def1a16b233b369297f05f0e)
 
-Currently you have to have the JSON Schema output. Here is an example to start:
 
 ```sh
-## get the Rust contracts
-git clone git@github.com:public-awesome/stargaze-contracts.git
-cd stargaze-contracts
-cargo build
+cosmwasm-ts-codegen recoil \
+    --schema ./schema \
+    --out ./ts \
+    --name MyContractName 
+```
 
-## now build the schema
-cd contracts/sg721/
-cargo schema
+for programmatic usage, you can use the `recoil` function:
+
+```ts
+import { recoil } from '@cosmwasm/ts-codegen';
+declare const recoil = (
+  name: string,
+  schemas: any[],
+  outPath: string
+) => Promise<void>;
+```
+### from-partial
+
+Generate pure message objects with the proper `utf8` encoding and `typeUrl` configured that you can broadcast yourself via `cosmjs` with the `from-partial` command.
+
+[see example output code](https://gist.github.com/pyramation/f50869d1ecdb6d6ced2bc0a44c6ff492)
+
+```sh
+cosmwasm-ts-codegen from-partial \
+    --schema ./schema \
+    --out ./ts \
+    --name MyContractName 
+```
+
+for programmatic usage, you can use the `fromPartial` function:
+
+```ts
+import { fromPartial } from '@cosmwasm/ts-codegen';
+declare const fromPartial = (name: string, schemas: any[], outPath: string) => Promise<void>;
 ```
 
 ### Example Output
@@ -72,8 +199,28 @@ https://gist.github.com/pyramation/a3bf4aa7b60a31287d0720ca1bb5473b
 https://gist.github.com/pyramation/48b28a75def1a16b233b369297f05f0e
 
 
-### Exporting Schemas
+### JSON Schema
+
+We generate code from the [JSON Schema](https://json-schema.org/) exported from CosmWasm smart contracts.
+### JSON Schema Generation
+
+Currently you have to have the JSON Schema output. Here is an example to start.
+
+First, get the Rust contracts and run `cargo build`:
+
+```sh
+git clone git@github.com:public-awesome/stargaze-contracts.git
+cd stargaze-contracts
+cargo build
+```
+
+now build the schema with `cargo schema`
 
+```sh
+cd contracts/sg721/
+cargo schema
+```
+### Exporting Schemas
 #### `cosmwasm_std` Examples
 
 ```rs
@@ -87,4 +234,38 @@ export_schema_with_title(
       &out_dir,
       "CosmosMsg_for_Empty",
 );
-```
+```
+
+## Developing
+
+### Initial setup
+
+```
+yarn 
+yarn bootstrap
+```
+
+### Building
+
+```
+yarn build
+```
+
+### Tests
+
+Then `cd` into a package and run the tests
+
+```
+cd ./packages/wasm-ast-types
+yarn test:watch
+```
+
+### Working with ASTs
+
+See the [docs](https://github.com/CosmWasm/ts-codegen/blob/main/packages/wasm-ast-types/README.md) in the `wasm-ast-types` package.
+
+## Related
+
+Checkout these related projects:
+
+* [@osmonauts/telescope](https://github.com/osmosis-labs/telescope) a "babel for the Cosmos", Telescope is a TypeScript Transpiler for Cosmos Protobufs.

package/main/cli.js

@@ -11,7 +11,7 @@ var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"))
 
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 
-var _prompt = require("./prompt");
+var _prompt = require("./utils/prompt");
 
 var _cmds = require("./cmds");
 

package/main/cmds.js

@@ -7,8 +7,6 @@ Object.defineProperty(exports, "__esModule", {
 });
 exports.Commands = void 0;
 
-var _boilerplate2 = _interopRequireDefault(require("./commands/boilerplate"));
-
 var _fromPartial = _interopRequireDefault(require("./commands/from-partial"));
 
 var _generate2 = _interopRequireDefault(require("./commands/generate"));
@@ -19,7 +17,6 @@ var _recoil2 = _interopRequireDefault(require("./commands/recoil"));
 
 var Commands = {};
 exports.Commands = Commands;
-Commands['boilerplate'] = _boilerplate2["default"];
 Commands['from-partial'] = _fromPartial["default"];
 Commands['generate'] = _generate2["default"];
 Commands['react-query'] = _reactQuery["default"];

package/main/commands/from-partial.js

@@ -11,9 +11,9 @@ var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"))
 
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 
-var _prompt = require("../prompt");
+var _prompt = require("../utils/prompt");
 
-var _fromPartial = _interopRequireDefault(require("../from-partial"));
+var _fromPartial = _interopRequireDefault(require("../generators/from-partial"));
 
 var _utils = require("../utils");
 
@@ -51,14 +51,18 @@ var _default = /*#__PURE__*/function () {
             schema = _yield$prompt.schema;
             out = _yield$prompt.out;
             name = _yield$prompt.name;
-            schemas = (0, _utils.readSchemas)({
+            _context.next = 9;
+            return (0, _utils.readSchemas)({
               schemaDir: schema,
               argv: argv
             });
-            _context.next = 10;
+
+          case 9:
+            schemas = _context.sent;
+            _context.next = 12;
             return (0, _fromPartial["default"])(name, schemas, out);
 
-          case 10:
+          case 12:
           case "end":
             return _context.stop();
         }

package/main/commands/generate.js

@@ -11,9 +11,9 @@ var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"))
 
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 
-var _prompt = require("../prompt");
+var _prompt = require("../utils/prompt");
 
-var _generate = _interopRequireDefault(require("../generate"));
+var _tsClient = _interopRequireDefault(require("../generators/ts-client"));
 
 var _utils = require("../utils");
 
@@ -51,14 +51,18 @@ var _default = /*#__PURE__*/function () {
             schema = _yield$prompt.schema;
             out = _yield$prompt.out;
             name = _yield$prompt.name;
-            schemas = (0, _utils.readSchemas)({
+            _context.next = 9;
+            return (0, _utils.readSchemas)({
               schemaDir: schema,
               argv: argv
             });
-            _context.next = 10;
-            return (0, _generate["default"])(name, schemas, out);
 
-          case 10:
+          case 9:
+            schemas = _context.sent;
+            _context.next = 12;
+            return (0, _tsClient["default"])(name, schemas, out);
+
+          case 12:
           case "end":
             return _context.stop();
         }

package/main/commands/react-query.js

@@ -13,9 +13,9 @@ var _objectWithoutProperties2 = _interopRequireDefault(require("@babel/runtime/h
 
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 
-var _prompt = require("../prompt");
+var _prompt = require("../utils/prompt");
 
-var _reactQuery = _interopRequireDefault(require("../react-query"));
+var _reactQuery = _interopRequireDefault(require("../generators/react-query"));
 
 var _utils = require("../utils");
 
@@ -71,14 +71,18 @@ var _default = /*#__PURE__*/function () {
             out = _yield$prompt.out;
             name = _yield$prompt.name;
             options = (0, _objectWithoutProperties2["default"])(_yield$prompt, _excluded);
-            schemas = (0, _utils.readSchemas)({
+            _context.next = 10;
+            return (0, _utils.readSchemas)({
               schemaDir: schema,
               argv: argv
             });
-            _context.next = 11;
+
+          case 10:
+            schemas = _context.sent;
+            _context.next = 13;
             return (0, _reactQuery["default"])(name, schemas, out, options);
 
-          case 11:
+          case 13:
           case "end":
             return _context.stop();
         }

package/main/commands/recoil.js

@@ -11,9 +11,9 @@ var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"))
 
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 
-var _prompt = require("../prompt");
+var _prompt = require("../utils/prompt");
 
-var _recoil = _interopRequireDefault(require("../recoil"));
+var _recoil = _interopRequireDefault(require("../generators/recoil"));
 
 var _utils = require("../utils");
 
@@ -51,14 +51,18 @@ var _default = /*#__PURE__*/function () {
             schema = _yield$prompt.schema;
             out = _yield$prompt.out;
             name = _yield$prompt.name;
-            schemas = (0, _utils.readSchemas)({
+            _context.next = 9;
+            return (0, _utils.readSchemas)({
               schemaDir: schema,
               argv: argv
             });
-            _context.next = 10;
+
+          case 9:
+            schemas = _context.sent;
+            _context.next = 12;
             return (0, _recoil["default"])(name, schemas, out);
 
-          case 10:
+          case 12:
           case "end":
             return _context.stop();
         }

package/main/file.js

@@ -7,7 +7,7 @@ var _regenerator = _interopRequireDefault(require("@babel/runtime/regenerator"))
 
 var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/asyncToGenerator"));
 
-var _prompt = require("./prompt");
+var _prompt = require("./utils/prompt");
 
 var _cli = require("./cli");
 

package/main/{from-partial.js → generators/from-partial.js}

@@ -15,7 +15,7 @@ var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/
 
 var _case = require("case");
 
-var _header = require("./header");
+var _header = require("../utils/header");
 
 var _path = require("path");
 
@@ -29,7 +29,7 @@ var _fs = require("fs");
 
 var _generator = _interopRequireDefault(require("@babel/generator"));
 
-var _utils = require("./utils");
+var _utils = require("../utils");
 
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 
@@ -37,7 +37,7 @@ function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj &&
 
 var _default = /*#__PURE__*/function () {
   var _ref = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee(name, schemas, outPath) {
-    var FromPartialFile, Contract, ExecuteMsg, typeHash, body, children, TheClass, Interface, code;
+    var FromPartialFile, Contract, ExecuteMsg, typeHash, body, context, children, TheClass, Interface, code;
     return _regenerator["default"].wrap(function _callee$(_context) {
       while (1) {
         switch (_context.prev = _context.next) {
@@ -59,7 +59,8 @@ var _default = /*#__PURE__*/function () {
               body.push(w.importStmt(['Coin'], '@cosmjs/amino'));
             }
 
-            body.push(w.importStmt(Object.keys(typeHash), "./".concat(Contract).replace(/\.ts$/, ''))); // execute messages
+            body.push(w.importStmt(Object.keys(typeHash), "./".concat(Contract).replace(/\.ts$/, '')));
+            context = new w.RenderContext((0, _utils.getDefinitionSchema)(schemas)); // execute messages
 
             if (ExecuteMsg) {
               children = (0, w.getMessageProperties)(ExecuteMsg);
@@ -67,8 +68,8 @@ var _default = /*#__PURE__*/function () {
               if (children.length > 0) {
                 TheClass = (0, _case.pascal)("".concat(name, "MessageComposer"));
                 Interface = (0, _case.pascal)("".concat(name, "Message"));
-                body.push(w.createFromPartialInterface(Interface, ExecuteMsg));
-                body.push(w.createFromPartialClass(TheClass, Interface, ExecuteMsg));
+                body.push(w.createFromPartialInterface(context, Interface, ExecuteMsg));
+                body.push(w.createFromPartialClass(context, TheClass, Interface, ExecuteMsg));
               }
             }
 
@@ -76,7 +77,7 @@ var _default = /*#__PURE__*/function () {
             (0, _mkdirp.sync)(outPath);
             (0, _fs.writeFileSync)((0, _path.join)(outPath, FromPartialFile), code);
 
-          case 16:
+          case 17:
           case "end":
             return _context.stop();
         }

package/main/{react-query.js → generators/react-query.js}

@@ -15,7 +15,7 @@ var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/
 
 var _case = require("case");
 
-var _header = require("./header");
+var _header = require("../utils/header");
 
 var _path = require("path");
 
@@ -29,29 +29,33 @@ var _fs = require("fs");
 
 var _generator = _interopRequireDefault(require("@babel/generator"));
 
-var _utils = require("./utils");
+var _utils = require("../utils");
 
-var _imports = require("./imports");
+var _imports = require("../utils/imports");
 
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 
 function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj && obj.__esModule) { return obj; } if (obj === null || _typeof(obj) !== "object" && typeof obj !== "function") { return { "default": obj }; } var cache = _getRequireWildcardCache(nodeInterop); if (cache && cache.has(obj)) { return cache.get(obj); } var newObj = {}; var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var key in obj) { if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) { var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null; if (desc && (desc.get || desc.set)) { Object.defineProperty(newObj, key, desc); } else { newObj[key] = obj[key]; } } } newObj["default"] = obj; if (cache) { cache.set(obj, newObj); } return newObj; }
 
 var _default = /*#__PURE__*/function () {
-  var _ref = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee(contractName, schemas, outPath, options) {
-    var ReactQueryFile, Contract, QueryMsg, ExecuteMsg, typeHash, ExecuteClient, QueryClient, body, reactQueryImports, clientImports, shouldGenerateMutationHooks, code;
+  var _ref = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee(contractName, schemas, outPath, reactQueryOptions) {
+    var context, options, ReactQueryFile, Contract, QueryMsg, ExecuteMsg, typeHash, ExecuteClient, QueryClient, body, reactQueryImports, clientImports, shouldGenerateMutationHooks, code;
     return _regenerator["default"].wrap(function _callee$(_context) {
       while (1) {
         switch (_context.prev = _context.next) {
           case 0:
+            context = new w.RenderContext((0, _utils.getDefinitionSchema)(schemas), {
+              reactQuery: reactQueryOptions !== null && reactQueryOptions !== void 0 ? reactQueryOptions : {}
+            });
+            options = context.options.reactQuery;
             ReactQueryFile = (0, _case.pascal)("".concat(contractName, "Contract")) + '.react-query.ts';
             Contract = (0, _case.pascal)("".concat(contractName, "Contract"));
             QueryMsg = (0, _utils.findQueryMsg)(schemas);
             ExecuteMsg = (0, _utils.findExecuteMsg)(schemas);
-            _context.next = 6;
+            _context.next = 8;
             return (0, _utils.findAndParseTypes)(schemas);
 
-          case 6:
+          case 8:
             typeHash = _context.sent;
             ExecuteClient = (0, _case.pascal)("".concat(contractName, "Client"));
             QueryClient = (0, _case.pascal)("".concat(contractName, "QueryClient"));
@@ -78,19 +82,19 @@ var _default = /*#__PURE__*/function () {
 
             if (QueryMsg) {
               [].push.apply(body, w.createReactQueryHooks({
+                context: context,
                 queryMsg: QueryMsg,
                 contractName: contractName,
-                QueryClient: QueryClient,
-                options: options
+                QueryClient: QueryClient
               }));
             }
 
             if (shouldGenerateMutationHooks) {
               [].push.apply(body, w.createReactQueryMutationHooks({
+                context: context,
                 execMsg: ExecuteMsg,
                 contractName: contractName,
-                ExecuteClient: ExecuteClient,
-                options: options
+                ExecuteClient: ExecuteClient
               }));
             }
 
@@ -98,7 +102,7 @@ var _default = /*#__PURE__*/function () {
             (0, _mkdirp.sync)(outPath);
             (0, _fs.writeFileSync)((0, _path.join)(outPath, ReactQueryFile), code);
 
-          case 23:
+          case 25:
           case "end":
             return _context.stop();
         }

package/main/{recoil.js → generators/recoil.js}

@@ -15,7 +15,7 @@ var _asyncToGenerator2 = _interopRequireDefault(require("@babel/runtime/helpers/
 
 var _case = require("case");
 
-var _header = require("./header");
+var _header = require("../utils/header");
 
 var _path = require("path");
 
@@ -29,7 +29,7 @@ var _fs = require("fs");
 
 var _generator = _interopRequireDefault(require("@babel/generator"));
 
-var _utils = require("./utils");
+var _utils = require("../utils");
 
 function _getRequireWildcardCache(nodeInterop) { if (typeof WeakMap !== "function") return null; var cacheBabelInterop = new WeakMap(); var cacheNodeInterop = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(nodeInterop) { return nodeInterop ? cacheNodeInterop : cacheBabelInterop; })(nodeInterop); }
 
@@ -37,7 +37,7 @@ function _interopRequireWildcard(obj, nodeInterop) { if (!nodeInterop && obj &&
 
 var _default = /*#__PURE__*/function () {
   var _ref = (0, _asyncToGenerator2["default"])( /*#__PURE__*/_regenerator["default"].mark(function _callee(name, schemas, outPath) {
-    var RecoilFile, Contract, QueryMsg, typeHash, QueryClient, ReadOnlyInstance, body, code;
+    var RecoilFile, Contract, QueryMsg, typeHash, QueryClient, ReadOnlyInstance, body, context, code;
     return _regenerator["default"].wrap(function _callee$(_context) {
       while (1) {
         switch (_context.prev = _context.next) {
@@ -55,22 +55,23 @@ var _default = /*#__PURE__*/function () {
             body = [];
             body.push(w.importStmt(['selectorFamily'], 'recoil'));
             body.push(w.importStmt(['cosmWasmClient'], './chain'));
-            body.push(w.importStmt(Object.keys(typeHash), "./".concat(Contract).replace(/\.ts$/, ''))); // query messages
+            body.push(w.importStmt(Object.keys(typeHash), "./".concat(Contract).replace(/\.ts$/, '')));
+            context = new w.RenderContext((0, _utils.getDefinitionSchema)(schemas)); // query messages
 
             if (QueryMsg) {
               QueryClient = (0, _case.pascal)("".concat(name, "QueryClient"));
               ReadOnlyInstance = (0, _case.pascal)("".concat(name, "ReadOnlyInterface"));
               body.push(w.importStmt([QueryClient], "./".concat(Contract)));
               body.push(w.createRecoilQueryClientType());
-              body.push(w.createRecoilQueryClient(name, QueryClient));
-              [].push.apply(body, w.createRecoilSelectors(name, QueryClient, QueryMsg));
+              body.push(w.createRecoilQueryClient(context, name, QueryClient));
+              [].push.apply(body, w.createRecoilSelectors(context, name, QueryClient, QueryMsg));
             }
 
             code = _header.header + (0, _generator["default"])(t.program(body)).code;
             (0, _mkdirp.sync)(outPath);
             (0, _fs.writeFileSync)((0, _path.join)(outPath, RecoilFile), code);
 
-          case 16:
+          case 17:
           case "end":
             return _context.stop();
         }