@lobb-js/lobb-ext-storage 0.8.3 → 0.8.4

package/dist/lib/components/foreignKeyComponent.svelte

@@ -0,0 +1,44 @@
+<script lang="ts">
+    import type { ExtensionProps } from "@lobb-js/studio";
+    import FileExplorer, { type Entry } from "./fileExplorer.svelte";
+    import FileIcon from "./fileIcon.svelte";
+
+    interface Props extends ExtensionProps {
+        value: Entry;
+    }
+
+	let { utils, value = $bindable(), ...props }: Props = $props();
+
+	const { FilePlus2 } = utils.components.Icons;
+	const { Drawer } = utils.components;
+
+    let openDrawer = $state(false);
+
+    function handleClick() {
+        openDrawer = true;
+    }
+
+    async function onHideHandle() {
+        openDrawer = false;
+    }
+
+    async function handleOnFileSelect(entry: Entry) {
+        value = entry;
+        openDrawer = false;
+    }
+</script>
+
+<button onclick={handleClick} class="flex flex-col items-center gap-2 w-full border p-4 rounded-md bg-muted/30">
+    {#if value}
+        <FileIcon entry={value} {utils} />
+    {:else}
+        <FilePlus2 class="text-muted-foreground" />
+        <div class="text-sm text-muted-foreground">Click to add an asset</div>
+    {/if}
+</button>
+
+{#if openDrawer}
+    <Drawer onHide={onHideHandle}>
+        <FileExplorer onFileSelect={handleOnFileSelect} utils={utils} {...props} />
+    </Drawer>
+{/if}

package/dist/lib/components/foreignKeyComponent.svelte.d.ts

@@ -0,0 +1,14 @@
+import { SvelteComponentTyped } from "svelte";
+declare const __propDef: {
+    props: Record<string, never>;
+    events: {
+        [evt: string]: CustomEvent<any>;
+    };
+    slots: {};
+};
+export type ForeignKeyComponentProps = typeof __propDef.props;
+export type ForeignKeyComponentEvents = typeof __propDef.events;
+export type ForeignKeyComponentSlots = typeof __propDef.slots;
+export default class ForeignKeyComponent extends SvelteComponentTyped<ForeignKeyComponentProps, ForeignKeyComponentEvents, ForeignKeyComponentSlots> {
+}
+export {};

package/dist/lib/components/pages/fileExplorerPage.svelte

@@ -0,0 +1,66 @@
+<script lang="ts">
+	import type { ExtensionProps } from "@lobb-js/studio";
+	
+	import { Sidebar, SidebarTrigger, Icons } from "@lobb-js/studio";
+  	import FileExplorer, { type Entry } from "../fileExplorer.svelte";
+	import path from "path-browserify"
+  	import { onMount } from "svelte";
+
+	const props: ExtensionProps = $props();
+	let { utils } = props;
+	const { location: routerLocation } = utils;
+	let sidebarData: any | null = $state(null);
+	let location: string = $state("/");
+
+	onMount(() => {
+		getSidebarData();
+		updateExplorerLocationFromRouter(routerLocation);
+	})
+
+	$effect(() => {
+		updateRouterLocationFromExplorer(location);
+	})
+
+	async function updateExplorerLocationFromRouter(localLocation: typeof routerLocation) {
+		const fileExplorerPath = localLocation.url.pathname.replace('/studio/extensions/storage/file_manager', '');
+		location = fileExplorerPath ? fileExplorerPath : "/";
+	}
+
+	async function updateRouterLocationFromExplorer(localLocation: string) {
+		const newPath = `/studio/extensions/storage/file_manager${localLocation}`;
+		if (routerLocation.url.pathname !== newPath) {
+			routerLocation.navigate(newPath);
+		}
+	}
+
+	async function getSidebarData() {
+		const response = await utils.lobb.findAll("storage_fs", {
+			filter: {
+				type: "directory",
+				is_pinned_sidebar: {
+					$eq: true,
+				},
+			},
+		});
+		const result = await response.json();
+		const entries = result.data;
+
+		sidebarData = entries.map((el: Entry): any => {
+			return {
+				name: el.name,
+				icon: Icons.Folder,
+				onclick: () => {
+					location = path.join(el.path, el.name);
+				}
+			};
+		});
+	}
+</script>
+
+<Sidebar title="Storage" data={sidebarData}>
+	<FileExplorer bind:location={location} {...props}>
+		{#snippet topLeftHeader()}
+			<SidebarTrigger />
+		{/snippet}
+	</FileExplorer>
+</Sidebar>

package/dist/lib/components/pages/fileExplorerPage.svelte.d.ts

@@ -0,0 +1,14 @@
+import { SvelteComponentTyped } from "svelte";
+declare const __propDef: {
+    props: Record<string, never>;
+    events: {
+        [evt: string]: CustomEvent<any>;
+    };
+    slots: {};
+};
+export type FileExplorerPageProps = typeof __propDef.props;
+export type FileExplorerPageEvents = typeof __propDef.events;
+export type FileExplorerPageSlots = typeof __propDef.slots;
+export default class FileExplorerPage extends SvelteComponentTyped<FileExplorerPageProps, FileExplorerPageEvents, FileExplorerPageSlots> {
+}
+export {};

package/dist/lib/index.js

@@ -0,0 +1,2 @@
+"use strict";
+// place files you want to import through the `$lib` alias in this folder.

package/dist/lib/utils.d.ts

@@ -0,0 +1,12 @@
+import { type ClassValue } from "clsx";
+export declare function cn(...inputs: ClassValue[]): string;
+export type WithoutChild<T> = T extends {
+    child?: any;
+} ? Omit<T, "child"> : T;
+export type WithoutChildren<T> = T extends {
+    children?: any;
+} ? Omit<T, "children"> : T;
+export type WithoutChildrenOrChild<T> = WithoutChildren<WithoutChild<T>>;
+export type WithElementRef<T, U extends HTMLElement = HTMLElement> = T & {
+    ref?: U | null;
+};

package/dist/lib/utils.js

@@ -0,0 +1,5 @@
+import { clsx } from "clsx";
+import { twMerge } from "tailwind-merge";
+export function cn(...inputs) {
+    return twMerge(clsx(inputs));
+}

package/dist/tests/fileManager.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/tests/fileManager.spec.js

@@ -0,0 +1,18 @@
+import { test, expect } from "@playwright/test";
+const FILE_MANAGER_URL = "/studio/extensions/storage/file_manager";
+test.describe("File Manager page", () => {
+    test.beforeEach(async ({ page }) => {
+        await page.goto(FILE_MANAGER_URL);
+    });
+    test("loads the file manager page", async ({ page }) => {
+        await expect(page).toHaveURL(new RegExp(FILE_MANAGER_URL));
+    });
+    test("shows the file manager nav link in the sidebar", async ({ page }) => {
+        await expect(page.locator(`a[href="${FILE_MANAGER_URL}"]`)).toBeVisible();
+    });
+    test("file manager page is accessible from the nav", async ({ page }) => {
+        await page.goto("/studio");
+        await page.locator(`a[href="${FILE_MANAGER_URL}"]`).click();
+        await expect(page).toHaveURL(new RegExp(FILE_MANAGER_URL));
+    });
+});

package/dist/tests/package.json

@@ -0,0 +1 @@
+{"type": "commonjs"}

package/dist/tests/playwright.config.cjs

@@ -0,0 +1,27 @@
+const { defineConfig, devices } = require("@playwright/test");
+
+module.exports = defineConfig({
+  testDir: __dirname,
+  testMatch: "**/*.spec.ts",
+  fullyParallel: true,
+  retries: 0,
+  expect: { timeout: 15000 },
+  use: {
+    baseURL: "http://localhost:3000",
+    trace: "on-first-retry",
+    headless: true,
+  },
+  projects: [
+    {
+      name: "chromium",
+      use: { ...devices["Desktop Chrome"] },
+    },
+  ],
+  // Automatically start the dev server before running tests
+  webServer: {
+    command: "bun run dev",
+    url: "http://localhost:3000/studio",
+    reuseExistingServer: true,
+    cwd: "../../../../", // packages/storage-ext root
+  },
+});

package/dist/tests/playwright.config.d.cts

@@ -0,0 +1,2 @@
+declare const _exports: import("@playwright/test").Config<import("@playwright/test").PlaywrightTestOptions & {}, import("@playwright/test").PlaywrightWorkerOptions & {}>;
+export = _exports;

package/package.json

@@ -1,11 +1,15 @@
 {
   "name": "@lobb-js/lobb-ext-storage",
-  "version": "0.8.3",
+  "version": "0.8.4",
   "license": "AGPL-3.0-only",
   "type": "module",
   "publishConfig": {
     "access": "public"
   },
+  "files": [
+    "extensions",
+    "dist"
+  ],
   "exports": {
     ".": "./extensions/storage/index.ts",
     "./studio": {
@@ -37,7 +41,7 @@
     "path-browserify": "^1.0.1"
   },
   "devDependencies": {
-    "@lobb-js/studio": "^0.7.2",
+    "@lobb-js/studio": "^0.7.3",
     "@lucide/svelte": "^0.563.1",
     "@playwright/test": "^1.58.2",
     "@sveltejs/adapter-node": "^5.5.4",

package/.vscode/settings.json

@@ -1,5 +0,0 @@
-{
-  "deno.disablePaths": [
-    "studio"
-  ]
-}

package/CHANGELOG.md

@@ -1,216 +0,0 @@
-# Changelog
-All notable changes to this project will be documented in this file. See [conventional commits](https://www.conventionalcommits.org/) for commit guidelines.
-
-- - -
-## storage-ext@0.8.3 - 2026-03-28
-#### Bug Fixes
-- update readme to trigger publish - (cf1e896) - malik ben
-- update READMEs to trigger republish of all packages - (2bd145d) - malik ben
-#### Miscellaneous Chores
-- remove dead storage-ext standalone GitHub Actions workflows - (578f982) - malik ben
-
-- - -
-
-## storage-ext@0.8.2 - 2026-03-28
-#### Bug Fixes
-- triggering the core package publish - (f0a8b54) - malik ben
-
-- - -
-
-## storage-ext@0.8.1 - 2026-03-28
-#### Bug Fixes
-- adding readme to all packages - (3a9264a) - malik ben
-#### Miscellaneous Chores
-- add publishConfig and fix ext packages for npm publishing - (49747e9) - malik ben
-
-- - -
-
-## storage-ext@0.8.0 - 2026-03-28
-#### Features
-- (**reports-ext,storage-ext**) convert studio from Svelte SPA to SvelteKit - (3cd7f63) - malik ben
-- (**storage-ext**) migrate packages/storage-ext from Deno to Bun - (a4e6bc6) - malik ben
-- replace hasDashboardExtension with virtual:lobb-studio-extensions module - (437cb2e) - malik ben
-#### Bug Fixes
-- add /studio subpath exports to ext packages, update studio pages to use them - (c0b9a82) - malik ben
-- untrack .svelte-kit from mindhar, fix process leak and $lib imports, update ai sdk versions - (017f784) - malik ben
-- chaning $lib to relative path - (c6d9e8f) - malik ben
-#### Miscellaneous Chores
-- (**storage-ext**) move extension logic and tests to extensions/storage, flatten studio, add Playwright tests - (a27a46d) - malik ben
-- (**version**) 0.25.2 - (a62acb9) - Cocogitto Bot
-- (**version**) 0.25.1 - (afe7e69) - Cocogitto Bot
-- (**version**) 0.25.0 - (77a383c) - Cocogitto Bot
-- (**version**) 0.24.0 - (a8cb605) - Cocogitto Bot
-- (**version**) 0.23.0 - (60f357e) - Cocogitto Bot
-- add dev:studio/build:studio scripts, fix Dockerfiles, remove --build flag - (1595975) - malik ben
-- migrate CI/CD from Deno/JSR to Bun/npm - (b4cc3bc) - malik ben
-- add prepublish/postpublish scripts to extension packages for standalone compatibility - (4d6108f) - malik ben
-- centralize studio app.css in @lobb-js/studio package, remove local copies - (05192dc) - malik ben
-- rename @lobb/ scope to @lobb-js/ across all packages and apps - (cce4ce0) - malik ben
-- add start/build scripts and gitignore build dir across all projects - (58f539d) - malik ben
-- update CLAUDE.md to enforce no-commit-without-explicit-instruction rule - (6d63a42) - malik ben
-- remove all deno.json and deno.lock files from the monorepo - (84ca5d4) - malik ben
-- replace workspace:* with exact versions in all package.json files - (74fbdb7) - malik ben
-- rename __studio to studio and remove unused studio dirs - (77fb932) - malik ben
-- rename studio directory to __studio for faker-ext, llm-ext, mail-ext, reports-ext, storage-ext - (47e754a) - malik ben
-
-- - -
-
-## storage-ext@0.7.1 - 2026-03-03
-#### Bug Fixes
-- (**storage-ext**) use ctx.lobb instead of Lobb.instance, add extra form data test - (27101f7) - malik ben
-- (**storage-ext**) fix tests to work from project root and fix foreignKeyObject persistence on file upload - (4b5bdd8) - malik ben
-#### Miscellaneous Chores
-- (**version**) 0.20.0 - (06cc303) - Cocogitto Bot
-
-- - -
-
-## storage-ext@0.7.0 - 2026-03-01
-#### Features
-- (**mindhar**) add storage extension integration - (bca6368) - malik ben
-#### Miscellaneous Chores
-- (**version**) 0.18.0 - (efc553f) - Cocogitto Bot
-- (**version**) 0.17.0 - (4174f0c) - Cocogitto Bot
-- (**version**) 0.16.0 - (9508655) - Cocogitto Bot
-- (**version**) 0.14.11 - (ad92b61) - Cocogitto Bot
-
-- - -
-
-## storage-ext@0.6.8 - 2026-02-25
-#### Bug Fixes
-- publishing the storage extension - (033ab43) - Malik Najjar
-#### Miscellaneous Chores
-- filling some logic in the chat compoenent and adding the force feature - (5cd0dc8) - Malik Najjar
-- fixing the deleteOne and deleteMany tests - (0e42622) - Malik Najjar
-- making the directories test pass - (4229229) - Malik Najjar
-- making the files tests pass - (f312a3a) - Malik Najjar
-- passing more tests - (93ee276) - Malik Najjar
-- adding a todo for the storage extension - (cb68710) - malik ben
-- implementing the store using the new nice way - (106b320) - Malik Najjar
-
-- - -
-
-## storage-ext@0.6.7 - 2026-02-23
-#### Bug Fixes
-- the core broke because of the override events - (f650f4c) - Malik Najjar
-#### Miscellaneous Chores
-- adding the ability to specify input and output types for the collectionServices methods - (72045f1) - Malik Najjar
-- adding neccessary override events and workflows for the storage extension - (f09698f) - Malik Najjar
-
-- - -
-
-## storage-ext@0.6.6 - 2026-02-23
-#### Bug Fixes
-- lobb crashing on missing event fix - (e0a9a75) - Malik Najjar
-
-- - -
-
-## storage-ext@0.6.5 - 2026-02-23
-#### Bug Fixes
-- lobb crashed because of this non existing event - (0aa47c9) - Malik Najjar
-
-- - -
-
-## storage-ext@0.6.4 - 2026-02-22
-#### Bug Fixes
-- coggito publishing packages order fix - (573c75e) - malik ben
-
-- - -
-
-## storage-ext@0.6.3 - 2026-02-22
-#### Bug Fixes
-- adjusted the names of the events - (6543d8c) - malik ben
-
-- - -
-
-## storage-ext@0.6.2 - 2026-02-22
-#### Bug Fixes
-- made the collectionService become an property in the main lobb object - (146e4cb) - malik ben
-
-- - -
-
-## storage-ext@0.6.1 - 2026-02-21
-#### Bug Fixes
-- using default export instead of named export for extensions - (37dd485) - malik ben
-#### Miscellaneous Chores
-- (**version**) 0.13.2 - (39b0145) - Cocogitto Bot
-- (**version**) 0.12.3 - (cd06fc0) - Cocogitto Bot
-- (**version**) 0.12.2 - (35b2ff3) - Cocogitto Bot
-- (**version**) 0.12.1 - (c548105) - Cocogitto Bot
-- (**version**) 0.11.1 - (659ebd3) - Cocogitto Bot
-- adding a comment - (c5c603b) - Malik Najjar
-
-- - -
-
-## storage-ext@0.6.0 - 2026-02-17
-#### Features
-- implement event overrides for collection creation and update workflows - (8a05d74) - Malik Najjar
-
-- - -
-
-## storage-ext@0.5.3 - 2026-02-17
-#### Bug Fixes
-- fixing the publishing issue - (f4d1641) - Malik Najjar
-
-- - -
-
-## storage-ext@0.5.2 - 2026-02-17
-#### Bug Fixes
-- publishing the storage studio - (d7dd43e) - Malik Najjar
-#### Miscellaneous Chores
-- (**version**) 0.10.2 - (2c92a7d) - Cocogitto Bot
-
-- - -
-
-## storage-ext@0.5.1 - 2026-02-17
-#### Bug Fixes
-- fixing the storage publish issue - (b75d8d1) - Malik Najjar
-
-- - -
-
-## storage-ext@0.5.0 - 2026-02-17
-#### Features
-- implement storage workflows and controllers for file management - (b9efd0f) - Malik Najjar
-#### Bug Fixes
-- update the auth extension - (5318dda) - Malik Najjar
-#### Miscellaneous Chores
-- added important todo to the storage extension - (43d0bec) - Malik Najjar
-- seperating types from the services file - (8c7bdce) - Malik Najjar
-
-- - -
-
-## storage-ext@0.4.0 - 2026-02-16
-#### Features
-- adding the ability to upload files in the ui - (1d7b346) - Malik Najjar
-- update event name in storage workflow and enhance Instagram webhook file handling - (a0cb186) - Malik Najjar
-
-- - -
-
-## storage-ext@0.3.0 - 2026-02-16
-#### Features
-- enhance storage services with URL file creation and path validation - (1a33fa6) - Malik Najjar
-
-- - -
-
-## storage-ext@0.2.0 - 2026-02-16
-#### Features
-- implement storage adapter and services, refactor workflows - (abd9ee5) - Malik Najjar
-
-- - -
-
-## storage-ext@0.1.29 - 2026-02-15
-#### Bug Fixes
-- fix deno publish issue - (e8dcc4f) - malik ben
-- issue fix - (63d66d3) - malik ben
-#### Miscellaneous Chores
-- (**version**) 0.5.5 - (d4dedeb) - Cocogitto Bot
-- (**version**) 0.5.4 - (1ca3970) - Cocogitto Bot
-- (**version**) 0.5.3 - (dcdb9cb) - Cocogitto Bot
-- (**version**) 0.5.2 - (aa66e29) - Cocogitto Bot
-- (**version**) 0.5.1 - (41b7c35) - Cocogitto Bot
-- (**version**) 0.5.0 - (af63147) - Cocogitto Bot
-- (**version**) 0.4.4 - (eaed3b4) - Cocogitto Bot
-- (**version**) 0.4.3 - (ea9ec49) - Cocogitto Bot
-
-- - -
-
-Changelog generated by [cocogitto](https://github.com/cocogitto/cocogitto).

package/lobb.ts

@@ -1,54 +0,0 @@
-import { Lobb } from "@lobb-js/core";
-import { storage } from "./extensions/storage/index.ts";
-
-Lobb.init({
-  project: {
-    name: "Storage Extension Test",
-    force_sync: true,
-  },
-  database: {
-    host: Bun.env.DATABASE_HOST ?? "localhost",
-    port: Number(Bun.env.DATABASE_PORT ?? 5432),
-    username: Bun.env.DATABASE_USER ?? "test",
-    password: Bun.env.DATABASE_PASSWORD ?? "test",
-    database: Bun.env.DATABASE_NAME ?? "storage_ext",
-  },
-  web_server: {
-    host: Bun.env.WEB_SERVER_HOST ?? "0.0.0.0",
-    port: Number(Bun.env.WEB_SERVER_PORT ?? 3000),
-    cors: {
-      origin: "*",
-    },
-  },
-  extensions: [
-    storage({
-      adapter: "local",
-      storagePath: "./storage",
-    }),
-  ],
-  collections: {
-    articles: {
-      indexes: {},
-      fields: {
-        id: {
-          type: "integer",
-        },
-        image: {
-          type: "string",
-          length: 255,
-        },
-        title: {
-          type: "string",
-          length: 255,
-          validators: {
-            required: true,
-          },
-        },
-        body: {
-          type: "string",
-          length: 255,
-        },
-      },
-    },
-  },
-});

package/scripts/postpublish.sh

@@ -1,12 +0,0 @@
-#!/bin/bash
-
-# Postpublish script for @lobb-js/lobb-ext-storage
-# Reverts package.json exports and cleans dist to avoid uncommitted changes
-
-echo "📝 Reverting package.json exports to development mode..."
-jq '."exports"["./studio"] = "./extensions/storage/studio/index.ts"' package.json > package.json.tmp && mv package.json.tmp package.json
-
-echo "🧹 Cleaning dist directory..."
-rm -rf dist
-
-echo "✅ Postpublish complete"

package/scripts/prepublish.sh

@@ -1,17 +0,0 @@
-#!/bin/bash
-
-# Prepublish script for @lobb-js/lobb-ext-storage
-# Builds the studio package and updates exports for publishing
-
-echo "📦 Building studio package..."
-bun run package
-
-if [ $? -ne 0 ]; then
-    echo "❌ Build failed"
-    exit 1
-fi
-
-echo "📝 Updating package.json exports for publishing..."
-jq '."exports"["./studio"] = {"svelte": "./dist/index.js", "types": "./dist/index.d.ts"}' package.json > package.json.tmp && mv package.json.tmp package.json
-
-echo "✅ Prepublish complete"

package/studio/app.html

@@ -1,12 +0,0 @@
-<!doctype html>
-<html lang="en">
-	<head>
-		<meta charset="utf-8" />
-		<link rel="icon" href="%sveltekit.assets%/vite.svg" />
-		<meta name="viewport" content="width=device-width, initial-scale=1" />
-		%sveltekit.head%
-	</head>
-	<body data-sveltekit-preload-data="hover">
-		<div style="display: contents">%sveltekit.body%</div>
-	</body>
-</html>

package/studio/routes/+layout.svelte

@@ -1,7 +0,0 @@
-<script lang="ts">
-	import "@lobb-js/studio/app.css";
-
-	let { children } = $props();
-</script>
-
-{@render children()}

package/studio/routes/+layout.ts

@@ -1 +0,0 @@
-export const ssr = false;

package/studio/routes/[...path]/+page.svelte

@@ -1,6 +0,0 @@
-<script lang="ts">
-	import { Studio } from "@lobb-js/studio";
-	import { env } from "$env/dynamic/public";
-</script>
-
-<Studio lobbUrl={env.PUBLIC_LOBB_URL} />

package/svelte.config.js

@@ -1,24 +0,0 @@
-import adapter from '@sveltejs/adapter-node';
-
-/** @type {import('@sveltejs/kit').Config} */
-const config = {
-	kit: {
-		adapter: adapter(),
-		paths: {
-			base: '/studio'
-		},
-		files: {
-			lib: 'studio/lib',
-			routes: 'studio/routes',
-			appTemplate: 'studio/app.html',
-			assets: 'public',
-			hooks: {
-				server: 'studio/hooks.server',
-				client: 'studio/hooks.client',
-			},
-			params: 'studio/params',
-		}
-	}
-};
-
-export default config;

package/todo.md

@@ -1,36 +0,0 @@
-# high priority
-
-- move the validation logic that checks if the directory of uploaded file path exists or not in the service level and not in the controller level.
-
-- a better way to implement this extension is to update or overright the collectionService. so that you can use the same exsting CollectionService class normally but with the ability to adjust the params of that service funciton. so the storage extension version of the normal collection overright will have different params set. for example it should have a param of type blob or File. so you shouldnt really expose services. in the mod.ts. the services already exists why expose. we shouldnt really have at all the services property
-  - remove services from this extension and from everywhere
-  - instead of creating your own service method. you can just overwrite or update the existing method
-    - for example to upload a file you can just use the collectionService mutated create version instead of creating your own function
-  - you need to also overwrite the controllers to call the new service function correctly
-  - this way is much better from exposing a bunch of service functions and more consistant
-  - you should use workflows to overwrite the controllers and the services
-  - make sure the tests work correctly
-  - remove totally the services from this extension and from the extensionSystem totally
-  - go to the `social_to_courier` and fix the storage update part.
-
-- remove the unique index of (location, name)
-- implement uploading a file by drag and drop
-- implement the listview
-
-# low priority
-
-- you need to add a refresh button
-- when the user tries to upload a file or a directory in a non existing.
-  directory you have to respond with a 400 Error
-- check if a file exists by sending a GET request instead of reading the
-  directory. because thats a unit test specific to local adapter. but the first
-  way would work in all kinds of adapters. and it will make the unit tests more
-  adaptable
-- prevent the user from not adding a / at the beggining of the path or adding a
-  / at the end of the path when inserting or updating a storage record and make
-  sure the path is not empty
-- implement a validation mechanism at the instatiating of the storage extension
-  that checks of all operations are successfully doable in that specific adapter
-  without issues. (really important)
-- Allow multiple versions of a file to be stored, enabling users to access
-  previous versions if needed.