@payez/next-mvp 3.9.1 → 4.0.1

package/dist/vibe/generic.js

@@ -1,369 +0,0 @@
-"use strict";
-/**
- * =============================================================================
- * VIBE GENERIC CLIENT - DYNAMIC COLLECTION/TABLE ACCESS
- * =============================================================================
- *
- * Provides dynamic access to any Vibe collection and table.
- * Use this when you need to work with tables not predefined in the typed client.
- *
- * Usage:
- *   import { vibeCollection, vibeTablePath, unwrapVibeDocument } from '@payez/next-mvp/vibe'
- *
- *   // Dynamic collection access
- *   const idealResume = vibeCollection('ideal_resume');
- *   const resumes = await idealResume.table('resumes').findMany();
- *
- *   // Path builders for custom fetch calls
- *   const path = vibeTablePath('ideal_resume', 'resumes', 123);
- *   // => '/v1/collections/ideal_resume/tables/resumes/123'
- *
- *   // Document unwrapping (Vibe stores data as JSON string in 'data' field)
- *   const unwrapped = unwrapVibeDocument(rawDoc);
- *
- * =============================================================================
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.GenericCollection = exports.GenericTableDelegate = void 0;
-exports.vibeTablePath = vibeTablePath;
-exports.vibeQueryPath = vibeQueryPath;
-exports.vibeGridPath = vibeGridPath;
-exports.unwrapVibeDocument = unwrapVibeDocument;
-exports.extractVibeDocuments = extractVibeDocuments;
-exports.vibeCollection = vibeCollection;
-exports.vibeTable = vibeTable;
-const client_1 = require("./client");
-const errors_1 = require("./errors");
-// -----------------------------------------------------------------------------
-// PATH BUILDERS
-// -----------------------------------------------------------------------------
-/**
- * Build path for collection table operations.
- * @param collection - Collection name (e.g., 'ideal_resume', 'vibe_app')
- * @param table - Table name (e.g., 'resumes', 'users')
- * @param id - Optional document ID
- * @returns API path string
- *
- * @example
- * vibeTablePath('ideal_resume', 'resumes')
- * // => '/v1/collections/ideal_resume/tables/resumes'
- *
- * vibeTablePath('ideal_resume', 'resumes', 123)
- * // => '/v1/collections/ideal_resume/tables/resumes/123'
- */
-function vibeTablePath(collection, table, id) {
-    const basePath = `/v1/collections/${collection}/tables/${table}`;
-    return id !== undefined ? `${basePath}/${id}` : basePath;
-}
-/**
- * Build path for collection table query endpoint.
- * @param collection - Collection name
- * @param table - Table name
- * @returns Query API path string
- */
-function vibeQueryPath(collection, table) {
-    return `/v1/collections/${collection}/tables/${table}/query`;
-}
-/**
- * Build path for collection table grid endpoint.
- * @param collection - Collection name
- * @param table - Table name
- * @returns Grid API path string
- */
-function vibeGridPath(collection, table) {
-    return `/v1/collections/${collection}/tables/${table}/grid`;
-}
-/**
- * Unwrap a Vibe document response.
- * Vibe returns documents with a wrapper where actual data is a JSON string.
- *
- * @param doc - Raw Vibe document (wrapper format)
- * @returns Unwrapped document with id from document_id, or null if invalid
- *
- * @example
- * const raw = { document_id: 123, data: '{"name":"John","email":"john@example.com"}' };
- * const unwrapped = unwrapVibeDocument(raw);
- * // => { id: 123, name: 'John', email: 'john@example.com' }
- */
-function unwrapVibeDocument(doc) {
-    if (!doc)
-        return null;
-    // Handle case where doc is already unwrapped (has id but no document_id)
-    if ('id' in doc && !('document_id' in doc)) {
-        return doc;
-    }
-    const wrapper = doc;
-    let parsedData = {};
-    if (typeof wrapper.data === 'string') {
-        try {
-            parsedData = JSON.parse(wrapper.data);
-        }
-        catch {
-            console.warn('[vibe-generic] Failed to parse document data JSON:', wrapper.data);
-            parsedData = {};
-        }
-    }
-    else if (typeof wrapper.data === 'object' && wrapper.data !== null) {
-        parsedData = wrapper.data;
-    }
-    const documentId = wrapper.document_id ?? doc.id ?? 0;
-    return {
-        id: documentId,
-        document_id: documentId,
-        ...parsedData,
-    };
-}
-/**
- * Extract and unwrap array of documents from Vibe response.
- *
- * @param responseData - Raw Vibe API response
- * @returns Array of unwrapped documents
- *
- * @example
- * const response = await fetch('/api/vibe/data/ideal_resume/resumes');
- * const data = await response.json();
- * const resumes = extractVibeDocuments(data);
- */
-function extractVibeDocuments(responseData) {
-    if (!responseData || typeof responseData !== 'object') {
-        return [];
-    }
-    const data = responseData;
-    // Try common response shapes
-    const docs = data.data ??
-        data.items ??
-        data.documents ??
-        (Array.isArray(responseData) ? responseData : null);
-    if (!Array.isArray(docs)) {
-        return [];
-    }
-    return docs
-        .map((doc) => unwrapVibeDocument(doc))
-        .filter((d) => d !== null);
-}
-// -----------------------------------------------------------------------------
-// GENERIC TABLE DELEGATE
-// -----------------------------------------------------------------------------
-/**
- * Generic table delegate for dynamic collection/table access.
- * Provides Prisma-like methods for any table.
- */
-class GenericTableDelegate {
-    collection;
-    tableName;
-    client;
-    constructor(collection, tableName, client) {
-        this.collection = collection;
-        this.tableName = tableName;
-        this.client = client;
-    }
-    /**
-     * Find multiple records with optional filtering and pagination.
-     */
-    async findMany(options) {
-        const params = new URLSearchParams();
-        // Build filter params
-        if (options?.where) {
-            for (const [key, value] of Object.entries(options.where)) {
-                if (value !== undefined && value !== null) {
-                    if (typeof value === 'object' && !Array.isArray(value)) {
-                        // Handle operator objects
-                        for (const [op, val] of Object.entries(value)) {
-                            if (Array.isArray(val)) {
-                                val.forEach((v) => params.append(`filter[${key}][${op}][]`, String(v)));
-                            }
-                            else {
-                                params.append(`filter[${key}][${op}]`, String(val));
-                            }
-                        }
-                    }
-                    else if (Array.isArray(value)) {
-                        value.forEach((v) => params.append(`filter[${key}][]`, String(v)));
-                    }
-                    else {
-                        params.append(`filter[${key}]`, String(value));
-                    }
-                }
-            }
-        }
-        // Pagination
-        if (options?.take !== undefined) {
-            params.append('limit', String(options.take));
-        }
-        if (options?.skip !== undefined) {
-            params.append('offset', String(options.skip));
-        }
-        // Sorting
-        if (options?.orderBy) {
-            const sortParts = [];
-            for (const [key, dir] of Object.entries(options.orderBy)) {
-                sortParts.push(dir === 'desc' ? `-${key}` : key);
-            }
-            if (sortParts.length > 0) {
-                params.append('sort', sortParts.join(','));
-            }
-        }
-        const queryString = params.toString();
-        const path = vibeTablePath(this.collection, this.tableName);
-        const url = `${this.client.getBaseUrl()}${path}${queryString ? `?${queryString}` : ''}`;
-        const response = await this.client.request(url, 'GET');
-        const unwrapped = extractVibeDocuments(response);
-        return {
-            data: unwrapped,
-            meta: response.meta || { total: unwrapped.length, limit: options?.take || 50, offset: options?.skip || 0 },
-        };
-    }
-    /**
-     * Find a single record by ID.
-     * Throws VibeNotFoundError if not found.
-     */
-    async findUnique(options) {
-        const path = vibeTablePath(this.collection, this.tableName, options.where.id);
-        const url = `${this.client.getBaseUrl()}${path}`;
-        const response = await this.client.request(url, 'GET');
-        const unwrapped = unwrapVibeDocument(response.data);
-        if (!unwrapped) {
-            throw new errors_1.VibeNotFoundError(`Document ${options.where.id} not found in ${this.collection}/${this.tableName}`, 'NOT_FOUND', { collection: this.collection, table: this.tableName, id: options.where.id });
-        }
-        return unwrapped;
-    }
-    /**
-     * Find a single record by ID, returns null if not found.
-     */
-    async findUniqueOrNull(options) {
-        try {
-            return await this.findUnique(options);
-        }
-        catch (error) {
-            if (error instanceof errors_1.VibeNotFoundError) {
-                return null;
-            }
-            throw error;
-        }
-    }
-    /**
-     * Find the first record matching the filter.
-     */
-    async findFirst(options) {
-        const result = await this.findMany({ ...options, take: 1 });
-        return result.data[0] || null;
-    }
-    /**
-     * Create a new record.
-     */
-    async create(options) {
-        const path = vibeTablePath(this.collection, this.tableName);
-        const url = `${this.client.getBaseUrl()}${path}`;
-        const response = await this.client.request(url, 'POST', options.data);
-        const unwrapped = unwrapVibeDocument(response.data);
-        if (!unwrapped) {
-            throw new errors_1.VibeServiceError('Failed to parse created document');
-        }
-        return unwrapped;
-    }
-    /**
-     * Update an existing record by ID.
-     */
-    async update(options) {
-        const path = vibeTablePath(this.collection, this.tableName, options.where.id);
-        const url = `${this.client.getBaseUrl()}${path}`;
-        const response = await this.client.request(url, 'PUT', options.data);
-        const unwrapped = unwrapVibeDocument(response.data);
-        if (!unwrapped) {
-            throw new errors_1.VibeServiceError('Failed to parse updated document');
-        }
-        return unwrapped;
-    }
-    /**
-     * Delete a record by ID (soft delete).
-     */
-    async delete(options) {
-        const path = vibeTablePath(this.collection, this.tableName, options.where.id);
-        const url = `${this.client.getBaseUrl()}${path}`;
-        const response = await this.client.request(url, 'DELETE');
-        const unwrapped = unwrapVibeDocument(response.data);
-        if (!unwrapped) {
-            throw new errors_1.VibeServiceError('Failed to parse deleted document');
-        }
-        return unwrapped;
-    }
-    /**
-     * Count records matching the filter.
-     */
-    async count(options) {
-        const result = await this.findMany({ ...options, take: 0 });
-        return result.meta.total;
-    }
-}
-exports.GenericTableDelegate = GenericTableDelegate;
-// -----------------------------------------------------------------------------
-// GENERIC COLLECTION
-// -----------------------------------------------------------------------------
-/**
- * Generic collection accessor for dynamic table access.
- */
-class GenericCollection {
-    collectionName;
-    client;
-    constructor(collectionName, client) {
-        this.collectionName = collectionName;
-        this.client = client;
-    }
-    /**
-     * Get a table delegate for the specified table.
-     *
-     * @example
-     * const idealResume = vibeCollection('ideal_resume');
-     * const resumes = await idealResume.table('resumes').findMany();
-     */
-    table(tableName) {
-        return new GenericTableDelegate(this.collectionName, tableName, this.client);
-    }
-}
-exports.GenericCollection = GenericCollection;
-// -----------------------------------------------------------------------------
-// FACTORY FUNCTIONS
-// -----------------------------------------------------------------------------
-let defaultClient = null;
-function getDefaultClient() {
-    if (!defaultClient) {
-        defaultClient = new client_1.VibeClient();
-    }
-    return defaultClient;
-}
-/**
- * Get a generic collection accessor for dynamic table access.
- *
- * @param collectionName - Name of the collection (e.g., 'ideal_resume', 'vibe_app')
- * @param config - Optional client configuration
- * @returns GenericCollection instance
- *
- * @example
- * import { vibeCollection } from '@payez/next-mvp/vibe';
- *
- * const idealResume = vibeCollection('ideal_resume');
- * const resumes = await idealResume.table('resumes').findMany({ take: 10 });
- * const resume = await idealResume.table('resumes').findUnique({ where: { id: 123 } });
- */
-function vibeCollection(collectionName, config) {
-    const client = config ? new client_1.VibeClient(config) : getDefaultClient();
-    return new GenericCollection(collectionName, client);
-}
-/**
- * Create a generic table delegate directly.
- *
- * @param collection - Collection name
- * @param table - Table name
- * @param config - Optional client configuration
- * @returns GenericTableDelegate instance
- *
- * @example
- * import { vibeTable } from '@payez/next-mvp/vibe';
- *
- * const resumes = vibeTable('ideal_resume', 'resumes');
- * const allResumes = await resumes.findMany();
- */
-function vibeTable(collection, table, config) {
-    const client = config ? new client_1.VibeClient(config) : getDefaultClient();
-    return new GenericTableDelegate(collection, table, client);
-}

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

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