@ez4/aws-topic 0.27.0

package/LICENSE

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

package/README.md

@@ -0,0 +1,40 @@
+# EZ4: AWS Topic
+
+It provides all the components to manage SNS topics on AWS.
+
+## Getting started
+
+#### Install
+
+```sh
+npm install @ez4/aws-topic -D
+```
+
+#### Permission
+
+Ensure the user performing deployments has the permissions below:
+
+```json
+{
+  "Version": "2012-10-17",
+  "Statement": [
+    {
+      "Sid": "TopicManagement",
+      "Effect": "Allow",
+      "Action": [
+        "sns:CreateTopic",
+        "sns:DeleteTopic",
+        "sns:Subscribe",
+        "sns:Unsubscribe",
+        "sns:TagResource",
+        "sns:UntagResource"
+      ],
+      "Resource": ["arn:aws:sns:*:{account-id}:{prefix}-*"]
+    }
+  ]
+}
+```
+
+## License
+
+MIT License

package/dist/client.cjs

@@ -0,0 +1,10 @@
+"use strict";var n=Object.defineProperty;var u=Object.getOwnPropertyDescriptor;var d=Object.getOwnPropertyNames;var M=Object.prototype.hasOwnProperty;var p=(s,e)=>n(s,"name",{value:e,configurable:!0});var l=(s,e)=>{for(var o in e)n(s,o,{get:e[o],enumerable:!0})},T=(s,e,o,i)=>{if(e&&
+typeof e=="object"||typeof e=="function")for(let t of d(e))!M.call(s,t)&&t!==o&&
+n(s,t,{get:()=>e[t],enumerable:!(i=u(e,t))||i.enumerable});return s};var f=s=>T(n({},"__esModule",{value:!0}),s);var w={};l(w,{Client:()=>m});module.exports=f(w);var r=require("@ez4/topic/utils"),
+a=require("@aws-sdk/client-sns");var y=new a.SNSClient({}),m;(e=>e.make=p((o,i,t)=>new class{async sendMessage(c){
+let g=await(0,r.getJsonStringMessage)(c,i);await y.send(new a.PublishCommand({TargetArn:o,
+Message:g,...t&&{...I(c,t)}}))}},"make"))(m||={});var I=p((s,e)=>{let o={};if(e){
+let{groupId:i,uniqueId:t}=e;if(o.MessageGroupId=`${s[i]}`,!o.MessageGroupId)throw new r.MissingMessageGroupError(
+i.toString());t&&s[t]&&(o.MessageDeduplicationId=`${s[t]}`)}return o},"getFifoPa\
+rameters");0&&(module.exports={Client});
+//# sourceMappingURL=client.cjs.map

package/dist/client.d.ts

@@ -0,0 +1,5 @@
+import type { Topic, Client as SnsClient } from '@ez4/topic';
+import type { MessageSchema } from '@ez4/topic/utils';
+export declare namespace Client {
+    const make: <T extends Topic.Message>(topicArn: string, messageSchema: MessageSchema, fifoMode?: Topic.FifoMode<T>) => SnsClient<T>;
+}

package/dist/client.mjs

@@ -0,0 +1,7 @@
+var p=Object.defineProperty;var n=(e,s)=>p(e,"name",{value:s,configurable:!0});import{getJsonStringMessage as c,MissingMessageGroupError as m}from"@ez4/topic/utils";
+import{PublishCommand as g,SNSClient as u}from"@aws-sdk/client-sns";var d=new u({}),M;(s=>s.make=n((t,i,o)=>new class{async sendMessage(r){let a=await c(
+r,i);await d.send(new g({TargetArn:t,Message:a,...o&&{...l(r,o)}}))}},"make"))(M||=
+{});var l=n((e,s)=>{let t={};if(s){let{groupId:i,uniqueId:o}=s;if(t.MessageGroupId=
+`${e[i]}`,!t.MessageGroupId)throw new m(i.toString());o&&e[o]&&(t.MessageDeduplicationId=
+`${e[o]}`)}return t},"getFifoParameters");export{M as Client};
+//# sourceMappingURL=client.mjs.map

package/dist/main.cjs

