@lobb-js/lobb-ext-storage 0.5.8 → 0.8.1

package/.github/workflows/create_tag_on_version_change.yaml

@@ -0,0 +1,45 @@
+name: Create Tag on Version Change
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  check-version-and-tag:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+    outputs:
+      current_version: ${{ steps.current_version.outputs.current_version }}
+      previous_version: ${{ steps.previous_version.outputs.previous_version }}
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - name: Get previous version
+        id: previous_version
+        run: |
+          PREV_VERSION=$(git show HEAD^:package.json | jq -r .version || echo "none")
+          echo "previous_version=$PREV_VERSION" >> "$GITHUB_OUTPUT"
+
+      - name: Get current version
+        id: current_version
+        run: |
+          CURR_VERSION=$(jq -r .version package.json)
+          echo "current_version=$CURR_VERSION" >> "$GITHUB_OUTPUT"
+
+      - name: Create tag
+        if: steps.previous_version.outputs.previous_version != steps.current_version.outputs.current_version
+        uses: rickstaa/action-create-tag@v1
+        with:
+          tag: "${{ steps.current_version.outputs.current_version }}"
+
+  publish-to-npm:
+    name: Publish to npm
+    needs: check-version-and-tag
+    if: needs.check-version-and-tag.outputs.previous_version != needs.check-version-and-tag.outputs.current_version
+    uses: maliknajjar/lobb_storage_ext/.github/workflows/publish_npm_package.yaml@main
+    secrets: inherit

package/.github/workflows/publish_npm_package.yaml

@@ -0,0 +1,28 @@
+name: publish package to npm
+
+on:
+  workflow_call:
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '24'
+          registry-url: 'https://registry.npmjs.org'
+      - name: Setup Bun
+        uses: oven-sh/setup-bun@v2
+      - name: Install jq
+        run: sudo apt-get update && sudo apt-get install -y jq
+      - name: Install dependencies
+        run: bun install
+      - name: Publish to npm
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

package/.vscode/settings.json

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

package/CHANGELOG.md

