@payez/next-mvp 3.0.0

package/dist/vibe/hooks/index.d.ts

@@ -0,0 +1,169 @@
+/**
+ * =============================================================================
+ * 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' })
+ *
+ * =============================================================================
+ */
+import { useQueryClient, type UseQueryOptions, type UseMutationOptions } from '@tanstack/react-query';
+import type { VibeTableName, VibeTableType, FindManyOptions, FindManyResult, CreateOptions, UpdateOptions, VibeClientConfig } from '../client';
+import type { VibeError } from '../errors';
+/**
+ * Generate consistent query keys for Vibe queries.
+ */
+export declare const vibeKeys: {
+    all: readonly ["vibe"];
+    table: (table: VibeTableName) => readonly ["vibe", keyof import("..").VibeTableTypes];
+    list: (table: VibeTableName, options?: FindManyOptions<unknown>) => readonly ["vibe", keyof import("..").VibeTableTypes, "list", FindManyOptions<unknown> | undefined];
+    detail: (table: VibeTableName, id: number) => readonly ["vibe", keyof import("..").VibeTableTypes, "detail", number];
+    count: (table: VibeTableName, options?: {
+        where?: unknown;
+    }) => readonly ["vibe", keyof import("..").VibeTableTypes, "count", {
+        where?: unknown;
+    } | undefined];
+};
+export interface UseVibeQueryOptions<T extends VibeTableName> extends Omit<UseQueryOptions<FindManyResult<VibeTableType<T>>, VibeError>, 'queryKey' | 'queryFn'> {
+    /** Vibe client config (optional - uses default if not provided) */
+    config?: VibeClientConfig;
+}
+/**
+ * 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' }
+ * })
+ * ```
+ */
+export declare function useVibeQuery<T extends VibeTableName>(table: T, options?: FindManyOptions<VibeTableType<T>>, queryOptions?: UseVibeQueryOptions<T>): import("@tanstack/react-query").UseQueryResult<FindManyResult<VibeTableType<T>>, VibeError>;
+export interface UseVibeDetailOptions<T extends VibeTableName> extends Omit<UseQueryOptions<VibeTableType<T> | null, VibeError>, 'queryKey' | 'queryFn'> {
+    /** Vibe client config (optional - uses default if not provided) */
+    config?: VibeClientConfig;
+}
+/**
+ * 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)
+ * ```
+ */
+export declare function useVibeDetail<T extends VibeTableName>(table: T, id: number | null | undefined, queryOptions?: UseVibeDetailOptions<T>): import("@tanstack/react-query").UseQueryResult<import("@tanstack/react-query").NoInfer<VibeTableType<T> | null>, VibeError>;
+export interface UseVibeCountOptions<T extends VibeTableName> extends Omit<UseQueryOptions<number, VibeError>, 'queryKey' | 'queryFn'> {
+    /** Vibe client config (optional - uses default if not provided) */
+    config?: VibeClientConfig;
+}
+/**
+ * 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' } })
+ * ```
+ */
+export declare function useVibeCount<T extends VibeTableName>(table: T, options?: {
+    where?: FindManyOptions<VibeTableType<T>>['where'];
+}, queryOptions?: UseVibeCountOptions<T>): import("@tanstack/react-query").UseQueryResult<number, VibeError>;
+type MutationOperation = 'create' | 'update' | 'delete';
+type MutationInput<T extends VibeTableName, Op extends MutationOperation> = Op extends 'create' ? CreateOptions<VibeTableType<T>>['data'] : Op extends 'update' ? UpdateOptions<VibeTableType<T>> : Op extends 'delete' ? {
+    id: number;
+} : never;
+type MutationResult<T extends VibeTableName, Op extends MutationOperation> = Op extends 'create' ? VibeTableType<T> : Op extends 'update' ? VibeTableType<T> : Op extends 'delete' ? VibeTableType<T> : never;
+export interface UseVibeMutationOptions<T extends VibeTableName, Op extends MutationOperation> extends Omit<UseMutationOptions<MutationResult<T, Op>, VibeError, MutationInput<T, Op>>, 'mutationFn'> {
+    /** Vibe client config (optional - uses default if not provided) */
+    config?: VibeClientConfig;
+    /** Automatically invalidate list queries after mutation (default: true) */
+    invalidateOnSuccess?: boolean;
+}
+/**
+ * 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 })
+ * ```
+ */
+export declare function useVibeMutation<T extends VibeTableName, Op extends MutationOperation>(table: T, operation: Op, mutationOptions?: UseVibeMutationOptions<T, Op>): import("@tanstack/react-query").UseMutationResult<MutationResult<T, Op>, VibeError, MutationInput<T, Op>, unknown>;
+/**
+ * Convenience hook for creating records.
+ */
+export declare function useVibeCreate<T extends VibeTableName>(table: T, options?: Omit<UseVibeMutationOptions<T, 'create'>, never>): import("@tanstack/react-query").UseMutationResult<VibeTableType<T>, VibeError, Omit<VibeTableType<T>, "id" | "created_at" | "updated_at">, unknown>;
+/**
+ * Convenience hook for updating records.
+ */
+export declare function useVibeUpdate<T extends VibeTableName>(table: T, options?: Omit<UseVibeMutationOptions<T, 'update'>, never>): import("@tanstack/react-query").UseMutationResult<VibeTableType<T>, VibeError, UpdateOptions<VibeTableType<T>>, unknown>;
+/**
+ * Convenience hook for deleting records.
+ */
+export declare function useVibeDelete<T extends VibeTableName>(table: T, options?: Omit<UseVibeMutationOptions<T, 'delete'>, never>): import("@tanstack/react-query").UseMutationResult<VibeTableType<T>, VibeError, {
+    id: number;
+}, unknown>;
+/**
+ * Prefetch Vibe data for SSR/SSG.
+ *
+ * @example
+ * ```tsx
+ * // In getServerSideProps or generateStaticParams
+ * await prefetchVibeQuery(queryClient, 'users', { take: 10 })
+ * ```
+ */
+export declare function prefetchVibeQuery<T extends VibeTableName>(queryClient: ReturnType<typeof useQueryClient>, table: T, options?: FindManyOptions<VibeTableType<T>>, config?: VibeClientConfig): Promise<void>;
+/**
+ * Prefetch a single Vibe record for SSR/SSG.
+ */
+export declare function prefetchVibeDetail<T extends VibeTableName>(queryClient: ReturnType<typeof useQueryClient>, table: T, id: number, config?: VibeClientConfig): Promise<void>;
+export {};

package/dist/vibe/hooks/index.js

@@ -0,0 +1,252 @@
+"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

@@ -0,0 +1,23 @@
+/**
+ * =============================================================================
+ * 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';

package/dist/vibe/index.js

@@ -0,0 +1,67 @@
+"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.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; } });

package/dist/vibe/sessions.d.ts

@@ -0,0 +1,161 @@
+/**
+ * =============================================================================
+ * 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;
+}>;