@@ -0,0 +1,137 @@
+"use strict";var h=Object.defineProperty;var rt=Object.getOwnPropertyDescriptor;var ot=Object.getOwnPropertyNames;var it=Object.prototype.hasOwnProperty;var i=(e,t)=>h(e,"name",{value:t,configurable:!0});var nt=(e,t)=>{for(var r in t)h(e,r,{get:t[r],enumerable:!0})},st=(e,t,r,o)=>{if(t&&
+typeof t=="object"||typeof t=="function")for(let n of ot(t))!it.call(e,n)&&n!==r&&
+h(e,n,{get:()=>t[n],enumerable:!(o=rt(t,n))||o.enumerable});return e};var pt=e=>st(h({},"__esModule",{value:!0}),e);var At={};nt(At,{SubscriptionServiceName:()=>a,SubscriptionServiceType:()=>d,TopicServiceName:()=>S,
+TopicServiceType:()=>y,createSubscription:()=>$,createSubscriptionFunction:()=>V,
+createTopic:()=>A,createTopicStateId:()=>k,getTopic:()=>bt,getTopicArn:()=>W,getTopicState:()=>Z,
+isSubscriptionState:()=>Rt,isTopicState:()=>O,registerTriggers:()=>xt});module.exports=
+pt(At);var Ze=require("@ez4/aws-common"),We=require("@ez4/aws-identity"),Ve=require("@ez4/aws-function"),
+Xe=require("@ez4/aws-queue"),Ye=require("@ez4/topic/library"),et=require("@ez4/project/library");var ue=require("@ez4/aws-common");var F=require("@ez4/aws-common"),D=require("@ez4/aws-identity"),ce=require("@ez4/utils");var x=require("@ez4/aws-identity");var v=i((e,t,r)=>`arn:aws:sns:${t}:${r}:${e}`,"buildTopicArn"),oe=i(async e=>{let[
+t,r]=await Promise.all([(0,x.getRegion)(),(0,x.getAccountId)()]);return(0,x.createPolicyDocument)(
+[{permissions:["sns:Publish"],resourceIds:e.map(o=>v(`${o}-*`,t,r))}])},"getPoli\
+cyDocument");var m=require("@aws-sdk/client-sns"),u=require("@ez4/aws-common");var S="AWS:SNS/Topic",y="aws:sns.topic";var z=new m.SNSClient({}),ie=i(async e=>{let{topicName:t,fifoMode:r}=e;return u.Logger.
+logCreate(S,t),{topicArn:(await z.send(new m.CreateTopicCommand({Name:t,Attributes:{
+...r&&{ContentBasedDeduplication:"true",FifoThroughputScope:"MessageGroup",FifoTopic:"\
+true"}},Tags:(0,u.getTagList)({...e.tags,ManagedBy:"EZ4"})}))).TopicArn}},"creat\
+eTopic"),ne=i(async e=>{let t=(0,u.tryParseArn)(e)?.resourceName??e;u.Logger.logDelete(
+S,t);try{return await z.send(new m.DeleteTopicCommand({TopicArn:e})),!0}catch(r){
+if(!(r instanceof m.NotFoundException))throw r;return!1}},"deleteTopic"),se=i(async(e,t)=>{
+let r=(0,u.tryParseArn)(e)?.resourceName??e;u.Logger.logTag(S,r),await z.send(new m.TagResourceCommand(
+{ResourceArn:e,Tags:(0,u.getTagList)({...t,ManagedBy:"EZ4"})}))},"tagTopic"),pe=i(
+async(e,t)=>{let r=(0,u.tryParseArn)(e)?.resourceName??e;u.Logger.logUntag(S,r),
+await z.send(new m.UntagResourceCommand({ResourceArn:e,TagKeys:t}))},"untagTopic");var ae=i(()=>({equals:ct,create:me,replace:mt,preview:at,update:ut,delete:St}),"\
+getTopicHandler"),ct=i((e,t)=>!!e.result&&e.result.topicArn===t.result?.topicArn,
+"equalsResource"),at=i(async(e,t)=>{let r={...e.parameters,dependencies:e.dependencies},
+o={...t.parameters,dependencies:t.dependencies},n=(0,ce.deepCompare)(r,o);if(n.counts)
+return{...n,name:r.topicName}},"previewResource"),mt=i(async(e,t)=>{if(t.result)
+throw new F.ReplaceResourceError(S,e.entryId,t.entryId);return me(e)},"replaceRe\
+source"),me=i(async e=>{let t=e.parameters;if(t.import){let[o,n]=await Promise.all(
+[(0,D.getRegion)(),(0,D.getAccountId)()]);return{topicArn:v(t.topicName,o,n)}}let{
+topicArn:r}=await ie(t);return{topicArn:r}},"createResource"),ut=i(async(e,t)=>{
+let{result:r,parameters:o}=e;r&&!o.import&&await ft(r.topicArn,o,t.parameters)},
+"updateResource"),St=i(async e=>{let{result:t,parameters:r}=e;t&&!r.import&&await ne(
+t.topicArn)},"deleteResource"),ft=i(async(e,t,r)=>{await(0,F.applyTagUpdates)(t.
+tags,r.tags,o=>se(e,o),o=>pe(e,o))},"checkTagUpdates");var Se=i(()=>{(0,ue.registerProvider)(y,ae())},"registerTopicProvider");var ve=require("@ez4/aws-common");var de=require("@ez4/aws-common"),Te=require("@ez4/utils");var b=require("@ez4/aws-common");var T=require("@aws-sdk/client-sns"),E=require("@ez4/aws-common");var a="AWS:SNS/Subscription",d="aws:sns.subscription";var fe=new T.SNSClient({});var le=i(async e=>{let t=(0,E.tryParseArn)(e.topicArn)?.resourceName??e.topicArn;
+E.Logger.logCreate(a,t);let{topicArn:r,protocol:o,endpoint:n}=e;return{subscriptionArn:(await fe.
+send(new T.SubscribeCommand({TopicArn:r,Protocol:o,Endpoint:n,ReturnSubscriptionArn:!0,
+Attributes:{...o==="sqs"&&{RawMessageDelivery:"true"}}}))).SubscriptionArn}},"cr\
+eateSubscription"),ye=i(async e=>{let t=(0,E.tryParseArn)(e)?.resourceName??e;E.Logger.
+logDelete(a,t);try{return await fe.send(new T.UnsubscribeCommand({SubscriptionArn:e})),
+!0}catch(r){if(!(r instanceof T.NotFoundException))throw r;return!1}},"deleteSub\
+scription");var ge=i((e,t)=>{if(!(0,b.isArn)(t))throw new b.InvalidParameterError(e,`endpoin\
+t ${t} is not supported.`);let{service:r}=(0,b.parseArn)(t);switch(r){case"lambd\
+a":case"sqs":return r}throw new b.InvalidParameterError(e,`protocol ${r} is not \
+supported.`)},"getSubscriptionProtocol");var be=i(()=>({equals:lt,create:xe,replace:gt,preview:yt,update:dt,delete:Tt}),"\
+getSubscriptionHandler"),lt=i((e,t)=>!!e.result&&e.result.subscriptionArn===t.result?.
+subscriptionArn,"equalsResource"),yt=i(async(e,t)=>{let r={...e.parameters,dependencies:e.
+dependencies},o={...t.parameters,dependencies:t.dependencies},n=(0,Te.deepCompare)(
+r,o,{exclude:{getTopicArn:!0,getEndpoint:!0}});if(n.counts)return{...n,name:r.fromService}},
+"previewResource"),gt=i(async(e,t,r)=>{if(t.result)throw new de.ReplaceResourceError(
+a,e.entryId,t.entryId);return xe(e,r)},"replaceResource"),xe=i(async(e,t)=>{let r=e.
+parameters,[o,n]=await Promise.all([r.getTopicArn(t),r.getEndpoint(t)]),{subscriptionArn:s}=await le(
+{protocol:ge(a,n),topicArn:o,endpoint:n});return{subscriptionArn:s,topicArn:o,endpoint:n}},
+"createResource"),dt=i(async()=>{},"updateResource"),Tt=i(async e=>{let{result:t}=e;
+t&&await ye(t.subscriptionArn)},"deleteResource");var Ee=i(()=>{(0,ve.registerProvider)(d,be())},"registerSubscriptionProvider");var U=require("@ez4/topic/library"),$e=require("@ez4/project/library");var Re=require("@ez4/stateful"),Ae=require("@ez4/utils");var we=require("@ez4/aws-common"),M=require("@ez4/utils");var L=class extends Error{static{i(this,"TopicNotFoundError")}constructor(t){super(
+`Topic service ${t} wasn't found.`)}};var k=i((e,t=!0)=>(0,M.hashData)(y,t?(0,M.toKebabCase)(e):e),"createTopicStateId"),
+O=i(e=>e.type===y,"isTopicState"),Z=i((e,t,r)=>{let o=e.getServiceState(t,r);if(!O(
+o))throw new L(t);return o},"getTopicState"),W=i((e,t,r)=>{let o=r.getDependencies(
+y).at(0)?.result;if(!o?.topicArn)throw new we.IncompleteResourceError(e,t,"topic\
+Arn");return o.topicArn},"getTopicArn");var A=i((e,t)=>{let r=(0,Ae.toKebabCase)(t.topicName),o=t.fifoMode?`${r}.fifo`:r,
+n=k(o,!1);return(0,Re.attachEntry)(e,{type:y,entryId:n,dependencies:[],parameters:{
+...t,topicName:o}})},"createTopic"),bt=i((e,t)=>{let r=k(t),o=e[r];return o&&O(o)?
+o:null},"getTopic");var Y=require("@ez4/project/library"),I=require("@ez4/topic/library"),q=require("@ez4/aws-function"),
+Q=require("@ez4/aws-common"),ee=require("@ez4/aws-identity"),ke=require("@ez4/aws-logs"),
+te=require("@ez4/aws-queue");var ze=require("@ez4/aws-function");var Pe=require("node:path"),Ne=require("@ez4/project/library"),Ce=require("@ez4/aws-function"),
+Ie=require("@ez4/aws-common");var he=i(async(e,t)=>{let{extras:r,debug:o,handler:n,listener:s,messageSchema:p}=t,
+c=(0,Ne.getDefinitionsObject)(e);return(0,Ie.getFunctionBundle)(Ce.MappingServiceName,
+{templateFile:(0,Pe.join)(__dirname,"../lib/message.ts"),filePrefix:"sns",define:{
+...c,__EZ4_SCHEMA:p?JSON.stringify(p):"undefined"},handler:n,listener:s,extras:r,
+debug:o})},"bundleSubscriptionFunction");var V=i((e,t,r,o)=>{let{handler:n}=o;return(0,ze.createFunction)(e,t,r,{handlerName:"\
+snsEntryPoint",sourceFile:n.sourceFile,functionName:o.functionName,description:o.
+description,variables:o.variables,timeout:o.timeout,memory:o.memory,debug:o.debug,
+tags:o.tags,getFunctionBundle:i(s=>{let p=s.getDependencies();return he(p,o)},"g\
+etFunctionBundle"),getFunctionFiles:i(()=>[n.sourceFile,n.dependencies],"getFunc\
+tionFiles")})},"createSubscriptionFunction");var g=require("@ez4/aws-function"),R=require("@ez4/aws-queue"),w=require("@ez4/aws-identity"),
+Fe=require("@ez4/stateful"),De=require("@ez4/utils");var $=i((e,t,r,o)=>{let n=t.parameters.topicName,s=[t.entryId,r.entryId];if((0,g.isFunctionState)(
+r)){let c=(0,g.getPermission)(e,t,r)??(0,g.createPermission)(e,t,r,{fromService:o.
+fromService,getPermission:i(async()=>{let[f,l]=await Promise.all([(0,w.getRegion)(),
+(0,w.getAccountId)()]);return{principal:"sns.amazonaws.com",sourceArn:v(n,f,l)}},
+"getPermission")});s.push(c.entryId)}if((0,R.isQueueState)(r)){let c=(0,R.attachQueuePolicy)(
+e,r,t,{fromService:o.fromService,policyGetters:[async()=>{let[f,l]=await Promise.
+all([(0,w.getRegion)(),(0,w.getAccountId)()]);return{principal:"sns.amazonaws.co\
+m",sourceArn:v(n,f,l)}}]});s.push(c.entryId)}let p=(0,De.hashData)(d,t.entryId,r.
+entryId);return(0,Fe.attachEntry)(e,{type:d,entryId:p,dependencies:s,parameters:{
+...o,getTopicArn:i(c=>W(S,p,c),"getTopicArn"),getEndpoint:i(c=>(0,g.isFunctionState)(
+r)?(0,g.getFunctionArn)(a,p,c):(0,R.getQueueArn)(a,p,c),"getEndpoint")}})},"crea\
+teSubscription");var Le=require("@ez4/project/library"),j=require("@ez4/utils");var X=i((e,t)=>`${(0,j.toKebabCase)(e.name)}-${(0,j.toKebabCase)(t)}`,"getIntern\
+alName"),Me=i((e,t,r)=>`${(0,Le.getServiceName)(e,r)}-${(0,j.toKebabCase)(t)}`,"\
+getFunctionName");var P=class extends Error{static{i(this,"RoleMissingError")}constructor(){super(
+"Execution role for SNS is missing.")}},N=class extends Error{constructor(r){super(
+`Imported project ${r} wasn't found.`);this.projectName=r}static{i(this,"Project\
+MissingError")}};var C;(o=>(o.LogRetention=90,o.Timeout=90,o.Memory=192))(C||={});var G=i(async(e,t,r,o,n)=>{if(!n.role||!(0,ee.isRoleState)(n.role))throw new P;for(let s of t.
+subscriptions)switch(s.type){default:throw new Q.InvalidParameterError(a,"subscr\
+iption not supported.");case I.TopicSubscriptionType.Lambda:{if(t.fifoMode)throw new Q.InvalidParameterError(
+a,"lambda subscription not supported for FIFO topics.");let{handler:p,listener:c}=s,
+f=X(t,p.name),l=(0,q.tryGetFunctionState)(n,f,o);if(!l){let re=Me(t,p.name,o),tt=(0,ke.createLogGroup)(
+e,{retention:s.logRetention??C.LogRetention,groupName:re,tags:o.tags});l=V(e,n.role,
+tt,{functionName:re,description:p.description,messageSchema:t.schema,timeout:s.timeout??
+C.Timeout,memory:s.memory??C.Memory,extras:t.extras,debug:o.debug,tags:o.tags,variables:{
+...o.variables,...t.variables,...s.variables},handler:{dependencies:n.getDependencies(
+p.file),functionName:p.name,sourceFile:p.file,module:p.module},...c&&{listener:{
+functionName:c.name,sourceFile:c.file,module:c.module}}}),n.setServiceState(l,f,
+o)}$(e,r,l,{fromService:l.parameters.functionName});break}case I.TopicSubscriptionType.
+Queue:{let p=(0,te.getQueueState)(n,s.service,o);$(e,r,p,{fromService:p.parameters.
+queueName});break}}},"prepareSubscriptions"),H=i((e,t,r,o)=>{if(t.extras){if(!o.
+role||!(0,ee.isRoleState)(o.role))throw new P;for(let n of t.subscriptions)switch(n.
+type){default:throw new Q.InvalidParameterError(a,"subscription not supported.");case I.TopicSubscriptionType.
+Lambda:{let s=X(t,n.handler.name),p=(0,q.getFunctionState)(o,s,r);(0,Y.linkServiceExtras)(
+e,p.entryId,t.extras);break}case I.TopicSubscriptionType.Queue:{let s=(0,te.getQueueState)(
+o,n.service,r);(0,Y.linkServiceExtras)(e,s.entryId,t.extras);break}}}},"connectS\
+ubscriptions");var Oe=require("@ez4/project/library");var _=i((e,t,r)=>{let n=Z(e,t.name,r).entryId,s=(0,Oe.getDefinitionName)(n,"topi\
+cArn"),p=JSON.stringify(t.fifoMode??null),c=JSON.stringify(t.schema);return{entryIds:[
+n],constructor:`make(${s}, ${c}, ${p})`,from:"@ez4/aws-topic/client",module:"Cli\
+ent"}},"prepareLinkedClient");var je=i(e=>{let{service:t,options:r,context:o}=e;return(0,U.isTopicService)(t)?
+_(o,t,r):null},"prepareLinkedServices"),Qe=i(async e=>{let{state:t,service:r,options:o,
+context:n}=e;if(!(0,U.isTopicService)(r))return!1;let{fifoMode:s}=r,p=A(t,{topicName:(0,$e.getServiceName)(
+r,o),fifoMode:!!s,tags:o.tags});return n.setServiceState(p,r,o),await G(t,r,p,o,
+n),!0},"prepareServices"),qe=i(e=>{let{state:t,service:r,options:o,context:n}=e;
+(0,U.isTopicService)(r)&&H(t,r,o,n)},"connectServices");var B=require("@ez4/topic/library"),Ge=require("@ez4/project/library");var He=i(e=>{let{service:t,options:r,context:o}=e;if(!(0,B.isTopicImport)(t))return null;
+let{project:n}=t,{imports:s}=r;if(!s||!s[n])throw new N(n);return _(o,t,s[n])},"\
+prepareLinkedImports"),_e=i(async e=>{let{state:t,service:r,options:o,context:n}=e;
+if(!(0,B.isTopicImport)(r))return!1;let{reference:s,project:p}=r,{imports:c}=o;if(!c||
+!c[p])throw new N(p);let f=A(t,{topicName:(0,Ge.getServiceName)(s,c[p]),fifoMode:!!r.
+fifoMode,import:!0});return n.setServiceState(f,r,o),await G(t,r,f,o,n),!0},"pre\
+pareImports"),Ue=i(e=>{let{state:t,service:r,options:o,context:n}=e;(0,B.isTopicImport)(
+r)&&H(t,r,o,n)},"connectImports");var K=require("@ez4/topic/library"),J=require("@ez4/aws-identity"),Be=require("@ez4/project/library");var Ke=i(async e=>{let{state:t,serviceType:r,options:o}=e;if(r!==K.ServiceType&&
+r!==K.ImportType)return null;let n=Object.values({options:o,...o.imports}).map(c=>(0,Be.getServiceName)(
+"",c)),[s]=n,p=`${s}-topic-policy`;return(0,J.tryGetPolicy)(t,p)??(0,J.createPolicy)(
+t,{tags:o.tags,policyDocument:await oe(n),policyName:p})},"prepareExecutionPolic\
+y");var Je=!1,xt=i(()=>{Je||((0,Ze.registerTriggers)(),(0,We.registerTriggers)(),(0,Ve.registerTriggers)(),
+(0,Xe.registerTriggers)(),(0,Ye.registerTriggers)(),(0,et.createTrigger)("@ez4/a\
+ws-topic",{"deploy:prepareExecutionPolicy":Ke,"deploy:prepareLinkedService":vt,"\
+deploy:prepareResources":Et,"deploy:connectResources":wt}),Se(),Ee(),Je=!0)},"re\
+gisterTriggers"),vt=i(e=>je(e)??He(e)??null,"prepareLinkedService"),Et=i(async e=>await Qe(
+e)||await _e(e),"prepareQueueResources"),wt=i(async e=>{await Promise.all([qe(e),
+Ue(e)])},"connectQueueResources");var Rt=i(e=>e.type===d,"isSubscriptionState");0&&(module.exports={SubscriptionServiceName,SubscriptionServiceType,TopicServiceName,
+TopicServiceType,createSubscription,createSubscriptionFunction,createTopic,createTopicStateId,
+getTopic,getTopicArn,getTopicState,isSubscriptionState,isTopicState,registerTriggers});
+//# sourceMappingURL=main.cjs.map

