@yopdev/dev-server 1.3.0-alpha.5 → 1.3.1

package/dist/src/config.d.ts

@@ -2,6 +2,7 @@ import { Sqs } from "./sqs";
 import { Sns } from "./sns";
 import { DynamoDb } from "./dynamodb";
 import { StartedNetwork } from "testcontainers";
+import { S3 } from "./s3";
 export type Config = {
     boundServicesPort?: number;
     localStackDockerImage?: string;
@@ -20,6 +21,7 @@ export type DevServerConfig = {
     network: StartedNetwork;
     sqs: Sqs;
     sns: Sns;
+    s3: S3;
     dynamo: DynamoDb;
     eventsProxy: {
         topic: {

package/dist/src/container.d.ts

@@ -0,0 +1,18 @@
+import { BindMount, Environment } from 'testcontainers/build/types';
+import { Callback, Service } from './services';
+import { PortWithOptionalBinding } from 'testcontainers/build/utils/port';
+import { Readable } from 'stream';
+import { WaitStrategy } from 'testcontainers/build/wait-strategies/wait-strategy';
+export declare const newContainer: (name: string, config: {
+    image: string;
+    networkAlias: string;
+    environment?: Environment;
+    bindMounts?: BindMount[];
+    exposedPorts?: PortWithOptionalBinding[];
+    logConsumer?: (stream: Readable) => unknown;
+    startup?: {
+        waitStrategy: WaitStrategy;
+        timeout: number;
+    };
+    endpointBuilder?: (port: number) => string;
+}, callback?: Callback<string>) => Service<string>;

package/dist/src/container.js

@@ -0,0 +1,80 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.newContainer = void 0;
+var logging_1 = require("@yopdev/logging");
+var testcontainers_1 = require("testcontainers");
+var services_1 = require("./services");
+var newContainer = function (name, config, callback) {
+    return new services_1.Service(new Container(name, config.image, config.networkAlias, config.environment, config.bindMounts, config.exposedPorts, config.logConsumer, config.startup, config.endpointBuilder), callback);
+};
+exports.newContainer = newContainer;
+var Container = /** @class */ (function () {
+    function Container(name, image, networkAlias, environment, bindMounts, exposedPorts, logConsumer, startup, endpointBuilder) {
+        var _this = this;
+        this.name = name;
+        this.networkAlias = networkAlias;
+        this.start = function (config) { return __awaiter(_this, void 0, void 0, function () {
+            var _this = this;
+            return __generator(this, function (_a) {
+                return [2 /*return*/, Promise.resolve(this.LOGGER.info('start'))
+                        .then(function () { return _this.container
+                        .withNetwork(config.network)
+                        .withNetworkAliases(_this.networkAlias)
+                        .start(); })
+                        .then(function (started) { return _this.started = started; })
+                        .then(function () { return _this.endpointBuilder(_this.started.getFirstMappedPort()); })
+                        .tap(function (url) { return _this.LOGGER.debug(url); })];
+            });
+        }); };
+        this.stop = function () { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) {
+            return [2 /*return*/, this.started.stop().then(function () { return undefined; })];
+        }); }); };
+        this.LOGGER = logging_1.LoggerFactory.create("CONTAINER[".concat(name, "]"));
+        var generic = new testcontainers_1.GenericContainer(image);
+        var withEnvironment = environment ? generic.withEnvironment(environment) : generic;
+        var withBindMounts = bindMounts ? withEnvironment.withBindMounts(bindMounts) : withEnvironment;
+        var withExposedPorts = exposedPorts ? withBindMounts.withExposedPorts.apply(withBindMounts, exposedPorts) : withBindMounts;
+        var withLogConsumer = logConsumer ? withExposedPorts.withLogConsumer(logConsumer) : withExposedPorts;
+        this.container = startup ? withLogConsumer.withWaitStrategy(startup.waitStrategy).withStartupTimeout(startup.timeout) : withLogConsumer;
+        this.networkAlias = networkAlias;
+        this.endpointBuilder = endpointBuilder !== null && endpointBuilder !== void 0 ? endpointBuilder : (function (port) { return "http://localhost:".concat(port); });
+    }
+    return Container;
+}());
+;

package/dist/src/deferred.js

@@ -95,13 +95,9 @@ var Promised = /** @class */ (function () {
                         .then(function () { return _this.service.start(config); })];
             });
         }); };
-        this.stop = function () { return __awaiter(_this, void 0, void 0, function () {
-            var _this = this;
-            return __generator(this, function (_a) {
-                return [2 /*return*/, Promise.resolve(this.LOGGER.info('stopped'))
-                        .then(function () { return _this.service.stop(); })];
-            });
-        }); };
+        this.stop = function () { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) {
+            return [2 /*return*/, this.service.stop()];
+        }); }); };
         this.name = (0, crypto_1.randomUUID)();
         this.LOGGER = logging_1.LoggerFactory.create("PROMISED[".concat(this.name, "]"));
     }

package/dist/src/dev-server.js

@@ -7,6 +7,8 @@ var sqs_1 = require("./sqs");
 var dynamodb_1 = require("./dynamodb");
 var logging_1 = require("@yopdev/logging");
 var sns_1 = require("./sns");
