@ez4/local-storage 0.22.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Silas B.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,15 @@
+# EZ4: Local Storage Provider
+
+A local storage emulator.
+
+## Getting started
+
+#### Install
+
+```sh
+npm install @ez4/local-storage -D
+```
+
+## License
+
+MIT License

package/dist/main.cjs

@@ -0,0 +1,24 @@
+"use strict";var g=Object.defineProperty;var E=Object.getOwnPropertyDescriptor;var v=Object.getOwnPropertyNames;var C=Object.prototype.hasOwnProperty;var n=(e,t)=>g(e,"name",{value:t,configurable:!0});var b=(e,t)=>{for(var o in t)g(e,o,{get:t[o],enumerable:!0})},z=(e,t,o,i)=>{if(t&&
+typeof t=="object"||typeof t=="function")for(let r of v(t))!C.call(e,r)&&r!==o&&
+g(e,r,{get:()=>t[r],enumerable:!(i=E(t,r))||i.enumerable});return e};var P=e=>z(g({},"__esModule",{value:!0}),e);var x={};b(x,{registerTriggers:()=>B});module.exports=P(x);var w=require("@ez4/storage/library"),h=require("@ez4/project/library");var m=require("@ez4/project/library");var a=require("node:fs/promises"),c=require("node:path"),p=require("node:fs"),u=require("@ez4/utils"),
+y=require("@ez4/project/library");var f=n((e,t)=>{let o=(0,y.getServiceName)(e,t),i=(0,c.join)(".ez4",(0,u.toKebabCase)(
+e));return new class{async exists(r){let s=(0,c.join)(i,r);return(0,p.existsSync)(
+s)}async write(r,s){let l=(0,c.join)(i,r);await(0,a.mkdir)((0,c.dirname)(l),{recursive:!0}),
+await(0,a.writeFile)(l,s)}async read(r){let s=(0,c.join)(i,r);return(0,a.readFile)(
+s)}async delete(r){let s=(0,c.join)(i,r);await(0,a.unlink)(s)}async getWriteUrl(r){
+return`http://${t.host}/${o}/${r}`}async getReadUrl(r){return`http://${t.host}/${o}\
+/${r}`}async getStats(r){let s=(0,c.join)(i,r);try{return{type:"application/octe\
+t-stream",size:(await(0,a.stat)(s)).size}}catch(l){if(!(0,u.isAnyObject)(l)||l.code!==
+"ENOENT")throw l;return}}}},"createStorageClient");var d=n((e,t)=>{let o=f(e.name,t);return{type:"Storage",name:e.name,identifier:(0,m.getServiceName)(
+e.name,t),clientHandler:n(()=>f(e.name,t),"clientHandler"),requestHandler:n(i=>F(
+o,i),"requestHandler")}},"registerBucketEmulator"),F=n(async(e,t)=>{if(!t.path||
+t.path==="/")throw new Error("File path wasn't given.");switch(t.method){case"GE\
+T":return $(e,t.path);case"PUT":{if(!t.body)throw new Error("File content wasn't\
+ given.");return k(e,t.path,t.body)}default:throw new Error("Unsupported storage\
+ request.")}},"handleRequest"),$=n(async(e,t)=>{let[o,i]=await Promise.all([e.read(
+t),e.getStats(t)]);return m.Logger.log(`File downloaded from ${t}`),{status:200,
+body:o,headers:{"content-type":i}}},"loadFile"),k=n(async(e,t,o)=>(await e.write(
+t,o),m.Logger.log(`File uploaded to ${t}`),{status:204}),"storeFile");var S=!1,B=n(()=>{S||((0,h.createTrigger)("@ez4/local-storage",{"emulator:getSer\
+vices":n(({service:e,options:t})=>(0,w.isBucketService)(e)?d(e,t):null,"emulator\
+:getServices")}),S=!0)},"registerTriggers");0&&(module.exports={registerTriggers});
+//# sourceMappingURL=main.cjs.map

package/dist/main.d.ts

@@ -0,0 +1 @@
+export * from './provider/register.js';

package/dist/main.mjs

