@nekutima/biome-sdk 0.1.18

package/dist/types/state-machine.types.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Base state machine types for Biome platform
+ * These types are shared between frontend and backend
+ */
+/**
+ * Base actor type for state machine transitions
+ */
+export type Actor = {
+    id: number;
+    type: string;
+    permissions: string[];
+};
+/**
+ * Base state machine event
+ */
+export type StateMachineEvent = {
+    type: string;
+    actor: Actor;
+    timestamp: Date;
+    metadata?: Record<string, any>;
+};
+/**
+ * Base state machine transition
+ */
+export type StateTransition<TState, TEvent> = {
+    from: TState;
+    event: TEvent;
+    to: TState;
+    actor: Actor;
+    timestamp: Date;
+    metadata?: Record<string, any>;
+};
+/**
+ * Base state machine configuration
+ */
+export type StateMachineConfig<TState, TEvent> = {
+    initialState: TState;
+    transitions: Array<{
+        from: TState;
+        event: TEvent;
+        to: TState;
+        allowedActors: string[];
+        validation?: (actor: Actor, metadata?: Record<string, any>) => boolean;
+    }>;
+    finalStates: TState[];
+};
+/**
+ * Base state machine service interface
+ */
+export interface IStateMachineService<TState, TEvent> {
+    getCurrentState(): TState;
+    canTransition(event: TEvent, actor: Actor): boolean;
+    transition(event: TEvent, actor: Actor, metadata?: Record<string, any>): Promise<TState>;
+    getValidTransitions(actor: Actor): TEvent[];
+    isFinalState(): boolean;
+    getTransitionHistory(): StateTransition<TState, TEvent>[];
+}
+/**
+ * State machine error types
+ */
+export declare enum StateMachineErrorType {
+    INVALID_TRANSITION = "INVALID_TRANSITION",
+    UNAUTHORIZED_ACTOR = "UNAUTHORIZED_ACTOR",
+    INVALID_STATE = "INVALID_STATE",
+    VALIDATION_FAILED = "VALIDATION_FAILED"
+}
+/**
+ * State machine error
+ */
+export type StateMachineError = {
+    type: StateMachineErrorType;
+    message: string;
+    currentState?: any;
+    attemptedEvent?: any;
+    actor?: Actor;
+    metadata?: Record<string, any>;
+};
+/**
+ * State machine audit log entry
+ */
+export type StateMachineAuditLog = {
+    id: string;
+    entityType: string;
+    entityId: number;
+    fromState: any;
+    toState: any;
+    event: string;
+    actor: Actor;
+    timestamp: Date;
+    metadata?: Record<string, any>;
+    success: boolean;
+    error?: StateMachineError;
+};
+/**
+ * State machine factory configuration
+ */
+export type StateMachineFactoryConfig = {
+    enableAuditLogging: boolean;
+    enableValidation: boolean;
+    maxHistorySize: number;
+};
+//# sourceMappingURL=state-machine.types.d.ts.map

package/dist/types/state-machine.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.types.d.ts","sourceRoot":"","sources":["../../src/types/state-machine.types.ts"],"names":[],"mappings":"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"}

package/dist/types/state-machine.types.js

@@ -0,0 +1,18 @@
+"use strict";
+/**
+ * Base state machine types for Biome platform
+ * These types are shared between frontend and backend
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StateMachineErrorType = void 0;
+/**
+ * State machine error types
+ */
+var StateMachineErrorType;
+(function (StateMachineErrorType) {
+    StateMachineErrorType["INVALID_TRANSITION"] = "INVALID_TRANSITION";
+    StateMachineErrorType["UNAUTHORIZED_ACTOR"] = "UNAUTHORIZED_ACTOR";
+    StateMachineErrorType["INVALID_STATE"] = "INVALID_STATE";
+    StateMachineErrorType["VALIDATION_FAILED"] = "VALIDATION_FAILED";
+})(StateMachineErrorType || (exports.StateMachineErrorType = StateMachineErrorType = {}));
+//# sourceMappingURL=state-machine.types.js.map