+var tunnel_1 = require("./tunnel");
+var s3_1 = require("./s3");
 var DevServer = /** @class */ (function () {
     function DevServer(name, service, config) {
         var _this = this;
@@ -32,6 +34,7 @@ var DevServer = /** @class */ (function () {
                 network: infra.network,
                 sqs: new sqs_1.Sqs(infra.aws),
                 sns: new sns_1.Sns(infra.aws),
+                s3: new s3_1.S3(infra.aws),
                 dynamo: new dynamodb_1.DynamoDb(infra.aws),
                 eventsProxy: {
                     topic: {
@@ -39,12 +42,13 @@ var DevServer = /** @class */ (function () {
                     }
                 },
             }); }); }); })
-                .then(function (config) { _this.LOGGER.debug('starting. config is %o', config); return config; })
+                .tap(function (config) { return _this.LOGGER.debug('config is %o', config); })
                 .then(function (aws) { return _this.service.start(aws); })
                 .then(function () { return _this.LOGGER.info('started'); })
                 .then(function () { return _this; });
         };
         this.stop = function () { return _this.service.stop()
+            .then(tunnel_1.terminate)
             .then(function () { var _a; return (_a = _this.localStack) === null || _a === void 0 ? void 0 : _a.stop(); })
             .then(function () { return _this.LOGGER.info('stopped'); }); };
         this.LOGGER = logging_1.LoggerFactory.create("DEVSERVER[".concat(name, "]"));

package/dist/src/dynamodb.js

@@ -40,6 +40,7 @@ exports.DynamoDb = exports.newDynamoDbTable = void 0;
 var client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
 var logging_1 = require("@yopdev/logging");
 var services_1 = require("./services");
+var assert_1 = require("./assert");
 var newDynamoDbTable = function (name, config, callback) { return new services_1.Service(new DynamoDbTableCreator(name, config.command), callback); };
 exports.newDynamoDbTable = newDynamoDbTable;
 var DynamoDbTableCreator = /** @class */ (function () {
@@ -51,12 +52,11 @@ var DynamoDbTableCreator = /** @class */ (function () {
             var _this = this;
             return __generator(this, function (_a) {
                 return [2 /*return*/, config.dynamo.createTable(this.command)
-                        .then(function () { return _this.LOGGER.info('created'); })
+                        .tap(function (output) { return _this.LOGGER.debug(output); })
                         .then(function () { return _this.name; })];
             });
         }); };
-        this.stop = function () { return Promise.resolve()
-            .then(function () { return _this.LOGGER.info('stopped'); }); };
+        this.stop = function () { return Promise.resolve(); };
         this.LOGGER = logging_1.LoggerFactory.create("TABLE[".concat(name, "]"));
     }
     return DynamoDbTableCreator;
@@ -69,7 +69,7 @@ var DynamoDb = /** @class */ (function () {
             return __generator(this, function (_a) {
                 return [2 /*return*/, this.client
                         .send(factory) //
-                        .then(function (table) { var _a; LOGGER.info('table created %s', (_a = table.TableDescription) === null || _a === void 0 ? void 0 : _a.TableName); return table; })
+                        .tap(function (table) { return LOGGER.debug('created %s', (0, assert_1.assertNotUndefined)(table.TableDescription).TableName); })
                         .catch(function (reason) {
                         LOGGER.error('failed to create table');
                         if (reason.name !== 'ResourceInUseException')
@@ -78,7 +78,6 @@ var DynamoDb = /** @class */ (function () {
             });
         }); };
         this.client = new client_dynamodb_1.DynamoDBClient(config);
-        LOGGER.debug('initialized');
     }
     return DynamoDb;
 }());

package/dist/src/event-proxy.d.ts

@@ -1,9 +1,11 @@
-import { SQSEvent } from 'aws-lambda';
+import { SNSMessageAttributes, SQSEvent } from 'aws-lambda';
 import { Service } from './services';
 export declare const newEventsProxy: (name: string, config: {
     handlers: EventHandler[];
-}) => Service<any>;
+    topic?: string;
+}) => Service<void>;
 export type EventHandler = {
+    name: string;
     handler: (event: SQSEvent) => Promise<unknown>;
-    matcher: (subject: string) => boolean;
+    matcher: (subject: string, attributes: SNSMessageAttributes) => boolean;
 };

package/dist/src/event-proxy.js

@@ -43,23 +43,25 @@ var logging_1 = require("@yopdev/logging");
 var stoppable_1 = require("./stoppable");
 var assert_1 = require("./assert");
 var services_1 = require("./services");