@@ -2,78 +2,199 @@
 All notable changes to this project will be documented in this file. See [conventional commits](https://www.conventionalcommits.org/) for commit guidelines.
 
 - - -
-## storage-ext-studio@0.5.8 - 2026-03-03
+## 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.22.0 - (6510e32) - Cocogitto Bot
-- (**version**) 0.21.0 - (c973aa9) - Cocogitto Bot
+- (**version**) 0.20.0 - (06cc303) - Cocogitto Bot
 
 - - -
 
-## storage-ext-studio@0.5.7 - 2026-03-01
+## 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
-- (**studio**) prevent @lobb-js/studio version shadowing in extensions - (cd674b9) - malik ben
+- publishing the storage extension - (033ab43) - Malik Najjar
 #### Miscellaneous Chores
-- (**version**) 0.15.0 - (0c2c345) - Cocogitto Bot
-- fixing the /studio base issue - (de6686f) - Malik Najjar
+- 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-studio@0.5.6 - 2026-02-22
+## storage-ext@0.6.7 - 2026-02-23
 #### Bug Fixes
-- adding a studio prefix for the studio app - (6607b5a) - malik ben
+- the core broke because of the override events - (f650f4c) - Malik Najjar
 #### Miscellaneous Chores
-- (**version**) 0.14.2 - (6ecdc1d) - Cocogitto Bot
+- 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-studio@0.5.5 - 2026-02-21
+## 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.14.0 - (7d2eb87) - Cocogitto Bot
+- (**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-studio@0.5.4 - 2026-02-17
+## storage-ext@0.5.3 - 2026-02-17
 #### Bug Fixes
-- fixing the standalone issue - (1a70a51) - Malik Najjar
+- 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.9 - (19ac765) - Cocogitto Bot
+- (**version**) 0.10.2 - (2c92a7d) - Cocogitto Bot
 
 - - -
 
-## storage-ext-studio@0.1.29 - 2026-02-17
+## storage-ext@0.5.1 - 2026-02-17
 #### Bug Fixes
-- fixing the publishing issue - (f4d1641) - Malik Najjar
+- fixing the storage publish issue - (b75d8d1) - Malik Najjar
 
 - - -
 
-## storage-ext-studio@0.0.1 - 2026-02-17
+## 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
-- (**version**) 0.10.4 - (d0d0474) - Cocogitto Bot
+- 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-studio@0.0.1 - 2026-02-17
+## 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
-- publishing the storage studio - (d7dd43e) - Malik Najjar
-#### Refactoring
-- restructure storage-ext studio components and remove unused files - (a3e375a) - Malik Najjar
+- fix deno publish issue - (e8dcc4f) - malik ben
+- issue fix - (63d66d3) - malik ben
 #### Miscellaneous Chores
-- (**version**) 0.10.2 - (2c92a7d) - Cocogitto Bot
 - (**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.4.2 - (4395d99) - Cocogitto Bot
-- (**version**) 0.4.1 - (5e9f152) - Cocogitto Bot
-- (**version**) 0.4.0 - (aafd2d6) - Cocogitto Bot
-#### Style
-- Update background color from bg-soft to bg-muted/30 across various components - (ad2240a) - Malik Najjar
+- (**version**) 0.5.0 - (af63147) - Cocogitto Bot
+- (**version**) 0.4.4 - (eaed3b4) - Cocogitto Bot
+- (**version**) 0.4.3 - (ea9ec49) - Cocogitto Bot
 
 - - -
 

package/README.md

@@ -1,35 +1 @@
-# Storage Extension - Studio
-
-This directory contains the frontend/dashboard interface for the storage extension.
-
-## Structure
-
-```
-studio/
-├── src/
-│   ├── index.ts                  # Extension entry point
-│   ├── main.ts                   # Vite app entry
-│   ├── components/               # UI components
-│   │   ├── fileExplorer.svelte
-│   │   ├── childrenFileExplorer.svelte
-│   │   ├── fileIcon.svelte
-│   │   ├── fileManagerBreadCrumbs.svelte
-│   │   └── explorerNotSupported.svelte
-│   ├── pages/                    # UI pages
-│   │   └── fileExplorerPage.svelte
-│   └── foreignKeyComponent.svelte
-├── public/                       # Static assets
-├── index.html                    # HTML entry point
-├── vite.config.ts                # Vite configuration
-├── tailwind.config.ts            # Tailwind CSS configuration
-└── tsconfig.json                 # TypeScript configuration
-```
-
-## Features
-
-The studio interface includes:
-- File explorer with directory navigation
-- File upload and management
-- Visual file icons
-- Breadcrumb navigation
-- Foreign key component integration
+# @lobb-js/lobb-ext-storage

package/extensions/storage/adapters/index.ts

@@ -0,0 +1,18 @@
+import type { StorageAdapter } from "./storageAdapter.ts";
+import type { ExtensionConfig } from "../config/extensionConfigSchema.ts";
+import { LobbError } from "@lobb-js/core";
+import { LocalStorageAdapter } from "./localAdapter.ts";
+
+export { StorageAdapter } from "./storageAdapter.ts";
+
+export function initStorageAdapter(config: ExtensionConfig): StorageAdapter {
+  if (config.adapter === "local") {
+    return new LocalStorageAdapter(config);
+  } else {
+    throw new LobbError({
+      code: "INTERNAL_SERVER_ERROR",
+      message:
+        `The (${config.adapter}) storage adapter is not implemented`,
+    });
+  }
+}

package/extensions/storage/adapters/localAdapter.ts

@@ -0,0 +1,60 @@
+import { LobbError } from "@lobb-js/core";
+import { join } from "node:path";
+import { writeFileSync, readFile, unlink } from "node:fs";
+import { promisify } from "node:util";
+import { StorageAdapter } from "./storageAdapter.ts";
+
+const readFileAsync = promisify(readFile);
+const unlinkAsync = promisify(unlink);
+
+export class LocalStorageAdapter extends StorageAdapter {
+  public async createFile(id: string, file: File): Promise<void> {
+    const fullPath = join(
+      this.config.storagePath,
+      String(id),
+    );
+
+    writeFileSync(fullPath, Buffer.from(await file.arrayBuffer()));
+  }
+
+  public async readFile(id: string): Promise<Uint8Array> {
+    const fullPath = join(
+      this.config.storagePath,
+      String(id),
+    );
+
+    try {
+      return new Uint8Array(await readFileAsync(fullPath));
+    } catch (error: any) {
+      if (error.code === "ENOENT") {
+        throw new LobbError({
+          code: "NOT_FOUND",
+          message: `The file doesn't exist in the file system`,
+        });
+      }
+
+      throw error;
+    }
+  }
+
+  public async removeFile(id: string): Promise<void> {
+    const fullPath = join(
+      this.config.storagePath,
+      String(id),
+    );
+
+    try {
+      await unlinkAsync(fullPath);
+    } catch (error: any) {
+      if (error.code === "ENOENT") {
+        // TODO: when you implement the logging part dont forget to
+        // add a log here with the neccessarry information
+        console.warn(
+          `STORAGE EXTENSION: couldnt delete this file ${fullPath} because it doesnt exist`,
+        );
+      } else {
+        throw error;
+      }
+    }
+  }
+}

package/extensions/storage/adapters/storageAdapter.ts

@@ -0,0 +1,13 @@
+import type { ExtensionConfig } from "../config/extensionConfigSchema.ts";
+
+export abstract class StorageAdapter {
+  protected config: ExtensionConfig;
+
+  constructor(config: ExtensionConfig) {
+    this.config = config;
+  }
+
+  public abstract createFile(id: string, file: File): Promise<void>;
+  public abstract readFile(id: string): Promise<Uint8Array>;
+  public abstract removeFile(id: string): Promise<void>;
+}

package/extensions/storage/collections/fileSystem.ts

@@ -0,0 +1,58 @@
+import type { CollectionConfig } from "@lobb-js/core";
+import type { ExtensionConfig } from "../config/extensionConfigSchema.ts";
+
+export function getFileSystemCollection(config: ExtensionConfig): CollectionConfig {
+  return {
+    "indexes": {},
+    "fields": {
+      "id": {
+        "type": "integer",
+      },
+      "name": {
+        "type": "string",
+        "length": 255,
+        "validators": {
+          "required": true,
+        },
+      },
+      "path": {
+        "type": "string",
+        "length": 255,
+        "pre_processors": {
+          "default": "/",
+        },
+      },
+      "type": {
+        "type": "string",
+        "length": 255,
+        "pre_processors": {
+          "default": "directory",
+        },
+        "validators": {
+          "enum": [
+            "file",
+            "directory",
+          ],
+        },
+      },
+      "icon": {
+        "type": "string",
+        "length": 255,
+      },
+      "is_pinned_sidebar": {
+        "type": "bool",
+        "pre_processors": {
+          "default": "false",
+        },
+      },
+      "file_mime_type": {
+        "type": "string",
+        "length": 255,
+      },
+      "file_size": {
+        "type": "long",
+      },
+      ...config.extend_fs?.fields,
+    },
+  };
+}

package/extensions/storage/collections/index.ts

@@ -0,0 +1,12 @@
+import type { CollectionConfig } from "@lobb-js/core";
+import type { ExtensionConfig } from "../config/extensionConfigSchema.ts";
+import { getFileSystemCollection } from "./fileSystem.ts";
+
+export function collections(extensionConfig: ExtensionConfig): Record<string, CollectionConfig> {
+  const collectionsSchemas: Record<string, CollectionConfig> = {};
+
+  // create the user collection
+  collectionsSchemas["storage_fs"] = getFileSystemCollection(extensionConfig);
+
+  return collectionsSchemas;
+}

package/extensions/storage/config/extensionConfigSchema.ts

@@ -0,0 +1,15 @@
+import type { CollectionFieldsWithoutId } from "@lobb-js/core";
+
+type BaseSchema = {};
+
+interface ExtendFs {
+  fields: CollectionFieldsWithoutId;
+}
+
+type LocalAdapter = BaseSchema & {
+  adapter: "local";
+  storagePath: string;
+  extend_fs?: ExtendFs;
+};
+
+export type ExtensionConfig = LocalAdapter;

package/extensions/storage/index.ts

@@ -0,0 +1,26 @@
+import type { Extension } from "@lobb-js/core";
+import type { ExtensionConfig } from "./config/extensionConfigSchema.ts";
+export type { StorageFsCreateOne, StorageFsFindOne } from "./types.ts";
+
+import packageJson from "../../package.json" with { type: "json" };
+import studioExtension from "./studioExtension.json" with { type: "json" };
+import { collections } from "./collections/index.ts";
+import { init } from "./init.ts";
+import { meta } from "./meta.ts";
+import { migrations } from "./migrations.ts";
+import { openapi } from "./openapi.ts";
+import { getWorkflows } from "./workflows/index.ts";
+
+export default function storage(extensionConfig: ExtensionConfig): Extension {
+  return {
+    version: packageJson.version,
+    name: "storage",
+    init: () => init(extensionConfig),
+    collections: (_lobb: any) => collections(extensionConfig),
+    migrations: migrations,
+    meta: meta,
+    workflows: getWorkflows(extensionConfig),
+    openapi: openapi,
+    dashboard: studioExtension,
+  };
+}

package/extensions/storage/init.ts

@@ -0,0 +1,6 @@
+import { mkdir } from "node:fs/promises";
+import type { ExtensionConfig } from "./config/extensionConfigSchema.ts";
+
+export async function init(storageConfig: ExtensionConfig) {
+  await mkdir(storageConfig.storagePath, { recursive: true });
+}

package/extensions/storage/meta.ts

@@ -0,0 +1,5 @@
+export async function meta() {
+  return {
+    storageCollectionName: "storage_fs",
+  };
+}

package/extensions/storage/migrations.ts

@@ -0,0 +1,3 @@
+import type { MigrationProps, Migrations } from "@lobb-js/core";
+
+export const migrations: Migrations = {};

package/extensions/storage/openapi.ts

@@ -0,0 +1,84 @@
+import type { OpenAPIV3_1 } from "openapi-types";
+
+export const paths: OpenAPIV3_1.Document["paths"] = {
+  "/api/collections/storage_fs/{id}": {
+    "get": {
+      "summary": "Get a record Or a file",
+      "description": "Get a record Or a file from the file system",
+      "parameters": [
+        {
+          "name": "id",
+          "in": "path",
+          "required": true,
+          "description": "The record ID of record in the file system.",
+          "schema": {
+            "type": "integer",
+            "example": 10,
+          },
+        },
+        {
+          "name": "action",
+          "in": "query",
+          "description": "used to respond with the file itself.",
+          "schema": {
+            "type": "string",
+            "examples": [
+              "view",
+              "download",
+            ],
+          },
+        },
+      ],
+      "responses": {
+        "200": {
+          "description": "Successful operation",
+          "content": {
+            "application/octet-stream": {
+              "schema": {
+                "type": "string",
+                "format": "binary",
+              },
+            },
+          },
+        },
+      },
+    },
+  },
+  "/api/collections/storage_fs": {
+    "post": {
+      "summary": "Create a record Or upload a file",
+      "description": "Add new record or upload a file to the file system",
+      "requestBody": {
+        "required": true,
+        "content": {
+          "multipart/form-data": {
+            "schema": {
+              "type": "object",
+              "required": ["file"],
+              "properties": {
+                "file": {
+                  "type": "string",
+                  "format": "binary",
+                  "description": "The file to be uploaded",
+                },
+                "data": {
+                  "type": "string",
+                  "description": "data of the record",
+                },
+              },
+            },
+          },
+        },
+      },
+      "responses": {
+        "201": {
+          "description": "Successful operation",
+        },
+      },
+    },
+  },
+};
+
+export const openapi = {
+  paths: paths,
+};