@ez4/local-storage 0.44.0 → 0.46.0

package/dist/client/local.d.ts

@@ -0,0 +1,9 @@
+import type { ServeOptions } from '@ez4/project/library';
+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,30 +1,48 @@
-"use strict";var m=Object.defineProperty;var C=Object.getOwnPropertyDescriptor;var P=Object.getOwnPropertyNames;var F=Object.prototype.hasOwnProperty;var s=(t,e)=>m(t,"name",{value:e,configurable:!0});var $=(t,e)=>{for(var o in e)m(t,o,{get:e[o],enumerable:!0})},z=(t,e,o,i)=>{if(e&&
-typeof e=="object"||typeof e=="function")for(let r of P(e))!F.call(t,r)&&r!==o&&
-m(t,r,{get:()=>e[r],enumerable:!(i=C(e,r))||i.enumerable});return t};var b=t=>z(m({},"__esModule",{value:!0}),t);var q={};$(q,{registerTriggers:()=>B});module.exports=b(q);var u=require("@ez4/storage/library"),v=require("@ez4/project/library");var w=require("@ez4/project/library");var c=require("node:fs/promises"),l=require("node:path"),d=require("node:fs"),p=require("@ez4/utils"),
-y=require("@ez4/project/library"),g=require("@ez4/logger"),S=require("file-type");var f=s((t,e)=>{let o=(0,y.getServiceName)(t,e),i=(0,l.join)(".ez4",(0,p.toKebabCase)(
-t));return new class{async exists(r){let n=(0,l.join)(i,r);return Promise.resolve(
-(0,d.existsSync)(n))}async write(r,n){let a=(0,l.join)(i,r);await(0,c.mkdir)((0,l.dirname)(
-a),{recursive:!0}),await(0,c.writeFile)(a,n),g.Logger.log(`\u2B06\uFE0F  File ${r}\
- uploaded.`)}async read(r){let n=(0,l.join)(i,r),a=await(0,c.readFile)(n);return g.Logger.
-log(`\u2B07\uFE0F  File ${r} downloaded.`),a}async delete(r){let n=(0,l.join)(i,
-r);await(0,c.unlink)(n),g.Logger.log(`\u2139\uFE0F  File ${r} deleted.`)}async getWriteUrl(r,n){
-return Promise.resolve(`http://${e.serviceHost}/${o}/${r}`)}async getReadUrl(r,n){
-return Promise.resolve(`http://${e.serviceHost}/${o}/${r}`)}async getStatsUrl(r,n){
-return Promise.resolve(`http://${e.serviceHost}/${o}/${r}`)}async getStats(r){let n=(0,l.join)(
-i,r);try{let a=await(0,S.fileTypeFromFile)(n),E=await(0,c.stat)(n);return{type:a?.
-mime??"application/octet-stream",size:E.size}}catch(a){if(!(0,p.isAnyObject)(a)||
-a.code!=="ENOENT")throw a;return}}}},"createServiceClient");var h=s((t,e)=>{let o=f(t.name,e);return{type:"Storage",name:t.name,identifier:(0,w.getServiceName)(
-t.name,e),exportHandler:s(()=>f(t.name,e),"exportHandler"),requestHandler:s(i=>O(
-o,i),"requestHandler")}},"registerBucketEmulator"),O=s(async(t,e)=>{let{method:o,
-path:i,body:r}=e;if(!i||i==="/")throw new Error("File path wasn't given.");switch(o){case"\
-GET":return R(t,i);case"PUT":{if(!r)throw new Error("File content wasn't given.");
-return T(t,i,r)}case"HEAD":return x(t,i);default:throw new Error("Unsupported st\
-orage request.")}},"handleRequest"),R=s(async(t,e)=>{let[o,i]=await Promise.all(
-[t.read(e),t.getStats(e)]);return{status:200,body:o,headers:{"content-type":i?.type??
-"application/octet-stream"}}},"loadFile"),T=s(async(t,e,o)=>(await t.write(e,o),
-{status:204}),"storeFile"),x=s(async(t,e)=>{let o=await t.getStats(e);return{status:200,
-headers:{"content-type":o?.type??"application/octet-stream","content-length":o?.
-size.toString()??"0"}}},"headFile");var B=s(()=>{(0,u.registerTriggers)(),(0,v.tryCreateTrigger)("@ez4/local-storage",
-{"emulator:getServices":s(({service:t,options:e})=>(0,u.isBucketService)(t)?h(t,
-e):null,"emulator:getServices")})},"registerTriggers");0&&(module.exports={registerTriggers});
+"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"),
+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,28 +1,45 @@
-var u=Object.defineProperty;var s=(t,e)=>u(t,"name",{value:e,configurable:!0});import{isBucketService as T,registerTriggers as x}from"@ez4/storage/library";import{
-tryCreateTrigger as B}from"@ez4/project/library";import{getServiceName as $}from"@ez4/project/library";import{mkdir as f,readFile as d,stat as y,unlink as S,writeFile as w}from"node:fs/promises";
-import{dirname as h,join as c}from"node:path";import{existsSync as v}from"node:fs";
-import{isAnyObject as E,toKebabCase as C}from"@ez4/utils";import{getServiceName as P}from"@ez4/project/library";
-import{Logger as l}from"@ez4/logger";import{fileTypeFromFile as F}from"file-type";var m=s((t,e)=>{let i=P(t,e),o=c(".ez4",C(t));return new class{async exists(r){let n=c(
-o,r);return Promise.resolve(v(n))}async write(r,n){let a=c(o,r);await f(h(a),{recursive:!0}),
-await w(a,n),l.log(`\u2B06\uFE0F  File ${r} uploaded.`)}async read(r){let n=c(o,
-r),a=await d(n);return l.log(`\u2B07\uFE0F  File ${r} downloaded.`),a}async delete(r){
-let n=c(o,r);await S(n),l.log(`\u2139\uFE0F  File ${r} deleted.`)}async getWriteUrl(r,n){
-return Promise.resolve(`http://${e.serviceHost}/${i}/${r}`)}async getReadUrl(r,n){
-return Promise.resolve(`http://${e.serviceHost}/${i}/${r}`)}async getStatsUrl(r,n){
-return Promise.resolve(`http://${e.serviceHost}/${i}/${r}`)}async getStats(r){let n=c(
-o,r);try{let a=await F(n),p=await y(n);return{type:a?.mime??"application/octet-s\
-tream",size:p.size}}catch(a){if(!E(a)||a.code!=="ENOENT")throw a;return}}}},"cre\
-ateServiceClient");var g=s((t,e)=>{let i=m(t.name,e);return{type:"Storage",name:t.name,identifier:$(
-t.name,e),exportHandler:s(()=>m(t.name,e),"exportHandler"),requestHandler:s(o=>z(
-i,o),"requestHandler")}},"registerBucketEmulator"),z=s(async(t,e)=>{let{method:i,
-path:o,body:r}=e;if(!o||o==="/")throw new Error("File path wasn't given.");switch(i){case"\
-GET":return b(t,o);case"PUT":{if(!r)throw new Error("File content wasn't given.");
-return O(t,o,r)}case"HEAD":return R(t,o);default:throw new Error("Unsupported st\
-orage request.")}},"handleRequest"),b=s(async(t,e)=>{let[i,o]=await Promise.all(
-[t.read(e),t.getStats(e)]);return{status:200,body:i,headers:{"content-type":o?.type??
-"application/octet-stream"}}},"loadFile"),O=s(async(t,e,i)=>(await t.write(e,i),
-{status:204}),"storeFile"),R=s(async(t,e)=>{let i=await t.getStats(e);return{status:200,
-headers:{"content-type":i?.type??"application/octet-stream","content-length":i?.
-size.toString()??"0"}}},"headFile");var X=s(()=>{x(),B("@ez4/local-storage",{"emulator:getServices":s(({service:t,options:e})=>T(
-t)?g(t,e):null,"emulator:getServices")})},"registerTriggers");export{X 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,12 +1,13 @@
-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) => {
+export declare const registerBucketEmulator: (service: BucketService, options: ServeOptions, context: EmulateServiceContext) => Promise<{
     type: string;
     name: string;
     identifier: string;
-    exportHandler: () => StorageClient;
+    bootstrapHandler: () => void;
     requestHandler: (request: EmulatorRequestEvent) => Promise<{
         status: number;
     }>;
-};
+    exportHandler: () => StorageClient;
+}>;