-var newEventsProxy = function (name, config) { return new services_1.Service(new EventsProxy(name, config.handlers)); };
+var newEventsProxy = function (name, config) { return new services_1.Service(new EventsProxy(name, config.handlers, config.topic)); };
 exports.newEventsProxy = newEventsProxy;
 var EventsProxy = /** @class */ (function () {
-    function EventsProxy(name, handlers) {
+    function EventsProxy(name, handlers, topic) {
         var _this = this;
         this.name = name;
         this.handlers = handlers;
+        this.topic = topic;
         this.pollingFrequency = 1;
         this.stopped = true;
         this.queueName = function () { return "EventProxyQueue".concat(Buffer.from(_this.name).toString('hex').substring(0, 64)); };
         this.start = function (config) { return __awaiter(_this, void 0, void 0, function () {
             var _this = this;
-            return __generator(this, function (_a) {
-                return [2 /*return*/, this.queueConnectedToTopic(config.sns, config.eventsProxy.topic.arn, config.sqs, this.queueName())
+            var _a;
+            return __generator(this, function (_b) {
+                return [2 /*return*/, this.queueConnectedToTopic(config.sns, (_a = this.topic) !== null && _a !== void 0 ? _a : config.eventsProxy.topic.arn, config.sqs, this.queueName())
                         .then(function (url) { return _this.startEventsConsumer(config.sqs.client, url); })
-                        .then(function () { return _this.stopped = false; })
-                        .then(function () { return undefined; })];
+                        .tap(function () { return _this.stopped = false; })
+                        .then(function (consumer) { return _this.LOGGER.debug(consumer); })];
             });
         }); };
         this.queueConnectedToTopic = function (sns, topic, sqs, queue) { return __awaiter(_this, void 0, void 0, function () {
@@ -87,41 +89,36 @@ var EventsProxy = /** @class */ (function () {
         }); };
         this.extractErrorMessage = function (e) { return typeof e === 'string' ? e : e.message !== undefined && typeof e.message === 'string' ? e.message : ''; };
         this.onEachMessage = function (message) {
-            var body = (0, assert_1.assertNotUndefined)(message.Body, 'body is not present');
-            var subject = JSON.parse(body).Subject;
             if (_this.stopped) {
-                _this.LOGGER.warn('stopped events proxy received message with subject %s', subject);
+                _this.LOGGER.warn('stopped events proxy received message %o', message);
                 return;
             }
-            var handlers = _this.handlers.filter(function (handler) { return handler.matcher(subject); });
+            var body = (0, assert_1.assertNotUndefined)(message.Body, 'body is not present');
+            var json = JSON.parse(body);
+            var attributes = json.MessageAttributes;
+            var subject = json.Subject;
+            var handlers = _this.handlers.filter(function (handler) { return handler.matcher(subject, attributes); });
             if (handlers.length === 0) {
-                _this.LOGGER.warn('no handlers found for subject %s, message %o', subject, message);
+                _this.LOGGER.warn('no handlers found for message %o', message);
             }
+            var record = (0, mappers_1.mapToLambdaSqsRecord)(message);
             handlers.forEach(function (handler) {
-                var record = (0, mappers_1.mapToLambdaSqsRecord)(message);
-                handler
+                return handler
                     .handler({ Records: [record] })
                     .then(function () {
-                    var _a;
-                    var json = JSON.parse(record.body);
-                    var subject = json.Subject || ((_a = json.Message) === null || _a === void 0 ? void 0 : _a.eventname) || 'unknown';
-                    _this.LOGGER.debug('subject accepted %s', subject);
+                    _this.LOGGER.debug('handler %s accepted message', handler.name);
                 })
                     .catch(function (e) {
                     var error = _this.extractErrorMessage(e);
-                    _this.LOGGER.error(e, 'failed %s with %s', subject, error);
+                    _this.LOGGER.error(e, 'handler %s failed with %s', handler.name, error);
                 });
             });
         };
-        this.stop = function () { return __awaiter(_this, void 0, void 0, function () {
-            var _this = this;
-            return __generator(this, function (_a) {
-                return [2 /*return*/, Promise.resolve(this.consumer)
-                        .then(function (consumer) { return consumer !== undefined ? (0, stoppable_1.stopConsumer)(consumer, _this.pollingFrequency).then(function () { return 'stopped'; }) : 'not started'; })
-                        .then(function (status) { return _this.LOGGER.info(status); })];
-            });
-        }); };
+        this.stop = function () { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) {
+            return [2 /*return*/, (0, stoppable_1.stopConsumer)(this.pollingFrequency, this.consumer)];
+        }); }); };
         this.LOGGER = logging_1.LoggerFactory.create("SNS->SQS[".concat(name, "]"));
+        this.LOGGER.debug('handling events from %s', topic !== null && topic !== void 0 ? topic : 'the event bus');
     }
     return EventsProxy;
 }());

package/dist/src/http-server.d.ts

@@ -16,7 +16,7 @@ export declare class HttpServer implements Lifecycle<string> {
     constructor(name: string, settings: HttpSettings, handler: (request: IncomingMessage, requestBody: string, response: ServerResponse) => void);
     start: () => Promise<string>;
     private endpointUrl;
-    stop: () => Promise<void>;
+    stop: () => Promise<any>;
 }
 export type HttpSettings = {
     protocol: string;

package/dist/src/http-server.js

@@ -15,14 +15,13 @@ var HttpServer = /** @class */ (function () {
         this.settings = settings;
         this.handler = handler;
         this.start = function () { return _this.server
-            .then(function () { return _this.LOGGER.info('listening on %s', (0, assert_1.assertNotUndefined)(_this.address).port); })
+            .then(function () { return _this.LOGGER.debug('listening [%s]', (0, assert_1.assertNotUndefined)(_this.address).port); })
             .then(function () { return _this.endpointUrl(); }); };
         this.endpointUrl = function () {
             var address = (0, assert_1.assertNotUndefined)(_this.address, 'server not started');
             return "".concat(_this.protocol, "//").concat(address.address, ":").concat(address.port, "/");
         };
-        this.stop = function () { return _this.server.then(function (server) { return server.close(); })
-            .then(function () { return _this.LOGGER.info('stop %s', (0, assert_1.assertNotUndefined)(_this.address).port); }); };
+        this.stop = function () { return _this.server.then(function (server) { return server.close(); }).then(function () { return undefined; }); };
         var server = (0, http_1.createServer)(function (req, res) {
             req.setEncoding('utf-8');
             var body = '';

package/dist/src/index.d.ts

@@ -7,5 +7,15 @@ export { newEventsProxy as eventsProxy } from './event-proxy';
 export { newScheduledTasks as scheduledTasks } from './scheduled-tasks';
 export { newPreTrafficHooks as preTrafficHooks } from './pre-traffic-hooks';
 export { newDynamoDbTable as dynamoDbTable } from './dynamodb';
+export { newContainer as container } from './container';
+export { newTunnel as tunnel } from './tunnel';
 export { all as allOf, oneThenOther } from './factories';
 export { lazy, promised } from './deferred';
+export { Lifecycle, Service } from './services';
+export { DevServerConfig } from './config';
+export { Route } from './lambda-http-proxy';
+declare global {
+    interface Promise<T> {
+        tap(onfulfilled?: (value: T) => void, onrejected?: (reason: unknown) => void): Promise<T>;
+    }
+}

package/dist/src/index.js

@@ -1,6 +1,42 @@
 "use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.promised = exports.lazy = exports.oneThenOther = exports.allOf = exports.dynamoDbTable = exports.preTrafficHooks = exports.scheduledTasks = exports.eventsProxy = exports.internalQueue = exports.snsHttpProxy = exports.lambdaHttpProxy = exports.httpServer = exports.DevServer = void 0;
+exports.Service = exports.promised = exports.lazy = exports.oneThenOther = exports.allOf = exports.tunnel = exports.container = exports.dynamoDbTable = exports.preTrafficHooks = exports.scheduledTasks = exports.eventsProxy = exports.internalQueue = exports.snsHttpProxy = exports.lambdaHttpProxy = exports.httpServer = exports.DevServer = void 0;
 var dev_server_1 = require("./dev-server");
 Object.defineProperty(exports, "DevServer", { enumerable: true, get: function () { return dev_server_1.DevServer; } });
 var http_server_1 = require("./http-server");
@@ -19,9 +55,25 @@ var pre_traffic_hooks_1 = require("./pre-traffic-hooks");
 Object.defineProperty(exports, "preTrafficHooks", { enumerable: true, get: function () { return pre_traffic_hooks_1.newPreTrafficHooks; } });
 var dynamodb_1 = require("./dynamodb");
 Object.defineProperty(exports, "dynamoDbTable", { enumerable: true, get: function () { return dynamodb_1.newDynamoDbTable; } });
+var container_1 = require("./container");
+Object.defineProperty(exports, "container", { enumerable: true, get: function () { return container_1.newContainer; } });
+var tunnel_1 = require("./tunnel");
+Object.defineProperty(exports, "tunnel", { enumerable: true, get: function () { return tunnel_1.newTunnel; } });
 var factories_1 = require("./factories");
 Object.defineProperty(exports, "allOf", { enumerable: true, get: function () { return factories_1.all; } });
 Object.defineProperty(exports, "oneThenOther", { enumerable: true, get: function () { return factories_1.oneThenOther; } });
 var deferred_1 = require("./deferred");
 Object.defineProperty(exports, "lazy", { enumerable: true, get: function () { return deferred_1.lazy; } });
 Object.defineProperty(exports, "promised", { enumerable: true, get: function () { return deferred_1.promised; } });
+var services_1 = require("./services");
+Object.defineProperty(exports, "Service", { enumerable: true, get: function () { return services_1.Service; } });
+Promise.prototype.tap = function (onfulfilled, onrejected) {
+    return __awaiter(this, void 0, void 0, function () {
+        var _this = this;
+        return __generator(this, function (_a) {
+            return [2 /*return*/, this.then(onfulfilled, onrejected).then(function () { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) {
+                    return [2 /*return*/, this];
+                }); }); })];
+        });
+    });
+};

package/dist/src/internal-queue.d.ts

@@ -1,7 +1,8 @@
+import { Queue } from "./sqs";
 import { SQSEvent } from "aws-lambda";
 import { Service, Callback } from "./services";
 export declare const newInternalQueue: (name: string, config: {
     index: number;
     visibility: number;
-    handler: (e: SQSEvent) => Promise<void>;
+    handler: (queue: Queue) => (e: SQSEvent) => Promise<void>;
 }, callback?: Callback<string>) => Service<string>;

package/dist/src/internal-queue.js

@@ -56,7 +56,7 @@ var InternalQueue = /** @class */ (function () {
             return __generator(this, function (_a) {
                 return [2 /*return*/, this.createQueue(sqs, this.queueName)
                         .then(function (queue) { return _this
-                        .createConsumer(sqs.client, _this.queueName, queue.url, _this.handler, _this.visibility)
+                        .createConsumer(sqs.client, _this.queueName, queue.url, _this.handler(queue), _this.visibility)
                         .then(function () { return queue.url; }); })];
             });
         }); };
@@ -89,9 +89,7 @@ var InternalQueue = /** @class */ (function () {
                         .then(function () { return _this; })];
             });
         }); };
