@payez/next-mvp 3.0.0

package/dist/vibe/types.d.ts

@@ -0,0 +1,353 @@
+/**
+ * =============================================================================
+ * VIBE APP TYPES
+ * =============================================================================
+ *
+ * Type definitions for the Vibe App tables.
+ * Includes both plain interfaces and serializable classes.
+ *
+ * Usage (plain objects - default):
+ *   const user = await vibe.users.findUnique({ where: { id: 1 } })
+ *   console.log(user.email) // Typed!
+ *
+ * Usage (class instances - optional):
+ *   const user = VibeUser.fromJSON(await vibe.users.findUnique({ where: { id: 1 } }))
+ *   const json = user.toJSON()
+ *
+ * =============================================================================
+ */
+/** Standard audit fields present on all Vibe documents */
+export interface VibeAuditFields {
+    id: number;
+    created_at: string;
+    updated_at: string | null;
+}
+/** Pagination metadata returned from list queries */
+export interface VibeMeta {
+    total: number;
+    limit: number;
+    offset: number;
+}
+/** Standard API response wrapper */
+export interface VibeResponse<T> {
+    success: true;
+    data: T;
+    meta?: VibeMeta;
+}
+/** Error response wrapper */
+export interface VibeErrorResponse {
+    success: false;
+    error: {
+        code: string;
+        message: string;
+        details?: Record<string, unknown>;
+    };
+}
+export interface IVibeUser extends VibeAuditFields {
+    idp_user_id: number;
+    email: string;
+    name: string | null;
+    type: 'human' | 'service' | 'admin';
+    oauth_provider: string | null;
+    last_login: string | null;
+    login_count: number;
+}
+export declare class VibeUser implements IVibeUser {
+    id: number;
+    idp_user_id: number;
+    email: string;
+    name: string | null;
+    type: 'human' | 'service' | 'admin';
+    oauth_provider: string | null;
+    last_login: string | null;
+    login_count: number;
+    created_at: string;
+    updated_at: string | null;
+    constructor(data: IVibeUser);
+    static fromJSON(json: IVibeUser): VibeUser;
+    toJSON(): IVibeUser;
+    get displayName(): string;
+}
+export type SessionStatus = 'active' | 'revoked' | 'expired';
+export interface IVibeLoginSession extends VibeAuditFields {
+    idp_user_id: number;
+    email: string;
+    name: string | null;
+    ip_address: string;
+    city: string | null;
+    region: string | null;
+    country: string | null;
+    country_code: string | null;
+    latitude: number | null;
+    longitude: number | null;
+    timezone: string | null;
+    user_agent: string;
+    device_type: 'desktop' | 'mobile' | 'tablet' | 'unknown';
+    browser: string;
+    browser_version: string | null;
+    os: string;
+    os_version: string | null;
+    oauth_provider: string | null;
+    session_token_hash: string | null;
+    status: SessionStatus;
+    revoked_by: string | null;
+    revoked_at: string | null;
+    revoke_reason: string | null;
+    last_activity: string | null;
+    expires_at: string;
+}
+export declare class VibeLoginSession implements IVibeLoginSession {
+    id: number;
+    idp_user_id: number;
+    email: string;
+    name: string | null;
+    ip_address: string;
+    city: string | null;
+    region: string | null;
+    country: string | null;
+    country_code: string | null;
+    latitude: number | null;
+    longitude: number | null;
+    timezone: string | null;
+    user_agent: string;
+    device_type: 'desktop' | 'mobile' | 'tablet' | 'unknown';
+    browser: string;
+    browser_version: string | null;
+    os: string;
+    os_version: string | null;
+    oauth_provider: string | null;
+    session_token_hash: string | null;
+    status: SessionStatus;
+    revoked_by: string | null;
+    revoked_at: string | null;
+    revoke_reason: string | null;
+    last_activity: string | null;
+    expires_at: string;
+    created_at: string;
+    updated_at: string | null;
+    constructor(data: IVibeLoginSession);
+    static fromJSON(json: IVibeLoginSession): VibeLoginSession;
+    toJSON(): IVibeLoginSession;
+    get isActive(): boolean;
+    get location(): string;
+    get deviceInfo(): string;
+}
+export interface IVibeProfile extends VibeAuditFields {
+    user_id: number;
+    bio: string | null;
+    avatar_url: string | null;
+    website: string | null;
+    location: string | null;
+    timezone: string | null;
+    language: string;
+    metadata: Record<string, unknown> | null;
+}
+export declare class VibeProfile implements IVibeProfile {
+    id: number;
+    user_id: number;
+    bio: string | null;
+    avatar_url: string | null;
+    website: string | null;
+    location: string | null;
+    timezone: string | null;
+    language: string;
+    metadata: Record<string, unknown> | null;
+    created_at: string;
+    updated_at: string | null;
+    constructor(data: IVibeProfile);
+    static fromJSON(json: IVibeProfile): VibeProfile;
+    toJSON(): IVibeProfile;
+}
+export interface IVibeSetting extends VibeAuditFields {
+    user_id: number | null;
+    key: string;
+    value: string | number | boolean | Record<string, unknown>;
+    type: 'string' | 'number' | 'boolean' | 'json';
+    description: string | null;
+    is_public: boolean;
+}
+export declare class VibeSetting implements IVibeSetting {
+    id: number;
+    user_id: number | null;
+    key: string;
+    value: string | number | boolean | Record<string, unknown>;
+    type: 'string' | 'number' | 'boolean' | 'json';
+    description: string | null;
+    is_public: boolean;
+    created_at: string;
+    updated_at: string | null;
+    constructor(data: IVibeSetting);
+    static fromJSON(json: IVibeSetting): VibeSetting;
+    toJSON(): IVibeSetting;
+}
+export interface IVibeFile extends VibeAuditFields {
+    user_id: number;
+    filename: string;
+    original_name: string;
+    mime_type: string;
+    size_bytes: number;
+    storage_path: string;
+    public_url: string | null;
+    is_public: boolean;
+    metadata: Record<string, unknown> | null;
+}
+export declare class VibeFile implements IVibeFile {
+    id: number;
+    user_id: number;
+    filename: string;
+    original_name: string;
+    mime_type: string;
+    size_bytes: number;
+    storage_path: string;
+    public_url: string | null;
+    is_public: boolean;
+    metadata: Record<string, unknown> | null;
+    created_at: string;
+    updated_at: string | null;
+    constructor(data: IVibeFile);
+    static fromJSON(json: IVibeFile): VibeFile;
+    toJSON(): IVibeFile;
+    get sizeFormatted(): string;
+}
+export type NotificationType = 'info' | 'success' | 'warning' | 'error';
+export interface IVibeNotification extends VibeAuditFields {
+    user_id: number;
+    type: NotificationType;
+    title: string;
+    message: string;
+    link: string | null;
+    read_at: string | null;
+    dismissed_at: string | null;
+    metadata: Record<string, unknown> | null;
+}
+export declare class VibeNotification implements IVibeNotification {
+    id: number;
+    user_id: number;
+    type: NotificationType;
+    title: string;
+    message: string;
+    link: string | null;
+    read_at: string | null;
+    dismissed_at: string | null;
+    metadata: Record<string, unknown> | null;
+    created_at: string;
+    updated_at: string | null;
+    constructor(data: IVibeNotification);
+    static fromJSON(json: IVibeNotification): VibeNotification;
+    toJSON(): IVibeNotification;
+    get isRead(): boolean;
+    get isDismissed(): boolean;
+}
+export type ActivityAction = 'create' | 'update' | 'delete' | 'login' | 'logout' | 'view' | 'export' | 'import' | 'other';
+export interface IVibeActivityLog extends VibeAuditFields {
+    user_id: number | null;
+    action: ActivityAction;
+    entity_type: string;
+    entity_id: number | null;
+    description: string;
+    ip_address: string | null;
+    user_agent: string | null;
+    metadata: Record<string, unknown> | null;
+}
+export declare class VibeActivityLog implements IVibeActivityLog {
+    id: number;
+    user_id: number | null;
+    action: ActivityAction;
+    entity_type: string;
+    entity_id: number | null;
+    description: string;
+    ip_address: string | null;
+    user_agent: string | null;
+    metadata: Record<string, unknown> | null;
+    created_at: string;
+    updated_at: string | null;
+    constructor(data: IVibeActivityLog);
+    static fromJSON(json: IVibeActivityLog): VibeActivityLog;
+    toJSON(): IVibeActivityLog;
+}
+export interface IVibeTag extends VibeAuditFields {
+    name: string;
+    slug: string;
+    color: string | null;
+    description: string | null;
+}
+export declare class VibeTag implements IVibeTag {
+    id: number;
+    name: string;
+    slug: string;
+    color: string | null;
+    description: string | null;
+    created_at: string;
+    updated_at: string | null;
+    constructor(data: IVibeTag);
+    static fromJSON(json: IVibeTag): VibeTag;
+    toJSON(): IVibeTag;
+}
+export interface IVibeComment extends VibeAuditFields {
+    user_id: number;
+    entity_type: string;
+    entity_id: number;
+    parent_id: number | null;
+    content: string;
+    is_edited: boolean;
+    edited_at: string | null;
+}
+export declare class VibeComment implements IVibeComment {
+    id: number;
+    user_id: number;
+    entity_type: string;
+    entity_id: number;
+    parent_id: number | null;
+    content: string;
+    is_edited: boolean;
+    edited_at: string | null;
+    created_at: string;
+    updated_at: string | null;
+    constructor(data: IVibeComment);
+    static fromJSON(json: IVibeComment): VibeComment;
+    toJSON(): IVibeComment;
+    get isReply(): boolean;
+}
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+export interface IVibeSiteLog extends VibeAuditFields {
+    level: LogLevel;
+    message: string;
+    source: string;
+    user_id: number | null;
+    request_id: string | null;
+    stack_trace: string | null;
+    metadata: Record<string, unknown> | null;
+}
+export declare class VibeSiteLog implements IVibeSiteLog {
+    id: number;
+    level: LogLevel;
+    message: string;
+    source: string;
+    user_id: number | null;
+    request_id: string | null;
+    stack_trace: string | null;
+    metadata: Record<string, unknown> | null;
+    created_at: string;
+    updated_at: string | null;
+    constructor(data: IVibeSiteLog);
+    static fromJSON(json: IVibeSiteLog): VibeSiteLog;
+    toJSON(): IVibeSiteLog;
+    get isError(): boolean;
+}
+/** Map of table names to their types */
+export interface VibeTableTypes {
+    users: IVibeUser;
+    login_sessions: IVibeLoginSession;
+    profiles: IVibeProfile;
+    settings: IVibeSetting;
+    files: IVibeFile;
+    notifications: IVibeNotification;
+    activity_log: IVibeActivityLog;
+    tags: IVibeTag;
+    comments: IVibeComment;
+    site_logs: IVibeSiteLog;
+}
+/** Valid table names */
+export type VibeTableName = keyof VibeTableTypes;
+/** Get the type for a specific table */
+export type VibeTableType<T extends VibeTableName> = VibeTableTypes[T];