package/dist/types/state-machine.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.types.js","sourceRoot":"","sources":["../../src/types/state-machine.types.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA4DH;;GAEG;AACH,IAAY,qBAKX;AALD,WAAY,qBAAqB;IAC7B,kEAAyC,CAAA;IACzC,kEAAyC,CAAA;IACzC,wDAA+B,CAAA;IAC/B,gEAAuC,CAAA;AAC3C,CAAC,EALW,qBAAqB,qCAArB,qBAAqB,QAKhC"}

package/dist/users/user.service.d.ts

@@ -0,0 +1,49 @@
+import { BiomeHttpClient } from '../core/http-client';
+/**
+ * User service - pure business logic without UI concerns
+ */
+export declare class BiomeUsers {
+    private http;
+    constructor(http: BiomeHttpClient);
+    /**
+     * Get all users with avatar URLs
+     */
+    getAll(): Promise<UserWithAvatar[]>;
+    /**
+     * Build avatar URL for user
+     */
+    private buildAvatarUrl;
+    /**
+     * Normalize URL to be absolute
+     */
+    private normalizeUrl;
+    /**
+     * Get users with pagination and search
+     */
+    getUsers(query?: string, limit?: number): Promise<UserWithAvatar[]>;
+    /**
+     * Get user by ID
+     */
+    getUserById(id: number): Promise<UserWithAvatar | null>;
+    /**
+     * Get user by username
+     */
+    getUserByUsername(username: string): Promise<UserWithAvatar | null>;
+    /**
+     * Search users
+     */
+    searchUsers(query: string, limit?: number): Promise<UserWithAvatar[]>;
+}
+export interface UserWithAvatar {
+    id: number;
+    username: string;
+    avatarStoragePath?: string | null;
+    avatarDownloadUrl?: string | null;
+    avatarUrl?: string | null;
+    profilePhoto?: {
+        downloadUrl?: string;
+        storagePath?: string;
+    };
+    profilePhotoFileId?: number | null;
+}
+//# sourceMappingURL=user.service.d.ts.map

package/dist/users/user.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.service.d.ts","sourceRoot":"","sources":["../../src/users/user.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAItD;;GAEG;AACH,qBAAa,UAAU;IAEP,OAAO,CAAC,IAAI;gBAAJ,IAAI,EAAE,eAAe;IAEzC;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAiBzC;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAYpB;;OAEG;IACG,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAgBzE;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAe7D;;OAEG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAezE;;OAEG;IACG,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;CAG9E;AAED,MAAM,WAAW,cAAc;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,iBAAiB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,YAAY,CAAC,EAAE;QACX,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IACF,kBAAkB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC"}