-        this.stop = function () { return Promise.resolve(_this.state)
-            .then(function (state) { return state !== undefined ? (0, stoppable_1.stopConsumer)(state.consumer, state.visibility).then(function () { return 'stopped'; }) : 'not started'; })
-            .then(function (status) { return _this.LOGGER.info(status); }); };
+        this.stop = function () { return (0, stoppable_1.stopConsumer)(_this.state.visibility, _this.state.consumer); };
         this.queueName = (index + 1000).toString().padStart(10, '0');
         this.LOGGER = logging_1.LoggerFactory.create("INTERNALQUEUE[".concat(name, "]"));
     }

package/dist/src/lambda-http-proxy.d.ts

@@ -5,9 +5,9 @@ export declare const newLambdaHttpProxy: (name: string, config: {
     settings: HttpSettings;
     routes: Route[];
 }, callback?: Callback<string>) => Service<string>;
-type Route = {
+export type Route = {
     method: RegExp;
     path: RegExp;
+    weight: number;
     handler: (event: APIGatewayProxyEvent) => Promise<APIGatewayProxyResult>;
 };
-export {};

package/dist/src/lambda-http-proxy.js

@@ -50,8 +50,7 @@ var LambdaHttpProxy = /** @class */ (function () {
         this.name = name;
         this.routes = routes;
         this.start = function () { return _this.server.start(); };
-        this.stop = function () { return _this.server.stop()
-            .then(function () { return _this.LOGGER.info('stopped'); }); };
+        this.stop = function () { return _this.server.stop(); };
         this.handler = function (lambdaHandler) {
             return function (request, body, response) {
                 return lambdaHandler((0, mappers_1.mapToLambdaEvent)(request, body))
@@ -76,12 +75,13 @@ var LambdaHttpProxy = /** @class */ (function () {
             var _a;
             return ((_a = _this.routes.filter(function (r) { return request.method.match(r.method); })
                 .filter(function (r) { return request.url.match(r.path); })
-                .sort(function (r1, r2) { return r2.path.source.length - r1.path.source.length; })
+                .sort(function (r1, r2) { return r2.weight - r1.weight; })
                 .map(function (r) { return _this.handler(r.handler); })
                 .find(function () { return true; })) !== null && _a !== void 0 ? _a : _this.fallback)(request, body, response);
         };
         this.server = new http_server_1.HttpServer(name, settings, this.resolveRoute);
         this.LOGGER = logging_1.LoggerFactory.create("HTTP->LAMBDA[".concat(this.name, "]"));
+        this.LOGGER.info('registered %i routes', routes.length);
     }
     return LambdaHttpProxy;
 }());

package/dist/src/localstack.js

@@ -57,12 +57,13 @@ var LocalStack = /** @class */ (function () {
                             accessKeyId: 'dummy',
                             secretAccessKey: 'dummy'
                         }
-                    }); })];
+                    }); })
+                        .tap(function () { return LOGGER.debug('started'); })];
             });
         }); };
         this.stop = function () { return Promise.resolve(_this.started)
             .then(function (container) { return container ? container.stop().then(function () { return 'stopped'; }) : 'not started'; })
-            .then(function (status) { return LOGGER.info(status); }); };
+            .then(function (status) { return LOGGER.debug(status); }); };
         var concreteConfig = this.configOrDefaults(config);
         var container = new testcontainers_1.GenericContainer(concreteConfig.localStackDockerImage);
         var localStatePath = concreteConfig.localStateBindMount;