package/dist/vibe/types.js

@@ -0,0 +1,315 @@
+"use strict";
+/**
+ * =============================================================================
+ * VIBE APP TYPES
+ * =============================================================================
+ *
+ * Type definitions for the Vibe App tables.
+ * Includes both plain interfaces and serializable classes.
+ *
+ * Usage (plain objects - default):
+ *   const user = await vibe.users.findUnique({ where: { id: 1 } })
+ *   console.log(user.email) // Typed!
+ *
+ * Usage (class instances - optional):
+ *   const user = VibeUser.fromJSON(await vibe.users.findUnique({ where: { id: 1 } }))
+ *   const json = user.toJSON()
+ *
+ * =============================================================================
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VibeSiteLog = exports.VibeComment = exports.VibeTag = exports.VibeActivityLog = exports.VibeNotification = exports.VibeFile = exports.VibeSetting = exports.VibeProfile = exports.VibeLoginSession = exports.VibeUser = void 0;
+class VibeUser {
+    id;
+    idp_user_id;
+    email;
+    name;
+    type;
+    oauth_provider;
+    last_login;
+    login_count;
+    created_at;
+    updated_at;
+    constructor(data) {
+        this.id = data.id;
+        this.idp_user_id = data.idp_user_id;
+        this.email = data.email;
+        this.name = data.name;
+        this.type = data.type;
+        this.oauth_provider = data.oauth_provider;
+        this.last_login = data.last_login;
+        this.login_count = data.login_count;
+        this.created_at = data.created_at;
+        this.updated_at = data.updated_at;
+    }
+    static fromJSON(json) {
+        return new VibeUser(json);
+    }
+    toJSON() {
+        return {
+            id: this.id,
+            idp_user_id: this.idp_user_id,
+            email: this.email,
+            name: this.name,
+            type: this.type,
+            oauth_provider: this.oauth_provider,
+            last_login: this.last_login,
+            login_count: this.login_count,
+            created_at: this.created_at,
+            updated_at: this.updated_at,
+        };
+    }
+    get displayName() {
+        return this.name || this.email;
+    }
+}
+exports.VibeUser = VibeUser;
+class VibeLoginSession {
+    id;
+    idp_user_id;
+    email;
+    name;
+    ip_address;
+    city;
+    region;
+    country;
+    country_code;
+    latitude;
+    longitude;
+    timezone;
+    user_agent;
+    device_type;
+    browser;
+    browser_version;
+    os;
+    os_version;
+    oauth_provider;
+    session_token_hash;
+    status;
+    revoked_by;
+    revoked_at;
+    revoke_reason;
+    last_activity;
+    expires_at;
+    created_at;
+    updated_at;
+    constructor(data) {
+        Object.assign(this, data);
+    }
+    static fromJSON(json) {
+        return new VibeLoginSession(json);
+    }
+    toJSON() {
+        return { ...this };
+    }
+    get isActive() {
+        return this.status === 'active' && new Date(this.expires_at) > new Date();
+    }
+    get location() {
+        const parts = [this.city, this.region, this.country].filter(Boolean);
+        return parts.join(', ') || 'Unknown';
+    }
+    get deviceInfo() {
+        return `${this.browser} on ${this.os}`;
+    }
+}
+exports.VibeLoginSession = VibeLoginSession;
+class VibeProfile {
+    id;
+    user_id;
+    bio;
+    avatar_url;
+    website;
+    location;
+    timezone;
+    language;
+    metadata;
+    created_at;
+    updated_at;
+    constructor(data) {
+        Object.assign(this, data);
+    }
+    static fromJSON(json) {
+        return new VibeProfile(json);
+    }
+    toJSON() {
+        return { ...this };
+    }
+}
+exports.VibeProfile = VibeProfile;
+class VibeSetting {
+    id;
+    user_id;
+    key;
+    value;
+    type;
+    description;
+    is_public;
+    created_at;
+    updated_at;
+    constructor(data) {
+        Object.assign(this, data);
+    }
+    static fromJSON(json) {
+        return new VibeSetting(json);
+    }
+    toJSON() {
+        return { ...this };
+    }
+}
+exports.VibeSetting = VibeSetting;
+class VibeFile {
+    id;
+    user_id;
+    filename;
+    original_name;
+    mime_type;
+    size_bytes;
+    storage_path;
+    public_url;
+    is_public;
+    metadata;
+    created_at;
+    updated_at;
+    constructor(data) {
+        Object.assign(this, data);
+    }
+    static fromJSON(json) {
+        return new VibeFile(json);
+    }
+    toJSON() {
+        return { ...this };
+    }
+    get sizeFormatted() {
+        const units = ['B', 'KB', 'MB', 'GB'];
+        let size = this.size_bytes;
+        let unitIndex = 0;
+        while (size >= 1024 && unitIndex < units.length - 1) {
+            size /= 1024;
+            unitIndex++;
+        }
+        return `${size.toFixed(1)} ${units[unitIndex]}`;
+    }
+}
+exports.VibeFile = VibeFile;
+class VibeNotification {
+    id;
+    user_id;
+    type;
+    title;
+    message;
+    link;
+    read_at;
+    dismissed_at;
+    metadata;
+    created_at;
+    updated_at;
+    constructor(data) {
+        Object.assign(this, data);
+    }
+    static fromJSON(json) {
+        return new VibeNotification(json);
+    }
+    toJSON() {
+        return { ...this };
+    }
+    get isRead() {
+        return this.read_at !== null;
+    }
+    get isDismissed() {
+        return this.dismissed_at !== null;
+    }
+}
+exports.VibeNotification = VibeNotification;
+class VibeActivityLog {
+    id;
+    user_id;
+    action;
+    entity_type;
+    entity_id;
+    description;
+    ip_address;
+    user_agent;
+    metadata;
+    created_at;
+    updated_at;
+    constructor(data) {
+        Object.assign(this, data);
+    }
+    static fromJSON(json) {
+        return new VibeActivityLog(json);
+    }
+    toJSON() {
+        return { ...this };
+    }
+}
+exports.VibeActivityLog = VibeActivityLog;
+class VibeTag {
+    id;
+    name;
+    slug;
+    color;
+    description;
+    created_at;
+    updated_at;
+    constructor(data) {
+        Object.assign(this, data);
+    }
+    static fromJSON(json) {
+        return new VibeTag(json);
+    }
+    toJSON() {
+        return { ...this };
+    }
+}
+exports.VibeTag = VibeTag;
+class VibeComment {
+    id;
+    user_id;
+    entity_type;
+    entity_id;
+    parent_id;
+    content;
+    is_edited;
+    edited_at;
+    created_at;
+    updated_at;
+    constructor(data) {
+        Object.assign(this, data);
+    }
+    static fromJSON(json) {
+        return new VibeComment(json);
+    }
+    toJSON() {
+        return { ...this };
+    }
+    get isReply() {
+        return this.parent_id !== null;
+    }
+}
+exports.VibeComment = VibeComment;
+class VibeSiteLog {
+    id;
+    level;
+    message;
+    source;
+    user_id;
+    request_id;
+    stack_trace;
+    metadata;
+    created_at;
+    updated_at;
+    constructor(data) {
+        Object.assign(this, data);
+    }
+    static fromJSON(json) {
+        return new VibeSiteLog(json);
+    }
+    toJSON() {
+        return { ...this };
+    }
+    get isError() {
+        return this.level === 'error' || this.level === 'fatal';
+    }
+}
+exports.VibeSiteLog = VibeSiteLog;