@payez/next-mvp 3.9.1 → 4.0.1

package/dist/vibe/hooks/index.js

@@ -1,252 +0,0 @@
-"use strict";
-/**
- * =============================================================================
- * VIBE REACT QUERY HOOKS
- * =============================================================================
- *
- * React Query wrappers for Vibe App operations.
- * Provides caching, refetching, and mutation handling out of the box.
- *
- * Usage:
- *   import { useVibeQuery, useVibeMutation } from '@payez/next-mvp/vibe/hooks'
- *
- *   // Query with auto caching
- *   const { data, isLoading, error } = useVibeQuery('users', {
- *     where: { status: 'active' },
- *     take: 10
- *   })
- *
- *   // Mutations
- *   const createUser = useVibeMutation('users', 'create')
- *   await createUser.mutateAsync({ email: 'test@example.com' })
- *
- * =============================================================================
- */
-'use client';
-/**
- * =============================================================================
- * VIBE REACT QUERY HOOKS
- * =============================================================================
- *
- * React Query wrappers for Vibe App operations.
- * Provides caching, refetching, and mutation handling out of the box.
- *
- * Usage:
- *   import { useVibeQuery, useVibeMutation } from '@payez/next-mvp/vibe/hooks'
- *
- *   // Query with auto caching
- *   const { data, isLoading, error } = useVibeQuery('users', {
- *     where: { status: 'active' },
- *     take: 10
- *   })
- *
- *   // Mutations
- *   const createUser = useVibeMutation('users', 'create')
- *   await createUser.mutateAsync({ email: 'test@example.com' })
- *
- * =============================================================================
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.vibeKeys = void 0;
-exports.useVibeQuery = useVibeQuery;
-exports.useVibeDetail = useVibeDetail;
-exports.useVibeCount = useVibeCount;
-exports.useVibeMutation = useVibeMutation;
-exports.useVibeCreate = useVibeCreate;
-exports.useVibeUpdate = useVibeUpdate;
-exports.useVibeDelete = useVibeDelete;
-exports.prefetchVibeQuery = prefetchVibeQuery;
-exports.prefetchVibeDetail = prefetchVibeDetail;
-const react_query_1 = require("@tanstack/react-query");
-const client_1 = require("../client");
-// -----------------------------------------------------------------------------
-// QUERY KEY FACTORY
-// -----------------------------------------------------------------------------
-/**
- * Generate consistent query keys for Vibe queries.
- */
-exports.vibeKeys = {
-    all: ['vibe'],
-    table: (table) => [...exports.vibeKeys.all, table],
-    list: (table, options) => [...exports.vibeKeys.table(table), 'list', options],
-    detail: (table, id) => [...exports.vibeKeys.table(table), 'detail', id],
-    count: (table, options) => [...exports.vibeKeys.table(table), 'count', options],
-};
-/**
- * React Query hook for fetching Vibe data.
- *
- * @param table - The table to query
- * @param options - Query options (where, take, skip, orderBy)
- * @param queryOptions - React Query options
- *
- * @example
- * ```tsx
- * const { data, isLoading } = useVibeQuery('users', {
- *   where: { status: 'active' },
- *   take: 10,
- *   orderBy: { created_at: 'desc' }
- * })
- * ```
- */
-function useVibeQuery(table, options, queryOptions) {
-    const client = queryOptions?.config ? (0, client_1.createVibeClient)(queryOptions.config) : client_1.vibe;
-    return (0, react_query_1.useQuery)({
-        queryKey: exports.vibeKeys.list(table, options),
-        queryFn: () => client[table].findMany(options),
-        ...queryOptions,
-    });
-}
-/**
- * React Query hook for fetching a single Vibe record by ID.
- *
- * @param table - The table to query
- * @param id - The record ID
- * @param queryOptions - React Query options
- *
- * @example
- * ```tsx
- * const { data: user, isLoading } = useVibeDetail('users', 123)
- * ```
- */
-function useVibeDetail(table, id, queryOptions) {
-    const client = queryOptions?.config ? (0, client_1.createVibeClient)(queryOptions.config) : client_1.vibe;
-    return (0, react_query_1.useQuery)({
-        queryKey: exports.vibeKeys.detail(table, id),
-        queryFn: () => client[table].findUniqueOrNull({ where: { id } }),
-        enabled: id != null && (queryOptions?.enabled ?? true),
-        ...queryOptions,
-    });
-}
-/**
- * React Query hook for counting Vibe records.
- *
- * @param table - The table to query
- * @param options - Count options (where)
- * @param queryOptions - React Query options
- *
- * @example
- * ```tsx
- * const { data: count } = useVibeCount('users', { where: { status: 'active' } })
- * ```
- */
-function useVibeCount(table, options, queryOptions) {
-    const client = queryOptions?.config ? (0, client_1.createVibeClient)(queryOptions.config) : client_1.vibe;
-    return (0, react_query_1.useQuery)({
-        queryKey: exports.vibeKeys.count(table, options),
-        queryFn: () => client[table].count(options),
-        ...queryOptions,
-    });
-}
-/**
- * React Query mutation hook for Vibe operations.
- *
- * @param table - The table to mutate
- * @param operation - The operation type (create, update, delete)
- * @param mutationOptions - React Query mutation options
- *
- * @example
- * ```tsx
- * const createUser = useVibeMutation('users', 'create')
- *
- * // Create a user
- * await createUser.mutateAsync({
- *   email: 'test@example.com',
- *   name: 'Test User'
- * })
- *
- * const updateUser = useVibeMutation('users', 'update')
- *
- * // Update a user
- * await updateUser.mutateAsync({
- *   where: { id: 123 },
- *   data: { name: 'Updated Name' }
- * })
- *
- * const deleteUser = useVibeMutation('users', 'delete')
- *
- * // Delete a user
- * await deleteUser.mutateAsync({ id: 123 })
- * ```
- */
-function useVibeMutation(table, operation, mutationOptions) {
-    const queryClient = (0, react_query_1.useQueryClient)();
-    const client = mutationOptions?.config ? (0, client_1.createVibeClient)(mutationOptions.config) : client_1.vibe;
-    const { invalidateOnSuccess = true, ...restOptions } = mutationOptions || {};
-    const { onSuccess: userOnSuccess, ...otherOptions } = restOptions;
-    return (0, react_query_1.useMutation)({
-        mutationFn: async (input) => {
-            const delegate = client[table];
-            switch (operation) {
-                case 'create':
-                    return delegate.create({ data: input });
-                case 'update':
-                    const updateInput = input;
-                    return delegate.update(updateInput);
-                case 'delete':
-                    const deleteInput = input;
-                    return delegate.delete({ where: { id: deleteInput.id } });
-                default:
-                    throw new Error(`Unknown operation: ${operation}`);
-            }
-        },
-        onSuccess: (...args) => {
-            // Invalidate list queries for this table
-            if (invalidateOnSuccess) {
-                queryClient.invalidateQueries({ queryKey: exports.vibeKeys.table(table) });
-            }
-            // Call user's onSuccess if provided
-            userOnSuccess?.(...args);
-        },
-        ...otherOptions,
-    });
-}
-// -----------------------------------------------------------------------------
-// CONVENIENCE HOOKS
-// -----------------------------------------------------------------------------
-/**
- * Convenience hook for creating records.
- */
-function useVibeCreate(table, options) {
-    return useVibeMutation(table, 'create', options);
-}
-/**
- * Convenience hook for updating records.
- */
-function useVibeUpdate(table, options) {
-    return useVibeMutation(table, 'update', options);
-}
-/**
- * Convenience hook for deleting records.
- */
-function useVibeDelete(table, options) {
-    return useVibeMutation(table, 'delete', options);
-}
-// -----------------------------------------------------------------------------
-// PREFETCH UTILITIES
-// -----------------------------------------------------------------------------
-/**
- * Prefetch Vibe data for SSR/SSG.
- *
- * @example
- * ```tsx
- * // In getServerSideProps or generateStaticParams
- * await prefetchVibeQuery(queryClient, 'users', { take: 10 })
- * ```
- */
-async function prefetchVibeQuery(queryClient, table, options, config) {
-    const client = config ? (0, client_1.createVibeClient)(config) : client_1.vibe;
-    await queryClient.prefetchQuery({
-        queryKey: exports.vibeKeys.list(table, options),
-        queryFn: () => client[table].findMany(options),
-    });
-}
-/**
- * Prefetch a single Vibe record for SSR/SSG.
- */
-async function prefetchVibeDetail(queryClient, table, id, config) {
-    const client = config ? (0, client_1.createVibeClient)(config) : client_1.vibe;
-    await queryClient.prefetchQuery({
-        queryKey: exports.vibeKeys.detail(table, id),
-        queryFn: () => client[table].findUniqueOrNull({ where: { id } }),
-    });
-}

