@ez4/aws-bucket 0.13.0 → 0.14.0

package/README.md

@@ -30,6 +30,7 @@ Ensure the user performing deployments has the permissions below:
         "s3:DeleteObject",
         "s3:PutBucketCORS",
         "s3:PutLifecycleConfiguration",
+        "s3:PutBucketNotification",
         "s3:PutBucketPolicy",
         "s3:DeleteBucketPolicy",
         "s3:PutBucketTagging",

package/dist/bucket/client.d.ts

@@ -1,15 +1,23 @@
-import type { ResourceTags } from '@ez4/aws-common';
+import type { Arn, ResourceTags } from '@ez4/aws-common';
 import type { Bucket } from '@ez4/storage';
+import { Event } from '@aws-sdk/client-s3';
 export type CreateRequest = {
     bucketName: string;
 };
 export type CreateResponse = {
     bucketName: string;
 };
+export type UpdateNotificationRequest = {
+    functionArn?: Arn;
+    eventsPath?: string;
+    eventsType: Event[];
+};
+export declare const isBucketEmpty: (bucketName: string) => Promise<boolean>;
 export declare const createBucket: (request: CreateRequest) => Promise<CreateResponse>;
+export declare const deleteBucket: (bucketName: string) => Promise<void>;
 export declare const tagBucket: (bucketName: string, tags: ResourceTags) => Promise<void>;
 export declare const updateCorsConfiguration: (bucketName: string, cors: Bucket.Cors) => Promise<void>;
 export declare const deleteCorsConfiguration: (bucketName: string) => Promise<void>;
 export declare const createLifecycle: (bucketName: string, autoExpireDays: number) => Promise<void>;
 export declare const deleteLifecycle: (bucketName: string) => Promise<void>;
-export declare const deleteBucket: (bucketName: string) => Promise<void>;
+export declare const updateEventNotifications: (bucketName: string, request: UpdateNotificationRequest) => Promise<void>;

package/dist/bucket/function/bundler.d.ts

@@ -0,0 +1,3 @@
+import type { EntryState } from '@ez4/stateful';
+import type { BucketEventFunctionParameters } from './types.js';
+export declare const bundleBucketEventFunction: (dependencies: EntryState[], parameters: BucketEventFunctionParameters) => Promise<string>;

package/dist/bucket/function/service.d.ts

@@ -0,0 +1,4 @@
+import type { RoleState } from '@ez4/aws-identity';
+import type { EntryState, EntryStates } from '@ez4/stateful';
+import type { BucketEventFunctionParameters } from './types.js';
+export declare const createBucketEventFunction: <E extends EntryState>(state: EntryStates<E>, roleState: RoleState, parameters: BucketEventFunctionParameters) => import("@ez4/aws-function").FunctionState;

package/dist/bucket/function/types.d.ts

@@ -0,0 +1,6 @@
+import type { FunctionParameters } from '@ez4/aws-function';
+import type { ExtraSource } from '@ez4/project/library';
+export type BucketEventFunctionParameters = Omit<FunctionParameters, 'getFunctionBundle'> & {
+    extras?: Record<string, ExtraSource>;
+    debug?: boolean;
+};

package/dist/bucket/service.d.ts

@@ -1,3 +1,4 @@
 import type { EntryState, EntryStates } from '@ez4/stateful';
+import type { FunctionState } from '@ez4/aws-function';
 import type { BucketParameters, BucketState } from './types.js';
-export declare const createBucket: <E extends EntryState>(state: EntryStates<E>, parameters: BucketParameters) => BucketState;
+export declare const createBucket: <E extends EntryState>(state: EntryStates<E>, functionState: FunctionState | undefined, parameters: BucketParameters) => BucketState;

package/dist/bucket/types.d.ts

@@ -1,16 +1,19 @@
+import type { Arn, ResourceTags } from '@ez4/aws-common';
 import type { EntryState } from '@ez4/stateful';
-import type { ResourceTags } from '@ez4/aws-common';
 import type { Bucket } from '@ez4/storage';
 import type { CreateRequest, CreateResponse } from './client.js';
 export declare const BucketServiceName = "AWS:S3/Bucket";
 export declare const BucketServiceType = "aws:s3.bucket";
 export type BucketParameters = CreateRequest & {
+    eventsPath?: string;
     autoExpireDays?: number;
     localPath?: string;
     tags?: ResourceTags;
     cors?: Bucket.Cors;
 };
