@gravito/nebula 1.0.0-alpha.5 → 1.0.0-beta.1

package/dist/index.cjs

@@ -1,141 +1,178 @@
+"use strict";
 var __create = Object.create;
-var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __toESM = (mod, isNodeMode, target) => {
-  target = mod != null ? __create(__getProtoOf(mod)) : {};
-  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  for (let key of __getOwnPropNames(mod))
-    if (!__hasOwnProp.call(to, key))
-      __defProp(to, key, {
-        get: () => mod[key],
-        enumerable: true
-      });
-  return to;
-};
-var __moduleCache = /* @__PURE__ */ new WeakMap;
-var __toCommonJS = (from) => {
-  var entry = __moduleCache.get(from), desc;
-  if (entry)
-    return entry;
-  entry = __defProp({}, "__esModule", { value: true });
-  if (from && typeof from === "object" || typeof from === "function")
-    __getOwnPropNames(from).map((key) => !__hasOwnProp.call(entry, key) && __defProp(entry, key, {
-      get: () => from[key],
-      enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
-    }));
-  __moduleCache.set(from, entry);
-  return entry;
-};
 var __export = (target, all) => {
   for (var name in all)
-    __defProp(target, name, {
-      get: all[name],
-      enumerable: true,
-      configurable: true,
-      set: (newValue) => all[name] = () => newValue
-    });
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
-var exports_src = {};
-__export(exports_src, {
-  default: () => orbitStorage,
+var index_exports = {};
+__export(index_exports, {
+  LocalStorageProvider: () => LocalStorageProvider,
+  OrbitNebula: () => OrbitNebula,
   OrbitStorage: () => OrbitStorage,
-  LocalStorageProvider: () => LocalStorageProvider
+  default: () => orbitStorage
 });
-module.exports = __toCommonJS(exports_src);
-var import_promises = require("node:fs/promises");
-var import_node_path = require("node:path");
-
-class LocalStorageProvider {
+module.exports = __toCommonJS(index_exports);
+var import_promises = require("fs/promises");
+var import_node_path = require("path");
+var LocalStorageProvider = class {
   rootDir;
   baseUrl;
+  /**
+   * Create a new LocalStorageProvider.
+   *
+   * @param rootDir - The root directory for storage.
+   * @param baseUrl - The base URL for accessing stored files.
+   */
   constructor(rootDir, baseUrl = "/storage") {
     this.rootDir = rootDir;
     this.baseUrl = baseUrl;
   }
+  /**
+   * Store data in a file.
+   *
+   * @param key - The storage key (path).
+   * @param data - The data to store.
+   */
   async put(key, data) {
-    const path = import_node_path.join(this.rootDir, key);
+    const path = (0, import_node_path.join)(this.rootDir, key);
     const dir = path.substring(0, path.lastIndexOf("/"));
     if (dir && dir !== this.rootDir) {
-      await import_promises.mkdir(dir, { recursive: true });
+      await (0, import_promises.mkdir)(dir, { recursive: true });
     }
     await Bun.write(path, data);
   }
+  /**
+   * Retrieve a file.
+   *
+   * @param key - The storage key.
+   * @returns A promise resolving to the file Blob or null if not found.
+   */
   async get(key) {
-    const file = Bun.file(import_node_path.join(this.rootDir, key));
+    const file = Bun.file((0, import_node_path.join)(this.rootDir, key));
     if (!await file.exists()) {
       return null;
     }
     return file;
   }
+  /**
+   * Delete a file.
+   *
+   * @param key - The storage key.
+   */
   async delete(key) {
-    const fs = await import("node:fs/promises");
+    const fs = await import("fs/promises");
     try {
-      await fs.unlink(import_node_path.join(this.rootDir, key));
-    } catch {}
+      await fs.unlink((0, import_node_path.join)(this.rootDir, key));
+    } catch {
+    }
   }
+  /**
+   * Get the public URL for a file.
+   *
+   * @param key - The storage key.
+   * @returns The public URL string.
+   */
   getUrl(key) {
     return `${this.baseUrl}/${key}`;
   }
-}
-
-class OrbitStorage {
-  options;
+};
+var OrbitNebula = class {
   constructor(options) {
     this.options = options;
   }
+  /**
+   * Install storage service into PlanetCore.
+   *
+   * @param core - The PlanetCore instance.
+   * @throws {Error} If configuration or provider is missing.
+   */
   install(core) {
     const config = this.options || core.config.get("storage");
     if (!config) {
-      throw new Error('[OrbitStorage] Configuration is required. Please provide options or set "storage" in core config.');
+      throw new Error(
+        '[OrbitNebula] Configuration is required. Please provide options or set "storage" in core config.'
+      );
     }
     const { exposeAs = "storage" } = config;
     const logger = core.logger;
-    logger.info(`[OrbitStorage] Initializing Storage (Exposed as: ${exposeAs})`);
+    logger.info(`[OrbitNebula] Initializing Storage (Exposed as: ${exposeAs})`);
     let provider = config.provider;
     if (!provider && config.local) {
-      logger.info(`[OrbitStorage] Using LocalStorageProvider at ${config.local.root}`);
+      logger.info(`[OrbitNebula] Using LocalStorageProvider at ${config.local.root}`);
       provider = new LocalStorageProvider(config.local.root, config.local.baseUrl);
     }
     if (!provider) {
-      throw new Error("[OrbitStorage] No provider configured. Please provide a provider instance or local configuration.");
+      throw new Error(
+        "[OrbitNebula] No provider configured. Please provide a provider instance or local configuration."
+      );
     }
     const storageService = {
-      ...provider,
       put: async (key, data) => {
         const finalData = await core.hooks.applyFilters("storage:upload", data, { key });
         await provider?.put(key, finalData);
         await core.hooks.doAction("storage:uploaded", { key });
-      }
+      },
+      get: (key) => provider?.get(key),
+      delete: (key) => provider?.delete(key),
+      getUrl: (key) => provider?.getUrl(key)
     };
     core.adapter.use("*", async (c, next) => {
       c.set(exposeAs, storageService);
       await next();
-      return;
+      return void 0;
     });
     core.hooks.doAction("storage:init", storageService);
   }
-}
+};
 function orbitStorage(core, options) {
-  const orbit = new OrbitStorage(options);
+  const orbit = new OrbitNebula(options);
   orbit.install(core);
   let provider = options.provider;
   if (!provider && options.local) {
     provider = new LocalStorageProvider(options.local.root, options.local.baseUrl);
   }
   if (!provider) {
-    throw new Error("[OrbitStorage] No provider configured.");
+    throw new Error("[OrbitNebula] No provider configured.");
   }
   return {
-    ...provider,
     put: async (key, data) => {
       const finalData = await core.hooks.applyFilters("storage:upload", data, { key });
       await provider?.put(key, finalData);
       await core.hooks.doAction("storage:uploaded", { key });
-    }
+    },
+    get: (key) => provider?.get(key),
+    delete: (key) => provider?.delete(key),
+    getUrl: (key) => provider?.getUrl(key)
   };
 }
