tina4-nodejs 3.10.76 → 3.10.83

package/CLAUDE.md

@@ -121,7 +121,7 @@ The HTTP foundation. Handles request/response lifecycle, route matching, middlew
 - `auth.ts` — Authentication helpers
 - `cache.ts` — In-memory caching
 - `session.ts` — Session management with pluggable handlers. `TINA4_SESSION_SAMESITE` env var (default: Lax)
-- `websocket.ts` — WebSocket support with backplane for scaling via Redis pub/sub (`TINA4_WS_BACKPLANE`, `TINA4_WS_BACKPLANE_URL`)
+- `websocket.ts` — WebSocket support with backplane for scaling via Redis pub/sub (`TINA4_WS_BACKPLANE`, `TINA4_WS_BACKPLANE_URL`). Rooms API: `wss.joinRoom(clientId, room)`, `wss.leaveRoom(clientId, room)`, `wss.broadcastToRoom(room, msg, excludeIds?)`, `wss.getRoomConnections(room)`, `wss.roomCount(room)`, `wss.getClientRooms(clientId)`
 - `queue.ts` — Queue system with pluggable backends
 - `graphql.ts` — GraphQL engine
 - `i18n.ts` — Internationalization / localization

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tina4-nodejs",
-  "version": "3.10.76",
+  "version": "3.10.83",
   "type": "module",
   "description": "Tina4 for Node.js/TypeScript — 54 built-in features, zero dependencies",
   "keywords": ["tina4", "framework", "web", "api", "orm", "graphql", "websocket", "typescript"],

package/packages/core/src/auth.ts

@@ -287,14 +287,6 @@ export function authenticateRequest(
   return null;
 }
 
-// ── Backward-Compatible Aliases ──────────────────────────────────
-
-/** Alias for getToken() — kept for backward compatibility. */
-export const createToken = getToken;
-
-/** Alias for validToken() — kept for backward compatibility. */
-export const validateToken = validToken;
-
 // ── API Key Validation ───────────────────────────────────────────
 
 /**
@@ -341,7 +333,4 @@ export class Auth {
   static refreshToken = refreshToken;
   static authenticateRequest = authenticateRequest;
   static validateApiKey = validateApiKey;
-  // Legacy aliases
-  static createToken = getToken;
-  static validateToken = validToken;
 }

package/packages/core/src/index.ts

@@ -38,7 +38,7 @@ export {
   APPLICATION_OCTET, TEXT_HTML, TEXT_PLAIN, TEXT_CSV, TEXT_XML,
 } from "./constants.js";
 export {
-  getToken, validToken, createToken, validateToken, getPayload,
+  getToken, validToken, getPayload,
   hashPassword, checkPassword,
   authMiddleware,
   refreshToken, authenticateRequest, validateApiKey,
@@ -52,6 +52,8 @@ export { ScssCompiler } from "./scss.js";
 export type { ScssConfig } from "./scss.js";
 export { Queue } from "./queue.js";
 export type { QueueConfig, QueueJob, ProcessOptions } from "./queue.js";
+export { createJob } from "./job.js";
+export type { JobData, JobQueueBridge } from "./job.js";
 export { GraphQL, ParseError } from "./graphql.js";
 export type { GraphQLField, ResolverFn, GraphQLResult } from "./graphql.js";
 export {
@@ -79,6 +81,7 @@ export { renderErrorOverlay, renderProductionError, isDebugMode } from "./errorO
 export { AI_TOOLS, isInstalled, showMenu, installSelected, installAll, generateContext } from "./ai.js";
 export type { AiTool } from "./ai.js";
 export type { ImapMessage, ImapFullMessage } from "./messenger.js";
+export { LiteBackend } from "./queueBackends/liteBackend.js";
 export { RabbitMQBackend } from "./queueBackends/rabbitmqBackend.js";
 export type { RabbitMQConfig } from "./queueBackends/rabbitmqBackend.js";
 export { KafkaBackend } from "./queueBackends/kafkaBackend.js";

package/packages/core/src/job.ts

@@ -0,0 +1,86 @@
+/**
+ * Tina4 Queue Job — a single queue job with lifecycle methods.
+ */
+
+// ── Types ────────────────────────────────────────────────────
+
+export interface JobData {
+  id: string;
+  payload: unknown;
+  status: "pending" | "reserved" | "failed" | "dead" | "completed";
+  createdAt: string;
+  attempts: number;
+  delayUntil: string | null;
+  priority: number;
+  topic: string;
+  error?: string;
+}
+
+export interface JobLifecycle {
+  /** Mark this job as completed. */
+  complete(): void;
+  /** Mark this job as failed with a reason. */
+  fail(reason?: string): void;
+  /** Reject this job with a reason. Alias for fail(). */
+  reject(reason?: string): void;
+  /** Re-queue this job with incremented attempts and optional delay. */
+  retry(delaySeconds?: number): void;
+  /** Return job fields as a flat array of values. */
+  toArray(): unknown[];
+  /** Return job as a plain object. */
+  toHash(): Record<string, unknown>;
+  /** Return job as a JSON string. */
+  toJson(): string;
+}
+
+export type QueueJob = JobData & JobLifecycle;
+
+// ── Job factory ──────────────────────────────────────────────
+
+export interface JobQueueBridge {
+  _failJob(topic: string, job: QueueJob, reason: string, maxRetries: number): void;
+  _retryJob(topic: string, job: QueueJob, delaySeconds?: number): void;
+  getMaxRetries(): number;
+}
+
+/** Create a QueueJob with lifecycle methods bound to a Queue instance. */
+export function createJob(data: JobData, queue: JobQueueBridge): QueueJob {
+  const job: QueueJob = {
+    ...data,
+    complete() {
+      job.status = "completed";
+    },
+    fail(reason = "") {
+      job.status = "failed";
+      job.error = reason;
+      job.attempts = (job.attempts || 0) + 1;
+      queue._failJob(job.topic, job, reason, queue.getMaxRetries());
+    },
+    reject(reason = "") {
+      job.fail(reason);
+    },
+    retry(delaySeconds?: number) {
+      queue._retryJob(job.topic, job, delaySeconds);
+    },
+    toArray() {
+      return [job.id, job.topic, job.payload, job.priority, job.attempts];
+    },
+    toHash() {
+      return {
+        id: job.id,
+        topic: job.topic,
+        payload: job.payload,
+        priority: job.priority,
+        attempts: job.attempts,
+        status: job.status,
+        createdAt: job.createdAt,
+        delayUntil: job.delayUntil,
+        error: job.error,
+      };
+    },
+    toJson() {
+      return JSON.stringify(job.toHash());
+    },
+  };
+  return job;
+}