@flink-app/flink 1.0.0 → 2.0.0-alpha.48

package/dist/src/ai/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./FlinkTool"), exports);
+__exportStar(require("./FlinkAgent"), exports);
+__exportStar(require("./ToolExecutor"), exports);
+__exportStar(require("./AgentRunner"), exports);
+__exportStar(require("./LLMAdapter"), exports);

package/dist/src/handlers/StreamWriterFactory.d.ts

@@ -0,0 +1,20 @@
+import { Response } from "express";
+import { StreamWriter, StreamFormat } from "../FlinkHttpHandler";
+/**
+ * Factory for creating StreamWriter instances for SSE and NDJSON streaming.
+ *
+ * Handles HTTP headers, connection lifecycle, and format-specific serialization.
+ */
+export declare class StreamWriterFactory {
+    /**
+     * Create a StreamWriter for the given format.
+     *
+     * Sets appropriate HTTP headers and manages the stream lifecycle including
+     * client disconnect detection.
+     *
+     * @param res - Express response object
+     * @param format - Stream format (sse or ndjson)
+     * @returns StreamWriter instance for writing data to the stream
+     */
+    static create<T = any>(res: Response, format: StreamFormat): StreamWriter<T>;
+}

package/dist/src/handlers/StreamWriterFactory.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StreamWriterFactory = void 0;
+var FlinkLog_1 = require("../FlinkLog");
+/**
+ * Factory for creating StreamWriter instances for SSE and NDJSON streaming.
+ *
+ * Handles HTTP headers, connection lifecycle, and format-specific serialization.
+ */
+var StreamWriterFactory = /** @class */ (function () {
+    function StreamWriterFactory() {
+    }
+    /**
+     * Create a StreamWriter for the given format.
+     *
+     * Sets appropriate HTTP headers and manages the stream lifecycle including
+     * client disconnect detection.
+     *
+     * @param res - Express response object
+     * @param format - Stream format (sse or ndjson)
+     * @returns StreamWriter instance for writing data to the stream
+     */
+    StreamWriterFactory.create = function (res, format) {
+        // Set appropriate headers based on format
+        if (format === "sse") {
+            res.setHeader("Content-Type", "text/event-stream");
+            res.setHeader("Cache-Control", "no-cache");
+            res.setHeader("Connection", "keep-alive");
+            res.flushHeaders();
+        }
+        else if (format === "ndjson") {
+            res.setHeader("Content-Type", "application/x-ndjson");
+            res.setHeader("Cache-Control", "no-cache");
+            res.flushHeaders();
+        }
+        var isOpen = true;
+        // Detect client disconnect
+        res.on("close", function () {
+            isOpen = false;
+        });
+        return {
+            write: function (data) {
+                if (!isOpen)
+                    return;
+                try {
+                    var json = JSON.stringify(data);
+                    if (format === "sse") {
+                        res.write("data: ".concat(json, "\n\n"));
+                    }
+                    else if (format === "ndjson") {
+                        res.write("".concat(json, "\n"));
+                    }
+                }
+                catch (err) {
+                    FlinkLog_1.log.error("StreamWriter serialization error:", { error: err });
+                    isOpen = false;
+                }
+            },
+            error: function (error) {
+                if (!isOpen)
+                    return;
+                var errorMessage = typeof error === "string" ? error : error.message;
+                if (format === "sse") {
+                    res.write("event: error\ndata: ".concat(JSON.stringify({ error: errorMessage }), "\n\n"));
+                }
+                else if (format === "ndjson") {
+                    res.write("".concat(JSON.stringify({ error: errorMessage }), "\n"));
+                }
+                res.end();
+                isOpen = false;
+            },
+            end: function () {
+                if (isOpen) {
+                    res.end();
+                    isOpen = false;
+                }
+            },
+            isOpen: function () { return isOpen; },
+        };
+    };
+    return StreamWriterFactory;
+}());
+exports.StreamWriterFactory = StreamWriterFactory;

package/dist/src/index.d.ts

@@ -9,4 +9,8 @@ export * from "./FlinkPlugin";
 export * from "./FlinkJob";
 export * from "./auth/FlinkAuthUser";
 export * from "./auth/FlinkAuthPlugin";
+export * from "./ai/FlinkTool";
+export * from "./ai/FlinkAgent";
+export * from "./ai/ToolExecutor";
+export * from "./ai/LLMAdapter";
 export type { Request as ExpressRequest, Response as ExpressResponse, NextFunction as ExpressNextFunction, RequestHandler as ExpressRequestHandler, ErrorRequestHandler as ExpressErrorRequestHandler, Express, static as expressStatic, } from "express";

package/dist/src/index.js

@@ -25,3 +25,7 @@ __exportStar(require("./FlinkPlugin"), exports);
 __exportStar(require("./FlinkJob"), exports);
 __exportStar(require("./auth/FlinkAuthUser"), exports);
 __exportStar(require("./auth/FlinkAuthPlugin"), exports);
+__exportStar(require("./ai/FlinkTool"), exports);
+__exportStar(require("./ai/FlinkAgent"), exports);
+__exportStar(require("./ai/ToolExecutor"), exports);
+__exportStar(require("./ai/LLMAdapter"), exports);

package/dist/src/utils.d.ts

@@ -12,6 +12,31 @@ export declare function getHandlerFiles(appRoot: string): Promise<string[]>;
 export declare function getSchemaFiles(appRoot: string): Promise<string[]>;
 export declare function getCollectionNameForRepo(repoFilename: string): string;
 export declare function getRepoInstanceName(fn: string): string;