@@ -83,7 +84,6 @@ var LocalStack = /** @class */ (function () {
             .start()
             .then(function (container) { return _this.started = container; })
             .then(function (container) { return "".concat(PROTOCOL, "://").concat(container.getHost(), ":").concat(container.getMappedPort(SERVICES_PORT)); }); };
-        LOGGER.debug('initialized');
     }
     LocalStack.prototype.configOrDefaults = function (config) {
         var selectedServicesPort = config === null || config === void 0 ? void 0 : config.boundServicesPort;

package/dist/src/mappers.js

@@ -6,7 +6,7 @@ var url_1 = require("url");
 var LOGGER = logging_1.LoggerFactory.create('MAPPERS');
 var mapToLambdaSqsRecord = function (message) {
     if (!message.Body)
-        throw new Error("message Body must be present: ".concat(message.Body));
+        throw new Error('message Body must be present');
     return {
         messageId: 'N/A',
         receiptHandle: 'N/A',
@@ -34,9 +34,11 @@ function mapToLambdaEvent(req, requestBody) {
     var claims = extractClaims(req);
     var headers = {};
     if (req.headers['content-type'])
-        headers['Content-Type'] = req.headers['content-type'];
+        headers['content-type'] = req.headers['content-type'];
     if (req.headers['accept'])
-        headers['Accept'] = req.headers['accept'];
+        headers['accept'] = req.headers['accept'];
+    if (req.headers['authorization'])
+        headers['authorization'] = req.headers['authorization'];
     return {
         httpMethod: req.method,
         body: requestBody,
@@ -52,7 +54,7 @@ function mapToLambdaEvent(req, requestBody) {
         requestContext: {
             accountId: '',
             apiId: '',
-            authorizer: { claims: claims },
+            authorizer: { jwt: { claims: claims }, claims: claims },
             httpMethod: '',
             identity: {
                 accessKey: '',

package/dist/src/pre-traffic-hooks.js

@@ -51,18 +51,14 @@ var PreTrafficHooks = /** @class */ (function () {
             return __generator(this, function (_a) {
                 return [2 /*return*/, Promise
                         .all(this.hooks())
-                        .then(function () { return _this.LOGGER.info('started'); })
                         .then(function () { return _this; })];
             });
         }); };
-        this.stop = function () { return __awaiter(_this, void 0, void 0, function () {
-            var _this = this;
-            return __generator(this, function (_a) {
-                return [2 /*return*/, Promise.resolve()
-                        .then(function () { return _this.LOGGER.info('stopped'); })];
-            });
-        }); };
+        this.stop = function () { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) {
+            return [2 /*return*/, Promise.resolve()];
+        }); }); };
         this.LOGGER = logging_1.LoggerFactory.create("PRETRAFFIC[".concat(name, "]"));
+        this.LOGGER.info('%i hooks registered', hooks.length);
     }
     return PreTrafficHooks;
 }());