package/dist/vibe/index.d.ts

@@ -1,25 +0,0 @@
-/**
- * =============================================================================
- * VIBE MODULE - MAIN EXPORTS
- * =============================================================================
- *
- * Typed Vibe App client for @payez/next-mvp
- *
- * Usage:
- *   import { vibe } from '@payez/next-mvp/vibe'
- *
- *   const users = await vibe.users.findMany({ where: { status: 'active' } })
- *
- * =============================================================================
- */
-export { vibe, createVibeClient, VibeClient, VibeTableDelegate } from './client';
-export type { VibeClientConfig, FindManyOptions, FindUniqueOptions, CreateOptions, UpdateOptions, DeleteOptions, CountOptions, FindManyResult, WhereClause, OrderByClause, FilterOperator, FilterValue, OrderDirection, } from './client';
-export type { VibeAuditFields, VibeMeta, VibeResponse, VibeErrorResponse, VibeTableTypes, VibeTableName, VibeTableType, IVibeUser, IVibeLoginSession, SessionStatus, IVibeProfile, IVibeSetting, IVibeFile, IVibeNotification, NotificationType, IVibeActivityLog, ActivityAction, IVibeTag, IVibeComment, IVibeSiteLog, LogLevel, } from './types';
-export { VibeUser, VibeLoginSession, VibeProfile, VibeSetting, VibeFile, VibeNotification, VibeActivityLog, VibeTag, VibeComment, VibeSiteLog, } from './types';
-export { VibeError, VibeNotFoundError, VibeValidationError, VibeAuthError, VibeRateLimitError, VibeConflictError, VibeServiceError, } from './errors';
-export { createLoginSession, getUserSessions, getAllSessions, getSessionById, revokeSession, revokeAllUserSessions, updateSessionActivity, isSessionValid, checkSessionRevocation, getSessionStats, } from './sessions';
-export type { CreateSessionInput, SessionQueryOptions } from './sessions';
-export { vibeCollection, vibeTable, vibeTablePath, vibeQueryPath, vibeGridPath, unwrapVibeDocument, extractVibeDocuments, GenericCollection, GenericTableDelegate, } from './generic';
-export type { VibeDocumentWrapper } from './generic';
-export { validateEnterpriseAuth, hasEnterpriseAuthHeaders, generateBackendHmacSignature, } from './enterprise-auth';
-export type { EnterpriseClientsConfig, EnterpriseAuthResult, } from './enterprise-auth';

