@agentick/nestjs 0.0.1

package/dist/tentickle.controller.js

@@ -0,0 +1,217 @@
+/**
+ * TentickleController - Default NestJS controller for Tentickle endpoints.
+ *
+ * Provides multiplexed SSE endpoints matching Express adapter API.
+ *
+ * @module @tentickle/nestjs/controller
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+import { Controller, Post, Get, Body, Res, HttpException, HttpStatus } from "@nestjs/common";
+import { TentickleService } from "./tentickle.service";
+// ============================================================================
+// Controller
+// ============================================================================
+/**
+ * Default controller for Tentickle endpoints.
+ *
+ * Provides multiplexed SSE with per-session subscriptions.
+ *
+ * @example Using the default controller
+ * ```typescript
+ * @Module({
+ *   imports: [TentickleModule.forRoot({ app })],
+ * })
+ * export class AppModule {}
+ * ```
+ *
+ * @example Custom controller
+ * ```typescript
+ * @Module({
+ *   imports: [TentickleModule.forRoot({ app, registerController: false })],
+ *   controllers: [MyController],
+ * })
+ * export class AppModule {}
+ * ```
+ */
+let TentickleController = class TentickleController {
+    tentickle;
+    constructor(tentickle) {
+        this.tentickle = tentickle;
+    }
+    /**
+     * SSE endpoint for multiplexed events.
+     *
+     * GET /events
+     */
+    events(res) {
+        this.tentickle.createConnection(res);
+    }
+    /**
+     * Subscribe to sessions.
+     *
+     * POST /subscribe
+     */
+    async subscribe(body) {
+        if (!body.connectionId) {
+            throw new HttpException("connectionId is required", HttpStatus.BAD_REQUEST);
+        }
+        const { connectionId, add = [], remove = [] } = body;
+        if (add.length > 0) {
+            await this.tentickle.subscribe(connectionId, add);
+        }
+        if (remove.length > 0) {
+            await this.tentickle.unsubscribe(connectionId, remove);
+        }
+        return { success: true };
+    }
+    /**
+     * Send message and stream events.
+     *
+     * POST /send
+     */
+    async send(body, res) {
+        const { sessionId, message, messages, props, metadata } = body;
+        // Build valid SendInput - must have message OR messages (not neither)
+        let input;
+        if (message) {
+            input = { message };
+        }
+        else if (messages && messages.length > 0) {
+            input = { messages };
+        }
+        else {
+            throw new HttpException("Either message or messages is required", HttpStatus.BAD_REQUEST);
+        }
+        // Add optional fields
+        const sendInput = {
+            ...input,
+            ...(props && { props }),
+            ...(metadata && { metadata }),
+        };
+        await this.tentickle.sendAndStream(sessionId, sendInput, res);
+    }
+    /**
+     * Abort execution.
+     *
+     * POST /abort
+     */
+    async abort(body) {
+        if (!body.sessionId) {
+            throw new HttpException("sessionId is required", HttpStatus.BAD_REQUEST);
+        }
+        await this.tentickle.abort(body.sessionId, body.reason);
+        return { success: true };
+    }
+    /**
+     * Close session.
+     *
+     * POST /close
+     */
+    async close(body) {
+        if (!body.sessionId) {
+            throw new HttpException("sessionId is required", HttpStatus.BAD_REQUEST);
+        }
+        await this.tentickle.close(body.sessionId);
+        return { success: true };
+    }
+    /**
+     * Submit tool confirmation response.
+     *
+     * POST /tool-response
+     */
+    async toolResponse(body) {
+        if (!body.sessionId) {
+            throw new HttpException("sessionId is required", HttpStatus.BAD_REQUEST);
+        }
+        if (!body.toolUseId) {
+            throw new HttpException("toolUseId is required", HttpStatus.BAD_REQUEST);
+        }
+        await this.tentickle.submitToolResult(body.sessionId, body.toolUseId, body.response);
+        return { success: true };
+    }
+    /**
+     * Publish to session channel.
+     *
+     * POST /channel
+     */
+    async channel(body) {
+        if (!body.sessionId) {
+            throw new HttpException("sessionId is required", HttpStatus.BAD_REQUEST);
+        }
+        if (!body.channel) {
+            throw new HttpException("channel is required", HttpStatus.BAD_REQUEST);
+        }
+        if (!body.type) {
+            throw new HttpException("type is required", HttpStatus.BAD_REQUEST);
+        }
+        await this.tentickle.publishToChannel(body.sessionId, body.channel, body.type, body.payload);
+        return { success: true };
+    }
+};
+__decorate([
+    Get("events"),
+    __param(0, Res()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", void 0)
+], TentickleController.prototype, "events", null);
+__decorate([
+    Post("subscribe"),
+    __param(0, Body()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], TentickleController.prototype, "subscribe", null);
+__decorate([
+    Post("send"),
+    __param(0, Body()),
+    __param(1, Res()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], TentickleController.prototype, "send", null);
+__decorate([
+    Post("abort"),
+    __param(0, Body()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], TentickleController.prototype, "abort", null);
+__decorate([
+    Post("close"),
+    __param(0, Body()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], TentickleController.prototype, "close", null);
+__decorate([
+    Post("tool-response"),
+    __param(0, Body()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], TentickleController.prototype, "toolResponse", null);
+__decorate([
+    Post("channel"),
+    __param(0, Body()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object]),
+    __metadata("design:returntype", Promise)
+], TentickleController.prototype, "channel", null);
+TentickleController = __decorate([
+    Controller(),
+    __metadata("design:paramtypes", [TentickleService])
+], TentickleController);
+export { TentickleController };
+//# sourceMappingURL=tentickle.controller.js.map

package/dist/tentickle.controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tentickle.controller.js","sourceRoot":"","sources":["../src/tentickle.controller.ts"],"names":[],"mappings":"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"}

package/dist/tentickle.filter.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Exception filter for Tentickle errors.
+ *
+ * Converts domain errors into appropriate HTTP exceptions.
+ *
+ * @module @tentickle/nestjs/filter
+ */
+import { type ExceptionFilter, type ArgumentsHost } from "@nestjs/common";
+import { SessionNotFoundError } from "@tentickle/server";
+/**
+ * Exception filter that handles SessionNotFoundError.
+ *
+ * Converts SessionNotFoundError to HTTP 404 Not Found.
+ *
+ * @example Controller usage (scoped)
+ * ```typescript
+ * @Controller()
+ * @UseFilters(TentickleExceptionFilter)
+ * export class MyController { ... }
+ * ```
+ *
+ * @example Global registration
+ * ```typescript
+ * app.useGlobalFilters(new TentickleExceptionFilter());
+ * ```
+ */
+export declare class TentickleExceptionFilter implements ExceptionFilter {
+    catch(exception: SessionNotFoundError, host: ArgumentsHost): void;
+}
+//# sourceMappingURL=tentickle.filter.d.ts.map

package/dist/tentickle.filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tentickle.filter.d.ts","sourceRoot":"","sources":["../src/tentickle.filter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAqB,KAAK,eAAe,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE7F,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;;;;;;;;;;;;;GAgBG;AACH,qBACa,wBAAyB,YAAW,eAAe;IAC9D,KAAK,CAAC,SAAS,EAAE,oBAAoB,EAAE,IAAI,EAAE,aAAa,GAAG,IAAI;CAUlE"}

package/dist/tentickle.filter.js

@@ -0,0 +1,48 @@
+/**
+ * Exception filter for Tentickle errors.
+ *
+ * Converts domain errors into appropriate HTTP exceptions.
+ *
+ * @module @tentickle/nestjs/filter
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+import { Catch, HttpStatus } from "@nestjs/common";
+import { SessionNotFoundError } from "@tentickle/server";
+/**
+ * Exception filter that handles SessionNotFoundError.
+ *
+ * Converts SessionNotFoundError to HTTP 404 Not Found.
+ *
+ * @example Controller usage (scoped)
+ * ```typescript
+ * @Controller()
+ * @UseFilters(TentickleExceptionFilter)
+ * export class MyController { ... }
+ * ```
+ *
+ * @example Global registration
+ * ```typescript
+ * app.useGlobalFilters(new TentickleExceptionFilter());
+ * ```
+ */
+let TentickleExceptionFilter = class TentickleExceptionFilter {
+    catch(exception, host) {
+        const ctx = host.switchToHttp();
+        const response = ctx.getResponse();
+        response.status(HttpStatus.NOT_FOUND).json({
+            statusCode: HttpStatus.NOT_FOUND,
+            message: "Session not found",
+            error: "Not Found",
+        });
+    }
+};
+TentickleExceptionFilter = __decorate([
+    Catch(SessionNotFoundError)
+], TentickleExceptionFilter);
+export { TentickleExceptionFilter };
+//# sourceMappingURL=tentickle.filter.js.map

package/dist/tentickle.filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tentickle.filter.js","sourceRoot":"","sources":["../src/tentickle.filter.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;;;;;;;AAEH,OAAO,EAAE,KAAK,EAAE,UAAU,EAA4C,MAAM,gBAAgB,CAAC;AAE7F,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;;;;;;;;;;;;;GAgBG;AAEI,IAAM,wBAAwB,GAA9B,MAAM,wBAAwB;IACnC,KAAK,CAAC,SAA+B,EAAE,IAAmB;QACxD,MAAM,GAAG,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAChC,MAAM,QAAQ,GAAG,GAAG,CAAC,WAAW,EAAY,CAAC;QAE7C,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC;YACzC,UAAU,EAAE,UAAU,CAAC,SAAS;YAChC,OAAO,EAAE,mBAAmB;YAC5B,KAAK,EAAE,WAAW;SACnB,CAAC,CAAC;IACL,CAAC;CACF,CAAA;AAXY,wBAAwB;IADpC,KAAK,CAAC,oBAAoB,CAAC;GACf,wBAAwB,CAWpC"}

package/dist/tentickle.module.d.ts

@@ -0,0 +1,112 @@
+/**
+ * TentickleModule - NestJS module for Tentickle Gateway.
+ *
+ * This is a thin adapter - all business logic lives in @tentickle/gateway.
+ *
+ * @module @tentickle/nestjs/module
+ */
+import { type DynamicModule } from "@nestjs/common";
+import type { Request, Response } from "express";
+import { Gateway, type GatewayConfig } from "@tentickle/gateway";
+export declare const TENTICKLE_GATEWAY = "TENTICKLE_GATEWAY";
+/**
+ * Gateway config type for NestJS module.
+ * Excludes standalone-mode-only options.
+ */
+export type TentickleModuleOptions = Omit<GatewayConfig, "port" | "host" | "transport" | "httpPort"> & {
+    /**
+     * Whether to register the default controller.
+     * Set to false if you want to define your own routes.
+     * @default true
+     */
+    registerController?: boolean;
+};
+export declare class TentickleService {
+    readonly gateway: Gateway;
+    constructor(gateway: Gateway);
+    /**
+     * Handle an HTTP request by delegating to Gateway.
+     */
+    handleRequest(req: Request, res: Response): Promise<void>;
+}
+export declare class TentickleController {
+    private readonly tentickle;
+    constructor(tentickle: TentickleService);
+    handleAll(req: Request, res: Response): Promise<void>;
+}
+/**
+ * NestJS module for Tentickle.
+ *
+ * @example Default controller (simplest)
+ * ```typescript
+ * import { TentickleModule } from '@tentickle/nestjs';
+ * import { createApp } from '@tentickle/core';
+ *
+ * @Module({
+ *   imports: [
+ *     TentickleModule.forRoot({
+ *       apps: { assistant: createApp(<MyAgent />) },
+ *       defaultApp: "assistant",
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * // Endpoints: GET /events, POST /send, POST /invoke, etc.
+ * ```
+ *
+ * @example With custom methods
+ * ```typescript
+ * import { TentickleModule, method } from '@tentickle/nestjs';
+ * import { z } from "zod";
+ *
+ * @Module({
+ *   imports: [
+ *     TentickleModule.forRoot({
+ *       apps: { assistant: myApp },
+ *       defaultApp: "assistant",
+ *       methods: {
+ *         tasks: {
+ *           list: method({
+ *             schema: z.object({ sessionId: z.string() }),
+ *             handler: async (params) => todoService.list(params.sessionId),
+ *           }),
+ *         },
+ *       },
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ *
+ * @example Custom controller with TentickleService
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     TentickleModule.forRoot({
+ *       apps: { assistant: myApp },
+ *       defaultApp: "assistant",
+ *       registerController: false,
+ *     }),
+ *   ],
+ *   controllers: [ChatController],
+ * })
+ * export class AppModule {}
+ *
+ * @Controller('chat')
+ * export class ChatController {
+ *   constructor(private tentickle: TentickleService) {}
+ *
+ *   @All('*')
+ *   async handleAll(@Req() req: Request, @Res() res: Response) {
+ *     await this.tentickle.handleRequest(req, res);
+ *   }
+ * }
+ * ```
+ */
+export declare class TentickleModule {
+    /**
+     * Register module with static configuration.
+     */
+    static forRoot(options: TentickleModuleOptions): DynamicModule;
+}
+//# sourceMappingURL=tentickle.module.d.ts.map

package/dist/tentickle.module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tentickle.module.d.ts","sourceRoot":"","sources":["../src/tentickle.module.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAEL,KAAK,aAAa,EAQnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,OAAO,EAAE,KAAK,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMjE,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AAMrD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,IAAI,CACvC,aAAa,EACb,MAAM,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,CAC3C,GAAG;IACF;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B,CAAC;AAMF,qBACa,gBAAgB;aAC4B,OAAO,EAAE,OAAO;gBAAhB,OAAO,EAAE,OAAO;IAEvE;;OAEG;IACG,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAGhE;AAMD,qBACa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,SAAS;gBAAT,SAAS,EAAE,gBAAgB;IAGlD,SAAS,CAAQ,GAAG,EAAE,OAAO,EAAS,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAG1E;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AACH,qBACa,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,sBAAsB,GAAG,aAAa;CAwB/D"}

package/dist/tentickle.module.js

@@ -0,0 +1,175 @@
+/**
+ * TentickleModule - NestJS module for Tentickle Gateway.
+ *
+ * This is a thin adapter - all business logic lives in @tentickle/gateway.
+ *
+ * @module @tentickle/nestjs/module
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var TentickleModule_1;
+import { Module, Inject, Injectable, Controller, All, Req, Res, } from "@nestjs/common";
+import { Gateway } from "@tentickle/gateway";
+// ============================================================================
+// Injection Tokens
+// ============================================================================
+export const TENTICKLE_GATEWAY = "TENTICKLE_GATEWAY";
+// ============================================================================
+// Service (thin wrapper around Gateway)
+// ============================================================================
+let TentickleService = class TentickleService {
+    gateway;
+    constructor(gateway) {
+        this.gateway = gateway;
+    }
+    /**
+     * Handle an HTTP request by delegating to Gateway.
+     */
+    async handleRequest(req, res) {
+        return this.gateway.handleRequest(req, res);
+    }
+};
+TentickleService = __decorate([
+    Injectable(),
+    __param(0, Inject(TENTICKLE_GATEWAY)),
+    __metadata("design:paramtypes", [Gateway])
+], TentickleService);
+export { TentickleService };
+// ============================================================================
+// Controller (delegates everything to Gateway)
+// ============================================================================
+let TentickleController = class TentickleController {
+    tentickle;
+    constructor(tentickle) {
+        this.tentickle = tentickle;
+    }
+    async handleAll(req, res) {
+        await this.tentickle.handleRequest(req, res);
+    }
+};
+__decorate([
+    All("*"),
+    __param(0, Req()),
+    __param(1, Res()),
+    __metadata("design:type", Function),
+    __metadata("design:paramtypes", [Object, Object]),
+    __metadata("design:returntype", Promise)
+], TentickleController.prototype, "handleAll", null);
+TentickleController = __decorate([
+    Controller(),
+    __metadata("design:paramtypes", [TentickleService])
+], TentickleController);
+export { TentickleController };
+// ============================================================================
+// Module
+// ============================================================================
+/**
+ * NestJS module for Tentickle.
+ *
+ * @example Default controller (simplest)
+ * ```typescript
+ * import { TentickleModule } from '@tentickle/nestjs';
+ * import { createApp } from '@tentickle/core';
+ *
+ * @Module({
+ *   imports: [
+ *     TentickleModule.forRoot({
+ *       apps: { assistant: createApp(<MyAgent />) },
+ *       defaultApp: "assistant",
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * // Endpoints: GET /events, POST /send, POST /invoke, etc.
+ * ```
+ *
+ * @example With custom methods
+ * ```typescript
+ * import { TentickleModule, method } from '@tentickle/nestjs';
+ * import { z } from "zod";
+ *
+ * @Module({
+ *   imports: [
+ *     TentickleModule.forRoot({
+ *       apps: { assistant: myApp },
+ *       defaultApp: "assistant",
+ *       methods: {
+ *         tasks: {
+ *           list: method({
+ *             schema: z.object({ sessionId: z.string() }),
+ *             handler: async (params) => todoService.list(params.sessionId),
+ *           }),
+ *         },
+ *       },
+ *     }),
+ *   ],
+ * })
+ * export class AppModule {}
+ * ```
+ *
+ * @example Custom controller with TentickleService
+ * ```typescript
+ * @Module({
+ *   imports: [
+ *     TentickleModule.forRoot({
+ *       apps: { assistant: myApp },
+ *       defaultApp: "assistant",
+ *       registerController: false,
+ *     }),
+ *   ],
+ *   controllers: [ChatController],
+ * })
+ * export class AppModule {}
+ *
+ * @Controller('chat')
+ * export class ChatController {
+ *   constructor(private tentickle: TentickleService) {}
+ *
+ *   @All('*')
+ *   async handleAll(@Req() req: Request, @Res() res: Response) {
+ *     await this.tentickle.handleRequest(req, res);
+ *   }
+ * }
+ * ```
+ */
+let TentickleModule = TentickleModule_1 = class TentickleModule {
+    /**
+     * Register module with static configuration.
+     */
+    static forRoot(options) {
+        // Create gateway in embedded mode
+        const gateway = new Gateway({
+            ...options,
+            embedded: true,
+        });
+        const providers = [
+            {
+                provide: TENTICKLE_GATEWAY,
+                useValue: gateway,
+            },
+            TentickleService,
+        ];
+        const controllers = options.registerController !== false ? [TentickleController] : [];
+        return {
+            module: TentickleModule_1,
+            providers,
+            controllers,
+            exports: [TentickleService, TENTICKLE_GATEWAY],
+        };
+    }
+};
+TentickleModule = TentickleModule_1 = __decorate([
+    Module({})
+], TentickleModule);
+export { TentickleModule };
+//# sourceMappingURL=tentickle.module.js.map

package/dist/tentickle.module.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tentickle.module.js","sourceRoot":"","sources":["../src/tentickle.module.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;;;;;;;;;;;;;;AAEH,OAAO,EACL,MAAM,EAGN,MAAM,EACN,UAAU,EACV,UAAU,EACV,GAAG,EACH,GAAG,EACH,GAAG,GACJ,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,OAAO,EAAsB,MAAM,oBAAoB,CAAC;AAEjE,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E,MAAM,CAAC,MAAM,iBAAiB,GAAG,mBAAmB,CAAC;AAsBrD,+EAA+E;AAC/E,wCAAwC;AACxC,+EAA+E;AAGxE,IAAM,gBAAgB,GAAtB,MAAM,gBAAgB;IAC4B;IAAvD,YAAuD,OAAgB;QAAhB,YAAO,GAAP,OAAO,CAAS;IAAG,CAAC;IAE3E;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,GAAY,EAAE,GAAa;QAC7C,OAAO,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC9C,CAAC;CACF,CAAA;AATY,gBAAgB;IAD5B,UAAU,EAAE;IAEE,WAAA,MAAM,CAAC,iBAAiB,CAAC,CAAA;qCAA0B,OAAO;GAD5D,gBAAgB,CAS5B;;AAED,+EAA+E;AAC/E,+CAA+C;AAC/C,+EAA+E;AAGxE,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IACD;IAA7B,YAA6B,SAA2B;QAA3B,cAAS,GAAT,SAAS,CAAkB;IAAG,CAAC;IAGtD,AAAN,KAAK,CAAC,SAAS,CAAQ,GAAY,EAAS,GAAa;QACvD,MAAM,IAAI,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;CACF,CAAA;AAHO;IADL,GAAG,CAAC,GAAG,CAAC;IACQ,WAAA,GAAG,EAAE,CAAA;IAAgB,WAAA,GAAG,EAAE,CAAA;;;;oDAE1C;AANU,mBAAmB;IAD/B,UAAU,EAAE;qCAE6B,gBAAgB;GAD7C,mBAAmB,CAO/B;;AAED,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoEG;AAEI,IAAM,eAAe,uBAArB,MAAM,eAAe;IAC1B;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,OAA+B;QAC5C,kCAAkC;QAClC,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC;YAC1B,GAAG,OAAO;YACV,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QAEH,MAAM,SAAS,GAAe;YAC5B;gBACE,OAAO,EAAE,iBAAiB;gBAC1B,QAAQ,EAAE,OAAO;aAClB;YACD,gBAAgB;SACjB,CAAC;QAEF,MAAM,WAAW,GAAG,OAAO,CAAC,kBAAkB,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAEtF,OAAO;YACL,MAAM,EAAE,iBAAe;YACvB,SAAS;YACT,WAAW;YACX,OAAO,EAAE,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;SAC/C,CAAC;IACJ,CAAC;CACF,CAAA;AA5BY,eAAe;IAD3B,MAAM,CAAC,EAAE,CAAC;GACE,eAAe,CA4B3B"}