+var OrbitStorage = OrbitNebula;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  LocalStorageProvider,
+  OrbitNebula,
+  OrbitStorage
+});

package/dist/index.d.cts

@@ -0,0 +1,93 @@
+import { PlanetCore, GravitoOrbit } from 'gravito-core';
+
+interface StorageProvider {
+    put(key: string, data: Blob | Buffer | string): Promise<void>;
+    get(key: string): Promise<Blob | null>;
+    delete(key: string): Promise<void>;
+    getUrl(key: string): string;
+}
+/**
+ * Local storage provider implementation.
+ */
+declare class LocalStorageProvider implements StorageProvider {
+    private rootDir;
+    private baseUrl;
+    /**
+     * Create a new LocalStorageProvider.
+     *
+     * @param rootDir - The root directory for storage.
+     * @param baseUrl - The base URL for accessing stored files.
+     */
+    constructor(rootDir: string, baseUrl?: string);
+    /**
+     * Store data in a file.
+     *
+     * @param key - The storage key (path).
+     * @param data - The data to store.
+     */
+    put(key: string, data: Blob | Buffer | string): Promise<void>;
+    /**
+     * Retrieve a file.
+     *
+     * @param key - The storage key.
+     * @returns A promise resolving to the file Blob or null if not found.
+     */
+    get(key: string): Promise<Blob | null>;
+    /**
+     * Delete a file.
+     *
+     * @param key - The storage key.
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Get the public URL for a file.
+     *
+     * @param key - The storage key.
+     * @returns The public URL string.
+     */
+    getUrl(key: string): string;
+}
+interface OrbitNebulaOptions {
+    provider?: StorageProvider;
+    exposeAs?: string;
+    local?: {
+        root: string;
+        baseUrl?: string;
+    };
+}
+/** @deprecated Use OrbitNebulaOptions instead */
+type OrbitStorageOptions = OrbitNebulaOptions;
+/**
+ * OrbitNebula - Storage Orbit
+ *
+ * Provides file storage functionality for Gravito applications.
+ */
+declare class OrbitNebula implements GravitoOrbit {
+    private options?;
+    constructor(options?: OrbitNebulaOptions | undefined);
+    /**
+     * Install storage service into PlanetCore.
+     *
+     * @param core - The PlanetCore instance.
+     * @throws {Error} If configuration or provider is missing.
+     */
+    install(core: PlanetCore): void;
+}
+/**
+ * Functional API for installing OrbitNebula.
+ *
+ * @param core - The PlanetCore instance.
+ * @param options - Storage options.
+ * @returns The configured storage provider wrapper.
+ * @throws {Error} If provider is not configured.
+ */
+declare function orbitStorage(core: PlanetCore, options: OrbitNebulaOptions): {
+    put: (key: string, data: Blob | Buffer | string) => Promise<void>;
+    get: (key: string) => Promise<Blob | null>;
+    delete: (key: string) => Promise<void>;
+    getUrl: (key: string) => string;
+};
+/** @deprecated Use OrbitNebula instead */
+declare const OrbitStorage: typeof OrbitNebula;
+
+export { LocalStorageProvider, OrbitNebula, type OrbitNebulaOptions, OrbitStorage, type OrbitStorageOptions, type StorageProvider, orbitStorage as default };