package/dist/main.d.ts

@@ -0,0 +1,9 @@
+export * from './triggers/register';
+export * from './topic/service';
+export * from './topic/types';
+export * from './topic/utils';
+export * from './subscription/function/service';
+export * from './subscription/function/types';
+export * from './subscription/service';
+export * from './subscription/types';
+export * from './subscription/utils';

package/dist/main.mjs

@@ -0,0 +1,123 @@
+var Ee=Object.defineProperty;var i=(e,t)=>Ee(e,"name",{value:t,configurable:!0});import{registerTriggers as Lt}from"@ez4/aws-common";import{registerTriggers as Mt}from"@ez4/aws-identity";
+import{registerTriggers as kt}from"@ez4/aws-function";import{registerTriggers as Ot}from"@ez4/aws-queue";
+import{registerTriggers as $t}from"@ez4/topic/library";import{createTrigger as jt}from"@ez4/project/library";import{registerProvider as He}from"@ez4/aws-common";import{applyTagUpdates as Fe,ReplaceResourceError as De}from"@ez4/aws-common";import{
+getAccountId as Le,getRegion as Me}from"@ez4/aws-identity";import{deepCompare as ke}from"@ez4/utils";import{getAccountId as we,getRegion as Re,createPolicyDocument as Ae}from"@ez4/aws-identity";var y=i((e,t,r)=>`arn:aws:sns:${t}:${r}:${e}`,"buildTopicArn"),O=i(async e=>{let[
+t,r]=await Promise.all([Re(),we()]);return Ae([{permissions:["sns:Publish"],resourceIds:e.
+map(o=>y(`${o}-*`,t,r))}])},"getPolicyDocument");import{SNSClient as Pe,CreateTopicCommand as Ne,DeleteTopicCommand as Ce,TagResourceCommand as Ie,
+UntagResourceCommand as he,NotFoundException as ze}from"@aws-sdk/client-sns";import{
+getTagList as $,Logger as b,tryParseArn as N}from"@ez4/aws-common";var S="AWS:SNS/Topic",f="aws:sns.topic";var x=new Pe({}),j=i(async e=>{let{topicName:t,fifoMode:r}=e;return b.logCreate(
+S,t),{topicArn:(await x.send(new Ne({Name:t,Attributes:{...r&&{ContentBasedDeduplication:"\
+true",FifoThroughputScope:"MessageGroup",FifoTopic:"true"}},Tags:$({...e.tags,ManagedBy:"\
+EZ4"})}))).TopicArn}},"createTopic"),Q=i(async e=>{let t=N(e)?.resourceName??e;b.
+logDelete(S,t);try{return await x.send(new Ce({TopicArn:e})),!0}catch(r){if(!(r instanceof
+ze))throw r;return!1}},"deleteTopic"),q=i(async(e,t)=>{let r=N(e)?.resourceName??
+e;b.logTag(S,r),await x.send(new Ie({ResourceArn:e,Tags:$({...t,ManagedBy:"EZ4"})}))},
+"tagTopic"),G=i(async(e,t)=>{let r=N(e)?.resourceName??e;b.logUntag(S,r),await x.
+send(new he({ResourceArn:e,TagKeys:t}))},"untagTopic");var H=i(()=>({equals:Oe,create:_,replace:je,preview:$e,update:Qe,delete:qe}),"ge\
+tTopicHandler"),Oe=i((e,t)=>!!e.result&&e.result.topicArn===t.result?.topicArn,"\
+equalsResource"),$e=i(async(e,t)=>{let r={...e.parameters,dependencies:e.dependencies},
+o={...t.parameters,dependencies:t.dependencies},n=ke(r,o);if(n.counts)return{...n,
+name:r.topicName}},"previewResource"),je=i(async(e,t)=>{if(t.result)throw new De(
+S,e.entryId,t.entryId);return _(e)},"replaceResource"),_=i(async e=>{let t=e.parameters;
+if(t.import){let[o,n]=await Promise.all([Me(),Le()]);return{topicArn:y(t.topicName,
+o,n)}}let{topicArn:r}=await j(t);return{topicArn:r}},"createResource"),Qe=i(async(e,t)=>{
+let{result:r,parameters:o}=e;r&&!o.import&&await Ge(r.topicArn,o,t.parameters)},
+"updateResource"),qe=i(async e=>{let{result:t,parameters:r}=e;t&&!r.import&&await Q(
+t.topicArn)},"deleteResource"),Ge=i(async(e,t,r)=>{await Fe(t.tags,r.tags,o=>q(e,
+o),o=>G(e,o))},"checkTagUpdates");var U=i(()=>{He(f,H())},"registerTopicProvider");import{registerProvider as ot}from"@ez4/aws-common";import{ReplaceResourceError as We}from"@ez4/aws-common";import{deepCompare as Ve}from"@ez4/utils";import{InvalidParameterError as V,isArn as Je,parseArn as Ze}from"@ez4/aws-common";import{NotFoundException as _e,SNSClient as Ue,SubscribeCommand as Be,UnsubscribeCommand as Ke}from"@aws-sdk/client-sns";
+import{Logger as B,tryParseArn as K}from"@ez4/aws-common";var a="AWS:SNS/Subscription",l="aws:sns.subscription";var J=new Ue({});var Z=i(async e=>{let t=K(e.topicArn)?.resourceName??e.topicArn;B.logCreate(a,t);
+let{topicArn:r,protocol:o,endpoint:n}=e;return{subscriptionArn:(await J.send(new Be(
+{TopicArn:r,Protocol:o,Endpoint:n,ReturnSubscriptionArn:!0,Attributes:{...o==="s\
+qs"&&{RawMessageDelivery:"true"}}}))).SubscriptionArn}},"createSubscription"),W=i(
+async e=>{let t=K(e)?.resourceName??e;B.logDelete(a,t);try{return await J.send(new Ke(
+{SubscriptionArn:e})),!0}catch(r){if(!(r instanceof _e))throw r;return!1}},"dele\
+teSubscription");var X=i((e,t)=>{if(!Je(t))throw new V(e,`endpoint ${t} is not supported.`);let{service:r}=Ze(
+t);switch(r){case"lambda":case"sqs":return r}throw new V(e,`protocol ${r} is not\
+ supported.`)},"getSubscriptionProtocol");var Y=i(()=>({equals:Xe,create:ee,replace:et,preview:Ye,update:tt,delete:rt}),"g\
+etSubscriptionHandler"),Xe=i((e,t)=>!!e.result&&e.result.subscriptionArn===t.result?.
+subscriptionArn,"equalsResource"),Ye=i(async(e,t)=>{let r={...e.parameters,dependencies:e.
+dependencies},o={...t.parameters,dependencies:t.dependencies},n=Ve(r,o,{exclude:{
+getTopicArn:!0,getEndpoint:!0}});if(n.counts)return{...n,name:r.fromService}},"p\
+reviewResource"),et=i(async(e,t,r)=>{if(t.result)throw new We(a,e.entryId,t.entryId);
+return ee(e,r)},"replaceResource"),ee=i(async(e,t)=>{let r=e.parameters,[o,n]=await Promise.
+all([r.getTopicArn(t),r.getEndpoint(t)]),{subscriptionArn:s}=await Z({protocol:X(
+a,n),topicArn:o,endpoint:n});return{subscriptionArn:s,topicArn:o,endpoint:n}},"c\
+reateResource"),tt=i(async()=>{},"updateResource"),rt=i(async e=>{let{result:t}=e;
+t&&await W(t.subscriptionArn)},"deleteResource");var te=i(()=>{ot(l,Y())},"registerSubscriptionProvider");import{isTopicService as L}from"@ez4/topic/library";import{getServiceName as Nt}from"@ez4/project/library";import{attachEntry as pt}from"@ez4/stateful";import{toKebabCase as ct}from"@ez4/utils";import{IncompleteResourceError as it}from"@ez4/aws-common";import{hashData as nt,
+toKebabCase as st}from"@ez4/utils";var v=class extends Error{static{i(this,"TopicNotFoundError")}constructor(t){super(
+`Topic service ${t} wasn't found.`)}};var C=i((e,t=!0)=>nt(f,t?st(e):e),"createTopicStateId"),I=i(e=>e.type===f,"isTop\
+icState"),re=i((e,t,r)=>{let o=e.getServiceState(t,r);if(!I(o))throw new v(t);return o},
+"getTopicState"),oe=i((e,t,r)=>{let o=r.getDependencies(f).at(0)?.result;if(!o?.
+topicArn)throw new it(e,t,"topicArn");return o.topicArn},"getTopicArn");var E=i((e,t)=>{let r=ct(t.topicName),o=t.fifoMode?`${r}.fifo`:r,n=C(o,!1);return pt(
+e,{type:f,entryId:n,dependencies:[],parameters:{...t,topicName:o}})},"createTopi\
+c"),Kr=i((e,t)=>{let r=C(t),o=e[r];return o&&I(o)?o:null},"getTopic");import{linkServiceExtras as me}from"@ez4/project/library";import{TopicSubscriptionType as w}from"@ez4/topic/library";
+import{getFunctionState as wt,tryGetFunctionState as Rt}from"@ez4/aws-function";
+import{InvalidParameterError as D}from"@ez4/aws-common";import{isRoleState as ue}from"@ez4/aws-identity";
+import{createLogGroup as At}from"@ez4/aws-logs";import{getQueueState as Se}from"@ez4/aws-queue";import{createFunction as ft}from"@ez4/aws-function";import{join as at}from"node:path";import{getDefinitionsObject as mt}from"@ez4/project/library";
+import{MappingServiceName as ut}from"@ez4/aws-function";import{getFunctionBundle as St}from"@ez4/aws-common";var ie=i(async(e,t)=>{let{extras:r,debug:o,handler:n,listener:s,messageSchema:p}=t,
+c=mt(e);return St(ut,{templateFile:at(import.meta.dirname,"../lib/message.ts"),filePrefix:"\
+sns",define:{...c,__EZ4_SCHEMA:p?JSON.stringify(p):"undefined"},handler:n,listener:s,
+extras:r,debug:o})},"bundleSubscriptionFunction");var ne=i((e,t,r,o)=>{let{handler:n}=o;return ft(e,t,r,{handlerName:"snsEntryPoin\
+t",sourceFile:n.sourceFile,functionName:o.functionName,description:o.description,
+variables:o.variables,timeout:o.timeout,memory:o.memory,debug:o.debug,tags:o.tags,
+getFunctionBundle:i(s=>{let p=s.getDependencies();return ie(p,o)},"getFunctionBu\
+ndle"),getFunctionFiles:i(()=>[n.sourceFile,n.dependencies],"getFunctionFiles")})},
+"createSubscriptionFunction");import{createPermission as lt,getFunctionArn as yt,getPermission as gt,isFunctionState as se}from"@ez4/aws-function";
+import{attachQueuePolicy as dt,getQueueArn as Tt,isQueueState as bt}from"@ez4/aws-queue";
+import{getAccountId as pe,getRegion as ce}from"@ez4/aws-identity";import{attachEntry as xt}from"@ez4/stateful";
+import{hashData as vt}from"@ez4/utils";var h=i((e,t,r,o)=>{let n=t.parameters.topicName,s=[t.entryId,r.entryId];if(se(r)){
+let c=gt(e,t,r)??lt(e,t,r,{fromService:o.fromService,getPermission:i(async()=>{let[
+m,u]=await Promise.all([ce(),pe()]);return{principal:"sns.amazonaws.com",sourceArn:y(
+n,m,u)}},"getPermission")});s.push(c.entryId)}if(bt(r)){let c=dt(e,r,t,{fromService:o.
+fromService,policyGetters:[async()=>{let[m,u]=await Promise.all([ce(),pe()]);return{
+principal:"sns.amazonaws.com",sourceArn:y(n,m,u)}}]});s.push(c.entryId)}let p=vt(
+l,t.entryId,r.entryId);return xt(e,{type:l,entryId:p,dependencies:s,parameters:{
+...o,getTopicArn:i(c=>oe(S,p,c),"getTopicArn"),getEndpoint:i(c=>se(r)?yt(a,p,c):
+Tt(a,p,c),"getEndpoint")}})},"createSubscription");import{getServiceName as Et}from"@ez4/project/library";import{toKebabCase as z}from"@ez4/utils";var F=i((e,t)=>`${z(e.name)}-${z(t)}`,"getInternalName"),ae=i((e,t,r)=>`${Et(e,r)}\
+-${z(t)}`,"getFunctionName");var g=class extends Error{static{i(this,"RoleMissingError")}constructor(){super(
+"Execution role for SNS is missing.")}},d=class extends Error{constructor(r){super(
+`Imported project ${r} wasn't found.`);this.projectName=r}static{i(this,"Project\
+MissingError")}};var T;(o=>(o.LogRetention=90,o.Timeout=90,o.Memory=192))(T||={});var R=i(async(e,t,r,o,n)=>{if(!n.role||!ue(n.role))throw new g;for(let s of t.subscriptions)
+switch(s.type){default:throw new D(a,"subscription not supported.");case w.Lambda:{
+if(t.fifoMode)throw new D(a,"lambda subscription not supported for FIFO topics.");
+let{handler:p,listener:c}=s,m=F(t,p.name),u=Rt(n,m,o);if(!u){let k=ae(t,p.name,o),
+ve=At(e,{retention:s.logRetention??T.LogRetention,groupName:k,tags:o.tags});u=ne(
+e,n.role,ve,{functionName:k,description:p.description,messageSchema:t.schema,timeout:s.
+timeout??T.Timeout,memory:s.memory??T.Memory,extras:t.extras,debug:o.debug,tags:o.
+tags,variables:{...o.variables,...t.variables,...s.variables},handler:{dependencies:n.
+getDependencies(p.file),functionName:p.name,sourceFile:p.file,module:p.module},...c&&
+{listener:{functionName:c.name,sourceFile:c.file,module:c.module}}}),n.setServiceState(
+u,m,o)}h(e,r,u,{fromService:u.parameters.functionName});break}case w.Queue:{let p=Se(
+n,s.service,o);h(e,r,p,{fromService:p.parameters.queueName});break}}},"prepareSu\
+bscriptions"),A=i((e,t,r,o)=>{if(t.extras){if(!o.role||!ue(o.role))throw new g;for(let n of t.
+subscriptions)switch(n.type){default:throw new D(a,"subscription not supported.");case w.
+Lambda:{let s=F(t,n.handler.name),p=wt(o,s,r);me(e,p.entryId,t.extras);break}case w.
+Queue:{let s=Se(o,n.service,r);me(e,s.entryId,t.extras);break}}}},"connectSubscr\
+iptions");import{getDefinitionName as Pt}from"@ez4/project/library";var P=i((e,t,r)=>{let n=re(e,t.name,r).entryId,s=Pt(n,"topicArn"),p=JSON.stringify(
+t.fifoMode??null),c=JSON.stringify(t.schema);return{entryIds:[n],constructor:`ma\
+ke(${s}, ${c}, ${p})`,from:"@ez4/aws-topic/client",module:"Client"}},"prepareLin\
+kedClient");var fe=i(e=>{let{service:t,options:r,context:o}=e;return L(t)?P(o,t,r):null},"pr\
+epareLinkedServices"),le=i(async e=>{let{state:t,service:r,options:o,context:n}=e;
+if(!L(r))return!1;let{fifoMode:s}=r,p=E(t,{topicName:Nt(r,o),fifoMode:!!s,tags:o.
+tags});return n.setServiceState(p,r,o),await R(t,r,p,o,n),!0},"prepareServices"),
+ye=i(e=>{let{state:t,service:r,options:o,context:n}=e;L(r)&&A(t,r,o,n)},"connect\
+Services");import{isTopicImport as M}from"@ez4/topic/library";import{getServiceName as Ct}from"@ez4/project/library";var ge=i(e=>{let{service:t,options:r,context:o}=e;if(!M(t))return null;let{project:n}=t,
+{imports:s}=r;if(!s||!s[n])throw new d(n);return P(o,t,s[n])},"prepareLinkedImpo\
+rts"),de=i(async e=>{let{state:t,service:r,options:o,context:n}=e;if(!M(r))return!1;
+let{reference:s,project:p}=r,{imports:c}=o;if(!c||!c[p])throw new d(p);let m=E(t,
+{topicName:Ct(s,c[p]),fifoMode:!!r.fifoMode,import:!0});return n.setServiceState(
+m,r,o),await R(t,r,m,o,n),!0},"prepareImports"),Te=i(e=>{let{state:t,service:r,options:o,
+context:n}=e;M(r)&&A(t,r,o,n)},"connectImports");import{ServiceType as It,ImportType as ht}from"@ez4/topic/library";import{createPolicy as zt,
+tryGetPolicy as Ft}from"@ez4/aws-identity";import{getServiceName as Dt}from"@ez4/project/library";var be=i(async e=>{let{state:t,serviceType:r,options:o}=e;if(r!==It&&r!==ht)return null;
+let n=Object.values({options:o,...o.imports}).map(c=>Dt("",c)),[s]=n,p=`${s}-top\
+ic-policy`;return Ft(t,p)??zt(t,{tags:o.tags,policyDocument:await O(n),policyName:p})},
+"prepareExecutionPolicy");var xe=!1,Ei=i(()=>{xe||(Lt(),Mt(),kt(),Ot(),$t(),jt("@ez4/aws-topic",{"deploy:p\
+repareExecutionPolicy":be,"deploy:prepareLinkedService":Qt,"deploy:prepareResour\
+ces":qt,"deploy:connectResources":Gt}),U(),te(),xe=!0)},"registerTriggers"),Qt=i(
+e=>fe(e)??ge(e)??null,"prepareLinkedService"),qt=i(async e=>await le(e)||await de(
+e),"prepareQueueResources"),Gt=i(async e=>{await Promise.all([ye(e),Te(e)])},"co\
+nnectQueueResources");var Pi=i(e=>e.type===l,"isSubscriptionState");export{a as SubscriptionServiceName,l as SubscriptionServiceType,S as TopicServiceName,
+f as TopicServiceType,h as createSubscription,ne as createSubscriptionFunction,E as createTopic,
+C as createTopicStateId,Kr as getTopic,oe as getTopicArn,re as getTopicState,Pi as isSubscriptionState,
+I as isTopicState,Ei as registerTriggers};
+//# sourceMappingURL=main.mjs.map