+/**
+ * Convert PascalCase or camelCase to kebab-case
+ *
+ * Examples:
+ * - FooBarBaz → foo-bar-baz
+ * - CarAgent → car-agent
+ * - APIAgent → api-agent
+ * - HTMLParser → html-parser
+ * - IOManager → io-manager
+ *
+ * Handles:
+ * - Single uppercase followed by lowercase: CarAgent → car-agent
+ * - Multiple consecutive uppercase: APIAgent → api-agent
+ * - All caps: HTML → html
+ */
+export declare function toKebabCase(str: string): string;
+/**
+ * Convert kebab-case to snake_case
+ *
+ * Examples:
+ * - car-agent → car_agent
+ * - api-agent → api_agent
+ * - html-parser → html_parser
+ */
+export declare function toSnakeCase(str: string): string;
 /**
  * Get http method from props or convention based on file name
  * if it starts with i.e "GetFoo"
@@ -37,3 +62,8 @@ export declare function getDataAtPath(data: any, instancePath: string): any;
  * @param maxDataLength Maximum length of data to show (default 500)
  */
 export declare function formatValidationErrors(errors: any[] | null | undefined, data: any, maxDataLength?: number): string;
+/**
+ * Generate a short random ID for nested conversations
+ * Format: 8 character alphanumeric string (e.g., "a3b7c9d2")
+ */
+export declare function generateShortId(): string;

package/dist/src/utils.js

@@ -47,11 +47,14 @@ exports.getHandlerFiles = getHandlerFiles;
 exports.getSchemaFiles = getSchemaFiles;
 exports.getCollectionNameForRepo = getCollectionNameForRepo;
 exports.getRepoInstanceName = getRepoInstanceName;
+exports.toKebabCase = toKebabCase;
+exports.toSnakeCase = toSnakeCase;
 exports.getHttpMethodFromHandlerName = getHttpMethodFromHandlerName;
 exports.getJsDocComment = getJsDocComment;
 exports.getPathParams = getPathParams;
 exports.getDataAtPath = getDataAtPath;
 exports.formatValidationErrors = formatValidationErrors;
+exports.generateShortId = generateShortId;
 var path_1 = require("path");
 var tiny_glob_1 = __importDefault(require("tiny-glob"));
 var FlinkHttpHandler_1 = require("./FlinkHttpHandler");
@@ -122,6 +125,43 @@ function getRepoInstanceName(fn) {
     var name = fn.split(".ts")[0];
     return name.charAt(0).toLowerCase() + name.substr(1);
 }
+/**
+ * Convert PascalCase or camelCase to kebab-case
+ *
+ * Examples:
+ * - FooBarBaz → foo-bar-baz
+ * - CarAgent → car-agent
+ * - APIAgent → api-agent
+ * - HTMLParser → html-parser
+ * - IOManager → io-manager
+ *
+ * Handles:
+ * - Single uppercase followed by lowercase: CarAgent → car-agent
+ * - Multiple consecutive uppercase: APIAgent → api-agent
+ * - All caps: HTML → html
+ */
+function toKebabCase(str) {
+    return str
+        // Insert hyphen before uppercase letters that follow lowercase letters
+        // CarAgent → Car-Agent
+        .replace(/([a-z])([A-Z])/g, "$1-$2")
+        // Insert hyphen before uppercase letter that follows uppercase and precedes lowercase
+        // APIAgent → API-Agent
+        .replace(/([A-Z])([A-Z][a-z])/g, "$1-$2")
+        // Convert to lowercase
+        .toLowerCase();
+}
+/**
+ * Convert kebab-case to snake_case
+ *
+ * Examples:
+ * - car-agent → car_agent
+ * - api-agent → api_agent
+ * - html-parser → html_parser
+ */
+function toSnakeCase(str) {
+    return str.replace(/-/g, "_");
+}
 /**
  * Get http method from props or convention based on file name
  * if it starts with i.e "GetFoo"
@@ -236,3 +276,15 @@ function formatValidationErrors(errors, data, maxDataLength) {
     });
     return formatted.join("\n");
 }
+/**
+ * Generate a short random ID for nested conversations
+ * Format: 8 character alphanumeric string (e.g., "a3b7c9d2")
+ */
+function generateShortId() {
+    var chars = "abcdefghijklmnopqrstuvwxyz0123456789";
+    var result = "";
+    for (var i = 0; i < 8; i++) {
+        result += chars.charAt(Math.floor(Math.random() * chars.length));
+    }
+    return result;
+}

package/package.json

@@ -1,9 +1,19 @@
 {
   "name": "@flink-app/flink",
-  "version": "1.0.0",
+  "version": "2.0.0-alpha.48",
   "description": "Typescript only framework for creating REST-like APIs on top of Express and mongodb",
   "types": "dist/src/index.d.ts",
   "main": "dist/src/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/src/index.d.ts",
+      "default": "./dist/src/index.js"
+    },
+    "./ai": {
+      "types": "./dist/src/ai/index.d.ts",
+      "default": "./dist/src/ai/index.js"
+    }
+  },
   "repository": "FrostDigital/flink",
   "bin": {
     "flink": "./dist/bin/flink.js"
@@ -41,7 +51,9 @@
     "toad-scheduler": "^2.2.0",
     "ts-json-schema-generator": "2.3.0",
     "ts-morph": "24.0.0",
-    "uuid": "^8.3.2"
+    "uuid": "^8.3.2",
+    "zod": "^4.3.6",
+    "zod-to-json-schema": "^3.25.1"
   },
   "devDependencies": {
     "@types/folder-hash": "^4.0.0",