package/dist/index.d.ts

@@ -0,0 +1,93 @@
+import { PlanetCore, GravitoOrbit } from 'gravito-core';
+
+interface StorageProvider {
+    put(key: string, data: Blob | Buffer | string): Promise<void>;
+    get(key: string): Promise<Blob | null>;
+    delete(key: string): Promise<void>;
+    getUrl(key: string): string;
+}
+/**
+ * Local storage provider implementation.
+ */
+declare class LocalStorageProvider implements StorageProvider {
+    private rootDir;
+    private baseUrl;
+    /**
+     * Create a new LocalStorageProvider.
+     *
+     * @param rootDir - The root directory for storage.
+     * @param baseUrl - The base URL for accessing stored files.
+     */
+    constructor(rootDir: string, baseUrl?: string);
+    /**
+     * Store data in a file.
+     *
+     * @param key - The storage key (path).
+     * @param data - The data to store.
+     */
+    put(key: string, data: Blob | Buffer | string): Promise<void>;
+    /**
+     * Retrieve a file.
+     *
+     * @param key - The storage key.
+     * @returns A promise resolving to the file Blob or null if not found.
+     */
+    get(key: string): Promise<Blob | null>;
+    /**
+     * Delete a file.
+     *
+     * @param key - The storage key.
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * Get the public URL for a file.
+     *
+     * @param key - The storage key.
+     * @returns The public URL string.
+     */
+    getUrl(key: string): string;
+}
+interface OrbitNebulaOptions {
+    provider?: StorageProvider;
+    exposeAs?: string;
+    local?: {
+        root: string;
+        baseUrl?: string;
+    };
+}
+/** @deprecated Use OrbitNebulaOptions instead */
+type OrbitStorageOptions = OrbitNebulaOptions;
+/**
+ * OrbitNebula - Storage Orbit
+ *
+ * Provides file storage functionality for Gravito applications.
+ */
+declare class OrbitNebula implements GravitoOrbit {
+    private options?;
+    constructor(options?: OrbitNebulaOptions | undefined);
+    /**
+     * Install storage service into PlanetCore.
+     *
+     * @param core - The PlanetCore instance.
+     * @throws {Error} If configuration or provider is missing.
+     */
+    install(core: PlanetCore): void;
+}
+/**
+ * Functional API for installing OrbitNebula.
+ *
+ * @param core - The PlanetCore instance.
+ * @param options - Storage options.
+ * @returns The configured storage provider wrapper.
+ * @throws {Error} If provider is not configured.
+ */
+declare function orbitStorage(core: PlanetCore, options: OrbitNebulaOptions): {
+    put: (key: string, data: Blob | Buffer | string) => Promise<void>;
+    get: (key: string) => Promise<Blob | null>;
+    delete: (key: string) => Promise<void>;
+    getUrl: (key: string) => string;
+};
+/** @deprecated Use OrbitNebula instead */
+declare const OrbitStorage: typeof OrbitNebula;
+
+export { LocalStorageProvider, OrbitNebula, type OrbitNebulaOptions, OrbitStorage, type OrbitStorageOptions, type StorageProvider, orbitStorage as default };