package/dist/src/s3.d.ts

@@ -0,0 +1,7 @@
+import { S3Client } from '@aws-sdk/client-s3';
+import { AwsConfig } from './config';
+export declare class S3 {
+    readonly client: S3Client;
+    constructor(aws: AwsConfig);
+    createBucket: (name: string) => Promise<import("@aws-sdk/client-s3").CreateBucketCommandOutput>;
+}

package/dist/src/s3.js

@@ -0,0 +1,69 @@
+"use strict";
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.S3 = void 0;
+var client_s3_1 = require("@aws-sdk/client-s3");
+var logging_1 = require("@yopdev/logging");
+var LOGGER = logging_1.LoggerFactory.create('S3');
+var S3 = /** @class */ (function () {
+    function S3(aws) {
+        var _this = this;
+        this.createBucket = function (name) { return __awaiter(_this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, this.client.send(new client_s3_1.CreateBucketCommand({
+                        Bucket: name,
+                    }))
+                        .tap(function () { return LOGGER.debug('bucket %s created', name); })];
+            });
+        }); };
+        this.client = new client_s3_1.S3Client(__assign({ forcePathStyle: true }, aws));
+    }
+    return S3;
+}());
+exports.S3 = S3;

package/dist/src/scheduled-tasks.d.ts

@@ -1,17 +1,6 @@
-/// <reference types="node" />
-import { Lifecycle, Service, Callback } from './services';
-export declare const newScheduledTasks: (name: string, schedules: Rate[], callback?: Callback<ScheduledTasks>) => Service<ScheduledTasks>;
-declare class ScheduledTasks implements Lifecycle<ScheduledTasks> {
-    readonly name: string;
-    private readonly schedules;
-    private LOGGER;
-    constructor(name: string, schedules: Rate[]);
-    intervals: NodeJS.Timeout[];
-    start: () => Promise<this>;
-    stop: () => Promise<void>;
-}
+import { Service } from './services';
+export declare const newScheduledTasks: (name: string, schedules: Rate[]) => Service<any>;
 export type Rate = {
     frequency: number;
     task: () => Promise<unknown>;
 };
-export {};

package/dist/src/scheduled-tasks.js

@@ -40,7 +40,7 @@ exports.newScheduledTasks = void 0;
 var logging_1 = require("@yopdev/logging");
 var timers_1 = require("timers");
 var services_1 = require("./services");
-var newScheduledTasks = function (name, schedules, callback) { return new services_1.Service(new ScheduledTasks(name, schedules), callback); };
+var newScheduledTasks = function (name, schedules) { return new services_1.Service(new ScheduledTasks(name, schedules)); };
 exports.newScheduledTasks = newScheduledTasks;
 var ScheduledTasks = /** @class */ (function () {
     function ScheduledTasks(name, schedules) {
@@ -52,18 +52,14 @@ var ScheduledTasks = /** @class */ (function () {
             var _this = this;
             return __generator(this, function (_a) {
                 return [2 /*return*/, Promise.resolve(this.schedules.forEach(function (schedule) { return _this.intervals.push(setInterval(schedule.task, schedule.frequency * 1000)); }))
-                        .then(function () { return _this.LOGGER.info('started'); })
-                        .then(function () { return _this; })];
-            });
-        }); };
-        this.stop = function () { return __awaiter(_this, void 0, void 0, function () {
-            var _this = this;
-            return __generator(this, function (_a) {
-                return [2 /*return*/, Promise.resolve(this.intervals.forEach(function (interval) { return (0, timers_1.clearInterval)(interval); }))
-                        .then(function () { return _this.LOGGER.info('stopped'); })];
+                        .then(function () { return undefined; })];
             });
         }); };
+        this.stop = function () { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) {
+            return [2 /*return*/, Promise.resolve(this.intervals.forEach(function (interval) { return (0, timers_1.clearInterval)(interval); }))];
+        }); }); };
         this.LOGGER = logging_1.LoggerFactory.create("SCHEDULER[".concat(name, "]"));
+        this.LOGGER.info('registered %i scheduled tasks', schedules.length);
     }
     return ScheduledTasks;
 }());

package/dist/src/sns-http-proxy.d.ts