-export type BucketResult = CreateResponse;
+export type BucketResult = CreateResponse & {
+    functionArn: Arn | undefined;
+};
 export type BucketState = EntryState & {
     type: typeof BucketServiceType;
     parameters: BucketParameters;

package/dist/main.cjs

@@ -1,88 +1,121 @@
-"use strict";var Ae=Object.create;var w=Object.defineProperty;var Fe=Object.getOwnPropertyDescriptor;var Ue=Object.getOwnPropertyNames;var Ge=Object.getPrototypeOf,We=Object.prototype.hasOwnProperty;var Ze=(e,t)=>{for(var r in t)w(e,r,{get:t[r],enumerable:!0})},I=(e,t,r,o)=>{if(t&&
-typeof t=="object"||typeof t=="function")for(let s of Ue(t))!We.call(e,s)&&s!==r&&
-w(e,s,{get:()=>t[s],enumerable:!(o=Fe(t,s))||o.enumerable});return e};var Je=(e,t,r)=>(r=e!=null?Ae(Ge(e)):{},I(t||!e||!e.__esModule?w(r,"default",{value:e,
-enumerable:!0}):r,e)),Qe=e=>I(w({},"__esModule",{value:!0}),e);var Bt={};Ze(Bt,{BucketServiceName:()=>n,BucketServiceType:()=>p,ObjectServiceName:()=>y,
-ObjectServiceType:()=>m,PolicyServiceName:()=>g,PolicyServiceType:()=>u,createBucket:()=>z,
-createBucketObject:()=>bt,createBucketPolicy:()=>kt,getBucketDomain:()=>St,getBucketName:()=>b,
-getBucketObjectFiles:()=>it,getBucketObjectPath:()=>B,getBucketState:()=>tt,getBucketStateId:()=>C,
-getPolicyDocument:()=>N,isBucketDomain:()=>dt,isBucketObjectState:()=>nt,isBucketPolicyState:()=>Pt,
-isBucketState:()=>Y,registerTriggers:()=>gt});module.exports=Qe(Bt);var Ne=require("@ez4/aws-common"),ze=require("@ez4/aws-identity"),Ie=require("@ez4/storage/library"),
-Le=require("@ez4/project/library");var Q=require("@ez4/aws-common");var F=require("@ez4/aws-common"),P=require("@ez4/utils");var i=require("@ez4/aws-common"),a=require("@aws-sdk/client-s3");var n="AWS:S3/Bucket",p="aws:s3.bucket";var f=new a.S3Client({}),L=async e=>{let{bucketName:t}=e;return i.Logger.logCreate(
-n,t),await f.send(new a.CreateBucketCommand({Bucket:t})),{bucketName:t}},q=async(e,t)=>{
-i.Logger.logTag(n,e),await f.send(new a.PutBucketTaggingCommand({Bucket:e,Tagging:{
-TagSet:(0,i.getTagList)({...t,ManagedBy:"EZ4"})}}))},K=async(e,t)=>{i.Logger.logUpdate(
-n,`${e} CORS`),await f.send(new a.PutBucketCorsCommand({Bucket:e,CORSConfiguration:{
-CORSRules:[{ID:"ID0",AllowedOrigins:t.allowOrigins,AllowedMethods:t.allowMethods,
-AllowedHeaders:t.allowHeaders,ExposeHeaders:t.exposeHeaders,MaxAgeSeconds:t.maxAge}]}}))},
-H=async e=>{i.Logger.logDelete(n,`${e} CORS`),await f.send(new a.DeleteBucketCorsCommand(
-{Bucket:e}))},M=async(e,t)=>{i.Logger.logCreate(n,`${e} lifecycle`),await f.send(
-new a.PutBucketLifecycleConfigurationCommand({Bucket:e,LifecycleConfiguration:{Rules:[
-{ID:"ID0",Status:a.ExpirationStatus.Enabled,Filter:{Prefix:"*"},Expiration:{Days:t}}]}}))},
-$=async e=>{i.Logger.logDelete(n,`${e} lifecycle`),await f.send(new a.DeleteBucketLifecycleCommand(
-{Bucket:e}))},A=async e=>{i.Logger.logDelete(n,e),await f.send(new a.DeleteBucketCommand(
-{Bucket:e}))};var U=()=>({equals:Ve,create:G,replace:Ye,preview:Xe,update:_e,delete:et}),Ve=(e,t)=>!!e.
-result&&e.result.bucketName===t.result?.bucketName,Xe=async(e,t)=>{let r={...e.parameters,
-dependencies:e.dependencies},o={...t.parameters,dependencies:t.dependencies},s=(0,P.deepCompare)(
-r,o);if(s.counts)return{...s,name:r.bucketName}},Ye=async(e,t)=>{if(t.result)throw new F.ReplaceResourceError(
-n,e.entryId,t.entryId);return G(e)},G=async e=>{let t=e.parameters,{bucketName:r}=await L(
-t);return await W(r,t,void 0),await Z(r,t,void 0),await J(r,t.tags,void 0),{bucketName:r}},
-_e=async(e,t)=>{let{result:r,parameters:o}=e;if(!r)return;let s=r.bucketName;await W(
-s,o,t.parameters),await Z(s,o,t.parameters),await J(s,o.tags,t.parameters.tags)},
-et=async e=>{let t=e.result;t&&await A(t.bucketName)},W=async(e,t,r)=>{if(!(t.cors&&
-r?.cors&&(0,P.deepEqual)(t.cors,r.cors))){if(t.cors)return K(e,t.cors);if(r?.cors)
-return H(e)}},Z=async(e,t,r)=>{if(t.autoExpireDays!==r?.autoExpireDays){if(t.autoExpireDays)
-return M(e,t.autoExpireDays);if(r?.autoExpireDays)return $(e)}},J=async(e,t,r)=>{
-let o=t??{};!(0,P.deepEqual)(o,r??{})&&await q(e,o)};var V=()=>{(0,Q.registerProvider)(p,U())};var ce=require("@ez4/aws-common");var re=require("@ez4/aws-common");var R=require("@ez4/stateful"),X=require("@ez4/aws-common"),j=require("@ez4/utils");var Y=e=>e.type===p,C=e=>(0,j.hashData)(p,(0,j.toKebabCase)(e)),tt=(e,t)=>{let r=(0,R.getEntry)(
-e,C(t));if(!Y(r))throw new R.EntryNotFoundError(r.entryId);return r},b=(e,t,r)=>{
-let o=r.getDependencies(p).at(0)?.result;if(!o?.bucketName)throw new X.IncompleteResourceError(
-e,t,"bucketName");return o.bucketName};var v=require("@ez4/aws-common"),S=require("@aws-sdk/client-s3");var g="AWS:S3/Policy",u="aws:s3.policy";var _=new S.S3Client({}),ee=async e=>{let{bucketName:t,role:r}=e;return v.Logger.
-logCreate(g,t),await _.send(new S.PutBucketPolicyCommand({Bucket:t,Policy:JSON.stringify(
-r)})),{bucketName:t}},te=async e=>{v.Logger.logDelete(g,e),await _.send(new S.DeleteBucketPolicyCommand(
-{Bucket:e}))};var oe=()=>({equals:rt,create:se,replace:st,preview:ot,update:ct,delete:at}),rt=(e,t)=>!!e.
-result&&e.result.bucketName===t.result?.bucketName,ot=async()=>{},st=async(e,t,r)=>{
-if(t.result)throw new re.ReplaceResourceError(g,e.entryId,t.entryId);return se(e,
-r)},se=async(e,t)=>{let r=e.parameters,o=b(g,"policy",t),s=await r.getRole(t);return await ee(
-{bucketName:o,role:s}),{bucketName:o}},ct=async()=>{},at=async e=>{let t=e.result;
-t&&await te(t.bucketName)};var ae=()=>{(0,ce.registerProvider)(u,oe())};var de=require("@ez4/aws-common");var ue=require("node:fs/promises"),ye=require("@ez4/aws-common"),E=require("@ez4/utils");var k=require("@ez4/aws-common"),ne=require("node:fs"),ie=Je(require("mime"),1),
-l=require("@aws-sdk/client-s3");var y="AWS:S3/Object",m="aws:s3.object";var nt=e=>e.type===m,B=(e,t)=>`${e}/${t}`,it=e=>e.getDependencies(m).map(({result:r})=>({
-lastModified:r?.lastModified,objectKey:r?.objectKey}));var T=new l.S3Client({}),h=async(e,t)=>{let{objectKey:r,filePath:o}=t;k.Logger.logCreate(
-y,B(e,r));let s=ie.default.getType(o);return await T.send(new l.PutObjectCommand(
-{Bucket:e,Key:r,Body:(0,ne.createReadStream)(o),...s&&{ContentType:s}})),{objectKey:r}},
-pe=async(e,t,r)=>{k.Logger.logTag(y,B(e,t)),await T.send(new l.PutObjectTaggingCommand(
-{Bucket:e,Key:t,Tagging:{TagSet:(0,k.getTagList)({...r,ManagedBy:"EZ4"})}}))},me=async(e,t)=>{
-k.Logger.logDelete(y,B(e,t)),await T.send(new l.DeleteObjectCommand({Bucket:e,Key:t}))};var le=()=>({equals:pt,create:fe,replace:ut,preview:mt,update:yt,delete:lt}),pt=(e,t)=>!!e.
-result&&e.result.objectKey===t.result?.objectKey,mt=async(e,t)=>{let r=e.parameters,
-o=t.parameters,s=(0,E.deepCompare)({...r,dependencies:e.dependencies,lastModified:await D(
+"use strict";var dt=Object.create;var v=Object.defineProperty;var St=Object.getOwnPropertyDescriptor;var kt=Object.getOwnPropertyNames;var bt=Object.getPrototypeOf,Pt=Object.prototype.hasOwnProperty;var xt=(e,t)=>{for(var r in t)v(e,r,{get:t[r],enumerable:!0})},W=(e,t,r,o)=>{if(t&&
+typeof t=="object"||typeof t=="function")for(let n of kt(t))!Pt.call(e,n)&&n!==r&&
+v(e,n,{get:()=>t[n],enumerable:!(o=St(t,n))||o.enumerable});return e};var Bt=(e,t,r)=>(r=e!=null?dt(bt(e)):{},W(t||!e||!e.__esModule?v(r,"default",{value:e,
+enumerable:!0}):r,e)),wt=e=>W(v({},"__esModule",{value:!0}),e);var Jt={};xt(Jt,{BucketServiceName:()=>i,BucketServiceType:()=>m,ObjectServiceName:()=>g,
+ObjectServiceType:()=>y,PolicyServiceName:()=>S,PolicyServiceType:()=>f,buildBucketArn:()=>q,
+createBucket:()=>M,createBucketEventFunction:()=>H,createBucketObject:()=>Zt,createBucketPolicy:()=>Vt,
+getBucketDomain:()=>Gt,getBucketName:()=>B,getBucketObjectFiles:()=>At,getBucketObjectPath:()=>w,
+getBucketState:()=>Ot,getBucketStateId:()=>b,getPolicyDocument:()=>K,isBucketDomain:()=>_t,
+isBucketObjectState:()=>Ft,isBucketPolicyState:()=>Wt,isBucketState:()=>fe,registerTriggers:()=>Ut});
+module.exports=wt(Jt);var ot=require("@ez4/aws-common"),nt=require("@ez4/aws-identity"),st=require("@ez4/aws-function"),
+ct=require("@ez4/storage/library"),at=require("@ez4/project/library");var ue=require("@ez4/aws-common");var ne=require("@ez4/aws-common"),z=require("@ez4/aws-function"),k=require("@ez4/utils");var p=require("@ez4/aws-common"),c=require("@aws-sdk/client-s3");var i="AWS:S3/Bucket",m="aws:s3.bucket";var u=new c.S3Client({}),Z=async e=>(p.Logger.logFetch(i,e),!(await u.send(new c.ListObjectsV2Command(
+{Bucket:e,MaxKeys:1}))).Contents?.length),J=async e=>{let{bucketName:t}=e;return p.Logger.
+logCreate(i,t),await u.send(new c.CreateBucketCommand({Bucket:t})),{bucketName:t}},
+Q=async e=>{p.Logger.logDelete(i,e),await u.send(new c.DeleteBucketCommand({Bucket:e}))},
+X=async(e,t)=>{p.Logger.logTag(i,e),await u.send(new c.PutBucketTaggingCommand({
+Bucket:e,Tagging:{TagSet:(0,p.getTagList)({...t,ManagedBy:"EZ4"})}}))},Y=async(e,t)=>{
+p.Logger.logUpdate(i,`${e} CORS`),await u.send(new c.PutBucketCorsCommand({Bucket:e,
+CORSConfiguration:{CORSRules:[{ID:"ID0",AllowedOrigins:t.allowOrigins,AllowedMethods:t.
+allowMethods,AllowedHeaders:t.allowHeaders,ExposeHeaders:t.exposeHeaders,MaxAgeSeconds:t.
+maxAge}]}}))},ee=async e=>{p.Logger.logDelete(i,`${e} CORS`),await u.send(new c.DeleteBucketCorsCommand(
+{Bucket:e}))},te=async(e,t)=>{p.Logger.logCreate(i,`${e} lifecycle`),await u.send(
+new c.PutBucketLifecycleConfigurationCommand({Bucket:e,LifecycleConfiguration:{Rules:[
+{ID:"ID0",Status:c.ExpirationStatus.Enabled,Filter:{Prefix:"*"},Expiration:{Days:t}}]}}))},
+re=async e=>{p.Logger.logDelete(i,`${e} lifecycle`),await u.send(new c.DeleteBucketLifecycleCommand(
+{Bucket:e}))},oe=async(e,t)=>{p.Logger.logUpdate(i,`${e} event notifications`);let{
+functionArn:r,eventsPath:o,eventsType:n}=t;await u.send(new c.PutBucketNotificationConfigurationCommand(
+{Bucket:e,SkipDestinationValidation:!0,NotificationConfiguration:{...r&&{LambdaFunctionConfigurations:[
+{Id:"ID0",LambdaFunctionArn:r,Events:n,...o&&{Filter:{Key:{FilterRules:[{Name:"p\
+refix",Value:o}]}}}}]}}}))};var se=()=>({equals:Rt,create:ce,replace:vt,preview:Et,update:Ct,delete:jt}),Rt=(e,t)=>!!e.
+result&&e.result.bucketName===t.result?.bucketName,Et=async(e,t)=>{let r={...e.parameters,
+dependencies:e.dependencies},o={...t.parameters,dependencies:t.dependencies},n=(0,k.deepCompare)(
+r,o);if(n.counts)return{...n,name:r.bucketName}},vt=async(e,t,r)=>{if(t.result)throw new ne.ReplaceResourceError(
+i,e.entryId,t.entryId);return ce(e,r)},ce=async(e,t)=>{let r=e.parameters,o=(0,z.tryGetFunctionArn)(
+t),{bucketName:n}=await J(r);await ae(n,r,void 0),await ie(n,r,void 0),await pe(
+n,r.tags,void 0);let s={eventsPath:r.eventsPath,functionArn:o};return await me(n,
+s,{}),{bucketName:n,functionArn:o}},Ct=async(e,t,r)=>{let{result:o,parameters:n}=e;
+if(!o)return;let s=o.bucketName,a=(0,z.tryGetFunctionArn)(r),l=t.result?.functionArn;
+await ae(s,n,t.parameters),await ie(s,n,t.parameters),await pe(s,n.tags,t.parameters.
+tags);let N={eventsPath:n.eventsPath,functionArn:a},D={eventsPath:t.parameters.eventsPath,
+functionArn:l};return await me(s,N,D),{...o,functionArn:a}},jt=async e=>{let t=e.
+result;t&&await Z(t.bucketName)&&await Q(t.bucketName)},ae=async(e,t,r)=>{if(!(t.
+cors&&r?.cors&&(0,k.deepEqual)(t.cors,r.cors))){if(t.cors)return Y(e,t.cors);if(r?.
+cors)return ee(e)}},ie=async(e,t,r)=>{if(t.autoExpireDays!==r?.autoExpireDays){if(t.
+autoExpireDays)return te(e,t.autoExpireDays);if(r?.autoExpireDays)return re(e)}},
+pe=async(e,t,r)=>{let o=t??{};!(0,k.deepEqual)(o,r??{})&&await X(e,o)},me=async(e,t,r)=>{
+!(0,k.deepEqual)(t,r)&&await oe(e,{eventsType:["s3:ObjectCreated:*","s3:ObjectRe\
+moved:*"],...t})};var ye=()=>{(0,ue.registerProvider)(m,se())};var xe=require("@ez4/aws-common");var ke=require("@ez4/aws-common");var C=require("@ez4/stateful"),le=require("@ez4/aws-common"),j=require("@ez4/utils");var fe=e=>e.type===m,b=e=>(0,j.hashData)(m,(0,j.toKebabCase)(e)),Ot=(e,t)=>{let r=(0,C.getEntry)(
+e,b(t));if(!fe(r))throw new C.EntryNotFoundError(r.entryId);return r},B=(e,t,r)=>{
+let o=r.getDependencies(m).at(0)?.result;if(!o?.bucketName)throw new le.IncompleteResourceError(
+e,t,"bucketName");return o.bucketName};var F=require("@ez4/aws-common"),P=require("@aws-sdk/client-s3");var S="AWS:S3/Policy",f="aws:s3.policy";var ge=new P.S3Client({}),de=async e=>{let{bucketName:t,role:r}=e;return F.Logger.
+logCreate(S,t),await ge.send(new P.PutBucketPolicyCommand({Bucket:t,Policy:JSON.
+stringify(r)})),{bucketName:t}},Se=async e=>{F.Logger.logDelete(S,e),await ge.send(
+new P.DeleteBucketPolicyCommand({Bucket:e}))};var be=()=>({equals:ht,create:Pe,replace:Nt,preview:Tt,update:Dt,delete:zt}),ht=(e,t)=>!!e.
+result&&e.result.bucketName===t.result?.bucketName,Tt=async()=>{},Nt=async(e,t,r)=>{
+if(t.result)throw new ke.ReplaceResourceError(S,e.entryId,t.entryId);return Pe(e,
+r)},Pe=async(e,t)=>{let r=e.parameters,o=B(S,"policy",t),n=await r.getRole(t);return await de(
+{bucketName:o,role:n}),{bucketName:o}},Dt=async()=>{},zt=async e=>{let t=e.result;
+t&&await Se(t.bucketName)};var Be=()=>{(0,xe.registerProvider)(f,be())};var Ne=require("@ez4/aws-common");var Ce=require("node:fs/promises"),je=require("@ez4/aws-common"),O=require("@ez4/utils");var x=require("@ez4/aws-common"),we=require("node:fs"),Re=Bt(require("mime"),1),
+d=require("@aws-sdk/client-s3");var g="AWS:S3/Object",y="aws:s3.object";var Ft=e=>e.type===y,w=(e,t)=>`${e}/${t}`,At=e=>e.getDependencies(y).map(({result:r})=>({
+lastModified:r?.lastModified,objectKey:r?.objectKey}));var A=new d.S3Client({}),I=async(e,t)=>{let{objectKey:r,filePath:o}=t;x.Logger.logCreate(
+g,w(e,r));let n=Re.default.getType(o);return await A.send(new d.PutObjectCommand(
+{Bucket:e,Key:r,Body:(0,we.createReadStream)(o),...n&&{ContentType:n}})),{objectKey:r}},
+Ee=async(e,t,r)=>{x.Logger.logTag(g,w(e,t)),await A.send(new d.PutObjectTaggingCommand(
+{Bucket:e,Key:t,Tagging:{TagSet:(0,x.getTagList)({...r,ManagedBy:"EZ4"})}}))},ve=async(e,t)=>{
+x.Logger.logDelete(g,w(e,t)),await A.send(new d.DeleteObjectCommand({Bucket:e,Key:t}))};var Oe=()=>({equals:It,create:he,replace:qt,preview:Lt,update:Kt,delete:Mt}),It=(e,t)=>!!e.
+result&&e.result.objectKey===t.result?.objectKey,Lt=async(e,t)=>{let r=e.parameters,
+o=t.parameters,n=(0,O.deepCompare)({...r,dependencies:e.dependencies,lastModified:await L(
 r.filePath)},{...o,dependencies:t.dependencies,lastModified:e.result?.lastModified});
-if(s.counts)return{...s,name:r.objectKey}},ut=async(e,t,r)=>{if(t.result)throw new ye.ReplaceResourceError(
-y,e.entryId,t.entryId);return fe(e,r)},fe=async(e,t)=>{let r=e.parameters,o=b(y,
-"bucket",t),s=await D(r.filePath),{objectKey:c}=await h(o,r);return await ge(o,c,
-r.tags,e.parameters.tags),{lastModified:s,bucketName:o,objectKey:c}},yt=async(e,t)=>{
-let{result:r,parameters:o}=e;if(!r)return;let{bucketName:s,objectKey:c}=r,d=ft(r,
-o,t.parameters);return await ge(s,c,o.tags,t.parameters.tags),d},lt=async e=>{let t=e.
-result;t&&await me(t.bucketName,t.objectKey)},D=async e=>{let{mtime:t}=await(0,ue.stat)(
-e);return t.getTime()},ft=async(e,t,r)=>{let o=await D(t.filePath);if(o<=e.lastModified&&
-t.filePath===r.filePath)return e;let{bucketName:s,objectKey:c}=e;return await h(
-s,{...t,objectKey:c}),{lastModified:o,bucketName:s,objectKey:c}},ge=async(e,t,r,o)=>{
-let s=r??{};!(0,E.deepEqual)(s,o??{})&&await pe(e,t,s)};var Se=()=>{(0,de.registerProvider)(m,le())};var Pe=require("@ez4/aws-identity");var ke=require("@ez4/aws-identity"),N=e=>(0,ke.createPolicyDocument)([{resourceIds:[
-`arn:aws:s3:::${e}-*`,`arn:aws:s3:::${e}-*/*`],permissions:["s3:ListBucket","s3:\
-PutObject","s3:GetObject","s3:DeleteObject"]}]);var be=async e=>{let{state:t,options:r}=e,{resourcePrefix:o,projectName:s}=r,c=`${o}\
--${s}`;return(0,Pe.createPolicy)(t,{policyName:`${c}-bucket-policy`,policyDocument:N(
-c)})};var Ce=require("@ez4/project/library"),Ee=require("@ez4/storage/library");var Be=require("@ez4/utils"),xe=require("@ez4/stateful");var z=(e,t)=>{let r=(0,Be.toKebabCase)(t.bucketName),o=C(t.bucketName);return(0,xe.attachEntry)(
-e,{type:p,entryId:o,dependencies:[],parameters:{...t,bucketName:r}})};var we=require("node:fs/promises"),x=require("node:path"),Re=require("@ez4/aws-bucket"),
-je=async(e,t,r)=>{let o=(0,x.join)(process.cwd(),r),s=await(0,we.readdir)(o,{withFileTypes:!0,
-recursive:!0});for(let c of s){if(!c.isFile())continue;let d=(0,x.join)(c.parentPath,
-c.name),O=(0,x.relative)(o,d);(0,Re.createBucketObject)(e,t,{objectKey:O,filePath:d})}};var Oe=async e=>{let{state:t,service:r,options:o}=e;if(!(0,Ee.isBucketService)(r))
-return;let{autoExpireDays:s,localPath:c,cors:d}=r,O=z(t,{bucketName:(0,Ce.getServiceName)(
-r,o),autoExpireDays:s,localPath:c,cors:d});c&&await je(t,O,c)};var ve=require("@ez4/storage/library"),Te=require("@ez4/project/library"),he=async e=>{
-let{service:t,options:r}=e;return(0,ve.isBucketService)(t)?{constructor:`make('${(0,Te.getServiceName)(
-t,r)}')`,module:"Client",from:"@ez4/aws-bucket/client"}:null};var De=!1,gt=()=>{De||((0,Ne.registerTriggers)(),(0,ze.registerTriggers)(),(0,Ie.registerTriggers)(),
-(0,Le.createTrigger)("@ez4/aws-bucket",{"deploy:prepareExecutionPolicy":be,"depl\
-oy:prepareLinkedService":he,"deploy:prepareResources":Oe}),V(),ae(),Se(),De=!0)};var qe=require("@ez4/aws-identity"),dt=e=>/(.+)\.s3\.(.+)\.amazonaws\.com/i.test(
-e),St=async e=>{let t=await(0,qe.getRegion)();return`${e}.s3.${t}.amazonaws.com`};var Ke=require("@ez4/stateful"),He=require("@ez4/utils");var kt=(e,t,r,o)=>{let s=(0,He.hashData)(u,t.entryId,r.entryId);return(0,Ke.attachEntry)(
-e,{type:u,entryId:s,dependencies:[t.entryId,r.entryId],parameters:o})};var Pt=e=>e.type===u;var Me=require("@ez4/stateful"),$e=require("@ez4/utils");var bt=(e,t,r)=>{let o=r.objectKey,s=(0,$e.hashData)(m,t.entryId,o);return(0,Me.attachEntry)(
-e,{type:m,entryId:s,dependencies:[t.entryId],parameters:r})};0&&(module.exports={BucketServiceName,BucketServiceType,ObjectServiceName,ObjectServiceType,
-PolicyServiceName,PolicyServiceType,createBucket,createBucketObject,createBucketPolicy,
-getBucketDomain,getBucketName,getBucketObjectFiles,getBucketObjectPath,getBucketState,
-getBucketStateId,getPolicyDocument,isBucketDomain,isBucketObjectState,isBucketPolicyState,
-isBucketState,registerTriggers});
+if(n.counts)return{...n,name:r.objectKey}},qt=async(e,t,r)=>{if(t.result)throw new je.ReplaceResourceError(
+g,e.entryId,t.entryId);return he(e,r)},he=async(e,t)=>{let r=e.parameters,o=B(g,
+"bucket",t),n=await L(r.filePath),{objectKey:s}=await I(o,r);return await Te(o,s,
+r.tags,e.parameters.tags),{lastModified:n,bucketName:o,objectKey:s}},Kt=async(e,t)=>{
+let{result:r,parameters:o}=e;if(!r)return;let{bucketName:n,objectKey:s}=r,a=Ht(r,
+o,t.parameters);return await Te(n,s,o.tags,t.parameters.tags),a},Mt=async e=>{let t=e.
+result;t&&await ve(t.bucketName,t.objectKey)},L=async e=>{let{mtime:t}=await(0,Ce.stat)(
+e);return t.getTime()},Ht=async(e,t,r)=>{let o=await L(t.filePath);if(o<=e.lastModified&&
+t.filePath===r.filePath)return e;let{bucketName:n,objectKey:s}=e;return await I(
+n,{...t,objectKey:s}),{lastModified:o,bucketName:n,objectKey:s}},Te=async(e,t,r,o)=>{
+let n=r??{};!(0,O.deepEqual)(n,o??{})&&await Ee(e,t,n)};var De=()=>{(0,Ne.registerProvider)(y,Oe())};var G=require("@ez4/aws-identity"),T=require("@ez4/storage/library"),Ze=require("@ez4/project/library"),
+V=require("@ez4/aws-function");var Fe=require("@ez4/aws-function"),h=require("@ez4/stateful"),Ae=require("@ez4/utils");var ze=require("@ez4/aws-identity"),q=e=>`arn:aws:s3:::${e}`,K=e=>(0,ze.createPolicyDocument)(
+[{resourceIds:[`arn:aws:s3:::${e}-*`,`arn:aws:s3:::${e}-*/*`],permissions:["s3:L\
+istBucket","s3:PutObject","s3:GetObject","s3:DeleteObject"]}]);var M=(e,t,r)=>{let o=(0,Ae.toKebabCase)(r.bucketName),n=b(r.bucketName),s=(0,h.attachEntry)(
+e,{type:m,entryId:n,dependencies:[],parameters:{...r,bucketName:o}});return t&&((0,Fe.createPermission)(
+e,s,t,{getPermission:()=>({principal:"s3.amazonaws.com",sourceArn:q(o)})}),(0,h.linkDependency)(
+e,s.entryId,t.entryId)),s};var He=require("@ez4/aws-function");var Ie=require("node:path"),Le=require("@ez4/project/library"),qe=require("@ez4/aws-function"),
+Ke=require("@ez4/aws-common"),Me=async(e,t)=>{let r=(0,Le.getDefinitionsObject)(
+e);return(0,Ke.bundleFunction)(qe.MappingServiceName,{sourceFile:t.sourceFile,wrapperFile:(0,Ie.join)(
+__dirname,"../lib/function.ts"),handlerName:t.handlerName,extras:t.extras,debug:t.
+debug,filePrefix:"s3",define:{...r}})};var H=(e,t,r)=>(0,He.createFunction)(e,t,{handlerName:"s3EntryPoint",functionName:r.
+functionName,sourceFile:r.sourceFile,variables:r.variables,description:r.description,
+timeout:r.timeout,memory:r.memory,tags:r.tags,getFunctionBundle:o=>{let n=o.getDependencies();
+return Me(n,r)}});var $=require("@ez4/project/library"),$e=require("@ez4/aws-common"),Ue=require("@ez4/utils"),
+U=async(e,t)=>{let r=(0,$.getServiceName)(e,t).substring(0,46),o=await(0,$e.getRandomName)(
+16);return`${r}-${o}`},_=(e,t,r)=>`${(0,$.getServiceName)(e,r)}-${(0,Ue.toKebabCase)(
+t)}`;var _e=require("node:fs/promises"),R=require("node:path"),Ge=require("@ez4/aws-bucket"),
+Ve=async(e,t,r)=>{let o=(0,R.join)(process.cwd(),r),n=await(0,_e.readdir)(o,{withFileTypes:!0,
+recursive:!0});for(let s of n){if(!s.isFile())continue;let a=(0,R.join)(s.parentPath,
+s.name),l=(0,R.relative)(o,a);(0,Ge.createBucketObject)(e,t,{objectKey:l,filePath:a})}};var We=e=>({entryId:b(e),constructor:`make('${e}')`,from:"@ez4/aws-bucket/client",
+module:"Client"});var E=class extends Error{constructor(){super("Execution role for S3 is missing.")}};var Je=async e=>{let{service:t,options:r}=e;if(!(0,T.isBucketService)(t))return null;
+let o=await U(t,r);return We(o)},Qe=async e=>{let{state:t,service:r,role:o,options:n}=e;
+if(!(0,T.isBucketService)(r))return;if(!o||!(0,G.isRoleState)(o))throw new E;let{
+globalName:s,localPath:a,autoExpireDays:l,events:N,cors:D}=r,lt=s??await U(r,n),
+ft=$t(t,r,o,n),gt=M(t,ft,{eventsPath:N?.path,bucketName:lt,autoExpireDays:l,localPath:a,
+cors:D});a&&await Ve(t,gt,a)},Xe=e=>{let{state:t,service:r,role:o,options:n}=e;if(!(0,T.isBucketService)(
+r)||!r.extras||!r.events)return;if(!o||!(0,G.isRoleState)(o))throw new E;let s=r.
+events.handler,a=_(r,s.name,n),l=(0,V.getFunction)(t,o,a);l&&(0,Ze.linkServiceExtras)(
+t,l.entryId,r.extras)},$t=(e,t,r,o)=>{if(!t.events)return;let n=t.events,s=n.handler,
+a=_(t,s.name,o);return(0,V.getFunction)(e,r,a)??H(e,r,{functionName:a,description:s.
+description,handlerName:s.name,sourceFile:s.file,timeout:n.timeout??15,memory:n.
+memory??192,extras:t.extras,debug:o.debug,variables:{...t.variables}})};var Ye=require("@ez4/project/library"),et=require("@ez4/aws-identity");var tt=e=>{let{state:t,options:r}=e,o=(0,Ye.getServiceName)("",r);return(0,et.createPolicy)(
+t,{policyName:`${o}-bucket-policy`,policyDocument:K(o)})};var rt=!1,Ut=()=>{rt||((0,ot.registerTriggers)(),(0,nt.registerTriggers)(),(0,st.registerTriggers)(),
+(0,ct.registerTriggers)(),(0,at.createTrigger)("@ez4/aws-bucket",{"deploy:prepar\
+eExecutionPolicy":tt,"deploy:prepareLinkedService":Je,"deploy:prepareResources":Qe,
+"deploy:connectResources":Xe}),ye(),Be(),De(),rt=!0)};var it=require("@ez4/aws-identity"),_t=e=>/(.+)\.s3\.(.+)\.amazonaws\.com/i.test(
+e),Gt=async e=>{let t=await(0,it.getRegion)();return`${e}.s3.${t}.amazonaws.com`};var pt=require("@ez4/stateful"),mt=require("@ez4/utils");var Vt=(e,t,r,o)=>{let n=(0,mt.hashData)(f,t.entryId,r.entryId);return(0,pt.attachEntry)(
+e,{type:f,entryId:n,dependencies:[t.entryId,r.entryId],parameters:o})};var Wt=e=>e.type===f;var ut=require("@ez4/stateful"),yt=require("@ez4/utils");var Zt=(e,t,r)=>{let o=r.objectKey,n=(0,yt.hashData)(y,t.entryId,o);return(0,ut.attachEntry)(
+e,{type:y,entryId:n,dependencies:[t.entryId],parameters:r})};0&&(module.exports={BucketServiceName,BucketServiceType,ObjectServiceName,ObjectServiceType,
+PolicyServiceName,PolicyServiceType,buildBucketArn,createBucket,createBucketEventFunction,
+createBucketObject,createBucketPolicy,getBucketDomain,getBucketName,getBucketObjectFiles,
+getBucketObjectPath,getBucketState,getBucketStateId,getPolicyDocument,isBucketDomain,
+isBucketObjectState,isBucketPolicyState,isBucketState,registerTriggers});

package/dist/main.d.ts

@@ -4,6 +4,8 @@ export * from './utils/policy.js';
 export * from './bucket/service.js';
 export * from './bucket/types.js';
 export * from './bucket/utils.js';
+export * from './bucket/function/service.js';
+export * from './bucket/function/types.js';
 export * from './policy/service.js';
 export * from './policy/types.js';
 export * from './policy/utils.js';

package/dist/main.mjs

@@ -1,81 +1,110 @@
-import{registerTriggers as lt}from"@ez4/aws-common";import{registerTriggers as ft}from"@ez4/aws-identity";
-import{registerTriggers as gt}from"@ez4/storage/library";import{createTrigger as dt}from"@ez4/project/library";import{registerProvider as Be}from"@ez4/aws-common";import{ReplaceResourceError as fe}from"@ez4/aws-common";import{deepCompare as ge,
-deepEqual as T}from"@ez4/utils";import{getTagList as se,Logger as p}from"@ez4/aws-common";import{CreateBucketCommand as ce,
-DeleteBucketCommand as ae,PutBucketTaggingCommand as ne,PutBucketCorsCommand as ie,
-DeleteBucketCorsCommand as pe,PutBucketLifecycleConfigurationCommand as me,DeleteBucketLifecycleCommand as ue,
-ExpirationStatus as ye,S3Client as le}from"@aws-sdk/client-s3";var a="AWS:S3/Bucket",n="aws:s3.bucket";var m=new le({}),w=async e=>{let{bucketName:t}=e;return p.logCreate(a,t),await m.
-send(new ce({Bucket:t})),{bucketName:t}},R=async(e,t)=>{p.logTag(a,e),await m.send(
-new ne({Bucket:e,Tagging:{TagSet:se({...t,ManagedBy:"EZ4"})}}))},j=async(e,t)=>{
-p.logUpdate(a,`${e} CORS`),await m.send(new ie({Bucket:e,CORSConfiguration:{CORSRules:[
-{ID:"ID0",AllowedOrigins:t.allowOrigins,AllowedMethods:t.allowMethods,AllowedHeaders:t.
-allowHeaders,ExposeHeaders:t.exposeHeaders,MaxAgeSeconds:t.maxAge}]}}))},C=async e=>{
-p.logDelete(a,`${e} CORS`),await m.send(new pe({Bucket:e}))},E=async(e,t)=>{p.logCreate(
-a,`${e} lifecycle`),await m.send(new me({Bucket:e,LifecycleConfiguration:{Rules:[
-{ID:"ID0",Status:ye.Enabled,Filter:{Prefix:"*"},Expiration:{Days:t}}]}}))},O=async e=>{
-p.logDelete(a,`${e} lifecycle`),await m.send(new ue({Bucket:e}))},v=async e=>{p.
-logDelete(a,e),await m.send(new ae({Bucket:e}))};var h=()=>({equals:de,create:D,replace:ke,preview:Se,update:Pe,delete:be}),de=(e,t)=>!!e.
-result&&e.result.bucketName===t.result?.bucketName,Se=async(e,t)=>{let r={...e.parameters,
-dependencies:e.dependencies},o={...t.parameters,dependencies:t.dependencies},s=ge(
-r,o);if(s.counts)return{...s,name:r.bucketName}},ke=async(e,t)=>{if(t.result)throw new fe(
-a,e.entryId,t.entryId);return D(e)},D=async e=>{let t=e.parameters,{bucketName:r}=await w(
-t);return await N(r,t,void 0),await z(r,t,void 0),await I(r,t.tags,void 0),{bucketName:r}},
-Pe=async(e,t)=>{let{result:r,parameters:o}=e;if(!r)return;let s=r.bucketName;await N(
-s,o,t.parameters),await z(s,o,t.parameters),await I(s,o.tags,t.parameters.tags)},
-be=async e=>{let t=e.result;t&&await v(t.bucketName)},N=async(e,t,r)=>{if(!(t.cors&&
-r?.cors&&T(t.cors,r.cors))){if(t.cors)return j(e,t.cors);if(r?.cors)return C(e)}},
-z=async(e,t,r)=>{if(t.autoExpireDays!==r?.autoExpireDays){if(t.autoExpireDays)return E(
-e,t.autoExpireDays);if(r?.autoExpireDays)return O(e)}},I=async(e,t,r)=>{let o=t??
-{};!T(o,r??{})&&await R(e,o)};var L=()=>{Be(n,h())};import{registerProvider as qe}from"@ez4/aws-common";import{ReplaceResourceError as he}from"@ez4/aws-common";import{EntryNotFoundError as xe,getEntry as we}from"@ez4/stateful";import{IncompleteResourceError as Re}from"@ez4/aws-common";
-import{hashData as je,toKebabCase as Ce}from"@ez4/utils";var Ee=e=>e.type===n,k=e=>je(n,Ce(e)),Mt=(e,t)=>{let r=we(e,k(t));if(!Ee(r))throw new xe(
-r.entryId);return r},g=(e,t,r)=>{let o=r.getDependencies(n).at(0)?.result;if(!o?.
-bucketName)throw new Re(e,t,"bucketName");return o.bucketName};import{Logger as q}from"@ez4/aws-common";import{S3Client as Oe,PutBucketPolicyCommand as ve,
-DeleteBucketPolicyCommand as Te}from"@aws-sdk/client-s3";var f="AWS:S3/Policy",u="aws:s3.policy";var K=new Oe({}),H=async e=>{let{bucketName:t,role:r}=e;return q.logCreate(f,t),
-await K.send(new ve({Bucket:t,Policy:JSON.stringify(r)})),{bucketName:t}},M=async e=>{
-q.logDelete(f,e),await K.send(new Te({Bucket:e}))};var $=()=>({equals:De,create:A,replace:ze,preview:Ne,update:Ie,delete:Le}),De=(e,t)=>!!e.
-result&&e.result.bucketName===t.result?.bucketName,Ne=async()=>{},ze=async(e,t,r)=>{
-if(t.result)throw new he(f,e.entryId,t.entryId);return A(e,r)},A=async(e,t)=>{let r=e.
-parameters,o=g(f,"policy",t),s=await r.getRole(t);return await H({bucketName:o,role:s}),
-{bucketName:o}},Ie=async()=>{},Le=async e=>{let t=e.result;t&&await M(t.bucketName)};var F=()=>{qe(u,$())};import{registerProvider as tt}from"@ez4/aws-common";import{stat as Ge}from"node:fs/promises";import{ReplaceResourceError as We}from"@ez4/aws-common";
-import{deepCompare as Ze,deepEqual as Je}from"@ez4/utils";import{getTagList as Ke,Logger as P}from"@ez4/aws-common";import{createReadStream as He}from"node:fs";
-import Me from"mime";import{PutObjectCommand as $e,PutObjectTaggingCommand as Ae,
-DeleteObjectCommand as Fe,S3Client as Ue}from"@aws-sdk/client-s3";var y="AWS:S3/Object",i="aws:s3.object";var cr=e=>e.type===i,d=(e,t)=>`${e}/${t}`,ar=e=>e.getDependencies(i).map(({result:r})=>({
-lastModified:r?.lastModified,objectKey:r?.objectKey}));var b=new Ue({}),B=async(e,t)=>{let{objectKey:r,filePath:o}=t;P.logCreate(y,d(e,
-r));let s=Me.getType(o);return await b.send(new $e({Bucket:e,Key:r,Body:He(o),...s&&
-{ContentType:s}})),{objectKey:r}},U=async(e,t,r)=>{P.logTag(y,d(e,t)),await b.send(
-new Ae({Bucket:e,Key:t,Tagging:{TagSet:Ke({...r,ManagedBy:"EZ4"})}}))},G=async(e,t)=>{
-P.logDelete(y,d(e,t)),await b.send(new Fe({Bucket:e,Key:t}))};var W=()=>({equals:Qe,create:Z,replace:Xe,preview:Ve,update:Ye,delete:_e}),Qe=(e,t)=>!!e.
-result&&e.result.objectKey===t.result?.objectKey,Ve=async(e,t)=>{let r=e.parameters,
-o=t.parameters,s=Ze({...r,dependencies:e.dependencies,lastModified:await x(r.filePath)},
-{...o,dependencies:t.dependencies,lastModified:e.result?.lastModified});if(s.counts)
-return{...s,name:r.objectKey}},Xe=async(e,t,r)=>{if(t.result)throw new We(y,e.entryId,
-t.entryId);return Z(e,r)},Z=async(e,t)=>{let r=e.parameters,o=g(y,"bucket",t),s=await x(
-r.filePath),{objectKey:c}=await B(o,r);return await J(o,c,r.tags,e.parameters.tags),
-{lastModified:s,bucketName:o,objectKey:c}},Ye=async(e,t)=>{let{result:r,parameters:o}=e;
-if(!r)return;let{bucketName:s,objectKey:c}=r,l=et(r,o,t.parameters);return await J(
-s,c,o.tags,t.parameters.tags),l},_e=async e=>{let t=e.result;t&&await G(t.bucketName,
-t.objectKey)},x=async e=>{let{mtime:t}=await Ge(e);return t.getTime()},et=async(e,t,r)=>{
-let o=await x(t.filePath);if(o<=e.lastModified&&t.filePath===r.filePath)return e;
-let{bucketName:s,objectKey:c}=e;return await B(s,{...t,objectKey:c}),{lastModified:o,
-bucketName:s,objectKey:c}},J=async(e,t,r,o)=>{let s=r??{};!Je(s,o??{})&&await U(
-e,t,s)};var Q=()=>{tt(i,W())};import{createPolicy as ot}from"@ez4/aws-identity";import{createPolicyDocument as rt}from"@ez4/aws-identity";var V=e=>rt([{resourceIds:[
-`arn:aws:s3:::${e}-*`,`arn:aws:s3:::${e}-*/*`],permissions:["s3:ListBucket","s3:\
-PutObject","s3:GetObject","s3:DeleteObject"]}]);var X=async e=>{let{state:t,options:r}=e,{resourcePrefix:o,projectName:s}=r,c=`${o}\
--${s}`;return ot(t,{policyName:`${c}-bucket-policy`,policyDocument:V(c)})};import{getServiceName as pt}from"@ez4/project/library";import{isBucketService as mt}from"@ez4/storage/library";import{toKebabCase as st}from"@ez4/utils";import{attachEntry as ct}from"@ez4/stateful";var Y=(e,t)=>{let r=st(t.bucketName),o=k(t.bucketName);return ct(e,{type:n,entryId:o,
-dependencies:[],parameters:{...t,bucketName:r}})};import{readdir as at}from"node:fs/promises";import{join as _,relative as nt}from"node:path";
-import{createBucketObject as it}from"@ez4/aws-bucket";var ee=async(e,t,r)=>{let o=_(
-process.cwd(),r),s=await at(o,{withFileTypes:!0,recursive:!0});for(let c of s){if(!c.
-isFile())continue;let l=_(c.parentPath,c.name),S=nt(o,l);it(e,t,{objectKey:S,filePath:l})}};var te=async e=>{let{state:t,service:r,options:o}=e;if(!mt(r))return;let{autoExpireDays:s,
-localPath:c,cors:l}=r,S=Y(t,{bucketName:pt(r,o),autoExpireDays:s,localPath:c,cors:l});
-c&&await ee(t,S,c)};import{isBucketService as ut}from"@ez4/storage/library";import{getServiceName as yt}from"@ez4/project/library";
-var re=async e=>{let{service:t,options:r}=e;return ut(t)?{constructor:`make('${yt(
-t,r)}')`,module:"Client",from:"@ez4/aws-bucket/client"}:null};var oe=!1,so=()=>{oe||(lt(),ft(),gt(),dt("@ez4/aws-bucket",{"deploy:prepareExecu\
-tionPolicy":X,"deploy:prepareLinkedService":re,"deploy:prepareResources":te}),L(),
-F(),Q(),oe=!0)};import{getRegion as St}from"@ez4/aws-identity";var no=e=>/(.+)\.s3\.(.+)\.amazonaws\.com/i.
-test(e),io=async e=>{let t=await St();return`${e}.s3.${t}.amazonaws.com`};import{attachEntry as kt}from"@ez4/stateful";import{hashData as Pt}from"@ez4/utils";var lo=(e,t,r,o)=>{let s=Pt(u,t.entryId,r.entryId);return kt(e,{type:u,entryId:s,
-dependencies:[t.entryId,r.entryId],parameters:o})};var So=e=>e.type===u;import{attachEntry as bt}from"@ez4/stateful";import{hashData as Bt}from"@ez4/utils";var xo=(e,t,r)=>{let o=r.objectKey,s=Bt(i,t.entryId,o);return bt(e,{type:i,entryId:s,
-dependencies:[t.entryId],parameters:r})};export{a as BucketServiceName,n as BucketServiceType,y as ObjectServiceName,i as ObjectServiceType,
-f as PolicyServiceName,u as PolicyServiceType,Y as createBucket,xo as createBucketObject,
-lo as createBucketPolicy,io as getBucketDomain,g as getBucketName,ar as getBucketObjectFiles,
-d as getBucketObjectPath,Mt as getBucketState,k as getBucketStateId,V as getPolicyDocument,
-no as isBucketDomain,cr as isBucketObjectState,So as isBucketPolicyState,Ee as isBucketState,
-so as registerTriggers};
+import{registerTriggers as Ut}from"@ez4/aws-common";import{registerTriggers as _t}from"@ez4/aws-identity";
+import{registerTriggers as Gt}from"@ez4/aws-function";import{registerTriggers as Vt}from"@ez4/storage/library";
+import{createTrigger as Wt}from"@ez4/project/library";import{registerProvider as Ue}from"@ez4/aws-common";import{ReplaceResourceError as Ie}from"@ez4/aws-common";import{tryGetFunctionArn as q}from"@ez4/aws-function";
+import{deepCompare as Le,deepEqual as B}from"@ez4/utils";import{getTagList as Ee,Logger as i}from"@ez4/aws-common";import{S3Client as ve,
+ListObjectsV2Command as Ce,CreateBucketCommand as je,DeleteBucketCommand as Oe,PutBucketTaggingCommand as he,
+PutBucketCorsCommand as Te,DeleteBucketCorsCommand as Ne,PutBucketLifecycleConfigurationCommand as De,
+DeleteBucketLifecycleCommand as ze,PutBucketNotificationConfigurationCommand as Fe,
+ExpirationStatus as Ae}from"@aws-sdk/client-s3";var a="AWS:S3/Bucket",u="aws:s3.bucket";var p=new ve({}),h=async e=>(i.logFetch(a,e),!(await p.send(new Ce({Bucket:e,MaxKeys:1}))).
+Contents?.length),T=async e=>{let{bucketName:t}=e;return i.logCreate(a,t),await p.
+send(new je({Bucket:t})),{bucketName:t}},N=async e=>{i.logDelete(a,e),await p.send(
+new Oe({Bucket:e}))},D=async(e,t)=>{i.logTag(a,e),await p.send(new he({Bucket:e,
+Tagging:{TagSet:Ee({...t,ManagedBy:"EZ4"})}}))},z=async(e,t)=>{i.logUpdate(a,`${e}\
+ CORS`),await p.send(new Te({Bucket:e,CORSConfiguration:{CORSRules:[{ID:"ID0",AllowedOrigins:t.
+allowOrigins,AllowedMethods:t.allowMethods,AllowedHeaders:t.allowHeaders,ExposeHeaders:t.
+exposeHeaders,MaxAgeSeconds:t.maxAge}]}}))},F=async e=>{i.logDelete(a,`${e} CORS`),
+await p.send(new Ne({Bucket:e}))},A=async(e,t)=>{i.logCreate(a,`${e} lifecycle`),
+await p.send(new De({Bucket:e,LifecycleConfiguration:{Rules:[{ID:"ID0",Status:Ae.
+Enabled,Filter:{Prefix:"*"},Expiration:{Days:t}}]}}))},I=async e=>{i.logDelete(a,
+`${e} lifecycle`),await p.send(new ze({Bucket:e}))},L=async(e,t)=>{i.logUpdate(a,
+`${e} event notifications`);let{functionArn:r,eventsPath:o,eventsType:n}=t;await p.
+send(new Fe({Bucket:e,SkipDestinationValidation:!0,NotificationConfiguration:{...r&&
+{LambdaFunctionConfigurations:[{Id:"ID0",LambdaFunctionArn:r,Events:n,...o&&{Filter:{
+Key:{FilterRules:[{Name:"prefix",Value:o}]}}}}]}}}))};var K=()=>({equals:qe,create:M,replace:Me,preview:Ke,update:He,delete:$e}),qe=(e,t)=>!!e.
+result&&e.result.bucketName===t.result?.bucketName,Ke=async(e,t)=>{let r={...e.parameters,
+dependencies:e.dependencies},o={...t.parameters,dependencies:t.dependencies},n=Le(
+r,o);if(n.counts)return{...n,name:r.bucketName}},Me=async(e,t,r)=>{if(t.result)throw new Ie(
+a,e.entryId,t.entryId);return M(e,r)},M=async(e,t)=>{let r=e.parameters,o=q(t),{
+bucketName:n}=await T(r);await H(n,r,void 0),await $(n,r,void 0),await U(n,r.tags,
+void 0);let s={eventsPath:r.eventsPath,functionArn:o};return await _(n,s,{}),{bucketName:n,
+functionArn:o}},He=async(e,t,r)=>{let{result:o,parameters:n}=e;if(!o)return;let s=o.
+bucketName,c=q(r),m=t.result?.functionArn;await H(s,n,t.parameters),await $(s,n,
+t.parameters),await U(s,n.tags,t.parameters.tags);let P={eventsPath:n.eventsPath,
+functionArn:c},x={eventsPath:t.parameters.eventsPath,functionArn:m};return await _(
+s,P,x),{...o,functionArn:c}},$e=async e=>{let t=e.result;t&&await h(t.bucketName)&&
+await N(t.bucketName)},H=async(e,t,r)=>{if(!(t.cors&&r?.cors&&B(t.cors,r.cors))){
+if(t.cors)return z(e,t.cors);if(r?.cors)return F(e)}},$=async(e,t,r)=>{if(t.autoExpireDays!==
+r?.autoExpireDays){if(t.autoExpireDays)return A(e,t.autoExpireDays);if(r?.autoExpireDays)
+return I(e)}},U=async(e,t,r)=>{let o=t??{};!B(o,r??{})&&await D(e,o)},_=async(e,t,r)=>{
+!B(t,r)&&await L(e,{eventsType:["s3:ObjectCreated:*","s3:ObjectRemoved:*"],...t})};var G=()=>{Ue(u,K())};import{registerProvider as ct}from"@ez4/aws-common";import{ReplaceResourceError as et}from"@ez4/aws-common";import{EntryNotFoundError as _e,getEntry as Ge}from"@ez4/stateful";import{IncompleteResourceError as Ve}from"@ez4/aws-common";
+import{hashData as We,toKebabCase as Ze}from"@ez4/utils";var Je=e=>e.type===u,d=e=>We(u,Ze(e)),Pr=(e,t)=>{let r=Ge(e,d(t));if(!Je(r))throw new _e(
+r.entryId);return r},k=(e,t,r)=>{let o=r.getDependencies(u).at(0)?.result;if(!o?.
+bucketName)throw new Ve(e,t,"bucketName");return o.bucketName};import{Logger as V}from"@ez4/aws-common";import{S3Client as Qe,PutBucketPolicyCommand as Xe,
+DeleteBucketPolicyCommand as Ye}from"@aws-sdk/client-s3";var g="AWS:S3/Policy",l="aws:s3.policy";var W=new Qe({}),Z=async e=>{let{bucketName:t,role:r}=e;return V.logCreate(g,t),
+await W.send(new Xe({Bucket:t,Policy:JSON.stringify(r)})),{bucketName:t}},J=async e=>{
+V.logDelete(g,e),await W.send(new Ye({Bucket:e}))};var Q=()=>({equals:tt,create:X,replace:ot,preview:rt,update:nt,delete:st}),tt=(e,t)=>!!e.
+result&&e.result.bucketName===t.result?.bucketName,rt=async()=>{},ot=async(e,t,r)=>{
+if(t.result)throw new et(g,e.entryId,t.entryId);return X(e,r)},X=async(e,t)=>{let r=e.
+parameters,o=k(g,"policy",t),n=await r.getRole(t);return await Z({bucketName:o,role:n}),
+{bucketName:o}},nt=async()=>{},st=async e=>{let t=e.result;t&&await J(t.bucketName)};var Y=()=>{ct(l,Q())};import{registerProvider as Rt}from"@ez4/aws-common";import{stat as ft}from"node:fs/promises";import{ReplaceResourceError as gt}from"@ez4/aws-common";
+import{deepCompare as dt,deepEqual as St}from"@ez4/utils";import{getTagList as at,Logger as w}from"@ez4/aws-common";import{createReadStream as it}from"node:fs";
+import pt from"mime";import{S3Client as mt,PutObjectCommand as ut,PutObjectTaggingCommand as yt,
+DeleteObjectCommand as lt}from"@aws-sdk/client-s3";var f="AWS:S3/Object",y="aws:s3.object";var qr=e=>e.type===y,b=(e,t)=>`${e}/${t}`,Kr=e=>e.getDependencies(y).map(({result:r})=>({
+lastModified:r?.lastModified,objectKey:r?.objectKey}));var R=new mt({}),E=async(e,t)=>{let{objectKey:r,filePath:o}=t;w.logCreate(f,b(e,
+r));let n=pt.getType(o);return await R.send(new ut({Bucket:e,Key:r,Body:it(o),...n&&
+{ContentType:n}})),{objectKey:r}},ee=async(e,t,r)=>{w.logTag(f,b(e,t)),await R.send(
+new yt({Bucket:e,Key:t,Tagging:{TagSet:at({...r,ManagedBy:"EZ4"})}}))},te=async(e,t)=>{
+w.logDelete(f,b(e,t)),await R.send(new lt({Bucket:e,Key:t}))};var re=()=>({equals:kt,create:oe,replace:Pt,preview:bt,update:xt,delete:Bt}),kt=(e,t)=>!!e.
+result&&e.result.objectKey===t.result?.objectKey,bt=async(e,t)=>{let r=e.parameters,
+o=t.parameters,n=dt({...r,dependencies:e.dependencies,lastModified:await v(r.filePath)},
+{...o,dependencies:t.dependencies,lastModified:e.result?.lastModified});if(n.counts)
+return{...n,name:r.objectKey}},Pt=async(e,t,r)=>{if(t.result)throw new gt(f,e.entryId,
+t.entryId);return oe(e,r)},oe=async(e,t)=>{let r=e.parameters,o=k(f,"bucket",t),
+n=await v(r.filePath),{objectKey:s}=await E(o,r);return await ne(o,s,r.tags,e.parameters.
+tags),{lastModified:n,bucketName:o,objectKey:s}},xt=async(e,t)=>{let{result:r,parameters:o}=e;
+if(!r)return;let{bucketName:n,objectKey:s}=r,c=wt(r,o,t.parameters);return await ne(
+n,s,o.tags,t.parameters.tags),c},Bt=async e=>{let t=e.result;t&&await te(t.bucketName,
+t.objectKey)},v=async e=>{let{mtime:t}=await ft(e);return t.getTime()},wt=async(e,t,r)=>{
+let o=await v(t.filePath);if(o<=e.lastModified&&t.filePath===r.filePath)return e;
+let{bucketName:n,objectKey:s}=e;return await E(n,{...t,objectKey:s}),{lastModified:o,
+bucketName:n,objectKey:s}},ne=async(e,t,r,o)=>{let n=r??{};!St(n,o??{})&&await ee(
+e,t,n)};var se=()=>{Rt(y,re())};import{isRoleState as ge}from"@ez4/aws-identity";import{isBucketService as O}from"@ez4/storage/library";
+import{linkServiceExtras as Kt}from"@ez4/project/library";import{getFunction as de}from"@ez4/aws-function";import{createPermission as vt}from"@ez4/aws-function";import{attachEntry as Ct,linkDependency as jt}from"@ez4/stateful";
+import{toKebabCase as Ot}from"@ez4/utils";import{createPolicyDocument as Et}from"@ez4/aws-identity";var ce=e=>`arn:aws:s3:\
+::${e}`,ae=e=>Et([{resourceIds:[`arn:aws:s3:::${e}-*`,`arn:aws:s3:::${e}-*/*`],permissions:[
+"s3:ListBucket","s3:PutObject","s3:GetObject","s3:DeleteObject"]}]);var ie=(e,t,r)=>{let o=Ot(r.bucketName),n=d(r.bucketName),s=Ct(e,{type:u,entryId:n,
+dependencies:[],parameters:{...r,bucketName:o}});return t&&(vt(e,s,t,{getPermission:()=>({
+principal:"s3.amazonaws.com",sourceArn:ce(o)})}),jt(e,s.entryId,t.entryId)),s};import{createFunction as zt}from"@ez4/aws-function";import{join as ht}from"node:path";import{getDefinitionsObject as Tt}from"@ez4/project/library";
+import{MappingServiceName as Nt}from"@ez4/aws-function";import{bundleFunction as Dt}from"@ez4/aws-common";
+var pe=async(e,t)=>{let r=Tt(e);return Dt(Nt,{sourceFile:t.sourceFile,wrapperFile:ht(
+import.meta.dirname,"../lib/function.ts"),handlerName:t.handlerName,extras:t.extras,
+debug:t.debug,filePrefix:"s3",define:{...r}})};var me=(e,t,r)=>zt(e,t,{handlerName:"s3EntryPoint",functionName:r.functionName,sourceFile:r.
+sourceFile,variables:r.variables,description:r.description,timeout:r.timeout,memory:r.
+memory,tags:r.tags,getFunctionBundle:o=>{let n=o.getDependencies();return pe(n,r)}});import{getServiceName as ue}from"@ez4/project/library";import{getRandomName as Ft}from"@ez4/aws-common";
+import{toKebabCase as At}from"@ez4/utils";var C=async(e,t)=>{let r=ue(e,t).substring(
+0,46),o=await Ft(16);return`${r}-${o}`},j=(e,t,r)=>`${ue(e,r)}-${At(t)}`;import{readdir as It}from"node:fs/promises";import{join as ye,relative as Lt}from"node:path";
+import{createBucketObject as qt}from"@ez4/aws-bucket";var le=async(e,t,r)=>{let o=ye(
+process.cwd(),r),n=await It(o,{withFileTypes:!0,recursive:!0});for(let s of n){if(!s.
+isFile())continue;let c=ye(s.parentPath,s.name),m=Lt(o,c);qt(e,t,{objectKey:m,filePath:c})}};var fe=e=>({entryId:d(e),constructor:`make('${e}')`,from:"@ez4/aws-bucket/client",
+module:"Client"});var S=class extends Error{constructor(){super("Execution role for S3 is missing.")}};var Se=async e=>{let{service:t,options:r}=e;if(!O(t))return null;let o=await C(t,
+r);return fe(o)},ke=async e=>{let{state:t,service:r,role:o,options:n}=e;if(!O(r))
+return;if(!o||!ge(o))throw new S;let{globalName:s,localPath:c,autoExpireDays:m,events:P,
+cors:x}=r,Be=s??await C(r,n),we=Mt(t,r,o,n),Re=ie(t,we,{eventsPath:P?.path,bucketName:Be,
+autoExpireDays:m,localPath:c,cors:x});c&&await le(t,Re,c)},be=e=>{let{state:t,service:r,
+role:o,options:n}=e;if(!O(r)||!r.extras||!r.events)return;if(!o||!ge(o))throw new S;
+let s=r.events.handler,c=j(r,s.name,n),m=de(t,o,c);m&&Kt(t,m.entryId,r.extras)},
+Mt=(e,t,r,o)=>{if(!t.events)return;let n=t.events,s=n.handler,c=j(t,s.name,o);return de(
+e,r,c)??me(e,r,{functionName:c,description:s.description,handlerName:s.name,sourceFile:s.
+file,timeout:n.timeout??15,memory:n.memory??192,extras:t.extras,debug:o.debug,variables:{
+...t.variables}})};import{getServiceName as Ht}from"@ez4/project/library";import{createPolicy as $t}from"@ez4/aws-identity";var Pe=e=>{let{state:t,options:r}=e,o=Ht("",r);return $t(t,{policyName:`${o}-buc\
+ket-policy`,policyDocument:ae(o)})};var xe=!1,an=()=>{xe||(Ut(),_t(),Gt(),Vt(),Wt("@ez4/aws-bucket",{"deploy:prepare\
+ExecutionPolicy":Pe,"deploy:prepareLinkedService":Se,"deploy:prepareResources":ke,
+"deploy:connectResources":be}),G(),Y(),se(),xe=!0)};import{getRegion as Zt}from"@ez4/aws-identity";var un=e=>/(.+)\.s3\.(.+)\.amazonaws\.com/i.
+test(e),yn=async e=>{let t=await Zt();return`${e}.s3.${t}.amazonaws.com`};import{attachEntry as Jt}from"@ez4/stateful";import{hashData as Qt}from"@ez4/utils";var Sn=(e,t,r,o)=>{let n=Qt(l,t.entryId,r.entryId);return Jt(e,{type:l,entryId:n,
+dependencies:[t.entryId,r.entryId],parameters:o})};var Pn=e=>e.type===l;import{attachEntry as Xt}from"@ez4/stateful";import{hashData as Yt}from"@ez4/utils";var En=(e,t,r)=>{let o=r.objectKey,n=Yt(y,t.entryId,o);return Xt(e,{type:y,entryId:n,
+dependencies:[t.entryId],parameters:r})};export{a as BucketServiceName,u as BucketServiceType,f as ObjectServiceName,y as ObjectServiceType,
+g as PolicyServiceName,l as PolicyServiceType,ce as buildBucketArn,ie as createBucket,
+me as createBucketEventFunction,En as createBucketObject,Sn as createBucketPolicy,
+yn as getBucketDomain,k as getBucketName,Kr as getBucketObjectFiles,b as getBucketObjectPath,
+Pr as getBucketState,d as getBucketStateId,ae as getPolicyDocument,un as isBucketDomain,
+qr as isBucketObjectState,Pn as isBucketPolicyState,Je as isBucketState,an as registerTriggers};

package/dist/triggers/bucket.d.ts

@@ -1,2 +1,4 @@
-import type { PrepareResourceEvent } from '@ez4/project/library';
+import type { DeployOptions, PrepareResourceEvent } from '@ez4/project/library';
+import { BucketService } from '@ez4/storage/library';
 export declare const prepareBucketServices: (event: PrepareResourceEvent) => Promise<void>;
+export declare const getFunctionName: (service: BucketService, handlerName: string, options: DeployOptions) => string;

package/dist/triggers/client.d.ts

@@ -1,2 +1,2 @@
-import type { ExtraSource, ServiceEvent } from '@ez4/project/library';
-export declare const prepareLinkedService: (event: ServiceEvent) => Promise<ExtraSource | null>;
+import type { ExtraSource } from '@ez4/project/library';
+export declare const prepareLinkedClient: (bucketName: string) => ExtraSource;

package/dist/triggers/errors.d.ts

@@ -0,0 +1,3 @@
+export declare class RoleMissingError extends Error {
+    constructor();
+}

package/dist/triggers/policy.d.ts

@@ -1,2 +1,2 @@
 import type { PolicyResourceEvent } from '@ez4/project/library';
-export declare const prepareExecutionPolicy: (event: PolicyResourceEvent) => Promise<import("@ez4/aws-identity").PolicyState>;
+export declare const prepareExecutionPolicy: (event: PolicyResourceEvent) => import("@ez4/aws-identity").PolicyState;

package/dist/triggers/service.d.ts

@@ -0,0 +1,4 @@
+import type { ServiceEvent, ConnectResourceEvent, PrepareResourceEvent } from '@ez4/project/library';
+export declare const prepareLinkedServices: (event: ServiceEvent) => Promise<import("@ez4/project/library").ExtraSource | null>;
+export declare const prepareBucketServices: (event: PrepareResourceEvent) => Promise<void>;
+export declare const connectBucketServices: (event: ConnectResourceEvent) => void;

package/dist/triggers/utils.d.ts

@@ -0,0 +1,4 @@
+import type { DeployOptions } from '@ez4/project/library';
+import { BucketService } from '@ez4/storage/library';
+export declare const getNewBucketName: (service: BucketService, options: DeployOptions) => Promise<string>;
+export declare const getFunctionName: (service: BucketService, handlerName: string, options: DeployOptions) => string;

package/dist/utils/policy.d.ts

@@ -1,2 +1,3 @@
-import type { PolicyDocument } from '@ez4/aws-identity';
-export declare const getPolicyDocument: (prefix: string) => PolicyDocument;
+import type { Arn } from '@ez4/aws-common';
+export declare const buildBucketArn: (bucketName: string) => Arn;
+export declare const getPolicyDocument: (prefix: string) => import("@ez4/aws-identity").PolicyDocument;

package/lib/function.ts

@@ -0,0 +1,43 @@
+import type { S3Event, Context } from 'aws-lambda';
+import { BucketEvent, BucketEventType } from '@ez4/storage';
+
+declare function next(event: BucketEvent, context: object): Promise<any>;
+
+declare const __EZ4_CONTEXT: object;
+
+/**
+ * Entrypoint to handle S3 notifications.
+ */
+export async function s3EntryPoint(event: S3Event, context: Context): Promise<void> {
+  for (const record of event.Records) {
+    const eventType = getKnownEventType(record.eventName);
+
+    if (!eventType) {
+      throw new Error(`Event type ${eventType} isn't supported.`);
+    }
+
+    const { bucket, object } = record.s3;
+
+    const request = {
+      requestId: context.awsRequestId,
+      bucketName: bucket.name,
+      objectSize: object.size,
+      objectKey: object.key,
+      eventType
+    };
+
+    await next(request, __EZ4_CONTEXT);
+  }
+}
+
+const getKnownEventType = (eventName: string) => {
+  if (eventName.startsWith('ObjectCreated:')) {
+    return BucketEventType.Create;
+  }
+
+  if (eventName.startsWith('ObjectRemoved:')) {
+    return BucketEventType.Delete;
+  }
+
+  return undefined;
+};

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ez4/aws-bucket",
   "description": "EZ4: Self-managed AWS S3 bucket provider",
-  "version": "0.13.0",
+  "version": "0.14.0",
   "author": "Silas B.",
   "license": "MIT",
   "type": "module",
@@ -42,17 +42,19 @@
     "live:publish": "npm run test && npm publish --access public"
   },
   "devDependencies": {
+    "@types/aws-lambda": "^8.10.147",
     "@types/mime": "^3.0.0"
   },
   "dependencies": {
-    "@aws-sdk/client-s3": "^3.614.0",
-    "@aws-sdk/s3-request-presigner": "^3.651.0",
-    "@ez4/aws-common": "^0.13.0",
-    "@ez4/aws-identity": "^0.13.0",
-    "@ez4/project": "^0.13.0",
-    "@ez4/stateful": "^0.13.0",
-    "@ez4/storage": "^0.13.0",
-    "@ez4/utils": "^0.13.0",
+    "@aws-sdk/client-s3": "^3.758.0",
+    "@aws-sdk/s3-request-presigner": "^3.758.0",
+    "@ez4/aws-common": "^0.14.0",
+    "@ez4/aws-function": "^0.14.0",
+    "@ez4/aws-identity": "^0.14.0",
+    "@ez4/project": "^0.14.0",
+    "@ez4/stateful": "^0.14.0",
+    "@ez4/storage": "^0.14.0",
+    "@ez4/utils": "^0.14.0",
     "mime": "^3.0.0"
   }
 }