package/dist/run.cjs

@@ -0,0 +1,4 @@
+"use strict";var i=Object.defineProperty;var a=Object.getOwnPropertyDescriptor;var g=Object.getOwnPropertyNames;var l=Object.prototype.hasOwnProperty;var p=(t,e)=>i(t,"name",{value:e,configurable:!0});var C=(t,e)=>{for(var r in e)i(t,r,{get:e[r],enumerable:!0})},f=(t,e,r,n)=>{if(e&&
+typeof e=="object"||typeof e=="function")for(let o of g(e))!l.call(t,o)&&o!==r&&
+i(t,o,{get:()=>e[o],enumerable:!(n=a(e,o))||n.enumerable});return t};var x=t=>f(i({},"__esModule",{value:!0}),t);var c={};C(c,{BucketRunner:()=>s});module.exports=x(c);var m=require("@ez4/project/library");var s;(e=>e.getClient=p(r=>m.Runner.getServiceClient(r),"getClient"))(s||={});0&&(module.exports={BucketRunner});
+//# sourceMappingURL=run.cjs.map

package/dist/run.d.ts

@@ -0,0 +1 @@
+export * from './service/runner';

package/dist/run.mjs

@@ -0,0 +1,2 @@
+var i=Object.defineProperty;var r=(t,e)=>i(t,"name",{value:e,configurable:!0});import{Runner as n}from"@ez4/project/library";var p;(e=>e.getClient=r(o=>n.getServiceClient(o),"getClient"))(p||={});export{p as BucketRunner};
+//# sourceMappingURL=run.mjs.map

