@ez4/local-storage 0.45.0 → 0.46.0

package/dist/client/local.d.ts

@@ -1,3 +1,9 @@
 import type { ServeOptions } from '@ez4/project/library';
-import type { Client } from '@ez4/storage';
-export declare const createLocalClient: (resourceName: string, options: ServeOptions) => Client;
+import type { Bucket, Client } from '@ez4/storage';
+export type LocalClientOptions = ServeOptions & {
+    events?: {
+        handler: (event: Bucket.Event) => Promise<void>;
+        path?: string;
+    };
+};
+export declare const createLocalClient: (resourceName: string, options: LocalClientOptions) => Client;

package/dist/handlers/lambda.d.ts

@@ -0,0 +1,4 @@
+import type { BucketEvent, BucketService } from '@ez4/storage/library';
+import type { EmulateServiceContext, ServeOptions } from '@ez4/project/library';
+import type { Bucket } from '@ez4/storage';
+export declare const processLambdaEvent: (service: BucketService, options: ServeOptions, context: EmulateServiceContext, events: BucketEvent, event: Bucket.Event) => Promise<void>;

package/dist/main.cjs

@@ -1,36 +1,48 @@
-"use strict";var p=Object.defineProperty;var F=Object.getOwnPropertyDescriptor;var P=Object.getOwnPropertyNames;var $=Object.prototype.hasOwnProperty;var s=(r,t)=>p(r,"name",{value:t,configurable:!0});var O=(r,t)=>{for(var i in t)p(r,i,{get:t[i],enumerable:!0})},b=(r,t,i,o)=>{if(t&&
-typeof t=="object"||typeof t=="function")for(let e of P(t))!$.call(r,e)&&e!==i&&
-p(r,e,{get:()=>t[e],enumerable:!(o=F(t,e))||o.enumerable});return r};var z=r=>b(p({},"__esModule",{value:!0}),r);var k={};O(k,{registerTriggers:()=>H});module.exports=z(k);var y=require("@ez4/storage/library"),C=require("@ez4/project/library");var f=require("@ez4/project/library");var a=require("node:fs/promises"),l=require("node:path"),S=require("node:fs"),w=require("file-type"),
-u=require("@ez4/utils"),v=require("@ez4/project/library"),m=require("@ez4/logger");var h=s((r,t)=>{let i=(0,v.getServiceName)(r,t),o=(0,l.join)(".ez4",(0,u.toKebabCase)(
-r));return new class{async stat(e){let n=(0,l.join)(o,e);try{let c=await(0,w.fileTypeFromFile)(
-n),g=await(0,a.stat)(n);return{type:c?.mime??"application/octet-stream",size:g.size}}catch(c){
-if(!(0,u.isAnyObject)(c)||c.code!=="ENOENT")throw c;return}}async exists(e){let n=(0,l.join)(
-o,e);return Promise.resolve((0,S.existsSync)(n))}async write(e,n){let c=(0,l.join)(
-o,e);await(0,a.mkdir)((0,l.dirname)(c),{recursive:!0}),await(0,a.writeFile)(c,n),
-m.Logger.log(`\u2B06\uFE0F  File ${e} uploaded.`)}async read(e){let n=(0,l.join)(
-o,e),c=await(0,a.readFile)(n);return m.Logger.log(`\u2B07\uFE0F  File ${e} downl\
-oaded.`),c}async delete(e){let n=(0,l.join)(o,e);await(0,a.unlink)(n),m.Logger.log(
-`\u2139\uFE0F  File ${e} deleted.`)}async copy(e,n){let c=(0,l.join)(o,e),g=(0,l.join)(
-o,n);await(0,a.copyFile)(c,g),m.Logger.log(`\u2139\uFE0F  File ${e} copied.`)}async*scan(){
-let e=await(0,a.readdir)(o,{recursive:!0});for(let n of e){let{size:c,mtime:g}=await(0,a.stat)(
-(0,l.join)(o,n));yield{key:n,modifiedAt:g,size:c}}}async getStatUrl(e,n){return Promise.
-resolve(`http://${t.serviceHost}/${i}/${e}`)}async getWriteUrl(e,n){return Promise.
-resolve(`http://${t.serviceHost}/${i}/${e}`)}async getReadUrl(e,n){return Promise.
-resolve(`http://${t.serviceHost}/${i}/${e}`)}}},"createLocalClient");var d=require("@ez4/logger");var E=s(async(r,t)=>{let i=await R(r,t),{name:o}=r;return{type:"Storage",name:o,
-identifier:(0,f.getServiceName)(o,t),bootstrapHandler:s(()=>{t.local?d.Logger.log(
-`\u{1F4C2} Local storage [${o}] in use.`):d.Logger.log(`\u{1F4C2} Remote storage [${o}\
-] in use.`)},"bootstrapHandler"),requestHandler:s(e=>B(i,e),"requestHandler"),exportHandler:s(
-()=>i,"exportHandler")}},"registerBucketEmulator"),R=s(async(r,t)=>{let i=await(0,f.triggerAllAsync)(
-"emulator:getClient",o=>o({service:r,options:t}));return i||h(r.name,t)},"getSto\
-rageClient"),B=s(async(r,t)=>{let{method:i,path:o,body:e}=t;if(!o||o==="/")throw new Error(
-"File path wasn't given.");switch(i){case"HEAD":return x(r,o);case"GET":return T(
-r,o);case"PUT":{if(!e)throw new Error("File content wasn't given.");return j(r,o,
-e)}default:throw new Error("Unsupported storage request.")}},"handleRequest"),T=s(
-async(r,t)=>{let[i,o]=await Promise.all([r.read(t),r.stat(t)]);return{status:200,
+"use strict";var y=Object.defineProperty;var R=Object.getOwnPropertyDescriptor;var j=Object.getOwnPropertyNames;var T=Object.prototype.hasOwnProperty;var c=(t,e)=>y(t,"name",{value:e,configurable:!0});var q=(t,e)=>{for(var i in e)y(t,i,{get:e[i],enumerable:!0})},L=(t,e,i,o)=>{if(e&&
+typeof e=="object"||typeof e=="function")for(let a of j(e))!T.call(t,a)&&a!==i&&
+y(t,a,{get:()=>e[a],enumerable:!(o=R(e,a))||o.enumerable});return t};var H=t=>L(y({},"__esModule",{value:!0}),t);var _={};q(_,{registerTriggers:()=>W});module.exports=H(_);var S=require("@ez4/storage/library"),x=require("@ez4/project/library");var h=require("@ez4/project/library"),F=require("@ez4/logger");var p=require("@ez4/local-common"),w=require("@ez4/utils"),b=require("@ez4/common");var B=c(async(t,e,i,o,a)=>{let{services:r}=t,n=await i.makeClients(r),s=(0,w.getRandomUUID)(),
+m=await(0,p.createModule)({listener:o.listener,handler:o.handler,version:e.version,
+variables:{...e.variables,...t.variables,...o.variables}}),g,f={requestId:(0,w.getRandomUUID)()};
+try{await(0,p.onBegin)(m,n,f),g={...f,...a,traceId:s},b.Runtime.setScope({traceId:s}),
+await(0,p.onReady)(m,n,g),await m.handler(g,n),await(0,p.onDone)(m,n,g)}catch(C){
+throw await(0,p.onError)(m,n,g??f,C),C}finally{await(0,p.onEnd)(m,n,f)}},"proces\
+sLambdaEvent");var l=require("node:fs/promises"),u=require("node:path"),O=require("node:fs"),z=require("file-type"),
+v=require("@ez4/utils"),P=require("@ez4/project/library"),E=require("@ez4/storage"),
+d=require("@ez4/logger");var k=c((t,e)=>{let i=(0,P.getServiceName)(t,e),o=(0,u.join)(".ez4",(0,v.toKebabCase)(
+t)),a=e.events;return new class{async stat(r){let n=(0,u.join)(o,r);try{let s=await(0,z.fileTypeFromFile)(
+n),m=await(0,l.stat)(n);return{type:s?.mime??"application/octet-stream",size:m.size}}catch(s){
+if(!(0,v.isAnyObject)(s)||s.code!=="ENOENT")throw s;return}}async exists(r){let n=(0,u.join)(
+o,r);return Promise.resolve((0,O.existsSync)(n))}async write(r,n){let s=(0,u.join)(
+o,r);if(await(0,l.mkdir)((0,u.dirname)(s),{recursive:!0}),await(0,l.writeFile)(s,
+n),d.Logger.log(`\u2B06\uFE0F  File ${r} uploaded.`),a&&(!a.path||r.startsWith(a.
+path))){let m=await(0,l.stat)(s);await a.handler({eventType:E.BucketEventType.Create,
+bucketName:i,objectSize:m.size,objectKey:r})}}async read(r){let n=(0,u.join)(o,r),
+s=await(0,l.readFile)(n);return d.Logger.log(`\u2B07\uFE0F  File ${r} downloaded\
+.`),s}async delete(r){let n=(0,u.join)(o,r);await(0,l.unlink)(n),d.Logger.log(`\u2139\
+\uFE0F  File ${r} deleted.`),a&&(!a.path||r.startsWith(a.path))&&await a.handler(
+{eventType:E.BucketEventType.Delete,bucketName:i,objectKey:r})}async copy(r,n){let s=(0,u.join)(
+o,r),m=(0,u.join)(o,n);await(0,l.copyFile)(s,m),d.Logger.log(`\u2139\uFE0F  File ${r}\
+ copied.`)}async*scan(){let r=await(0,l.readdir)(o,{recursive:!0});for(let n of r){
+let{size:s,mtime:m}=await(0,l.stat)((0,u.join)(o,n));yield{key:n,modifiedAt:m,size:s}}}async getStatUrl(r,n){
+return Promise.resolve(`http://${e.serviceHost}/${i}/${r}`)}async getWriteUrl(r,n){
+return Promise.resolve(`http://${e.serviceHost}/${i}/${r}`)}async getReadUrl(r,n){
+return Promise.resolve(`http://${e.serviceHost}/${i}/${r}`)}}},"createLocalClien\
+t");var $=c(async(t,e,i)=>{let o=await U(t,e,i),{name:a}=t;return{type:"Storage",name:a,
+identifier:(0,h.getServiceName)(a,e),bootstrapHandler:c(()=>{F.Logger.log(`\u{1F4C2} ${e.
+local?"Local":"Remote"} storage [${a}] in use.`)},"bootstrapHandler"),requestHandler:c(
+r=>A(o,r),"requestHandler"),exportHandler:c(()=>o,"exportHandler")}},"registerBu\
+cketEmulator"),U=c(async(t,e,i)=>{let o=await(0,h.triggerAllAsync)("emulator:get\
+Client",a=>a({service:t,options:e}));if(!o){let{events:a}=t;return k(t.name,{...e,
+events:a&&{path:a.path,handler:c(r=>B(t,e,i,a,r),"handler")}})}return o},"getSto\
+rageClient"),A=c(async(t,e)=>{let{method:i,path:o,body:a}=e;if(!o||o==="/")throw new Error(
+"File path wasn't given.");switch(i){case"HEAD":return I(t,o);case"GET":return N(
+t,o);case"PUT":{if(!a)throw new Error("File content wasn't given.");return D(t,o,
+a)}default:throw new Error("Unsupported storage request.")}},"handleRequest"),N=c(
+async(t,e)=>{let[i,o]=await Promise.all([t.read(e),t.stat(e)]);return{status:200,
 body:i,headers:{"content-type":o?.type??"application/octet-stream"}}},"loadFile"),
-j=s(async(r,t,i)=>(await r.write(t,i),{status:204}),"storeFile"),x=s(async(r,t)=>{
-let i=await r.stat(t);return i?{status:200,headers:{"content-length":i.size.toString(),
-"content-type":i.type}}:{status:404}},"headFile");var H=s(()=>{(0,y.registerTriggers)(),(0,C.tryCreateTrigger)("@ez4/local-storage",
-{"emulator:getServices":s(({service:r,options:t})=>(0,y.isBucketService)(r)?E(r,
-t):null,"emulator:getServices")})},"registerTriggers");0&&(module.exports={registerTriggers});
+D=c(async(t,e,i)=>(await t.write(e,i),{status:204}),"storeFile"),I=c(async(t,e)=>{
+let i=await t.stat(e);return i?{status:200,headers:{"content-length":i.size.toString(),
+"content-type":i.type}}:{status:404}},"headFile");var W=c(()=>{(0,S.registerTriggers)(),(0,x.tryCreateTrigger)("@ez4/local-storage",
+{"emulator:getServices":c(({service:t,options:e,context:i})=>(0,S.isBucketService)(
+t)?$(t,e,i):null,"emulator:getServices")})},"registerTriggers");0&&(module.exports={registerTriggers});
 //# sourceMappingURL=main.cjs.map

package/dist/main.mjs

@@ -1,34 +1,45 @@
-var y=Object.defineProperty;var s=(e,r)=>y(e,"name",{value:r,configurable:!0});import{isBucketService as k,registerTriggers as q}from"@ez4/storage/library";import{
-tryCreateTrigger as A}from"@ez4/project/library";import{getServiceName as z,triggerAllAsync as R}from"@ez4/project/library";import{copyFile as d,mkdir as S,readdir as w,readFile as v,stat as m,unlink as h,
-writeFile as E}from"node:fs/promises";import{dirname as C,join as c}from"node:path";
-import{existsSync as F}from"node:fs";import{fileTypeFromFile as P}from"file-type";
-import{isAnyObject as $,toKebabCase as O}from"@ez4/utils";import{getServiceName as b}from"@ez4/project/library";
-import{Logger as g}from"@ez4/logger";var p=s((e,r)=>{let i=b(e,r),o=c(".ez4",O(e));return new class{async stat(t){let n=c(
-o,t);try{let a=await P(n),l=await m(n);return{type:a?.mime??"application/octet-s\
-tream",size:l.size}}catch(a){if(!$(a)||a.code!=="ENOENT")throw a;return}}async exists(t){
-let n=c(o,t);return Promise.resolve(F(n))}async write(t,n){let a=c(o,t);await S(
-C(a),{recursive:!0}),await E(a,n),g.log(`\u2B06\uFE0F  File ${t} uploaded.`)}async read(t){
-let n=c(o,t),a=await v(n);return g.log(`\u2B07\uFE0F  File ${t} downloaded.`),a}async delete(t){
-let n=c(o,t);await h(n),g.log(`\u2139\uFE0F  File ${t} deleted.`)}async copy(t,n){
-let a=c(o,t),l=c(o,n);await d(a,l),g.log(`\u2139\uFE0F  File ${t} copied.`)}async*scan(){
-let t=await w(o,{recursive:!0});for(let n of t){let{size:a,mtime:l}=await m(c(o,
-n));yield{key:n,modifiedAt:l,size:a}}}async getStatUrl(t,n){return Promise.resolve(
-`http://${r.serviceHost}/${i}/${t}`)}async getWriteUrl(t,n){return Promise.resolve(
-`http://${r.serviceHost}/${i}/${t}`)}async getReadUrl(t,n){return Promise.resolve(
-`http://${r.serviceHost}/${i}/${t}`)}}},"createLocalClient");import{Logger as u}from"@ez4/logger";var f=s(async(e,r)=>{let i=await B(e,r),{name:o}=e;return{type:"Storage",name:o,
-identifier:z(o,r),bootstrapHandler:s(()=>{r.local?u.log(`\u{1F4C2} Local storage [${o}\
-] in use.`):u.log(`\u{1F4C2} Remote storage [${o}] in use.`)},"bootstrapHandler"),
-requestHandler:s(t=>T(i,t),"requestHandler"),exportHandler:s(()=>i,"exportHandle\
-r")}},"registerBucketEmulator"),B=s(async(e,r)=>{let i=await R("emulator:getClie\
-nt",o=>o({service:e,options:r}));return i||p(e.name,r)},"getStorageClient"),T=s(
-async(e,r)=>{let{method:i,path:o,body:t}=r;if(!o||o==="/")throw new Error("File \
-path wasn't given.");switch(i){case"HEAD":return H(e,o);case"GET":return j(e,o);case"\
-PUT":{if(!t)throw new Error("File content wasn't given.");return x(e,o,t)}default:
-throw new Error("Unsupported storage request.")}},"handleRequest"),j=s(async(e,r)=>{
-let[i,o]=await Promise.all([e.read(r),e.stat(r)]);return{status:200,body:i,headers:{
-"content-type":o?.type??"application/octet-stream"}}},"loadFile"),x=s(async(e,r,i)=>(await e.
-write(r,i),{status:204}),"storeFile"),H=s(async(e,r)=>{let i=await e.stat(r);return i?
-{status:200,headers:{"content-length":i.size.toString(),"content-type":i.type}}:
-{status:404}},"headFile");var ot=s(()=>{q(),A("@ez4/local-storage",{"emulator:getServices":s(({service:e,options:r})=>k(
-e)?f(e,r):null,"emulator:getServices")})},"registerTriggers");export{ot as registerTriggers};
+var E=Object.defineProperty;var c=(t,r)=>E(t,"name",{value:r,configurable:!0});import{isBucketService as Q,registerTriggers as V}from"@ez4/storage/library";import{
+tryCreateTrigger as X}from"@ez4/project/library";import{getServiceName as D,triggerAllAsync as I}from"@ez4/project/library";import{
+Logger as W}from"@ez4/logger";import{createModule as C,onBegin as b,onReady as B,onDone as O,onError as z,onEnd as P}from"@ez4/local-common";
+import{getRandomUUID as y}from"@ez4/utils";import{Runtime as k}from"@ez4/common";var v=c(async(t,r,i,o,n)=>{let{services:e}=t,a=await i.makeClients(e),s=y(),l=await C(
+{listener:o.listener,handler:o.handler,version:r.version,variables:{...r.variables,
+...t.variables,...o.variables}}),p,u={requestId:y()};try{await b(l,a,u),p={...u,
+...n,traceId:s},k.setScope({traceId:s}),await B(l,a,p),await l.handler(p,a),await O(
+l,a,p)}catch(f){throw await z(l,a,p??u,f),f}finally{await P(l,a,u)}},"processLam\
+bdaEvent");import{copyFile as F,mkdir as $,readdir as x,readFile as R,stat as d,unlink as j,
+writeFile as T}from"node:fs/promises";import{dirname as q,join as m}from"node:path";
+import{existsSync as L}from"node:fs";import{fileTypeFromFile as H}from"file-type";
+import{isAnyObject as U,toKebabCase as A}from"@ez4/utils";import{getServiceName as N}from"@ez4/project/library";
+import{BucketEventType as h}from"@ez4/storage";import{Logger as g}from"@ez4/logger";var S=c((t,r)=>{let i=N(t,r),o=m(".ez4",A(t)),n=r.events;return new class{async stat(e){
+let a=m(o,e);try{let s=await H(a),l=await d(a);return{type:s?.mime??"application\
+/octet-stream",size:l.size}}catch(s){if(!U(s)||s.code!=="ENOENT")throw s;return}}async exists(e){
+let a=m(o,e);return Promise.resolve(L(a))}async write(e,a){let s=m(o,e);if(await $(
+q(s),{recursive:!0}),await T(s,a),g.log(`\u2B06\uFE0F  File ${e} uploaded.`),n&&
+(!n.path||e.startsWith(n.path))){let l=await d(s);await n.handler({eventType:h.Create,
+bucketName:i,objectSize:l.size,objectKey:e})}}async read(e){let a=m(o,e),s=await R(
+a);return g.log(`\u2B07\uFE0F  File ${e} downloaded.`),s}async delete(e){let a=m(
+o,e);await j(a),g.log(`\u2139\uFE0F  File ${e} deleted.`),n&&(!n.path||e.startsWith(
+n.path))&&await n.handler({eventType:h.Delete,bucketName:i,objectKey:e})}async copy(e,a){
+let s=m(o,e),l=m(o,a);await F(s,l),g.log(`\u2139\uFE0F  File ${e} copied.`)}async*scan(){
+let e=await x(o,{recursive:!0});for(let a of e){let{size:s,mtime:l}=await d(m(o,
+a));yield{key:a,modifiedAt:l,size:s}}}async getStatUrl(e,a){return Promise.resolve(
+`http://${r.serviceHost}/${i}/${e}`)}async getWriteUrl(e,a){return Promise.resolve(
+`http://${r.serviceHost}/${i}/${e}`)}async getReadUrl(e,a){return Promise.resolve(
+`http://${r.serviceHost}/${i}/${e}`)}}},"createLocalClient");var w=c(async(t,r,i)=>{let o=await _(t,r,i),{name:n}=t;return{type:"Storage",name:n,
+identifier:D(n,r),bootstrapHandler:c(()=>{W.log(`\u{1F4C2} ${r.local?"Local":"Re\
+mote"} storage [${n}] in use.`)},"bootstrapHandler"),requestHandler:c(e=>G(o,e),
+"requestHandler"),exportHandler:c(()=>o,"exportHandler")}},"registerBucketEmulat\
+or"),_=c(async(t,r,i)=>{let o=await I("emulator:getClient",n=>n({service:t,options:r}));
+if(!o){let{events:n}=t;return S(t.name,{...r,events:n&&{path:n.path,handler:c(e=>v(
+t,r,i,n,e),"handler")}})}return o},"getStorageClient"),G=c(async(t,r)=>{let{method:i,
+path:o,body:n}=r;if(!o||o==="/")throw new Error("File path wasn't given.");switch(i){case"\
+HEAD":return J(t,o);case"GET":return K(t,o);case"PUT":{if(!n)throw new Error("Fi\
+le content wasn't given.");return M(t,o,n)}default:throw new Error("Unsupported \
+storage request.")}},"handleRequest"),K=c(async(t,r)=>{let[i,o]=await Promise.all(
+[t.read(r),t.stat(r)]);return{status:200,body:i,headers:{"content-type":o?.type??
+"application/octet-stream"}}},"loadFile"),M=c(async(t,r,i)=>(await t.write(r,i),
+{status:204}),"storeFile"),J=c(async(t,r)=>{let i=await t.stat(r);return i?{status:200,
+headers:{"content-length":i.size.toString(),"content-type":i.type}}:{status:404}},
+"headFile");var Be=c(()=>{V(),X("@ez4/local-storage",{"emulator:getServices":c(({service:t,options:r,
+context:i})=>Q(t)?w(t,r,i):null,"emulator:getServices")})},"registerTriggers");export{Be as registerTriggers};
 //# sourceMappingURL=main.mjs.map

package/dist/provider/emulator.d.ts

@@ -1,7 +1,7 @@
-import type { EmulatorRequestEvent, ServeOptions } from '@ez4/project/library';
+import type { EmulateServiceContext, EmulatorRequestEvent, 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) => Promise<{
+export declare const registerBucketEmulator: (service: BucketService, options: ServeOptions, context: EmulateServiceContext) => Promise<{
     type: string;
     name: string;
     identifier: string;

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@ez4/local-storage",
   "description": "EZ4: Local storage emulator",
-  "version": "0.45.0",
+  "version": "0.46.0",
   "author": "Silas B.",
   "license": "MIT",
   "type": "module",
   "keywords": [
     "ez4",
-    "ez4-local"
+    "local",
+    "emulator",
+    "storage"
   ],
   "repository": {
     "type": "git",
@@ -48,11 +50,12 @@
     "live:publish": "npm run build && npm publish --access public"
   },
   "dependencies": {
-    "@ez4/local-common": "^0.45.0",
-    "@ez4/logger": "^0.45.0",
-    "@ez4/project": "^0.45.0",
-    "@ez4/storage": "^0.45.0",
-    "@ez4/utils": "^0.45.0",
+    "@ez4/common": "^0.46.0",
+    "@ez4/local-common": "^0.46.0",
+    "@ez4/logger": "^0.46.0",
+    "@ez4/project": "^0.46.0",
+    "@ez4/storage": "^0.46.0",
+    "@ez4/utils": "^0.46.0",
     "file-type": "^21.3.0"
   }
 }