@progalaxyelabs/ngx-stonescriptphp-client 1.5.0 → 1.6.0

package/fesm2022/progalaxyelabs-ngx-stonescriptphp-client.mjs

@@ -196,6 +196,12 @@ class MyEnvironmentModel {
     };
     apiServer = { host: '' };
     chatServer = { host: '' };
+    /**
+     * Files service server configuration
+     * Used by FilesService for file upload/download operations
+     * @example { host: 'https://files.progalaxyelabs.com/api/' }
+     */
+    filesServer;
     /**
      * Authentication configuration
      * @default { mode: 'cookie', refreshEndpoint: '/auth/refresh', useCsrf: true }
@@ -1492,6 +1498,270 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.15", ngImpo
                 }]
         }], ctorParameters: () => [] });
 
+/**
+ * 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.
+ */
+class FilesService {
+    tokens;
+    signinStatus;
+    environment;
+    csrf;
+    host = '';
+    apiHost = '';
+    authConfig;
+    constructor(tokens, signinStatus, environment, csrf) {
+        this.tokens = tokens;
+        this.signinStatus = signinStatus;
+        this.environment = environment;
+        this.csrf = csrf;
+        this.host = environment.filesServer?.host || '';
+        this.apiHost = environment.apiServer.host;
+        this.authConfig = {
+            mode: environment.auth?.mode || 'cookie',
+            refreshEndpoint: environment.auth?.refreshEndpoint,
+            useCsrf: environment.auth?.useCsrf,
+            refreshTokenCookieName: environment.auth?.refreshTokenCookieName || 'refresh_token',
+            csrfTokenCookieName: environment.auth?.csrfTokenCookieName || 'csrf_token',
+            csrfHeaderName: environment.auth?.csrfHeaderName || 'X-CSRF-Token'
+        };
+        if (!this.authConfig.refreshEndpoint) {
+            this.authConfig.refreshEndpoint = this.authConfig.mode === 'cookie'
+                ? '/auth/refresh'
+                : '/user/refresh_access';
+        }
+        if (this.authConfig.useCsrf === undefined) {
+            this.authConfig.useCsrf = this.authConfig.mode === 'cookie';
+        }
+    }
+    /**
+     * Check if the files server is configured.
+     */
+    isConfigured() {
+        return !!this.host;
+    }
+    /**
+     * 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
+     */
+    async upload(file, entityType, entityId) {
+        const formData = new FormData();
+        formData.append('file', file);
+        if (entityType) {
+            formData.append('entityType', entityType);
+        }
+        if (entityId) {
+            formData.append('entityId', entityId);
+        }
+        const url = this.host + 'upload';
+        const options = {
+            method: 'POST',
+            mode: 'cors',
+            redirect: 'error',
+            body: formData
+            // No Content-Type header — browser sets multipart boundary automatically
+        };
+        const response = await this.requestWithRetry(url, options);
+        return response.file;
+    }
+    /**
+     * 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
+     */
+    async download(fileId) {
+        const url = this.host + 'files/' + fileId;
+        const options = {
+            method: 'GET',
+            mode: 'cors',
+            redirect: 'error'
+        };
+        this.includeAccessToken(options);
+        let response = await fetch(url, options);
+        if (response.status === 401) {
+            const refreshed = await this.refreshAccessToken();
+            if (refreshed) {
+                this.includeAccessToken(options);
+                response = await fetch(url, options);
+            }
+        }
+        if (response.status === 401) {
+            this.signinStatus.signedOut();
+        }
+        if (!response.ok) {
+            throw new Error(`Download failed: ${response.status} ${response.statusText}`);
+        }
+        return response.blob();
+    }
+    /**
+     * List all files for the current user.
+     *
+     * @returns Promise resolving to array of file metadata
+     */
+    async list() {
+        const url = this.host + 'files';
+        const options = {
+            method: 'GET',
+            mode: 'cors',
+            redirect: 'error'
+        };
+        const response = await this.requestWithRetry(url, options);
+        return response.files;
+    }
+    /**
+     * Delete a file from the files service.
+     *
+     * @param fileId UUID of the file to delete
+     * @returns Promise resolving to true on success
+     */
+    async delete(fileId) {
+        const url = this.host + 'files/' + fileId;
+        const options = {
+            method: 'DELETE',
+            mode: 'cors',
+            redirect: 'error'
+        };
+        const response = await this.requestWithRetry(url, options);
+        return response.success;
+    }
+    /**
+     * Make a request with automatic Bearer token injection and 401 retry.
+     */
+    async requestWithRetry(url, options) {
+        this.includeAccessToken(options);
+        let response = await fetch(url, options);
+        if (response.status === 401) {
+            const refreshed = await this.refreshAccessToken();
+            if (refreshed) {
+                this.includeAccessToken(options);
+                response = await fetch(url, options);
+            }
+        }
+        if (response.status === 401) {
+            this.signinStatus.signedOut();
+        }
+        if (!response.ok) {
+            const body = await response.json().catch(() => ({}));
+            throw new Error(body.message || `Request failed: ${response.status}`);
+        }
+        return response.json();
+    }
+    includeAccessToken(options) {
+        const accessToken = this.tokens.getAccessToken();
+        if (!accessToken)
+            return;
+        if (!options.headers) {
+            options.headers = {};
+        }
+        options.headers['Authorization'] = 'Bearer ' + accessToken;
+    }
+    async refreshAccessToken() {
+        if (this.authConfig.mode === 'none') {
+            return false;
+        }
+        if (this.authConfig.mode === 'cookie') {
+            return this.refreshAccessTokenCookieMode();
+        }
+        else {
+            return this.refreshAccessTokenBodyMode();
+        }
+    }
+    async refreshAccessTokenCookieMode() {
+        try {
+            const refreshTokenUrl = this.apiHost + this.authConfig.refreshEndpoint.replace(/^\/+/, '');
+            const headers = {
+                'Content-Type': 'application/json'
+            };
+            if (this.authConfig.useCsrf) {
+                const csrfToken = this.csrf.getCsrfToken(this.authConfig.csrfTokenCookieName);
+                if (!csrfToken) {
+                    return false;
+                }
+                headers[this.authConfig.csrfHeaderName] = csrfToken;
+            }
+            const response = await fetch(refreshTokenUrl, {
+                method: 'POST',
+                mode: 'cors',
+                credentials: 'include',
+                redirect: 'error',
+                headers
+            });
+            if (!response.ok) {
+                this.tokens.clear();
+                return false;
+            }
+            const data = await response.json();
+            if (!data || data.status !== 'ok') {
+                return false;
+            }
+            const newAccessToken = data.data?.access_token || data.access_token;
+            if (!newAccessToken) {
+                return false;
+            }
+            this.tokens.setAccessToken(newAccessToken);
+            return true;
+        }
+        catch {
+            this.tokens.clear();
+            return false;
+        }
+    }
+    async refreshAccessTokenBodyMode() {
+        try {
+            const refreshToken = this.tokens.getRefreshToken();
+            if (!refreshToken) {
+                return false;
+            }
+            const accessToken = this.tokens.getAccessToken();
+            const refreshTokenUrl = this.apiHost + this.authConfig.refreshEndpoint.replace(/^\/+/, '');
+            const response = await fetch(refreshTokenUrl, {
+                method: 'POST',
+                mode: 'cors',
+                redirect: 'error',
+                headers: { 'Content-Type': 'application/json' },
+                body: JSON.stringify({
+                    access_token: accessToken,
+                    refresh_token: refreshToken
+                })
+            });
+            if (!response.ok) {
+                this.tokens.clear();
+                return false;
+            }
+            const data = await response.json();
+            if (!data) {
+                return false;
+            }
+            const newAccessToken = data.data?.access_token || data.access_token;
+            if (!newAccessToken) {
+                return false;
+            }
+            this.tokens.setTokens(newAccessToken, refreshToken);
+            return true;
+        }
+        catch {
+            this.tokens.clear();
+            return false;
+        }
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "20.3.15", ngImport: i0, type: FilesService, deps: [{ token: TokenService }, { token: SigninStatusService }, { token: MyEnvironmentModel }, { token: CsrfService }], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "20.3.15", ngImport: i0, type: FilesService, providedIn: 'root' });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.15", ngImport: i0, type: FilesService, decorators: [{
+            type: Injectable,
+            args: [{
+                    providedIn: 'root'
+                }]
+        }], ctorParameters: () => [{ type: TokenService }, { type: SigninStatusService }, { type: MyEnvironmentModel }, { type: CsrfService }] });
+
 class NgxStoneScriptPhpClientModule {
     static forRoot(environment) {
         return {
@@ -3779,5 +4049,5 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "20.3.15", ngImpo
  * Generated bundle index. Do not edit.
  */
 
-export { ApiConnectionService, ApiResponse, AuthPageComponent, AuthService, CsrfService, DbService, LoginDialogComponent, MyEnvironmentModel, NgxStoneScriptPhpClientModule, RegisterComponent, SigninStatusService, TenantLoginComponent, TenantLoginDialogComponent, TenantRegisterComponent, TenantRegisterDialogComponent, TokenService, VerifyStatus };
+export { ApiConnectionService, ApiResponse, AuthPageComponent, AuthService, CsrfService, DbService, FilesService, LoginDialogComponent, MyEnvironmentModel, NgxStoneScriptPhpClientModule, RegisterComponent, SigninStatusService, TenantLoginComponent, TenantLoginDialogComponent, TenantRegisterComponent, TenantRegisterDialogComponent, TokenService, VerifyStatus };
 //# sourceMappingURL=progalaxyelabs-ngx-stonescriptphp-client.mjs.map