@teamvortexsoftware/vortex-fastify-5-sdk 0.0.1

package/dist/handlers/jwt.js

@@ -0,0 +1,81 @@
+"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 = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["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.handleJwtGeneration = handleJwtGeneration;
+var vortex_node_22_sdk_1 = require("@teamvortexsoftware/vortex-node-22-sdk");
+var config_1 = require("../config");
+var utils_1 = require("../utils");
+function handleJwtGeneration(request, reply) {
+    return __awaiter(this, void 0, void 0, function () {
+        var config, authenticatedUser, vortex, jwt, error_1, message;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    _a.trys.push([0, 3, , 4]);
+                    if (request.method !== 'POST') {
+                        return [2 /*return*/, (0, utils_1.createErrorResponse)(reply, 'Method not allowed', 405)];
+                    }
+                    return [4 /*yield*/, (0, config_1.getVortexConfig)()];
+                case 1:
+                    config = _a.sent();
+                    if (!config.authenticateUser) {
+                        return [2 /*return*/, (0, utils_1.createErrorResponse)(reply, 'JWT generation requires authentication configuration. Please configure authenticateUser hook.', 500)];
+                    }
+                    return [4 /*yield*/, config.authenticateUser(request, reply)];
+                case 2:
+                    authenticatedUser = _a.sent();
+                    if (!authenticatedUser) {
+                        return [2 /*return*/, (0, utils_1.createErrorResponse)(reply, 'Unauthorized', 401)];
+                    }
+                    vortex = new vortex_node_22_sdk_1.Vortex(config.apiKey);
+                    jwt = vortex.generateJwt({
+                        userId: authenticatedUser.userId,
+                        identifiers: authenticatedUser.identifiers,
+                        groups: authenticatedUser.groups,
+                        role: authenticatedUser.role,
+                    });
+                    return [2 /*return*/, (0, utils_1.createApiResponse)(reply, { jwt: jwt })];
+                case 3:
+                    error_1 = _a.sent();
+                    message = error_1 instanceof Error ? error_1.message : 'An error occurred';
+                    return [2 /*return*/, (0, utils_1.createErrorResponse)(reply, message, 500)];
+                case 4: return [2 /*return*/];
+            }
+        });
+    });
+}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { configureVortex, configureVortexAsync, configureVortexLazy, getVortexConfig, authenticateRequest, createAllowAllAccessControl } from './config';
+export type { VortexConfig, AuthenticatedUser, AccessControlHook, InvitationResource, InvitationTargetResource, GroupResource, InvitationAccessHook, InvitationTargetAccessHook, GroupAccessHook, BasicAccessHook } from './config';
+export { createVortexJwtRoute, createVortexInvitationsRoute, createVortexInvitationRoute, createVortexInvitationsAcceptRoute, createVortexInvitationsByGroupRoute, createVortexReinviteRoute, createVortexRoutes, vortexPlugin, registerVortexRoutes, VORTEX_ROUTES, createVortexApiPath, } from './routes';
+export type { VortexPluginOptions } from './routes';
+export { handleJwtGeneration, } from './handlers/jwt';
+export { handleGetInvitationsByTarget, handleGetInvitation, handleRevokeInvitation, handleAcceptInvitations, handleGetInvitationsByGroup, handleDeleteInvitationsByGroup, handleReinvite, } from './handlers/invitations';
+export { createApiResponse, createErrorResponse, parseRequestBody, getQueryParam, getRouteParam, validateRequiredFields, sanitizeInput, } from './utils';
+export * from '@teamvortexsoftware/vortex-node-22-sdk';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,eAAe,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,UAAU,CAAC;AACzJ,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,iBAAiB,EACjB,kBAAkB,EAClB,wBAAwB,EACxB,aAAa,EACb,oBAAoB,EACpB,0BAA0B,EAC1B,eAAe,EACf,eAAe,EAChB,MAAM,UAAU,CAAC;AAElB,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,2BAA2B,EAC3B,kCAAkC,EAClC,mCAAmC,EACnC,yBAAyB,EACzB,kBAAkB,EAClB,YAAY,EACZ,oBAAoB,EACpB,aAAa,EACb,mBAAmB,GACpB,MAAM,UAAU,CAAC;AAClB,YAAY,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEpD,OAAO,EACL,mBAAmB,GACpB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,4BAA4B,EAC5B,mBAAmB,EACnB,sBAAsB,EACtB,uBAAuB,EACvB,2BAA2B,EAC3B,8BAA8B,EAC9B,cAAc,GACf,MAAM,wBAAwB,CAAC;AAEhC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,sBAAsB,EACtB,aAAa,GACd,MAAM,SAAS,CAAC;AAEjB,cAAc,wCAAwC,CAAC"}