package/dist/users/user.service.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BiomeUsers = void 0;
+const error_handler_1 = require("../core/error-handler");
+/**
+ * User service - pure business logic without UI concerns
+ */
+class BiomeUsers {
+    constructor(http) {
+        this.http = http;
+    }
+    /**
+     * Get all users with avatar URLs
+     */
+    async getAll() {
+        try {
+            const response = await this.http.get('/users');
+            if (!response.payload) {
+                throw new Error('No user data received');
+            }
+            return response.payload.users.map(user => ({
+                ...user,
+                avatarUrl: this.buildAvatarUrl(user),
+            }));
+        }
+        catch (error) {
+            throw (0, error_handler_1.createSdkError)(error, 'Failed to get users');
+        }
+    }
+    /**
+     * Build avatar URL for user
+     */
+    buildAvatarUrl(user) {
+        if (user.avatarDownloadUrl) {
+            return this.normalizeUrl(user.avatarDownloadUrl);
+        }
+        if (user.avatarStoragePath) {
+            return this.normalizeUrl(`/trunk/files/${user.avatarStoragePath}`);
+        }
+        return null;
+    }
+    /**
+     * Normalize URL to be absolute
+     */
+    normalizeUrl(path) {
+        if (path.startsWith('http://') || path.startsWith('https://')) {
+            return path;
+        }
+        // For SDK, we don't have access to environment
+        // This would need to be passed in via config or handled at a higher level
+        const baseUrl = ''; // This should be handled by HTTP client base URL
+        const normalizedPath = path.startsWith('/') ? path : `/${path}`;
+        return `${baseUrl}${normalizedPath}`;
+    }
+    /**
+     * Get users with pagination and search
+     */
+    async getUsers(query, limit) {
+        try {
+            const params = new URLSearchParams();
+            if (query)
+                params.set('q', query);
+            if (limit)
+                params.set('limit', limit.toString());
+            const response = await this.http.get(`/users?${params}`);
+            return response.payload.users.map(user => ({
+                ...user,
+                avatarUrl: this.buildAvatarUrl(user),
+            }));
+        }
+        catch (error) {
+            throw (0, error_handler_1.createSdkError)(error, 'Failed to get users');
+        }
+    }
+    /**
+     * Get user by ID
+     */
+    async getUserById(id) {
+        try {
+            const response = await this.http.get(`/users/${id}`);
+            const user = response.payload;
+            if (!user)
+                return null;
+            return {
+                ...user,
+                avatarUrl: this.buildAvatarUrl(user),
+            };
+        }
+        catch (error) {
+            throw (0, error_handler_1.createSdkError)(error, 'Failed to get user by ID');
+        }
+    }
+    /**
+     * Get user by username
+     */
+    async getUserByUsername(username) {
+        try {
+            const response = await this.http.get(`/users/username/${encodeURIComponent(username)}`);
+            const user = response.payload;
+            if (!user)
+                return null;
+            return {
+                ...user,
+                avatarUrl: this.buildAvatarUrl(user),
+            };
+        }
+        catch (error) {
+            throw (0, error_handler_1.createSdkError)(error, 'Failed to get user by username');
+        }
+    }
+    /**
+     * Search users
+     */
+    async searchUsers(query, limit) {
+        return this.getUsers(query, limit);
+    }
+}
+exports.BiomeUsers = BiomeUsers;
+//# sourceMappingURL=user.service.js.map

package/dist/users/user.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.service.js","sourceRoot":"","sources":["../../src/users/user.service.ts"],"names":[],"mappings":"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"}

package/dist/utils/date.utils.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Date utilities for Biome platform
+ */
+/**
+ * Formats a date to ISO string
+ */
+export declare const toISOString: (date: Date) => string;
+/**
+ * Parses a date from various formats
+ */
+export declare const parseDate: (date: string | Date | null | undefined) => Date | null;
+/**
+ * Checks if a date is valid
+ */
+export declare const isValidDate: (date: unknown) => boolean;
+/**
+ * Gets the current date in ISO format
+ */
+export declare const getCurrentDate: () => string;
+/**
+ * Adds days to a date
+ */
+export declare const addDays: (date: Date, days: number) => Date;
+/**
+ * Subtracts days from a date
+ */
+export declare const subtractDays: (date: Date, days: number) => Date;
+/**
+ * Gets the difference in days between two dates
+ */
+export declare const getDaysDifference: (date1: Date, date2: Date) => number;
+/**
+ * Checks if a date is in the past
+ */
+export declare const isPast: (date: Date) => boolean;
+/**
+ * Checks if a date is in the future
+ */
+export declare const isFuture: (date: Date) => boolean;
+/**
+ * Checks if a date is today
+ */
+export declare const isToday: (date: Date) => boolean;
+/**
+ * Formats a date for display
+ */
+export declare const formatDate: (date: Date, locale?: string) => string;
+/**
+ * Formats a date and time for display
+ */
+export declare const formatDateTime: (date: Date, locale?: string) => string;
+/**
+ * Gets the start of the day
+ */
+export declare const getStartOfDay: (date: Date) => Date;
+/**
+ * Gets the end of the day
+ */
+export declare const getEndOfDay: (date: Date) => Date;
+//# sourceMappingURL=date.utils.d.ts.map