@@ -0,0 +1,20 @@
+var f=Object.defineProperty;var o=(e,t)=>f(e,"name",{value:t,configurable:!0});import{isBucketService as k}from"@ez4/storage/library";import{createTrigger as B}from"@ez4/project/library";import{getServiceName as z,Logger as m}from"@ez4/project/library";import{mkdir as p,readFile as y,stat as d,unlink as S,writeFile as w}from"node:fs/promises";
+import{dirname as h,join as c}from"node:path";import{existsSync as E}from"node:fs";
+import{isAnyObject as v,toKebabCase as C}from"@ez4/utils";import{getServiceName as b}from"@ez4/project/library";var l=o((e,t)=>{let a=b(e,t),i=c(".ez4",C(e));return new class{async exists(r){let n=c(
+i,r);return E(n)}async write(r,n){let s=c(i,r);await p(h(s),{recursive:!0}),await w(
+s,n)}async read(r){let n=c(i,r);return y(n)}async delete(r){let n=c(i,r);await S(
+n)}async getWriteUrl(r){return`http://${t.host}/${a}/${r}`}async getReadUrl(r){return`\
+http://${t.host}/${a}/${r}`}async getStats(r){let n=c(i,r);try{return{type:"appl\
+ication/octet-stream",size:(await d(n)).size}}catch(s){if(!v(s)||s.code!=="ENOEN\
+T")throw s;return}}}},"createStorageClient");var g=o((e,t)=>{let a=l(e.name,t);return{type:"Storage",name:e.name,identifier:z(
+e.name,t),clientHandler:o(()=>l(e.name,t),"clientHandler"),requestHandler:o(i=>P(
+a,i),"requestHandler")}},"registerBucketEmulator"),P=o(async(e,t)=>{if(!t.path||
+t.path==="/")throw new Error("File path wasn't given.");switch(t.method){case"GE\
+T":return F(e,t.path);case"PUT":{if(!t.body)throw new Error("File content wasn't\
+ given.");return $(e,t.path,t.body)}default:throw new Error("Unsupported storage\
+ request.")}},"handleRequest"),F=o(async(e,t)=>{let[a,i]=await Promise.all([e.read(
+t),e.getStats(t)]);return m.log(`File downloaded from ${t}`),{status:200,body:a,
+headers:{"content-type":i}}},"loadFile"),$=o(async(e,t,a)=>(await e.write(t,a),m.
+log(`File uploaded to ${t}`),{status:204}),"storeFile");var u=!1,J=o(()=>{u||(B("@ez4/local-storage",{"emulator:getServices":o(({service:e,
+options:t})=>k(e)?g(e,t):null,"emulator:getServices")}),u=!0)},"registerTriggers");export{J as registerTriggers};
+//# sourceMappingURL=main.mjs.map

package/dist/provider/emulator.d.ts

@@ -0,0 +1,12 @@
+import type { EmulatorServiceRequest, ServeOptions } from '@ez4/project/library';
+import type { Client as StorageClient } from '@ez4/storage';
+import type { BucketService } from '@ez4/storage/library';
+export declare const registerBucketEmulator: (service: BucketService, options: ServeOptions) => {
+    type: string;
+    name: string;
+    identifier: string;
+    clientHandler: () => StorageClient;
+    requestHandler: (request: EmulatorServiceRequest) => Promise<{
+        status: number;
+    }>;
+};

package/dist/provider/register.d.ts

@@ -0,0 +1 @@
+export declare const registerTriggers: () => void;

package/dist/service/client.d.ts

@@ -0,0 +1,3 @@
+import type { ServeOptions } from '@ez4/project/library';
+import type { Client } from '@ez4/storage';
+export declare const createStorageClient: (serviceName: string, serveOptions: ServeOptions) => Client;

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@ez4/local-storage",
+  "description": "EZ4: Local storage emulator",
+  "version": "0.22.0",
+  "author": "Silas B.",
+  "license": "MIT",
+  "type": "module",
+  "keywords": [
+    "ez4",
+    "ez4-local"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sbalmt/ez4.git",
+    "directory": "providers/local/local-storage"
+  },
+  "engines": {
+    "node": ">=22.7"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/main.d.ts",
+      "require": "./dist/main.cjs",
+      "import": "./dist/main.mjs"
+    }
+  },
+  "workspaces": [
+    "packages/*",
+    "providers/local/*"
+  ],
+  "scripts": {
+    "clean": "rm -f *.tsbuildinfo && rm -rf dist/*",
+    "build": "tsc -p tsconfig.json && node tools/bundler.mjs",
+    "test": "npm run test:types && node --test --import ../../../tools/tsnode.mjs test/*.spec.ts",
+    "test:only": "npm run test:types && node --test-only --test --import ../../../tools/tsnode.mjs test/*.spec.ts",
+    "test:types": "npm run build && tsc -p tsconfig.test.json",
+    "local:publish": "npm run build && npm run clean:registry && npm publish --registry http://localhost:4873",
+    "clean:registry": "rm -rf ../../../.registry/@ez4/local-storage",
+    "live:publish": "npm run test && npm publish --access public"
+  },
+  "dependencies": {
+    "@ez4/local-common": "^0.22.0",
+    "@ez4/project": "^0.22.0",
+    "@ez4/storage": "^0.22.0",
+    "@ez4/utils": "^0.22.0"
+  }
+}