package/dist/subscription/client.d.ts

@@ -0,0 +1,15 @@
+import type { Arn } from '@ez4/aws-common';
+export declare const enum SubscriptionProtocol {
+    Lambda = "lambda",
+    SQS = "sqs"
+}
+export type CreateRequest = {
+    topicArn: string;
+    protocol: SubscriptionProtocol;
+    endpoint: string;
+};
+export type CreateResponse = {
+    subscriptionArn: Arn;
+};
+export declare const createSubscription: (request: CreateRequest) => Promise<CreateResponse>;
+export declare const deleteSubscription: (subscriptionArn: string) => Promise<boolean>;

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

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

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

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

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

@@ -0,0 +1,18 @@
+import type { TopicMessageSchema } from '@ez4/topic/library';
+import type { FunctionParameters } from '@ez4/aws-function';
+import type { ExtraSource } from '@ez4/project/library';
+export type SubscriptionFunction = {
+    functionName: string;
+    sourceFile: string;
+    module?: string;
+};
+export type SubscriptionEntryPoint = SubscriptionFunction & {
+    dependencies: string[];
+};
+export type SubscriptionFunctionParameters = Omit<FunctionParameters, 'getFunctionBundle' | 'getFunctionFiles' | 'sourceFile' | 'handlerName'> & {
+    handler: SubscriptionEntryPoint;
+    listener?: SubscriptionFunction;
+    messageSchema?: TopicMessageSchema | null;
+    extras?: Record<string, ExtraSource>;
+    debug?: boolean;
+};

