@flink-app/flink 0.14.3 → 2.0.0-alpha.100

package/spec/mock-project/dist/src/FlinkContext.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/spec/mock-project/dist/src/FlinkErrors.js

@@ -0,0 +1,143 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.notFound = notFound;
+exports.conflict = conflict;
+exports.badRequest = badRequest;
+exports.unauthorized = unauthorized;
+exports.forbidden = forbidden;
+exports.internalServerError = internalServerError;
+var uuid_1 = require("uuid");
+/**
+ * Returns a 404 Not Found error response.
+ * Use when a requested resource doesn't exist (e.g., invalid ID, missing entity).
+ *
+ * @param detail - Optional custom error message
+ * @param code - Optional custom error code
+ * @example
+ * ```ts
+ * if (!user) return notFound("User not found");
+ * ```
+ */
+function notFound(detail, code) {
+    return {
+        status: 404,
+        error: {
+            id: (0, uuid_1.v4)(),
+            title: "Not Found",
+            detail: detail || "The requested resource does not exist",
+            code: code || "notFound"
+        },
+    };
+}
+/**
+ * Returns a 409 Conflict error response.
+ * Use when a request conflicts with existing data (e.g., duplicate username/email).
+ *
+ * @param detail - Optional custom error message
+ * @param code - Optional custom error code
+ * @example
+ * ```ts
+ * if (existingUser) return conflict("Email already registered");
+ * ```
+ */
+function conflict(detail, code) {
+    return {
+        status: 409,
+        error: {
+            id: (0, uuid_1.v4)(),
+            title: "Conflict",
+            detail: detail || "An identical entity exits",
+            code: code || "conflict"
+        },
+    };
+}
+/**
+ * Returns a 400 Bad Request error response.
+ * Use when the request is malformed or contains invalid data (e.g., validation errors).
+ *
+ * @param detail - Optional custom error message
+ * @param code - Optional custom error code
+ * @example
+ * ```ts
+ * if (!email || !password) return badRequest("Email and password are required");
+ * ```
+ */
+function badRequest(detail, code) {
+    return {
+        status: 400,
+        error: {
+            id: (0, uuid_1.v4)(),
+            title: "Bad Request",
+            detail: detail || "Invalid request",
+            code: code || "badRequest"
+        },
+    };
+}
+/**
+ * Returns a 401 Unauthorized error response.
+ * Use when authentication is required but missing or invalid (e.g., no token, expired token).
+ * This means "who are you?" - the user needs to identify themselves first.
+ *
+ * @param detail - Optional custom error message
+ * @param code - Optional custom error code
+ * @example
+ * ```ts
+ * if (!ctx.auth?.user) return unauthorized("Authentication required");
+ * ```
+ */
+function unauthorized(detail, code) {
+    return {
+        status: 401,
+        error: {
+            id: (0, uuid_1.v4)(),
+            title: "Unauthorized",
+            detail: detail || "Authentication required",
+            code: code || "unauthorized"
+        },
+    };
+}
+/**
+ * Returns a 403 Forbidden error response.
+ * Use when the user is authenticated but lacks permission to access the resource.
+ * This means "I know who you are, but you're not allowed to do this."
+ *
+ * @param detail - Optional custom error message
+ * @param code - Optional custom error code
+ * @example
+ * ```ts
+ * if (ctx.auth?.user?.role !== "admin") return forbidden("Admin access required");
+ * ```
+ */
+function forbidden(detail, code) {
+    return {
+        status: 403,
+        error: {
+            id: (0, uuid_1.v4)(),
+            title: "Forbidden",
+            detail: detail || "You do not have permission to access this resource",
+            code: code || "forbidden"
+        },
+    };
+}
+/**
+ * Returns a 500 Internal Server Error response.
+ * Use when an unexpected error occurs on the server side.
+ *
+ * @param detail - Optional custom error message
+ * @param code - Optional custom error code
+ * @example
+ * ```ts
+ * try { ... } catch (error) { return internalServerError("Failed to process request"); }
+ * ```
+ */
+function internalServerError(detail, code) {
+    return {
+        status: 500,
+        error: {
+            id: (0, uuid_1.v4)(),
+            title: "Internal Server Error",
+            detail: detail || "Something unexpected went wrong",
+            code: code || "internalServerError"
+        },
+    };
+}

