feat(storage-client, server): touch method

core/storage-client/src/storage-client.ts

@@ -181,7 +181,7 @@ export class AlwatrStorageClient<DocumentType extends AlwatrDocumentObject = Alw
       documentObject: T,
       storage: string | undefined = this.config.name,
   ): Promise<T> {
-    this._logger.logMethodArgs?.('set', {documentId: documentObject.id});
+    this._logger.logMethodArgs?.('set', {storage, documentId: documentObject.id});
     if (storage == null) throw new Error('storage_not_defined');
 
     const responseJson = await serviceRequest<AlwatrServiceResponseSuccessWithMeta<T>>({
@@ -201,6 +201,29 @@ export class AlwatrStorageClient<DocumentType extends AlwatrDocumentObject = Alw
     return responseJson.data;
   }
 
+  /**
+   * Touch the storage to make sure storage file exist.
+   *
+   * Example:
+   *
+   * ```ts
+   * await userStorage.touch();
+   * ```
+   */
+  async touch(storage: string | undefined = this.config.name): Promise<void> {
+    this._logger.logMethodArgs?.('touch', {storage});
+    if (storage == null) throw new Error('storage_not_defined');
+
+    await serviceRequest({
+      ...this.fetchOption,
+      method: 'GET',
+      url: this.fetchOption.url + 'touch',
+      queryParameters: {
+        storage,
+      },
+    });
+  }
+
   /**
    * Delete a document object from the storage.
    *
@@ -236,7 +259,7 @@ export class AlwatrStorageClient<DocumentType extends AlwatrDocumentObject = Alw
   async getStorage<T extends DocumentType = DocumentType>(
       name: string | undefined = this.config.name,
   ): Promise<AlwatrDocumentStorage<T>> {
-    this._logger.logMethod?.('getStorage');
+    this._logger.logMethodArgs?.('getStorage', {name});
     if (name == null) throw new Error('storage_not_defined');
 
     const responseJson = (await serviceRequest({
@@ -269,7 +292,7 @@ export class AlwatrStorageClient<DocumentType extends AlwatrDocumentObject = Alw
    * ```
    */
   async keys(storage: string | undefined = this.config.name): Promise<Array<string>> {
-    this._logger.logMethod?.('keys');
+    this._logger.logMethodArgs?.('keys', {storage});
     if (storage == null) throw new Error('storage_not_defined');
 
     const responseJson = await serviceRequest({

core/storage-engine/src/storage-engine.ts

@@ -172,6 +172,7 @@ export class AlwatrStorageEngine<DocumentType extends AlwatrDocumentObject = Alw
       this._logger.incident?.('load', 'file_not_found', 'Storage path not found, empty storage loaded', {
         path: this.storagePath,
       });
+      this.save();
       return this._newStorage;
     }
 

services/storage-server/src/route/touch.ts

@@ -0,0 +1,18 @@
+import {config, logger} from '../config.js';
+import {nanoServer} from '../lib/nano-server.js';
+import {storageProvider} from '../lib/storage-provider.js';
+
+nanoServer.route('GET', '/touch', (connection) => {
+  logger.logMethod?.('touch');
+
+  connection.requireToken(config.nanoServer.accessToken);
+
+  const params = connection.requireQueryParams<{storage: string; id: string}>({storage: 'string', id: 'string'});
+
+  storageProvider.get({name: params.storage});
+
+  return {
+    ok: true,
+    data: {},
+  };
+});