package/dist/subscription/handler.d.ts

@@ -0,0 +1,3 @@
+import type { StepHandler } from '@ez4/stateful';
+import type { SubscriptionState } from './types';
+export declare const getSubscriptionHandler: () => StepHandler<SubscriptionState>;

package/dist/subscription/helpers/protocol.d.ts

@@ -0,0 +1,2 @@
+import { SubscriptionProtocol } from '../client';
+export declare const getSubscriptionProtocol: (serviceName: string, endpoint: string) => SubscriptionProtocol;

package/dist/subscription/provider.d.ts

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

package/dist/subscription/service.d.ts

@@ -0,0 +1,6 @@
+import type { EntryState, EntryStates } from '@ez4/stateful';
+import type { FunctionState } from '@ez4/aws-function';
+import type { QueueState } from '@ez4/aws-queue';
+import type { TopicState } from '../topic/types';
+import type { SubscriptionParameters, SubscriptionState } from './types';
+export declare const createSubscription: <E extends EntryState>(state: EntryStates<E>, topicState: TopicState, endpointState: FunctionState | QueueState, parameters: Pick<SubscriptionParameters, "fromService">) => SubscriptionState;

package/dist/subscription/types.d.ts

@@ -0,0 +1,21 @@
+import type { Arn } from '@ez4/aws-common';
+import type { EntryState, StepContext } from '@ez4/stateful';
+import type { CreateResponse } from './client';
+export declare const SubscriptionServiceName = "AWS:SNS/Subscription";
+export declare const SubscriptionServiceType = "aws:sns.subscription";
+export type GetSubscriptionTopicArn = (context: StepContext) => Promise<Arn> | Arn;
+export type GetSubscriptionEndpoint = (context: StepContext) => Promise<string> | string;
+export type SubscriptionParameters = {
+    getTopicArn: GetSubscriptionTopicArn;
+    getEndpoint: GetSubscriptionEndpoint;
+    fromService: string;
+};
+export type SubscriptionResult = CreateResponse & {
+    topicArn: Arn;
+    endpoint: string;
+};
+export type SubscriptionState = EntryState & {
+    type: typeof SubscriptionServiceType;
+    parameters: SubscriptionParameters;
+    result?: SubscriptionResult;
+};