package/spec/mock-project/dist/src/FlinkHttpHandler.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ValidationMode = exports.HttpMethod = void 0;
+var HttpMethod;
+(function (HttpMethod) {
+    HttpMethod["get"] = "get";
+    HttpMethod["post"] = "post";
+    HttpMethod["put"] = "put";
+    HttpMethod["delete"] = "delete";
+    HttpMethod["patch"] = "patch";
+})(HttpMethod || (exports.HttpMethod = HttpMethod = {}));
+/**
+ * Validation mode for handler request and response schemas.
+ *
+ * Controls whether request and/or response data is validated against JSON schemas.
+ *
+ * **Security Note:** Skipping validation can introduce security risks. Only use
+ * SkipValidation or ValidateResponse when you have implemented custom validation
+ * or the endpoint is internal/trusted.
+ *
+ * - Validate: Validate both request and response (default behavior)
+ * - SkipValidation: Skip both request and response validation
+ * - ValidateRequest: Validate only request, skip response validation
+ * - ValidateResponse: Validate only response, skip request validation
+ *
+ * @example
+ * ```typescript
+ * // Skip validation for webhook with custom signature verification
+ * export const Route: RouteProps = {
+ *   path: "/webhook",
+ *   validation: ValidationMode.SkipValidation
+ * };
+ *
+ * // Validate request but allow flexible response during development
+ * export const Route: RouteProps = {
+ *   path: "/api/data",
+ *   validation: ValidationMode.ValidateRequest
+ * };
+ * ```
+ */
+var ValidationMode;
+(function (ValidationMode) {
+    ValidationMode["Validate"] = "Validate";
+    ValidationMode["SkipValidation"] = "SkipValidation";
+    ValidationMode["ValidateRequest"] = "ValidateRequest";
+    ValidationMode["ValidateResponse"] = "ValidateResponse";
+})(ValidationMode || (exports.ValidationMode = ValidationMode = {}));

package/spec/mock-project/dist/src/FlinkJob.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/spec/mock-project/dist/src/FlinkLog.js

@@ -0,0 +1,119 @@
+"use strict";
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.log = void 0;
+var node_color_log_1 = __importDefault(require("node-color-log"));
+var LOG_LEVELS = {
+    trace: 0,
+    debug: 1,
+    info: 2,
+    warn: 3,
+    error: 4,
+};
+/**
+ * Current global log level for trace filtering
+ */
+var currentLogLevel = "info";
+/**
+ * Check if a message should be logged based on current level
+ */
+function shouldLog(messageLevel) {
+    return LOG_LEVELS[messageLevel] >= LOG_LEVELS[currentLogLevel];
+}
+/**
+ * Flink logging utility with proper stdout/stderr separation
+ *
+ * Following Unix/POSIX best practices:
+ * - trace, debug, info → stdout (normal output)
+ * - warn, error → stderr (diagnostic output)
+ *
+ * Benefits:
+ * - Container orchestration can capture streams separately
+ * - Shell redirection works correctly (command > out.log 2> err.log)
+ * - Log aggregation tools can route differently
+ * - Monitoring systems can alert on stderr only
+ *
+ * Note: console.warn() and console.error() automatically write to stderr in Node.js
+ */
+exports.log = {
+    /**
+     * Trace logs (stdout)
+     * Use for extremely detailed diagnostic information (most verbose level)
+     */
+    trace: function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        if (shouldLog("trace")) {
+            var timestamp = new Date().toISOString();
+            console.log.apply(console, __spreadArray(["".concat(timestamp, " [TRACE]")], args, false));
+        }
+    },
+    /**
+     * Debug logs (stdout)
+     * Use for detailed diagnostic information during development
+     */
+    debug: node_color_log_1.default.debug.bind(node_color_log_1.default),
+    /**
+     * Info logs (stdout)
+     * Use for general informational messages about application state
+     */
+    info: node_color_log_1.default.info.bind(node_color_log_1.default),
+    /**
+     * Warning logs (stderr)
+     * Use for potentially harmful situations that aren't errors
+     * Writes to stderr following Unix/POSIX best practices
+     */
+    warn: node_color_log_1.default.warn.bind(node_color_log_1.default),
+    /**
+     * Error logs (stderr)
+     * Use for error events that might still allow the app to continue
+     * Writes to stderr following Unix/POSIX best practices
+     */
+    error: node_color_log_1.default.error.bind(node_color_log_1.default),
+    /**
+     * JSON output (stdout)
+     * Use for structured data output
+     */
+    json: function () {
+        var args = [];
+        for (var _i = 0; _i < arguments.length; _i++) {
+            args[_i] = arguments[_i];
+        }
+        for (var _a = 0, args_1 = args; _a < args_1.length; _a++) {
+            var o = args_1[_a];
+            console.log(JSON.stringify(o, null, 2));
+        }
+    },
+    /**
+     * Colored background log (stdout)
+     * Use for highlighted messages during development
+     */
+    bgColorLog: node_color_log_1.default.bgColorLog.bind(node_color_log_1.default),
+    /**
+     * Colored font log (stdout)
+     * Use for colored messages during development
+     */
+    fontColorLog: node_color_log_1.default.fontColorLog.bind(node_color_log_1.default),
+    /**
+     * Set global log level
+     */
+    setLevel: function (level) {
+        currentLogLevel = level;
+        // node-color-log doesn't support trace, so use debug as the effective level
+        var effectiveLevel = level === "trace" ? "debug" : level;
+        node_color_log_1.default.setLevel(effectiveLevel);
+    },
+};