package/dist/utils/date.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.utils.d.ts","sourceRoot":"","sources":["../../src/utils/date.utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,IAAI,KAAG,MAExC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GAAI,MAAM,MAAM,GAAG,IAAI,GAAG,IAAI,GAAG,SAAS,KAAG,IAAI,GAAG,IASzE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,OAAO,KAAG,OAI3C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,QAAO,MAEjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,MAAM,IAAI,EAAE,MAAM,MAAM,KAAG,IAIlD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,MAAM,IAAI,EAAE,MAAM,MAAM,KAAG,IAEvD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,iBAAiB,GAAI,OAAO,IAAI,EAAE,OAAO,IAAI,KAAG,MAG5D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,MAAM,GAAI,MAAM,IAAI,KAAG,OAEnC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,QAAQ,GAAI,MAAM,IAAI,KAAG,OAErC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,MAAM,IAAI,KAAG,OAGpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,UAAU,GAAI,MAAM,IAAI,EAAE,eAAgB,KAAG,MAEzD,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,IAAI,EAAE,eAAgB,KAAG,MAE7D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,IAAI,KAAG,IAI1C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,GAAI,MAAM,IAAI,KAAG,IAIxC,CAAC"}

package/dist/utils/date.utils.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * Date utilities for Biome platform
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEndOfDay = exports.getStartOfDay = exports.formatDateTime = exports.formatDate = exports.isToday = exports.isFuture = exports.isPast = exports.getDaysDifference = exports.subtractDays = exports.addDays = exports.getCurrentDate = exports.isValidDate = exports.parseDate = exports.toISOString = void 0;
+/**
+ * Formats a date to ISO string
+ */
+const toISOString = (date) => {
+    return date.toISOString();
+};
+exports.toISOString = toISOString;
+/**
+ * Parses a date from various formats
+ */
+const parseDate = (date) => {
+    if (!date)
+        return null;
+    if (date instanceof Date)
+        return date;
+    try {
+        return new Date(date);
+    }
+    catch {
+        return null;
+    }
+};
+exports.parseDate = parseDate;
+/**
+ * Checks if a date is valid
+ */
+const isValidDate = (date) => {
+    if (!date)
+        return false;
+    const d = new Date(date);
+    return d instanceof Date && !isNaN(d.getTime());
+};
+exports.isValidDate = isValidDate;
+/**
+ * Gets the current date in ISO format
+ */
+const getCurrentDate = () => {
+    return new Date().toISOString();
+};
+exports.getCurrentDate = getCurrentDate;
+/**
+ * Adds days to a date
+ */
+const addDays = (date, days) => {
+    const result = new Date(date);
+    result.setDate(result.getDate() + days);
+    return result;
+};
+exports.addDays = addDays;
+/**
+ * Subtracts days from a date
+ */
+const subtractDays = (date, days) => {
+    return (0, exports.addDays)(date, -days);
+};
+exports.subtractDays = subtractDays;
+/**
+ * Gets the difference in days between two dates
+ */
+const getDaysDifference = (date1, date2) => {
+    const timeDiff = date2.getTime() - date1.getTime();
+    return Math.ceil(timeDiff / (1000 * 3600 * 24));
+};
+exports.getDaysDifference = getDaysDifference;
+/**
+ * Checks if a date is in the past
+ */
+const isPast = (date) => {
+    return date < new Date();
+};
+exports.isPast = isPast;
+/**
+ * Checks if a date is in the future
+ */
+const isFuture = (date) => {
+    return date > new Date();
+};
+exports.isFuture = isFuture;
+/**
+ * Checks if a date is today
+ */
+const isToday = (date) => {
+    const today = new Date();
+    return date.toDateString() === today.toDateString();
+};
+exports.isToday = isToday;
+/**
+ * Formats a date for display
+ */
+const formatDate = (date, locale = 'en-US') => {
+    return date.toLocaleDateString(locale);
+};
+exports.formatDate = formatDate;
+/**
+ * Formats a date and time for display
+ */
+const formatDateTime = (date, locale = 'en-US') => {
+    return date.toLocaleString(locale);
+};
+exports.formatDateTime = formatDateTime;
+/**
+ * Gets the start of the day
+ */
+const getStartOfDay = (date) => {
+    const result = new Date(date);
+    result.setHours(0, 0, 0, 0);
+    return result;
+};
+exports.getStartOfDay = getStartOfDay;
+/**
+ * Gets the end of the day
+ */
+const getEndOfDay = (date) => {
+    const result = new Date(date);
+    result.setHours(23, 59, 59, 999);
+    return result;
+};
+exports.getEndOfDay = getEndOfDay;
+//# sourceMappingURL=date.utils.js.map