package/dist/subscription/utils.d.ts

@@ -0,0 +1,3 @@
+import type { EntryState } from '@ez4/stateful';
+import type { SubscriptionState } from './types';
+export declare const isSubscriptionState: (resource: EntryState) => resource is SubscriptionState;

package/dist/topic/client.d.ts

@@ -0,0 +1,13 @@
+import type { Arn, ResourceTags } from '@ez4/aws-common';
+export type CreateRequest = {
+    topicName: string;
+    fifoMode: boolean;
+    tags?: ResourceTags;
+};
+export type CreateResponse = {
+    topicArn: Arn;
+};
+export declare const createTopic: (request: CreateRequest) => Promise<CreateResponse>;
+export declare const deleteTopic: (topicArn: string) => Promise<boolean>;
+export declare const tagTopic: (topicArn: string, tags: ResourceTags) => Promise<void>;
+export declare const untagTopic: (topicArn: string, tagKeys: string[]) => Promise<void>;

package/dist/topic/errors.d.ts

@@ -0,0 +1,3 @@
+export declare class TopicNotFoundError extends Error {
+    constructor(topicName: string);
+}

package/dist/topic/handler.d.ts

@@ -0,0 +1,3 @@
+import type { StepHandler } from '@ez4/stateful';
+import type { TopicState } from './types';
+export declare const getTopicHandler: () => StepHandler<TopicState>;