package/dist/vibe/index.js

@@ -1,72 +0,0 @@
-"use strict";
-/**
- * =============================================================================
- * VIBE MODULE - MAIN EXPORTS
- * =============================================================================
- *
- * Typed Vibe App client for @payez/next-mvp
- *
- * Usage:
- *   import { vibe } from '@payez/next-mvp/vibe'
- *
- *   const users = await vibe.users.findMany({ where: { status: 'active' } })
- *
- * =============================================================================
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateBackendHmacSignature = exports.hasEnterpriseAuthHeaders = exports.validateEnterpriseAuth = exports.GenericTableDelegate = exports.GenericCollection = exports.extractVibeDocuments = exports.unwrapVibeDocument = exports.vibeGridPath = exports.vibeQueryPath = exports.vibeTablePath = exports.vibeTable = exports.vibeCollection = exports.getSessionStats = exports.checkSessionRevocation = exports.isSessionValid = exports.updateSessionActivity = exports.revokeAllUserSessions = exports.revokeSession = exports.getSessionById = exports.getAllSessions = exports.getUserSessions = exports.createLoginSession = exports.VibeServiceError = exports.VibeConflictError = exports.VibeRateLimitError = exports.VibeAuthError = exports.VibeValidationError = exports.VibeNotFoundError = exports.VibeError = exports.VibeSiteLog = exports.VibeComment = exports.VibeTag = exports.VibeActivityLog = exports.VibeNotification = exports.VibeFile = exports.VibeSetting = exports.VibeProfile = exports.VibeLoginSession = exports.VibeUser = exports.VibeTableDelegate = exports.VibeClient = exports.createVibeClient = exports.vibe = void 0;
-// Client exports
-var client_1 = require("./client");
-Object.defineProperty(exports, "vibe", { enumerable: true, get: function () { return client_1.vibe; } });
-Object.defineProperty(exports, "createVibeClient", { enumerable: true, get: function () { return client_1.createVibeClient; } });
-Object.defineProperty(exports, "VibeClient", { enumerable: true, get: function () { return client_1.VibeClient; } });
-Object.defineProperty(exports, "VibeTableDelegate", { enumerable: true, get: function () { return client_1.VibeTableDelegate; } });
-// Class exports (for serialization)
-var types_1 = require("./types");
-Object.defineProperty(exports, "VibeUser", { enumerable: true, get: function () { return types_1.VibeUser; } });
-Object.defineProperty(exports, "VibeLoginSession", { enumerable: true, get: function () { return types_1.VibeLoginSession; } });
-Object.defineProperty(exports, "VibeProfile", { enumerable: true, get: function () { return types_1.VibeProfile; } });
-Object.defineProperty(exports, "VibeSetting", { enumerable: true, get: function () { return types_1.VibeSetting; } });
-Object.defineProperty(exports, "VibeFile", { enumerable: true, get: function () { return types_1.VibeFile; } });
-Object.defineProperty(exports, "VibeNotification", { enumerable: true, get: function () { return types_1.VibeNotification; } });
-Object.defineProperty(exports, "VibeActivityLog", { enumerable: true, get: function () { return types_1.VibeActivityLog; } });
-Object.defineProperty(exports, "VibeTag", { enumerable: true, get: function () { return types_1.VibeTag; } });
-Object.defineProperty(exports, "VibeComment", { enumerable: true, get: function () { return types_1.VibeComment; } });
-Object.defineProperty(exports, "VibeSiteLog", { enumerable: true, get: function () { return types_1.VibeSiteLog; } });
-// Error exports
-var errors_1 = require("./errors");
-Object.defineProperty(exports, "VibeError", { enumerable: true, get: function () { return errors_1.VibeError; } });
-Object.defineProperty(exports, "VibeNotFoundError", { enumerable: true, get: function () { return errors_1.VibeNotFoundError; } });
-Object.defineProperty(exports, "VibeValidationError", { enumerable: true, get: function () { return errors_1.VibeValidationError; } });
-Object.defineProperty(exports, "VibeAuthError", { enumerable: true, get: function () { return errors_1.VibeAuthError; } });
-Object.defineProperty(exports, "VibeRateLimitError", { enumerable: true, get: function () { return errors_1.VibeRateLimitError; } });
-Object.defineProperty(exports, "VibeConflictError", { enumerable: true, get: function () { return errors_1.VibeConflictError; } });
-Object.defineProperty(exports, "VibeServiceError", { enumerable: true, get: function () { return errors_1.VibeServiceError; } });
-// Session management exports
-var sessions_1 = require("./sessions");
-Object.defineProperty(exports, "createLoginSession", { enumerable: true, get: function () { return sessions_1.createLoginSession; } });
-Object.defineProperty(exports, "getUserSessions", { enumerable: true, get: function () { return sessions_1.getUserSessions; } });
-Object.defineProperty(exports, "getAllSessions", { enumerable: true, get: function () { return sessions_1.getAllSessions; } });
-Object.defineProperty(exports, "getSessionById", { enumerable: true, get: function () { return sessions_1.getSessionById; } });
-Object.defineProperty(exports, "revokeSession", { enumerable: true, get: function () { return sessions_1.revokeSession; } });
-Object.defineProperty(exports, "revokeAllUserSessions", { enumerable: true, get: function () { return sessions_1.revokeAllUserSessions; } });
-Object.defineProperty(exports, "updateSessionActivity", { enumerable: true, get: function () { return sessions_1.updateSessionActivity; } });
-Object.defineProperty(exports, "isSessionValid", { enumerable: true, get: function () { return sessions_1.isSessionValid; } });
-Object.defineProperty(exports, "checkSessionRevocation", { enumerable: true, get: function () { return sessions_1.checkSessionRevocation; } });
-Object.defineProperty(exports, "getSessionStats", { enumerable: true, get: function () { return sessions_1.getSessionStats; } });
-// Generic/dynamic collection exports
-var generic_1 = require("./generic");
-Object.defineProperty(exports, "vibeCollection", { enumerable: true, get: function () { return generic_1.vibeCollection; } });
-Object.defineProperty(exports, "vibeTable", { enumerable: true, get: function () { return generic_1.vibeTable; } });
-Object.defineProperty(exports, "vibeTablePath", { enumerable: true, get: function () { return generic_1.vibeTablePath; } });
-Object.defineProperty(exports, "vibeQueryPath", { enumerable: true, get: function () { return generic_1.vibeQueryPath; } });
-Object.defineProperty(exports, "vibeGridPath", { enumerable: true, get: function () { return generic_1.vibeGridPath; } });
-Object.defineProperty(exports, "unwrapVibeDocument", { enumerable: true, get: function () { return generic_1.unwrapVibeDocument; } });
-Object.defineProperty(exports, "extractVibeDocuments", { enumerable: true, get: function () { return generic_1.extractVibeDocuments; } });
-Object.defineProperty(exports, "GenericCollection", { enumerable: true, get: function () { return generic_1.GenericCollection; } });
-Object.defineProperty(exports, "GenericTableDelegate", { enumerable: true, get: function () { return generic_1.GenericTableDelegate; } });
-// Enterprise authentication exports
-var enterprise_auth_1 = require("./enterprise-auth");
-Object.defineProperty(exports, "validateEnterpriseAuth", { enumerable: true, get: function () { return enterprise_auth_1.validateEnterpriseAuth; } });
-Object.defineProperty(exports, "hasEnterpriseAuthHeaders", { enumerable: true, get: function () { return enterprise_auth_1.hasEnterpriseAuthHeaders; } });
-Object.defineProperty(exports, "generateBackendHmacSignature", { enumerable: true, get: function () { return enterprise_auth_1.generateBackendHmacSignature; } });

package/dist/vibe/sessions.d.ts

@@ -1,161 +0,0 @@
-/**
- * =============================================================================
- * VIBE LOGIN SESSIONS
- * =============================================================================
- *
- * Server-side utilities for managing login sessions in Vibe.
- * Tracks user logins with location, device info, and allows session control.
- *
- * This module uses the MVP's vibe client with proper auth token handling
- * for member-to-vibe calls.
- *
- * USAGE:
- * ------
- * import { createLoginSession, getUserSessions, revokeSession } from '@payez/next-mvp/vibe/sessions';
- *
- * // On login (requires user's access token):
- * await createLoginSession({
- *   idpUserId: 22,
- *   email: 'user@example.com',
- *   ipAddress: '1.2.3.4',
- *   userAgent: '...',
- *   location: { city: 'NYC', ... },
- *   accessToken: userAccessToken,  // Required for member-to-vibe
- * });
- *
- * // Admin: revoke a session
- * await revokeSession(sessionId, 'admin@example.com', accessToken, 'Suspicious activity');
- *
- * =============================================================================
- */
-import type { IVibeLoginSession, SessionStatus } from './types';
-import type { LocationInfo } from '../lib/geolocation';
-import type { DeviceInfo } from '../lib/user-agent-parser';
-export interface CreateSessionInput {
-    /** IDP user ID */
-    idpUserId: number;
-    /** User email */
-    email: string;
-    /** User's display name */
-    name?: string;
-    /** Client IP address */
-    ipAddress: string;
-    /** User agent string */
-    userAgent: string;
-    /** Location info from geolocation lookup */
-    location?: LocationInfo | null;
-    /** Parsed device info */
-    device?: DeviceInfo;
-    /** OAuth provider used for login */
-    oauthProvider?: string;
-    /** Hashed session token for lookup */
-    sessionTokenHash?: string;
-    /**
-     * User's access token - REQUIRED for member-to-vibe calls.
-     * Without this, the request will fail with 401.
-     */
-    accessToken: string;
-}
-export interface SessionQueryOptions {
-    status?: SessionStatus;
-    page?: number;
-    pageSize?: number;
-}
-/**
- * Create a new login session record.
- * Called when a user successfully logs in.
- *
- * @param input - Session creation parameters including accessToken
- * @returns The created session, or null on failure
- */
-export declare function createLoginSession(input: CreateSessionInput): Promise<IVibeLoginSession | null>;
-/**
- * Get all sessions for a specific user.
- *
- * @param idpUserId - The user's IDP ID
- * @param accessToken - User's access token for auth
- * @returns Array of sessions
- */
-export declare function getUserSessions(idpUserId: number, accessToken: string): Promise<IVibeLoginSession[]>;
-/**
- * Get all sessions (admin only).
- * Returns sessions from all users, sorted by most recent first.
- *
- * @param options - Query options
- * @param accessToken - Admin's access token
- * @returns Array of sessions with total count
- */
-export declare function getAllSessions(options: SessionQueryOptions | undefined, accessToken: string): Promise<{
-    sessions: IVibeLoginSession[];
-    total: number;
-}>;
-/**
- * Get a single session by ID.
- *
- * @param sessionId - The session document ID
- * @param accessToken - Access token for auth
- */
-export declare function getSessionById(sessionId: number, accessToken: string): Promise<IVibeLoginSession | null>;
-/**
- * Revoke a specific session.
- * The user will be logged out on their next request.
- *
- * @param sessionId - The session document ID
- * @param adminEmail - Email of the admin performing the revocation
- * @param accessToken - Admin's access token
- * @param reason - Optional reason for revocation
- * @returns The updated session, or null on failure
- */
-export declare function revokeSession(sessionId: number, adminEmail: string, accessToken: string, reason?: string): Promise<IVibeLoginSession | null>;
-/**
- * Revoke all sessions for a specific user.
- * Useful when an account is compromised.
- *
- * @param idpUserId - The user's IDP ID
- * @param adminEmail - Email of the admin performing the revocation
- * @param accessToken - Admin's access token
- * @param reason - Optional reason for revocation
- * @returns Number of sessions revoked
- */
-export declare function revokeAllUserSessions(idpUserId: number, adminEmail: string, accessToken: string, reason?: string): Promise<number>;
-/**
- * Update the last_activity timestamp for a session.
- * Call this periodically during user activity.
- *
- * @param sessionId - The session document ID
- * @param accessToken - Access token for auth
- * @returns true if updated successfully
- */
-export declare function updateSessionActivity(sessionId: number, accessToken: string): Promise<boolean>;
-/**
- * Check if a session is still valid (not revoked/expired).
- * Use this in middleware to enforce session revocation.
- *
- * @param sessionId - The session document ID
- * @param accessToken - Access token for auth
- * @returns true if session is active and not expired
- */
-export declare function isSessionValid(sessionId: number, accessToken: string): Promise<boolean>;
-/**
- * Check if a user has any revoked sessions that need enforcement.
- * Returns the most recently revoked session if found.
- *
- * @param idpUserId - The user's IDP ID
- * @param accessToken - Access token for auth
- * @param sessionTokenHash - Optional token hash to check specific session
- * @returns Revoked session info if enforcement needed, null otherwise
- */
-export declare function checkSessionRevocation(idpUserId: number, accessToken: string, sessionTokenHash?: string): Promise<IVibeLoginSession | null>;
-/**
- * Get session statistics for admin dashboard.
- *
- * @param accessToken - Admin's access token
- */
-export declare function getSessionStats(accessToken: string): Promise<{
-    totalActive: number;
-    totalRevoked: number;
-    uniqueUsers: number;
-    byCountry: Record<string, number>;
-    byDevice: Record<string, number>;
-    recentLogins: number;
-}>;