@progalaxyelabs/ngx-stonescriptphp-client 1.5.0 → 1.6.0

package/index.d.ts

@@ -150,6 +150,14 @@ declare class MyEnvironmentModel {
     chatServer: {
         host: string;
     };
+    /**
+     * Files service server configuration
+     * Used by FilesService for file upload/download operations
+     * @example { host: 'https://files.progalaxyelabs.com/api/' }
+     */
+    filesServer?: {
+        host: string;
+    };
     /**
      * Authentication configuration
      * @default { mode: 'cookie', refreshEndpoint: '/auth/refresh', useCsrf: true }
@@ -243,12 +251,12 @@ declare class ApiConnectionService {
 
 type AuthProvider = 'google' | 'linkedin' | 'apple' | 'microsoft' | 'github' | 'zoho' | 'emailPassword';
 interface User {
-    user_id?: number;
-    id?: string;
+    user_id: number;
+    id: string;
     email: string;
-    display_name?: string;
+    display_name: string;
     photo_url?: string;
-    is_email_verified?: boolean;
+    is_email_verified: boolean;
 }
 interface AuthResult {
     success: boolean;
@@ -546,6 +554,122 @@ declare class DbService {
     static ɵprov: i0.ɵɵInjectableDeclaration<DbService>;
 }
 
+/**
+ * Result of a file upload operation
+ */
+interface FileUploadResult {
+    /** Unique file identifier (UUID) */
+    id: string;
+    /** Original file name */
+    name: string;
+    /** MIME content type */
+    contentType: string;
+    /** File size in bytes */
+    size: number;
+    /** ISO timestamp of upload */
+    uploadedAt: string;
+    /** Tenant ID (present when tenant-scoped) */
+    tenantId?: string;
+}
+/**
+ * File metadata as returned by the list endpoint
+ */
+interface FileMetadata {
+    /** Unique file identifier (UUID) */
+    fileId: string;
+    /** Original file name */
+    fileName: string;
+    /** MIME content type */
+    contentType: string;
+    /** File size in bytes */
+    size: number;
+    /** ISO timestamp of upload */
+    uploadedAt: string;
+}
+/**
+ * Response from the file list endpoint
+ */
+interface FileListResponse {
+    success: boolean;
+    count: number;
+    files: FileMetadata[];
+}
+/**
+ * Response from the file upload endpoint
+ */
+interface FileUploadResponse {
+    success: boolean;
+    file: FileUploadResult;
+}
+/**
+ * Response from the file delete endpoint
+ */
+interface FileDeleteResponse {
+    success: boolean;
+    message: string;
+}
+
+/**
+ * Service for interacting with the stonescriptphp-files server.
+ * Handles file upload, download, list, and delete operations
+ * with automatic Bearer token injection and 401 refresh handling.
+ */
+declare class FilesService {
+    private tokens;
+    private signinStatus;
+    private environment;
+    private csrf;
+    private host;
+    private apiHost;
+    private authConfig;
+    constructor(tokens: TokenService, signinStatus: SigninStatusService, environment: MyEnvironmentModel, csrf: CsrfService);
+    /**
+     * Check if the files server is configured.
+     */
+    isConfigured(): boolean;
+    /**
+     * Upload a file to the files service.
+     * Uses FormData — does NOT set Content-Type header (browser sets multipart boundary).
+     *
+     * @param file The File object to upload
+     * @param entityType Optional entity type for server-side reference linking
+     * @param entityId Optional entity ID for server-side reference linking
+     * @returns Promise resolving to the upload result
+     */
+    upload(file: File, entityType?: string, entityId?: string): Promise<FileUploadResult>;
+    /**
+     * Download a file from the files service.
+     * Returns a Blob suitable for URL.createObjectURL().
+     *
+     * @param fileId UUID of the file to download
+     * @returns Promise resolving to the file Blob
+     */
+    download(fileId: string): Promise<Blob>;
+    /**
+     * List all files for the current user.
+     *
+     * @returns Promise resolving to array of file metadata
+     */
+    list(): Promise<FileMetadata[]>;
+    /**
+     * Delete a file from the files service.
+     *
+     * @param fileId UUID of the file to delete
+     * @returns Promise resolving to true on success
+     */
+    delete(fileId: string): Promise<boolean>;
+    /**
+     * Make a request with automatic Bearer token injection and 401 retry.
+     */
+    private requestWithRetry;
+    private includeAccessToken;
+    private refreshAccessToken;
+    private refreshAccessTokenCookieMode;
+    private refreshAccessTokenBodyMode;
+    static ɵfac: i0.ɵɵFactoryDeclaration<FilesService, never>;
+    static ɵprov: i0.ɵɵInjectableDeclaration<FilesService>;
+}
+
 declare class NgxStoneScriptPhpClientModule {
     static forRoot(environment: MyEnvironmentModel): ModuleWithProviders<NgxStoneScriptPhpClientModule>;
     static ɵfac: i0.ɵɵFactoryDeclaration<NgxStoneScriptPhpClientModule, never>;
@@ -826,5 +950,5 @@ declare class TenantRegisterDialogComponent {
     static ɵcmp: i0.ɵɵComponentDeclaration<TenantRegisterDialogComponent, "lib-tenant-register-dialog", never, {}, {}, never, never, true, never>;
 }
 
-export { ApiConnectionService, ApiResponse, AuthPageComponent, AuthService, CsrfService, DbService, LoginDialogComponent, MyEnvironmentModel, NgxStoneScriptPhpClientModule, RegisterComponent, SigninStatusService, TenantLoginComponent, TenantLoginDialogComponent, TenantRegisterComponent, TenantRegisterDialogComponent, TokenService, VerifyStatus };
-export type { AuthConfig, AuthMode, AuthProvider, AuthResult, AuthServerConfig, TenantCreatedEvent, TenantMembership, TenantSelectedEvent, User };
+export { ApiConnectionService, ApiResponse, AuthPageComponent, AuthService, CsrfService, DbService, FilesService, LoginDialogComponent, MyEnvironmentModel, NgxStoneScriptPhpClientModule, RegisterComponent, SigninStatusService, TenantLoginComponent, TenantLoginDialogComponent, TenantRegisterComponent, TenantRegisterDialogComponent, TokenService, VerifyStatus };
+export type { AuthConfig, AuthMode, AuthProvider, AuthResult, AuthServerConfig, FileDeleteResponse, FileListResponse, FileMetadata, FileUploadResponse, FileUploadResult, TenantCreatedEvent, TenantMembership, TenantSelectedEvent, User };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@progalaxyelabs/ngx-stonescriptphp-client",
-  "version": "1.5.0",
+  "version": "1.6.0",
   "description": "Angular client library for StoneScriptPHP backend framework",
   "keywords": [
     "angular",