package/dist/topic/provider.d.ts

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

package/dist/topic/service.d.ts

@@ -0,0 +1,9 @@
+import type { EntryState, EntryStates } from '@ez4/stateful';
+import type { TopicParameters, TopicState } from './types';
+import { TopicServiceType } from './types';
+export declare const createTopic: <E extends EntryState>(state: EntryStates<E>, parameters: TopicParameters) => TopicState;
+export declare const getTopic: <E extends EntryState>(state: EntryStates<E>, topicName: string) => (E & EntryState & {
+    type: typeof TopicServiceType;
+    parameters: TopicParameters;
+    result?: import("./types").TopicResult;
+}) | null;

package/dist/topic/types.d.ts

@@ -0,0 +1,13 @@
+import type { EntryState } from '@ez4/stateful';
+import type { CreateRequest, CreateResponse } from './client';
+export declare const TopicServiceName = "AWS:SNS/Topic";
+export declare const TopicServiceType = "aws:sns.topic";
+export type TopicParameters = CreateRequest & {
+    import?: boolean;
+};
+export type TopicResult = CreateResponse;
+export type TopicState = EntryState & {
+    type: typeof TopicServiceType;
+    parameters: TopicParameters;
+    result?: TopicResult;
+};

package/dist/topic/utils.d.ts

@@ -0,0 +1,7 @@
+import type { DeployOptions, EventContext } from '@ez4/project/library';
+import type { EntryState, StepContext } from '@ez4/stateful';
+import type { TopicState } from './types';
+export declare const createTopicStateId: (topicName: string, normalize?: boolean) => string;
+export declare const isTopicState: (resource: EntryState) => resource is TopicState;
+export declare const getTopicState: (context: EventContext, topicName: string, options: DeployOptions) => TopicState;
+export declare const getTopicArn: (serviceName: string, resourceId: string, context: StepContext) => `arn:aws:${string}:${string}:${string}:${string}`;

package/dist/triggers/client.d.ts

@@ -0,0 +1,3 @@
+import type { TopicImport, TopicService } from '@ez4/topic/library';
+import type { DeployOptions, EventContext, ExtraSource } from '@ez4/project/library';
+export declare const prepareLinkedClient: (context: EventContext, service: TopicService | TopicImport, options: DeployOptions) => ExtraSource;

package/dist/triggers/defaults.d.ts