package/dist/{index.mjs → index.js}

@@ -1,33 +1,25 @@
-import { createRequire } from "node:module";
-var __create = Object.create;
-var __getProtoOf = Object.getPrototypeOf;
-var __defProp = Object.defineProperty;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __toESM = (mod, isNodeMode, target) => {
-  target = mod != null ? __create(__getProtoOf(mod)) : {};
-  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
-  for (let key of __getOwnPropNames(mod))
-    if (!__hasOwnProp.call(to, key))
-      __defProp(to, key, {
-        get: () => mod[key],
-        enumerable: true
-      });
-  return to;
-};
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
-
 // src/index.ts
-import { mkdir } from "node:fs/promises";
-import { join } from "node:path";
-
-class LocalStorageProvider {
+import { mkdir } from "fs/promises";
+import { join } from "path";
+var LocalStorageProvider = class {
   rootDir;
   baseUrl;
+  /**
+   * Create a new LocalStorageProvider.
+   *
+   * @param rootDir - The root directory for storage.
+   * @param baseUrl - The base URL for accessing stored files.
+   */
   constructor(rootDir, baseUrl = "/storage") {
     this.rootDir = rootDir;
     this.baseUrl = baseUrl;
   }
+  /**
+   * Store data in a file.
+   *
+   * @param key - The storage key (path).
+   * @param data - The data to store.
+   */
   async put(key, data) {
     const path = join(this.rootDir, key);
     const dir = path.substring(0, path.lastIndexOf("/"));
@@ -36,6 +28,12 @@ class LocalStorageProvider {
     }
     await Bun.write(path, data);
   }
+  /**
+   * Retrieve a file.
+   *
+   * @param key - The storage key.
+   * @returns A promise resolving to the file Blob or null if not found.
+   */
   async get(key) {
     const file = Bun.file(join(this.rootDir, key));
     if (!await file.exists()) {
@@ -43,75 +41,101 @@ class LocalStorageProvider {
     }
     return file;
   }
+  /**
+   * Delete a file.
+   *
+   * @param key - The storage key.
+   */
   async delete(key) {
-    const fs = await import("node:fs/promises");
+    const fs = await import("fs/promises");
     try {
       await fs.unlink(join(this.rootDir, key));
-    } catch {}
+    } catch {
+    }
   }
+  /**
+   * Get the public URL for a file.
+   *
+   * @param key - The storage key.
+   * @returns The public URL string.
+   */
   getUrl(key) {
     return `${this.baseUrl}/${key}`;
   }
-}
-
-class OrbitStorage {
-  options;
+};
+var OrbitNebula = class {
   constructor(options) {
     this.options = options;
   }
+  /**
+   * Install storage service into PlanetCore.
+   *
+   * @param core - The PlanetCore instance.
+   * @throws {Error} If configuration or provider is missing.
+   */
   install(core) {
     const config = this.options || core.config.get("storage");
     if (!config) {
-      throw new Error('[OrbitStorage] Configuration is required. Please provide options or set "storage" in core config.');
+      throw new Error(
+        '[OrbitNebula] Configuration is required. Please provide options or set "storage" in core config.'
+      );
     }
     const { exposeAs = "storage" } = config;
     const logger = core.logger;
-    logger.info(`[OrbitStorage] Initializing Storage (Exposed as: ${exposeAs})`);
+    logger.info(`[OrbitNebula] Initializing Storage (Exposed as: ${exposeAs})`);
     let provider = config.provider;
     if (!provider && config.local) {
-      logger.info(`[OrbitStorage] Using LocalStorageProvider at ${config.local.root}`);
+      logger.info(`[OrbitNebula] Using LocalStorageProvider at ${config.local.root}`);
       provider = new LocalStorageProvider(config.local.root, config.local.baseUrl);
     }
     if (!provider) {
-      throw new Error("[OrbitStorage] No provider configured. Please provide a provider instance or local configuration.");
+      throw new Error(
+        "[OrbitNebula] No provider configured. Please provide a provider instance or local configuration."
+      );
     }
     const storageService = {
-      ...provider,
       put: async (key, data) => {
         const finalData = await core.hooks.applyFilters("storage:upload", data, { key });
         await provider?.put(key, finalData);
         await core.hooks.doAction("storage:uploaded", { key });
-      }
+      },
+      get: (key) => provider?.get(key),
+      delete: (key) => provider?.delete(key),
+      getUrl: (key) => provider?.getUrl(key)
     };
     core.adapter.use("*", async (c, next) => {
       c.set(exposeAs, storageService);
       await next();
-      return;
+      return void 0;
     });
     core.hooks.doAction("storage:init", storageService);
   }
-}
+};
 function orbitStorage(core, options) {
-  const orbit = new OrbitStorage(options);
+  const orbit = new OrbitNebula(options);
   orbit.install(core);
   let provider = options.provider;
   if (!provider && options.local) {
     provider = new LocalStorageProvider(options.local.root, options.local.baseUrl);
   }
   if (!provider) {
-    throw new Error("[OrbitStorage] No provider configured.");
+    throw new Error("[OrbitNebula] No provider configured.");
   }
   return {
-    ...provider,
     put: async (key, data) => {
       const finalData = await core.hooks.applyFilters("storage:upload", data, { key });
       await provider?.put(key, finalData);
       await core.hooks.doAction("storage:uploaded", { key });
-    }
+    },
+    get: (key) => provider?.get(key),
+    delete: (key) => provider?.delete(key),
+    getUrl: (key) => provider?.getUrl(key)
   };
 }
+var OrbitStorage = OrbitNebula;
 export {
-  orbitStorage as default,
+  LocalStorageProvider,
+  OrbitNebula,
   OrbitStorage,
-  LocalStorageProvider
+  orbitStorage as default
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gravito/nebula",
-  "version": "1.0.0-alpha.5",
+  "version": "1.0.0-beta.1",
   "publishConfig": {
     "access": "public"
   },
@@ -35,12 +35,13 @@
   "author": "Carl Lee <carllee0520@gmail.com>",
   "license": "MIT",
   "peerDependencies": {
-    "gravito-core": "1.0.0-beta.4"
+    "gravito-core": "1.0.0-beta.6"
   },
   "devDependencies": {
-    "gravito-core": "1.0.0-beta.4",
-    "hono": "^4.11.1",
     "bun-types": "latest",
+    "gravito-core": "1.0.0-beta.6",
+    "@gravito/photon": "1.0.0-beta.1",
+    "tsup": "^8.5.1",
     "typescript": "^5.9.3"
   },
   "homepage": "https://github.com/gravito-framework/gravito#readme",