@@ -5,17 +5,19 @@ import { DevServerConfig } from "./config";
 export declare const newSnsHttpProxy: (name: string, config: {
     settings: HttpSettings;
     method: string;
-    subject: string | undefined;
+    subject?: string;
+    topic?: string;
 }, callback?: Callback<string>) => Service<string>;
 export declare class SnsHttpProxy implements Lifecycle<string> {
     readonly name: string;
     private readonly settings;
     private readonly method;
     private readonly subject?;
+    private readonly topic?;
     private LOGGER;
     private server;
     private config;
-    constructor(name: string, settings: HttpSettings, method: string, subject?: string);
+    constructor(name: string, settings: HttpSettings, method: string, subject?: string, topic?: string);
     start: (config: DevServerConfig) => Promise<string>;
     stop: () => Promise<void>;
     handler: (method: string, subject?: string) => (request: IncomingMessage, body: string, response: ServerResponse) => Promise<void>;

package/dist/src/sns-http-proxy.js

@@ -17,33 +17,34 @@ var http_server_1 = require("./http-server");
 var responses_1 = require("./responses");
 var services_1 = require("./services");
 var assert_1 = require("./assert");
-var newSnsHttpProxy = function (name, config, callback) { return new services_1.Service(new SnsHttpProxy(name, config.settings, config.method, config.subject), callback); };
+var newSnsHttpProxy = function (name, config, callback) { return new services_1.Service(new SnsHttpProxy(name, config.settings, config.method, config.subject, config.topic), callback); };
 exports.newSnsHttpProxy = newSnsHttpProxy;
 var SnsHttpProxy = /** @class */ (function () {
-    function SnsHttpProxy(name, settings, method, subject) {
+    function SnsHttpProxy(name, settings, method, subject, topic) {
         var _this = this;
         this.name = name;
         this.settings = settings;
         this.method = method;
         this.subject = subject;
+        this.topic = topic;
         this.start = function (config) { return Promise.resolve(_this.server)
             .then(function (server) { return server.start(); })
-            .then(function (endpoint) {
+            .tap(function () {
+            var _a;
             _this.config = {
-                topic: config.eventsProxy.topic,
+                topic: (_a = _this.topic) !== null && _a !== void 0 ? _a : config.eventsProxy.topic.arn,
                 sns: config.sns
             };
-            return endpoint;
         })
             .then(function (endpoint) { return endpoint; }); };
         this.stop = function () { return _this.onlyWhenStarted(_this.server).stop()
-            .then(function () { return _this.LOGGER.info('stopped'); }); };
+            .then(function () { return _this.LOGGER.debug('stopped'); }); };
         this.handler = function (method, subject) {
             return function (request, body, response) {
                 return Promise.resolve(((0, assert_1.assertNotUndefined)(_this.config)))
                     .then(function (config) {
                     return config.sns
-                        .publish(config.topic, _this.extractMessage(method, request, body), subject, _this.extractMessageAttributes(request))
+                        .publish({ arn: config.topic }, _this.extractMessage(method, request, body), subject, _this.extractMessageAttributes(request))
                         .then(function () { return (0, responses_1.writeResponse)(response, 200, ''); })
                         .catch(function (e) {
                         _this.LOGGER.error(e, 'request failed to execute');
@@ -76,6 +77,7 @@ var SnsHttpProxy = /** @class */ (function () {
         };
         this.server = new http_server_1.HttpServer(this.name, this.settings, this.handler(this.method, this.subject));
         this.LOGGER = logging_1.LoggerFactory.create("HTTP->SNS[".concat(name, "]"));
+        this.LOGGER.info('forwarding %s %s events to %s', subject ? "events with ".concat(subject, " subject") : 'all', method, topic !== null && topic !== void 0 ? topic : 'the event bus');
     }
     return SnsHttpProxy;
 }());

package/dist/src/sns.js

@@ -50,7 +50,8 @@ var Sns = /** @class */ (function () {
                         .send(new client_sns_1.CreateTopicCommand({
                         Name: topic,
                     }))
-                        .then(function (o) { return (0, assert_1.assertNotUndefined)(o.TopicArn, 'TopicArn is not present'); })];
+                        .then(function (o) { return (0, assert_1.assertNotUndefined)(o.TopicArn, 'TopicArn is not present'); })
+                        .tap(function (arn) { return LOGGER.debug('topic %o created', arn); })];
             });
         }); };
         this.createSubscription = function (topic, queue) { return __awaiter(_this, void 0, void 0, function () {
@@ -61,7 +62,7 @@ var Sns = /** @class */ (function () {
                         Protocol: 'sqs',
                         Endpoint: queue.arn,
                     }))
-                        .then(function () { return LOGGER.debug('connected %s to %s', topic.arn, queue.arn); })];
+                        .then(function () { return LOGGER.debug('subscription %s->%s created', topic.arn, queue.arn); })];
             });
         }); };
         this.publish = function (topic, body, subject, attributes) { return __awaiter(_this, void 0, void 0, function () {
@@ -73,12 +74,11 @@ var Sns = /** @class */ (function () {
                         MessageAttributes: attributes,
                         Subject: subject,
                     }))
-                        .then(function () { return LOGGER.debug('published with subject %s to %s', subject, topic.arn); })
+                        .then(function () { return LOGGER.trace('published %s[%s]', topic.arn, subject); })
                         .then()];
             });
         }); };
         this.client = new client_sns_1.SNSClient(aws);
-        LOGGER.debug('initialized');
     }
     return Sns;
 }());

package/dist/src/sqs.d.ts