@@ -0,0 +1,14 @@
+export declare namespace Defaults {
+    /**
+     * Default log retention in days.
+     */
+    const LogRetention = 90;
+    /**
+     * Default lambda timeout.
+     */
+    const Timeout = 90;
+    /**
+     * Default lambda memory.
+     */
+    const Memory = 192;
+}

package/dist/triggers/errors.d.ts

@@ -0,0 +1,7 @@
+export declare class RoleMissingError extends Error {
+    constructor();
+}
+export declare class ProjectMissingError extends Error {
+    projectName: string;
+    constructor(projectName: string);
+}

package/dist/triggers/import.d.ts

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

package/dist/triggers/policy.d.ts

@@ -0,0 +1,2 @@
+import type { PolicyResourceEvent } from '@ez4/project/library';
+export declare const prepareExecutionPolicy: (event: PolicyResourceEvent) => Promise<import("@ez4/stateful").EntryState<string> | null>;

package/dist/triggers/register.d.ts

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

package/dist/triggers/service.d.ts

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

package/dist/triggers/subscription.d.ts

@@ -0,0 +1,6 @@
+import type { TopicService, TopicImport } from '@ez4/topic/library';
+import type { DeployOptions, EventContext } from '@ez4/project/library';
+import type { EntryStates } from '@ez4/stateful';
+import type { TopicState } from '../topic/types';
+export declare const prepareSubscriptions: (state: EntryStates, service: TopicService | TopicImport, topicState: TopicState, options: DeployOptions, context: EventContext) => Promise<void>;
+export declare const connectSubscriptions: (state: EntryStates, service: TopicService | TopicImport, options: DeployOptions, context: EventContext) => void;

package/dist/triggers/utils.d.ts

@@ -0,0 +1,4 @@
+import type { TopicService, TopicImport } from '@ez4/topic/library';
+import type { DeployOptions } from '@ez4/project/library';
+export declare const getInternalName: (service: TopicService | TopicImport, suffixName: string) => string;
+export declare const getFunctionName: (service: TopicService | TopicImport, handlerName: string, options: DeployOptions) => string;

package/dist/utils/policy.d.ts

@@ -0,0 +1,3 @@
+import type { Arn } from '@ez4/aws-common';
+export declare const buildTopicArn: (topicName: string, region: string, accountId: string) => Arn;
+export declare const getPolicyDocument: (prefixList: string[]) => Promise<import("@ez4/aws-identity").PolicyDocument>;

package/lib/message.ts

@@ -0,0 +1,93 @@
+import type { SNSEvent, Context } from 'aws-lambda';
+import type { MessageSchema } from '@ez4/topic/utils';
+import type { Topic } from '@ez4/topic';
+
+import * as TopicUtils from '@ez4/topic/utils';
+
+import { ServiceEventType } from '@ez4/common';
+
+declare const __EZ4_SCHEMA: MessageSchema | null;
+declare const __EZ4_CONTEXT: object;
+
+declare function dispatch(event: Topic.ServiceEvent<Topic.Message>, context: object): Promise<void>;
+declare function handle(message: Topic.Incoming<Topic.Message>, context: object): Promise<any>;
+
+/**
+ * Entrypoint to handle SNS events.
+ */
+export async function snsEntryPoint(event: SNSEvent, context: Context): Promise<void> {
+  let currentRequest: Topic.Incoming<Topic.Message> | undefined;
+
+  const request = {
+    requestId: context.awsRequestId
+  };
+
+  try {
+    await onBegin(request);
+
+    if (!__EZ4_SCHEMA) {
+      throw new Error(`Validation schema for SNS message not found.`);
+    }
+
+    for (const record of event.Records) {
+      const payload = JSON.parse(record.Sns.Message);
+      const message = await TopicUtils.getJsonMessage(payload, __EZ4_SCHEMA);
+
+      currentRequest = {
+        ...request,
+        message
+      };
+
+      await onReady(currentRequest);
+
+      await handle(currentRequest, __EZ4_CONTEXT);
+    }
+  } catch (error) {
+    await onError(error, currentRequest ?? request);
+  } finally {
+    await onEnd(request);
+  }
+}
+
+const onBegin = async (request: Topic.Request) => {
+  return dispatch(
+    {
+      type: ServiceEventType.Begin,
+      request
+    },
+    __EZ4_CONTEXT
+  );
+};
+
+const onReady = async (request: Topic.Incoming<Topic.Message>) => {
+  return dispatch(
+    {
+      type: ServiceEventType.Ready,
+      request
+    },
+    __EZ4_CONTEXT
+  );
+};
+
+const onError = async (error: Error, request: Topic.Request | Topic.Incoming<Topic.Message>) => {
+  console.error(error);
+
+  return dispatch(
+    {
+      type: ServiceEventType.Error,
+      request,
+      error
+    },
+    __EZ4_CONTEXT
+  );
+};
+
+const onEnd = async (request: Topic.Request) => {
+  return dispatch(
+    {
+      type: ServiceEventType.End,
+      request
+    },
+    __EZ4_CONTEXT
+  );
+};

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@ez4/aws-topic",
+  "description": "EZ4: Self-managed AWS SNS topics provider",
+  "version": "0.27.0",
+  "author": "Silas B.",
+  "license": "MIT",
+  "type": "module",
+  "keywords": [
+    "ez4"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sbalmt/ez4.git",
+    "directory": "providers/aws/aws-topic"
+  },
+  "engines": {
+    "node": ">=22.7"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/main.d.ts",
+      "require": "./dist/main.cjs",
+      "import": "./dist/main.mjs"
+    },
+    "./client": {
+      "types": "./dist/client.d.ts",
+      "require": "./dist/client.cjs",
+      "import": "./dist/client.mjs"
+    }
+  },
+  "workspaces": [
+    "foundation/*",
+    "contracts/*",
+    "providers/aws/*"
+  ],
+  "scripts": {
+    "lint": "eslint --cache",
+    "clean": "rm -f *.tsbuildinfo && rm -rf dist/*",
+    "build": "tsc && node tools/bundler.mjs",
+    "test": "npm run build && ez4 test -e ../../../local.env",
+    "local:publish": "npm run build && npm run clean:registry && npm publish --registry http://localhost:4873",
+    "clean:registry": "rm -rf ../../../.registry/@ez4/aws-topic",
+    "live:publish": "npm run build && npm publish --access public"
+  },
+  "devDependencies": {
+    "@types/aws-lambda": "^8.10.147"
+  },
+  "dependencies": {
+    "@aws-sdk/client-sns": "^3.758.0",
+    "@ez4/aws-common": "^0.27.0",
+    "@ez4/aws-identity": "^0.27.0",
+    "@ez4/aws-function": "^0.27.0",
+    "@ez4/aws-logs": "^0.27.0",
+    "@ez4/aws-queue": "^0.27.0",
+    "@ez4/topic": "^0.27.0",
+    "@ez4/project": "^0.27.0",
+    "@ez4/queue": "^0.27.0",
+    "@ez4/schema": "^0.27.0",
+    "@ez4/stateful": "^0.27.0",
+    "@ez4/transform": "^0.27.0",
+    "@ez4/validator": "^0.27.0",
+    "@ez4/utils": "^0.27.0"
+  }
+}