package/dist/utils/date.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.utils.js","sourceRoot":"","sources":["../../src/utils/date.utils.ts"],"names":[],"mappings":"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"}

package/dist/utils/username-generator.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Creative Username Generator
+ *
+ * Generates unique, memorable usernames following the pattern:
+ * Adjective + Noun + Number (e.g., "BraveEagle2847", "SilverFox1923")
+ *
+ * This module is part of the SDK for reusability across frontend and backend.
+ *
+ * Features:
+ * - Generates creative, memorable usernames
+ * - Optional uniqueness checking with retry logic
+ * - Max 10 retry attempts if collision occurs
+ * - Returns predictable format: AdjNounNNNN
+ *
+ * @module username-generator
+ */
+/**
+ * Generate a creative username following the pattern: Adjective + Noun + Number
+ *
+ * @param checkUniqueness - Optional function to check if username is already taken.
+ *                          Should return Promise<true> if unique, Promise<false> if taken.
+ * @param maxAttempts - Maximum number of retry attempts if collision occurs (default: 10)
+ * @returns Promise<string> - A unique username following the pattern AdjNounNNNN
+ *
+ * @example
+ * ```typescript
+ * // Without uniqueness check
+ * const username = await generateCreativeUsername();
+ * console.log(username); // "BraveEagle2847"
+ *
+ * // With uniqueness check
+ * const username = await generateCreativeUsername(async (name) => {
+ *   const exists = await db.users.findOne({ username: name });
+ *   return !exists; // Return true if unique, false if taken
+ * });
+ * ```
+ *
+ * @throws {Error} If unable to generate unique username after maxAttempts
+ */
+export declare function generateCreativeUsername(checkUniqueness?: (username: string) => Promise<boolean>, maxAttempts?: number): Promise<string>;
+/**
+ * Generate multiple username suggestions
+ *
+ * @param count - Number of suggestions to generate (default: 3)
+ * @returns Promise<string[]> - Array of username suggestions
+ *
+ * @example
+ * ```typescript
+ * const suggestions = await generateUsernameSuggestions(5);
+ * console.log(suggestions);
+ * // ["BraveEagle2847", "SilverFox1923", "MightyTiger4567", "NobleWolf3892", "SwiftHawk7651"]
+ * ```
+ */
+export declare function generateUsernameSuggestions(count?: number): Promise<string[]>;
+/**
+ * Validate username format
+ *
+ * Checks if a username matches the expected pattern:
+ * - Starts with uppercase letter
+ * - Followed by lowercase letters
+ * - Followed by uppercase letter
+ * - Followed by lowercase letters
+ * - Ends with 4 digits
+ *
+ * @param username - The username to validate
+ * @returns true if username matches the generated format, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isValidGeneratedUsername('BraveEagle2847'); // true
+ * isValidGeneratedUsername('braveEagle2847'); // false (lowercase start)
+ * isValidGeneratedUsername('BraveEagle284');  // false (only 3 digits)
+ * ```
+ */
+export declare function isValidGeneratedUsername(username: string): boolean;
+//# sourceMappingURL=username-generator.d.ts.map

package/dist/utils/username-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"username-generator.d.ts","sourceRoot":"","sources":["../../src/utils/username-generator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAmDH;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAsB,wBAAwB,CAC1C,eAAe,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EACxD,WAAW,GAAE,MAAW,GACzB,OAAO,CAAC,MAAM,CAAC,CAqCjB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,2BAA2B,CAAC,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAkBtF;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAIlE"}