package/dist/index.js

@@ -0,0 +1,55 @@
+"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 });
+exports.sanitizeInput = exports.validateRequiredFields = exports.getRouteParam = exports.getQueryParam = exports.parseRequestBody = exports.createErrorResponse = exports.createApiResponse = exports.handleReinvite = exports.handleDeleteInvitationsByGroup = exports.handleGetInvitationsByGroup = exports.handleAcceptInvitations = exports.handleRevokeInvitation = exports.handleGetInvitation = exports.handleGetInvitationsByTarget = exports.handleJwtGeneration = exports.createVortexApiPath = exports.VORTEX_ROUTES = exports.registerVortexRoutes = exports.vortexPlugin = exports.createVortexRoutes = exports.createVortexReinviteRoute = exports.createVortexInvitationsByGroupRoute = exports.createVortexInvitationsAcceptRoute = exports.createVortexInvitationRoute = exports.createVortexInvitationsRoute = exports.createVortexJwtRoute = exports.createAllowAllAccessControl = exports.authenticateRequest = exports.getVortexConfig = exports.configureVortexLazy = exports.configureVortexAsync = exports.configureVortex = void 0;
+var config_1 = require("./config");
+Object.defineProperty(exports, "configureVortex", { enumerable: true, get: function () { return config_1.configureVortex; } });
+Object.defineProperty(exports, "configureVortexAsync", { enumerable: true, get: function () { return config_1.configureVortexAsync; } });
+Object.defineProperty(exports, "configureVortexLazy", { enumerable: true, get: function () { return config_1.configureVortexLazy; } });
+Object.defineProperty(exports, "getVortexConfig", { enumerable: true, get: function () { return config_1.getVortexConfig; } });
+Object.defineProperty(exports, "authenticateRequest", { enumerable: true, get: function () { return config_1.authenticateRequest; } });
+Object.defineProperty(exports, "createAllowAllAccessControl", { enumerable: true, get: function () { return config_1.createAllowAllAccessControl; } });
+var routes_1 = require("./routes");
+Object.defineProperty(exports, "createVortexJwtRoute", { enumerable: true, get: function () { return routes_1.createVortexJwtRoute; } });
+Object.defineProperty(exports, "createVortexInvitationsRoute", { enumerable: true, get: function () { return routes_1.createVortexInvitationsRoute; } });
+Object.defineProperty(exports, "createVortexInvitationRoute", { enumerable: true, get: function () { return routes_1.createVortexInvitationRoute; } });
+Object.defineProperty(exports, "createVortexInvitationsAcceptRoute", { enumerable: true, get: function () { return routes_1.createVortexInvitationsAcceptRoute; } });
+Object.defineProperty(exports, "createVortexInvitationsByGroupRoute", { enumerable: true, get: function () { return routes_1.createVortexInvitationsByGroupRoute; } });
+Object.defineProperty(exports, "createVortexReinviteRoute", { enumerable: true, get: function () { return routes_1.createVortexReinviteRoute; } });
+Object.defineProperty(exports, "createVortexRoutes", { enumerable: true, get: function () { return routes_1.createVortexRoutes; } });
+Object.defineProperty(exports, "vortexPlugin", { enumerable: true, get: function () { return routes_1.vortexPlugin; } });
+Object.defineProperty(exports, "registerVortexRoutes", { enumerable: true, get: function () { return routes_1.registerVortexRoutes; } });
+Object.defineProperty(exports, "VORTEX_ROUTES", { enumerable: true, get: function () { return routes_1.VORTEX_ROUTES; } });
+Object.defineProperty(exports, "createVortexApiPath", { enumerable: true, get: function () { return routes_1.createVortexApiPath; } });
+var jwt_1 = require("./handlers/jwt");
+Object.defineProperty(exports, "handleJwtGeneration", { enumerable: true, get: function () { return jwt_1.handleJwtGeneration; } });
+var invitations_1 = require("./handlers/invitations");
+Object.defineProperty(exports, "handleGetInvitationsByTarget", { enumerable: true, get: function () { return invitations_1.handleGetInvitationsByTarget; } });
+Object.defineProperty(exports, "handleGetInvitation", { enumerable: true, get: function () { return invitations_1.handleGetInvitation; } });
+Object.defineProperty(exports, "handleRevokeInvitation", { enumerable: true, get: function () { return invitations_1.handleRevokeInvitation; } });
+Object.defineProperty(exports, "handleAcceptInvitations", { enumerable: true, get: function () { return invitations_1.handleAcceptInvitations; } });
+Object.defineProperty(exports, "handleGetInvitationsByGroup", { enumerable: true, get: function () { return invitations_1.handleGetInvitationsByGroup; } });
+Object.defineProperty(exports, "handleDeleteInvitationsByGroup", { enumerable: true, get: function () { return invitations_1.handleDeleteInvitationsByGroup; } });
+Object.defineProperty(exports, "handleReinvite", { enumerable: true, get: function () { return invitations_1.handleReinvite; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "createApiResponse", { enumerable: true, get: function () { return utils_1.createApiResponse; } });
+Object.defineProperty(exports, "createErrorResponse", { enumerable: true, get: function () { return utils_1.createErrorResponse; } });
+Object.defineProperty(exports, "parseRequestBody", { enumerable: true, get: function () { return utils_1.parseRequestBody; } });
+Object.defineProperty(exports, "getQueryParam", { enumerable: true, get: function () { return utils_1.getQueryParam; } });
+Object.defineProperty(exports, "getRouteParam", { enumerable: true, get: function () { return utils_1.getRouteParam; } });
+Object.defineProperty(exports, "validateRequiredFields", { enumerable: true, get: function () { return utils_1.validateRequiredFields; } });
+Object.defineProperty(exports, "sanitizeInput", { enumerable: true, get: function () { return utils_1.sanitizeInput; } });
+__exportStar(require("@teamvortexsoftware/vortex-node-22-sdk"), exports);

package/dist/routes.d.ts

@@ -0,0 +1,102 @@
+import { FastifyInstance, FastifyRequest, FastifyReply, FastifyPluginAsync } from 'fastify';
+/**
+ * Expected route paths that match the React provider's API calls
+ * This ensures the Fastify routes and React provider stay in sync
+ */
+export declare const VORTEX_ROUTES: {
+    readonly JWT: "/jwt";
+    readonly INVITATIONS: "/invitations";
+    readonly INVITATION: "/invitations/:invitationId";
+    readonly INVITATIONS_ACCEPT: "/invitations/accept";
+    readonly INVITATIONS_BY_GROUP: "/invitations/by-group/:groupType/:groupId";
+    readonly INVITATION_REINVITE: "/invitations/:invitationId/reinvite";
+};
+/**
+ * Utility to create the full API path based on base URL
+ */
+export declare function createVortexApiPath(baseUrl: string, route: keyof typeof VORTEX_ROUTES): string;
+/**
+ * Creates individual route handlers for JWT endpoint
+ */
+export declare function createVortexJwtRoute(): (request: FastifyRequest, reply: FastifyReply) => Promise<never>;
+/**
+ * Creates individual route handlers for invitations endpoint
+ */
+export declare function createVortexInvitationsRoute(): (request: FastifyRequest, reply: FastifyReply) => Promise<never>;
+/**
+ * Creates individual route handlers for single invitation endpoint
+ */
+export declare function createVortexInvitationRoute(): {
+    get: (request: FastifyRequest, reply: FastifyReply) => Promise<never>;
+    delete: (request: FastifyRequest, reply: FastifyReply) => Promise<never>;
+};
+/**
+ * Creates individual route handlers for invitations accept endpoint
+ */
+export declare function createVortexInvitationsAcceptRoute(): (request: FastifyRequest, reply: FastifyReply) => Promise<never>;
+/**
+ * Creates individual route handlers for invitations by group endpoint
+ */
+export declare function createVortexInvitationsByGroupRoute(): {
+    get: (request: FastifyRequest, reply: FastifyReply) => Promise<never>;
+    delete: (request: FastifyRequest, reply: FastifyReply) => Promise<never>;
+};
+/**
+ * Creates individual route handlers for reinvite endpoint
+ */
+export declare function createVortexReinviteRoute(): (request: FastifyRequest, reply: FastifyReply) => Promise<never>;
+/**
+ * Creates all Vortex routes for manual registration
+ * This provides individual handlers that can be attached to specific routes
+ */
+export declare function createVortexRoutes(): {
+    jwt: (request: FastifyRequest, reply: FastifyReply) => Promise<never>;
+    invitations: (request: FastifyRequest, reply: FastifyReply) => Promise<never>;
+    invitation: {
+        get: (request: FastifyRequest, reply: FastifyReply) => Promise<never>;
+        delete: (request: FastifyRequest, reply: FastifyReply) => Promise<never>;
+    };
+    invitationsAccept: (request: FastifyRequest, reply: FastifyReply) => Promise<never>;
+    invitationsByGroup: {
+        get: (request: FastifyRequest, reply: FastifyReply) => Promise<never>;
+        delete: (request: FastifyRequest, reply: FastifyReply) => Promise<never>;
+    };
+    invitationReinvite: (request: FastifyRequest, reply: FastifyReply) => Promise<never>;
+};
+/**
+ * Creates a Fastify plugin with all Vortex routes configured
+ * This is the easiest way to integrate Vortex into a Fastify app
+ *
+ * Usage:
+ * ```typescript
+ * import Fastify from 'fastify';
+ * import { vortexPlugin } from '@teamvortexsoftware/vortex-fastify-5-sdk';
+ *
+ * const fastify = Fastify();
+ * await fastify.register(vortexPlugin, { prefix: '/api/vortex' });
+ * ```
+ */
+export declare const vortexPlugin: FastifyPluginAsync;
+/**
+ * Manual route registration helper for more control
+ * Use this if you want to register routes individually or with custom logic
+ *
+ * Usage:
+ * ```typescript
+ * import Fastify from 'fastify';
+ * import { registerVortexRoutes } from '@teamvortexsoftware/vortex-fastify-5-sdk';
+ *
+ * const fastify = Fastify();
+ *
+ * // Register with custom prefix
+ * await registerVortexRoutes(fastify, '/api/v1/vortex');
+ * ```
+ */
+export declare function registerVortexRoutes(fastify: FastifyInstance, basePath?: string): Promise<void>;
+/**
+ * Type definitions for Fastify plugin options
+ */
+export interface VortexPluginOptions {
+    prefix?: string;
+}
+//# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAY5F;;;GAGG;AACH,eAAO,MAAM,aAAa;;;;;;;CAOhB,CAAC;AAEX;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,OAAO,aAAa,GAAG,MAAM,CAE9F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,KACZ,SAAS,cAAc,EAAE,OAAO,YAAY,oBAGnE;AAED;;GAEG;AACH,wBAAgB,4BAA4B,KACpB,SAAS,cAAc,EAAE,OAAO,YAAY,oBAGnE;AAED;;GAEG;AACH,wBAAgB,2BAA2B;mBAEV,cAAc,SAAS,YAAY;sBAGhC,cAAc,SAAS,YAAY;EAItE;AAED;;GAEG;AACH,wBAAgB,kCAAkC,KAC1B,SAAS,cAAc,EAAE,OAAO,YAAY,oBAGnE;AAED;;GAEG;AACH,wBAAgB,mCAAmC;mBAElB,cAAc,SAAS,YAAY;sBAGhC,cAAc,SAAS,YAAY;EAItE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,KACjB,SAAS,cAAc,EAAE,OAAO,YAAY,oBAGnE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB;mBAhED,cAAc,SAAS,YAAY;2BASnC,cAAc,SAAS,YAAY;;uBAUnC,cAAc,SAAS,YAAY;0BAGhC,cAAc,SAAS,YAAY;;iCAUtC,cAAc,SAAS,YAAY;;uBAUnC,cAAc,SAAS,YAAY;0BAGhC,cAAc,SAAS,YAAY;;kCAUtC,cAAc,SAAS,YAAY;EAkBnE;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,EAAE,kBAc1B,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,oBAAoB,CAAC,OAAO,EAAE,eAAe,EAAE,QAAQ,GAAE,MAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAapH;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/routes.js

@@ -0,0 +1,239 @@
+"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 = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["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.vortexPlugin = exports.VORTEX_ROUTES = void 0;
+exports.createVortexApiPath = createVortexApiPath;
+exports.createVortexJwtRoute = createVortexJwtRoute;
+exports.createVortexInvitationsRoute = createVortexInvitationsRoute;
+exports.createVortexInvitationRoute = createVortexInvitationRoute;
+exports.createVortexInvitationsAcceptRoute = createVortexInvitationsAcceptRoute;
+exports.createVortexInvitationsByGroupRoute = createVortexInvitationsByGroupRoute;
+exports.createVortexReinviteRoute = createVortexReinviteRoute;
+exports.createVortexRoutes = createVortexRoutes;
+exports.registerVortexRoutes = registerVortexRoutes;
+var jwt_1 = require("./handlers/jwt");
+var invitations_1 = require("./handlers/invitations");
+/**
+ * Expected route paths that match the React provider's API calls
+ * This ensures the Fastify routes and React provider stay in sync
+ */
+exports.VORTEX_ROUTES = {
+    JWT: '/jwt',
+    INVITATIONS: '/invitations',
+    INVITATION: '/invitations/:invitationId',
+    INVITATIONS_ACCEPT: '/invitations/accept',
+    INVITATIONS_BY_GROUP: '/invitations/by-group/:groupType/:groupId',
+    INVITATION_REINVITE: '/invitations/:invitationId/reinvite',
+};
+/**
+ * Utility to create the full API path based on base URL
+ */
+function createVortexApiPath(baseUrl, route) {
+    return "".concat(baseUrl.replace(/\/$/, '')).concat(exports.VORTEX_ROUTES[route]);
+}
+/**
+ * Creates individual route handlers for JWT endpoint
+ */
+function createVortexJwtRoute() {
+    return function (request, reply) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, (0, jwt_1.handleJwtGeneration)(request, reply)];
+            });
+        });
+    };
+}
+/**
+ * Creates individual route handlers for invitations endpoint
+ */
+function createVortexInvitationsRoute() {
+    return function (request, reply) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, (0, invitations_1.handleGetInvitationsByTarget)(request, reply)];
+            });
+        });
+    };
+}
+/**
+ * Creates individual route handlers for single invitation endpoint
+ */
+function createVortexInvitationRoute() {
+    return {
+        get: function (request, reply) {
+            return __awaiter(this, void 0, void 0, function () {
+                return __generator(this, function (_a) {
+                    return [2 /*return*/, (0, invitations_1.handleGetInvitation)(request, reply)];
+                });
+            });
+        },
+        delete: function (request, reply) {
+            return __awaiter(this, void 0, void 0, function () {
+                return __generator(this, function (_a) {
+                    return [2 /*return*/, (0, invitations_1.handleRevokeInvitation)(request, reply)];
+                });
+            });
+        },
+    };
+}
+/**
+ * Creates individual route handlers for invitations accept endpoint
+ */
+function createVortexInvitationsAcceptRoute() {
+    return function (request, reply) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, (0, invitations_1.handleAcceptInvitations)(request, reply)];
+            });
+        });
+    };
+}
+/**
+ * Creates individual route handlers for invitations by group endpoint
+ */
+function createVortexInvitationsByGroupRoute() {
+    return {
+        get: function (request, reply) {
+            return __awaiter(this, void 0, void 0, function () {
+                return __generator(this, function (_a) {
+                    return [2 /*return*/, (0, invitations_1.handleGetInvitationsByGroup)(request, reply)];
+                });
+            });
+        },
+        delete: function (request, reply) {
+            return __awaiter(this, void 0, void 0, function () {
+                return __generator(this, function (_a) {
+                    return [2 /*return*/, (0, invitations_1.handleDeleteInvitationsByGroup)(request, reply)];
+                });
+            });
+        },
+    };
+}
+/**
+ * Creates individual route handlers for reinvite endpoint
+ */
+function createVortexReinviteRoute() {
+    return function (request, reply) {
+        return __awaiter(this, void 0, void 0, function () {
+            return __generator(this, function (_a) {
+                return [2 /*return*/, (0, invitations_1.handleReinvite)(request, reply)];
+            });
+        });
+    };
+}
+/**
+ * Creates all Vortex routes for manual registration
+ * This provides individual handlers that can be attached to specific routes
+ */
+function createVortexRoutes() {
+    return {
+        jwt: createVortexJwtRoute(),
+        invitations: createVortexInvitationsRoute(),
+        invitation: createVortexInvitationRoute(),
+        invitationsAccept: createVortexInvitationsAcceptRoute(),
+        invitationsByGroup: createVortexInvitationsByGroupRoute(),
+        invitationReinvite: createVortexReinviteRoute(),
+    };
+}
+/**
+ * Creates a Fastify plugin with all Vortex routes configured
+ * This is the easiest way to integrate Vortex into a Fastify app
+ *
+ * Usage:
+ * ```typescript
+ * import Fastify from 'fastify';
+ * import { vortexPlugin } from '@teamvortexsoftware/vortex-fastify-5-sdk';
+ *
+ * const fastify = Fastify();
+ * await fastify.register(vortexPlugin, { prefix: '/api/vortex' });
+ * ```
+ */
+var vortexPlugin = function vortexPlugin(fastify) {
+    return __awaiter(this, void 0, void 0, function () {
+        var routes;
+        return __generator(this, function (_a) {
+            routes = createVortexRoutes();
+            // Register all routes
+            fastify.post(exports.VORTEX_ROUTES.JWT, routes.jwt);
+            fastify.get(exports.VORTEX_ROUTES.INVITATIONS, routes.invitations);
+            fastify.get(exports.VORTEX_ROUTES.INVITATION, routes.invitation.get);
+            fastify.delete(exports.VORTEX_ROUTES.INVITATION, routes.invitation.delete);
+            fastify.post(exports.VORTEX_ROUTES.INVITATIONS_ACCEPT, routes.invitationsAccept);
+            fastify.get(exports.VORTEX_ROUTES.INVITATIONS_BY_GROUP, routes.invitationsByGroup.get);
+            fastify.delete(exports.VORTEX_ROUTES.INVITATIONS_BY_GROUP, routes.invitationsByGroup.delete);
+            fastify.post(exports.VORTEX_ROUTES.INVITATION_REINVITE, routes.invitationReinvite);
+            return [2 /*return*/];
+        });
+    });
+};
+exports.vortexPlugin = vortexPlugin;
+/**
+ * Manual route registration helper for more control
+ * Use this if you want to register routes individually or with custom logic
+ *
+ * Usage:
+ * ```typescript
+ * import Fastify from 'fastify';
+ * import { registerVortexRoutes } from '@teamvortexsoftware/vortex-fastify-5-sdk';
+ *
+ * const fastify = Fastify();
+ *
+ * // Register with custom prefix
+ * await registerVortexRoutes(fastify, '/api/v1/vortex');
+ * ```
+ */
+function registerVortexRoutes(fastify_1) {
+    return __awaiter(this, arguments, void 0, function (fastify, basePath) {
+        var routes, cleanBasePath;
+        if (basePath === void 0) { basePath = '/api/vortex'; }
+        return __generator(this, function (_a) {
+            routes = createVortexRoutes();
+            cleanBasePath = basePath.replace(/\/$/, '');
+            // Register all routes with the base path
+            fastify.post("".concat(cleanBasePath).concat(exports.VORTEX_ROUTES.JWT), routes.jwt);
+            fastify.get("".concat(cleanBasePath).concat(exports.VORTEX_ROUTES.INVITATIONS), routes.invitations);
+            fastify.get("".concat(cleanBasePath).concat(exports.VORTEX_ROUTES.INVITATION), routes.invitation.get);
+            fastify.delete("".concat(cleanBasePath).concat(exports.VORTEX_ROUTES.INVITATION), routes.invitation.delete);
+            fastify.post("".concat(cleanBasePath).concat(exports.VORTEX_ROUTES.INVITATIONS_ACCEPT), routes.invitationsAccept);
+            fastify.get("".concat(cleanBasePath).concat(exports.VORTEX_ROUTES.INVITATIONS_BY_GROUP), routes.invitationsByGroup.get);
+            fastify.delete("".concat(cleanBasePath).concat(exports.VORTEX_ROUTES.INVITATIONS_BY_GROUP), routes.invitationsByGroup.delete);
+            fastify.post("".concat(cleanBasePath).concat(exports.VORTEX_ROUTES.INVITATION_REINVITE), routes.invitationReinvite);
+            return [2 /*return*/];
+        });
+    });
+}