@@ -3,8 +3,9 @@ import { AwsConfig } from "./config";
 export declare class Sqs {
     readonly client: SQSClient;
     constructor(config: AwsConfig);
-    createNamedQueue: (name: string) => Promise<{
-        url: string;
-        arn: string;
-    }>;
+    createNamedQueue: (name: string) => Promise<Queue>;
 }
+export type Queue = {
+    arn: string;
+    url: string;
+};

package/dist/src/sqs.js

@@ -60,11 +60,11 @@ var Sqs = /** @class */ (function () {
                         .then(function (attributes) { return ({
                         url: (0, assert_1.assertNotUndefined)(create.QueueUrl),
                         arn: (0, assert_1.assertNotUndefined)(attributes.Attributes)[QUEUE_NAME_ATTRIBUTE_NAME],
-                    }); }); })];
+                    }); }); })
+                        .tap(function (queue) { return LOGGER.debug('created %s', queue.arn); })];
             });
         }); };
         this.client = new client_sqs_1.SQSClient(config);
-        LOGGER.debug('initialized');
     }
     return Sqs;
 }());

package/dist/src/stoppable.d.ts

@@ -1,2 +1,2 @@
 import { Consumer } from "sqs-consumer";
-export declare const stopConsumer: (target: Consumer, queueWaitTimeSecs: number) => Promise<void>;
+export declare const stopConsumer: (queueWaitTimeSecs: number, target?: Consumer) => Promise<void>;

package/dist/src/stoppable.js

@@ -37,12 +37,18 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.stopConsumer = void 0;
-var stopConsumer = function (target, queueWaitTimeSecs) { return __awaiter(void 0, void 0, void 0, function () {
+var stopConsumer = function (queueWaitTimeSecs, target) { return __awaiter(void 0, void 0, void 0, function () {
     return __generator(this, function (_a) {
-        target.stop();
-        return [2 /*return*/, new Promise(function (resolve) {
-                setTimeout(resolve, queueWaitTimeSecs * 1000 + 1);
-            })];
+        if (target) {
+            target.stop();
+            return [2 /*return*/, new Promise(function (resolve) {
+                    setTimeout(resolve, queueWaitTimeSecs * 1000 + 1);
+                })];
+        }
+        else {
+            return [2 /*return*/, Promise.resolve()];
+        }
+        return [2 /*return*/];
     });
 }); };
 exports.stopConsumer = stopConsumer;

package/dist/src/tunnel.d.ts

@@ -0,0 +1,10 @@
+import { Service } from './services';
+export declare const terminate: () => Promise<void>;
+export declare const newTunnel: (config: {
+    name: string;
+    port: number;
+    fixed?: {
+        name: string;
+        token: string;
+    };
+}) => Service<string>;

package/dist/src/tunnel.js

@@ -0,0 +1,79 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.newTunnel = exports.terminate = void 0;
+var services_1 = require("./services");
+var logging_1 = require("@yopdev/logging");
+var ngrok = require("@ngrok/ngrok");
+var assert_1 = require("./assert");
+var terminate = function () { return __awaiter(void 0, void 0, void 0, function () { return __generator(this, function (_a) {
+    return [2 /*return*/, ngrok.kill()];
+}); }); };
+exports.terminate = terminate;
+var newTunnel = function (config) {
+    return new services_1.Service(new Tunnel(config.name, config.port, config.fixed));
+};
+exports.newTunnel = newTunnel;
+var Tunnel = /** @class */ (function () {
+    function Tunnel(name, port, domain) {
+        var _this = this;
+        this.name = name;
+        this.port = port;
+        this.domain = domain;
+        this.start = function () { return __awaiter(_this, void 0, void 0, function () {
+            var _this = this;
+            var _a, _b;
+            return __generator(this, function (_c) {
+                return [2 /*return*/, ngrok
+                        .forward({
+                        proto: 'http',
+                        domain: (_a = this.domain) === null || _a === void 0 ? void 0 : _a.name,
+                        addr: this.port,
+                        authtoken: (_b = this.domain) === null || _b === void 0 ? void 0 : _b.token,
+                    })
+                        .then(function (listener) { return (0, assert_1.assertNotUndefined)(listener.url()); })
+                        .tap(function (url) { return _this.logger.debug(url); })];
+            });
+        }); };
+        this.stop = function () { return __awaiter(_this, void 0, void 0, function () { return __generator(this, function (_a) {
+            return [2 /*return*/, ngrok.disconnect()];
+        }); }); };
+        this.logger = logging_1.LoggerFactory.create("TUNNEL[".concat(name, "]"));
+    }
+    return Tunnel;
+}());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yopdev/dev-server",
-  "version": "1.3.0-alpha.5",
+  "version": "1.3.1",
   "scripts": {
     "compile": "tsc",
     "pretest": "npm run compile",
@@ -18,15 +18,17 @@
   },
   "dependencies": {
     "@aws-sdk/client-dynamodb": "^3.451.0",
+    "@aws-sdk/client-s3": "^3.451.0",
     "@aws-sdk/client-sns": "^3.451.0",
     "@aws-sdk/client-sqs": "^3.451.0",
+    "@ngrok/ngrok": "^0.9.1",
     "@yopdev/logging": "^0.0.2",
     "sqs-consumer": "^7.4.0",
     "testcontainers": "^10.2.2"
   },
   "repository": {
     "type": "git",
-    "url": "github:blockademy/devserver"
+    "url": "git+https://github.com/blockademy/devserver.git"
   },
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",