package/dist/service/runner.d.ts

@@ -0,0 +1,4 @@
+import type { Client } from '@ez4/storage';
+export declare namespace BucketRunner {
+    const getClient: (resourceName: string) => Client;
+}

package/dist/service/tester.d.ts

@@ -4,14 +4,16 @@ import type { ClientMockOptions } from '../client/mock';
 export declare namespace BucketTester {
     type MockOptions = ClientMockOptions;
     type ClientMock = Client & {
+        stat: Mock<Client['stat']>;
         exists: Mock<Client['exists']>;
         write: Mock<Client['write']>;
         read: Mock<Client['read']>;
         delete: Mock<Client['delete']>;
+        copy: Mock<Client['copy']>;
+        scan: Mock<Client['scan']>;
+        getStatUrl: Mock<Client['getStatUrl']>;
         getWriteUrl: Mock<Client['getWriteUrl']>;
         getReadUrl: Mock<Client['getReadUrl']>;
-        getStatsUrl: Mock<Client['getStatsUrl']>;
-        getStats: Mock<Client['getStats']>;
     };
     const getClient: (resourceName: string) => Client;
     const getClientMock: (resourceName: string, options?: MockOptions) => ClientMock;

package/dist/test.cjs

@@ -1,21 +1,25 @@
-"use strict";var m=Object.defineProperty;var y=Object.getOwnPropertyDescriptor;var S=Object.getOwnPropertyNames;var k=Object.prototype.hasOwnProperty;var a=(o,r)=>m(o,"name",{value:r,configurable:!0});var h=(o,r)=>{for(var n in r)m(o,n,{get:r[n],enumerable:!0})},x=(o,r,n,i)=>{if(r&&
-typeof r=="object"||typeof r=="function")for(let e of S(r))!k.call(o,e)&&e!==n&&
-m(o,e,{get:()=>r[e],enumerable:!(i=y(r,e))||i.enumerable});return o};var O=o=>x(m({},"__esModule",{value:!0}),o);var P={};h(P,{BucketTester:()=>u});module.exports=O(P);var p=require("@ez4/project/library"),l=require("node:test");var d=require("node:stream"),f=require("@ez4/utils"),g=require("@ez4/logger"),C=require("file-type");var M=a((o,r)=>{let n=(0,f.toKebabCase)(o),i=r?.keys??{};return new class{async exists(e){
-let t=i[e]??r?.default;return Promise.resolve(!!t)}async write(e,t){return g.Logger.
-log(`\u2B06\uFE0F  File ${e} uploaded.`),t instanceof d.Readable?i[e]=t.read():i[e]=
-Buffer.from(t),Promise.resolve()}async read(e){let t=i[e]??r?.default;if(!t)throw new Error(
-`Key ${e} not found.`);return g.Logger.log(`\u2B07\uFE0F  File ${e} downloaded.`),
-Promise.resolve(Buffer.from(t))}async delete(e){if(!i[e]){if(!r?.default)throw new Error(
-`Key ${e} not found.`);return Promise.resolve()}return g.Logger.log(`\u2139\uFE0F  File ${e}\
- deleted.`),delete i[e],Promise.resolve()}async getWriteUrl(e,t){return Promise.
-resolve(`http://${n}/${e}`)}async getReadUrl(e,t){return Promise.resolve(`http:/\
-/${n}/${e}`)}async getStatsUrl(e,t){return Promise.resolve(`http://${n}/${e}`)}async getStats(e){
-let t=i[e]??r?.default;return t?{type:(await(0,C.fileTypeFromBuffer)(t))?.mime??
-"application/octet-stream",size:t.byteLength}:void 0}}},"createClientMock");var u;(e=>(e.getClient=a(t=>p.Tester.getServiceClient(t),"getClient"),e.getClientMock=
-a((t,c)=>{let s=M(t,c);return l.mock.method(s,"exists"),l.mock.method(s,"write"),
-l.mock.method(s,"read"),l.mock.method(s,"delete"),l.mock.method(s,"getWriteUrl"),
-l.mock.method(s,"getReadUrl"),l.mock.method(s,"getStatsUrl"),l.mock.method(s,"ge\
-tStats"),s},"getClientMock"),e.setClientMock=a((t,c)=>{p.Tester.mockServiceClient(
-t,(0,e.getClientMock)(t,c))},"setClientMock"),e.restoreClient=a(t=>{p.Tester.restoreServiceClient(
-t)},"restoreClient")))(u||={});0&&(module.exports={BucketTester});
+"use strict";var d=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var h=Object.getOwnPropertyNames;var k=Object.prototype.hasOwnProperty;var a=(n,o)=>d(n,"name",{value:o,configurable:!0});var v=(n,o)=>{for(var l in o)d(n,l,{get:o[l],enumerable:!0})},w=(n,o,l,r)=>{if(o&&
+typeof o=="object"||typeof o=="function")for(let e of h(o))!k.call(n,e)&&e!==l&&
+d(n,e,{get:()=>o[e],enumerable:!(r=u(o,e))||r.enumerable});return n};var x=n=>w(d({},"__esModule",{value:!0}),n);var O={};v(O,{BucketTester:()=>M});module.exports=x(O);var p=require("@ez4/project/library"),s=require("node:test");var g=require("node:stream"),f=require("file-type"),C=require("@ez4/utils"),m=require("@ez4/logger");var y=a((n,o)=>{let l=(0,C.toKebabCase)(n),r=o?.keys??{};return new class{async stat(e){
+let t=r[e]??o?.default;return t?{type:(await(0,f.fileTypeFromBuffer)(t))?.mime??
+"application/octet-stream",size:t.byteLength}:void 0}async exists(e){let t=r[e]??
+o?.default;return Promise.resolve(!!t)}async write(e,t){return m.Logger.log(`\u2B06\uFE0F \
+ File ${e} uploaded.`),t instanceof g.Readable?r[e]=t.read():r[e]=Buffer.from(t),
+Promise.resolve()}async read(e){let t=r[e]??o?.default;if(!t)throw new Error(`Ke\
+y ${e} not found.`);return m.Logger.log(`\u2B07\uFE0F  File ${e} downloaded.`),Promise.
+resolve(Buffer.from(t))}async delete(e){if(!r[e]){if(!o?.default)throw new Error(
+`Key ${e} not found.`);return Promise.resolve()}return m.Logger.log(`\u2139\uFE0F  File ${e}\
+ deleted.`),delete r[e],Promise.resolve()}async copy(e,t){let c=r[e]??o?.default;
+if(!c)throw new Error(`Key ${e} not found.`);return m.Logger.log(`\u2139\uFE0F  File ${e}\
+ copied.`),r[t]=c,Promise.resolve()}async*scan(){for(let e in r){let t=r[e];yield Promise.
+resolve({modifiedAt:new Date,size:t.length,key:e})}}async getStatUrl(e,t){return Promise.
+resolve(`http://${l}/${e}`)}async getWriteUrl(e,t){return Promise.resolve(`http:\
+//${l}/${e}`)}async getReadUrl(e,t){return Promise.resolve(`http://${l}/${e}`)}}},
+"createClientMock");var M;(e=>(e.getClient=a(t=>p.Tester.getServiceClient(t),"getClient"),e.getClientMock=
+a((t,c)=>{let i=y(t,c);return s.mock.method(i,"stat"),s.mock.method(i,"exists"),
+s.mock.method(i,"write"),s.mock.method(i,"read"),s.mock.method(i,"delete"),s.mock.
+method(i,"copy"),s.mock.method(i,"scan"),s.mock.method(i,"getStatUrl"),s.mock.method(
+i,"getWriteUrl"),s.mock.method(i,"getReadUrl"),i},"getClientMock"),e.setClientMock=
+a((t,c)=>{p.Tester.mockServiceClient(t,(0,e.getClientMock)(t,c))},"setClientMock"),
+e.restoreClient=a(t=>{p.Tester.restoreServiceClient(t)},"restoreClient")))(M||={});0&&(module.exports={BucketTester});
 //# sourceMappingURL=test.cjs.map

package/dist/test.mjs

@@ -1,18 +1,23 @@
-var d=Object.defineProperty;var s=(l,r)=>d(l,"name",{value:r,configurable:!0});import{Tester as g}from"@ez4/project/library";import{mock as n}from"node:test";import{Readable as f}from"node:stream";import{toKebabCase as C}from"@ez4/utils";
-import{Logger as m}from"@ez4/logger";import{fileTypeFromBuffer as M}from"file-type";var p=s((l,r)=>{let a=C(l),i=r?.keys??{};return new class{async exists(e){let t=i[e]??
-r?.default;return Promise.resolve(!!t)}async write(e,t){return m.log(`\u2B06\uFE0F  File ${e}\
- uploaded.`),t instanceof f?i[e]=t.read():i[e]=Buffer.from(t),Promise.resolve()}async read(e){
-let t=i[e]??r?.default;if(!t)throw new Error(`Key ${e} not found.`);return m.log(
-`\u2B07\uFE0F  File ${e} downloaded.`),Promise.resolve(Buffer.from(t))}async delete(e){
-if(!i[e]){if(!r?.default)throw new Error(`Key ${e} not found.`);return Promise.resolve()}
-return m.log(`\u2139\uFE0F  File ${e} deleted.`),delete i[e],Promise.resolve()}async getWriteUrl(e,t){
-return Promise.resolve(`http://${a}/${e}`)}async getReadUrl(e,t){return Promise.
-resolve(`http://${a}/${e}`)}async getStatsUrl(e,t){return Promise.resolve(`http:\
-//${a}/${e}`)}async getStats(e){let t=i[e]??r?.default;return t?{type:(await M(t))?.
-mime??"application/octet-stream",size:t.byteLength}:void 0}}},"createClientMock");var u;(e=>(e.getClient=s(t=>g.getServiceClient(t),"getClient"),e.getClientMock=s(
-(t,c)=>{let o=p(t,c);return n.method(o,"exists"),n.method(o,"write"),n.method(o,
-"read"),n.method(o,"delete"),n.method(o,"getWriteUrl"),n.method(o,"getReadUrl"),
-n.method(o,"getStatsUrl"),n.method(o,"getStats"),o},"getClientMock"),e.setClientMock=
-s((t,c)=>{g.mockServiceClient(t,(0,e.getClientMock)(t,c))},"setClientMock"),e.restoreClient=
-s(t=>{g.restoreServiceClient(t)},"restoreClient")))(u||={});export{u as BucketTester};
+var g=Object.defineProperty;var l=(c,n)=>g(c,"name",{value:n,configurable:!0});import{Tester as d}from"@ez4/project/library";import{mock as i}from"node:test";import{Readable as f}from"node:stream";import{fileTypeFromBuffer as C}from"file-type";
+import{toKebabCase as y}from"@ez4/utils";import{Logger as m}from"@ez4/logger";var p=l((c,n)=>{let a=y(c),o=n?.keys??{};return new class{async stat(e){let t=o[e]??
+n?.default;return t?{type:(await C(t))?.mime??"application/octet-stream",size:t.
+byteLength}:void 0}async exists(e){let t=o[e]??n?.default;return Promise.resolve(
+!!t)}async write(e,t){return m.log(`\u2B06\uFE0F  File ${e} uploaded.`),t instanceof
+f?o[e]=t.read():o[e]=Buffer.from(t),Promise.resolve()}async read(e){let t=o[e]??
+n?.default;if(!t)throw new Error(`Key ${e} not found.`);return m.log(`\u2B07\uFE0F  File ${e}\
+ downloaded.`),Promise.resolve(Buffer.from(t))}async delete(e){if(!o[e]){if(!n?.
+default)throw new Error(`Key ${e} not found.`);return Promise.resolve()}return m.
+log(`\u2139\uFE0F  File ${e} deleted.`),delete o[e],Promise.resolve()}async copy(e,t){
+let s=o[e]??n?.default;if(!s)throw new Error(`Key ${e} not found.`);return m.log(
+`\u2139\uFE0F  File ${e} copied.`),o[t]=s,Promise.resolve()}async*scan(){for(let e in o){
+let t=o[e];yield Promise.resolve({modifiedAt:new Date,size:t.length,key:e})}}async getStatUrl(e,t){
+return Promise.resolve(`http://${a}/${e}`)}async getWriteUrl(e,t){return Promise.
+resolve(`http://${a}/${e}`)}async getReadUrl(e,t){return Promise.resolve(`http:/\
+/${a}/${e}`)}}},"createClientMock");var M;(e=>(e.getClient=l(t=>d.getServiceClient(t),"getClient"),e.getClientMock=l(
+(t,s)=>{let r=p(t,s);return i.method(r,"stat"),i.method(r,"exists"),i.method(r,"\
+write"),i.method(r,"read"),i.method(r,"delete"),i.method(r,"copy"),i.method(r,"s\
+can"),i.method(r,"getStatUrl"),i.method(r,"getWriteUrl"),i.method(r,"getReadUrl"),
+r},"getClientMock"),e.setClientMock=l((t,s)=>{d.mockServiceClient(t,(0,e.getClientMock)(
+t,s))},"setClientMock"),e.restoreClient=l(t=>{d.restoreServiceClient(t)},"restor\
+eClient")))(M||={});export{M as BucketTester};
 //# sourceMappingURL=test.mjs.map

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "@ez4/local-storage",
   "description": "EZ4: Local storage emulator",
-  "version": "0.44.0",
+  "version": "0.46.0",
   "author": "Silas B.",
   "license": "MIT",
   "type": "module",
   "keywords": [
     "ez4",
-    "ez4-local"
+    "local",
+    "emulator",
+    "storage"
   ],
   "repository": {
     "type": "git",
@@ -27,6 +29,11 @@
       "types": "./dist/test.d.ts",
       "require": "./dist/test.cjs",
       "import": "./dist/test.mjs"
+    },
+    "./run": {
+      "types": "./dist/run.d.ts",
+      "require": "./dist/run.cjs",
+      "import": "./dist/run.mjs"
     }
   },
   "workspaces": [
@@ -43,11 +50,12 @@
     "live:publish": "npm run build && npm publish --access public"
   },
   "dependencies": {
-    "@ez4/local-common": "^0.44.0",
-    "@ez4/logger": "^0.44.0",
-    "@ez4/project": "^0.44.0",
-    "@ez4/storage": "^0.44.0",
-    "@ez4/utils": "^0.44.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"
   }
 }