package/dist/utils.d.ts

@@ -0,0 +1,9 @@
+import { FastifyRequest, FastifyReply } from 'fastify';
+export declare function createApiResponse(reply: FastifyReply, data: unknown, status?: number): FastifyReply;
+export declare function createErrorResponse(reply: FastifyReply, message: string, status?: number): FastifyReply;
+export declare function parseRequestBody(request: FastifyRequest): Promise<unknown>;
+export declare function getQueryParam(request: FastifyRequest, param: string): string | null;
+export declare function getRouteParam(request: FastifyRequest, param: string): string | null;
+export declare function validateRequiredFields(data: Record<string, unknown>, fields: string[]): void;
+export declare function sanitizeInput(input: string | null): string | null;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAE,MAAY,GAAG,YAAY,CAExG;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAY,GAAG,YAAY,CAE5G;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAMhF;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUnF;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAInF;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAK5F;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAQjE"}

package/dist/utils.js

@@ -0,0 +1,95 @@
+"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 = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["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.createApiResponse = createApiResponse;
+exports.createErrorResponse = createErrorResponse;
+exports.parseRequestBody = parseRequestBody;
+exports.getQueryParam = getQueryParam;
+exports.getRouteParam = getRouteParam;
+exports.validateRequiredFields = validateRequiredFields;
+exports.sanitizeInput = sanitizeInput;
+function createApiResponse(reply, data, status) {
+    if (status === void 0) { status = 200; }
+    return reply.status(status).send(data);
+}
+function createErrorResponse(reply, message, status) {
+    if (status === void 0) { status = 400; }
+    return reply.status(status).send({ error: message });
+}
+function parseRequestBody(request) {
+    return __awaiter(this, void 0, void 0, function () {
+        return __generator(this, function (_a) {
+            // In Fastify, the body is already parsed and available on the request
+            if (request.body) {
+                return [2 /*return*/, request.body];
+            }
+            throw new Error('Request body is empty or not parsed');
+        });
+    });
+}
+function getQueryParam(request, param) {
+    var query = request.query;
+    var value = query[param];
+    if (typeof value === 'string') {
+        return value;
+    }
+    if (Array.isArray(value) && value.length > 0 && typeof value[0] === 'string') {
+        return value[0];
+    }
+    return null;
+}
+function getRouteParam(request, param) {
+    var params = request.params;
+    var value = params[param];
+    return typeof value === 'string' ? value : null;
+}
+function validateRequiredFields(data, fields) {
+    var missing = fields.filter(function (field) { return data[field] === undefined || data[field] === null; });
+    if (missing.length > 0) {
+        throw new Error("Missing required fields: ".concat(missing.join(', ')));
+    }
+}
+function sanitizeInput(input) {
+    if (!input)
+        return null;
+    // Basic input sanitization - remove potential XSS/injection characters
+    return input
+        .trim()
+        .replace(/[<>'"]/g, '') // Remove basic XSS characters
+        .substring(0, 1000); // Limit length to prevent DoS
+}