@k-msg/provider/dist/aligo/send.mjs

Complete provider system with adapters and implementations for K-Message platform

import{readRuntimeEnv as y}from"@k-msg/core";var Q={iwinv:{providerId:"iwinv",providerName:"IWINV Messaging Provider",channelOnboarding:"manual",templateLifecycleApi:"available",plusIdPolicy:"optional",plusIdInference:"unsupported",liveTestSupport:"supported",checks:[{id:"channel_registered_in_console",title:"Kakao channel is registered in IWINV console",description:"IWINV channel onboarding is manual. Confirm channel registration and approval in console.",kind:"manual",severity:"blocker",scopes:["doctor","preflight"]},{id:"iwinv_config_required",title:"IWINV config has required keys",kind:"config",severity:"blocker",scopes:["doctor","preflight"],configKeys:["apiKey"]},{id:"template_capability_available",title:"Template lifecycle APIs are available",kind:"capability",severity:"warning",scopes:["doctor","preflight"],capabilityMethods:["listTemplates","getTemplate","createTemplate","updateTemplate","deleteTemplate"]},{id:"template_list_probe",title:"Template list API probe",kind:"api_probe",severity:"warning",scopes:["doctor","preflight"],probeOperation:"list_templates"}],notes:["Channel add/auth is not available via IWINV public API in current integration.","Template APIs are available and can be probed."]},aligo:{providerId:"aligo",providerName:"Aligo Smart SMS",channelOnboarding:"api",templateLifecycleApi:"available",plusIdPolicy:"required_if_no_inference",plusIdInference:"supported",liveTestSupport:"supported",checks:[{id:"aligo_config_required",title:"Aligo config has required keys",kind:"config",severity:"blocker",scopes:["doctor","preflight"],configKeys:["apiKey","userId"]},{id:"channel_api_capability_available",title:"Kakao channel APIs are available",kind:"capability",severity:"warning",scopes:["doctor","preflight"],capabilityMethods:["listKakaoChannels","requestKakaoChannelAuth","addKakaoChannel"]},{id:"channel_list_probe",title:"Kakao channel list API probe",kind:"api_probe",severity:"warning",scopes:["doctor","preflight"],probeOperation:"list_kakao_channels"},{id:"template_list_probe",title:"Template list API probe",kind:"api_probe",severity:"warning",scopes:["doctor","preflight"],probeOperation:"list_templates"}]},solapi:{providerId:"solapi",providerName:"SOLAPI Messaging Provider",channelOnboarding:"none",templateLifecycleApi:"unavailable",plusIdPolicy:"required_if_no_inference",plusIdInference:"unsupported",liveTestSupport:"partial",checks:[{id:"solapi_config_required",title:"SOLAPI config has required keys",kind:"config",severity:"blocker",scopes:["doctor","preflight"],configKeys:["apiKey","apiSecret"]}],notes:["SOLAPI ALIMTALK requires kakao profileId/pfId, but plusId inference is not available in current integration."]},mock:{providerId:"mock",providerName:"Mock Provider",channelOnboarding:"api",templateLifecycleApi:"available",plusIdPolicy:"optional",plusIdInference:"supported",liveTestSupport:"none",checks:[{id:"mock_template_capability_available",title:"Mock template APIs are available",kind:"capability",severity:"info",scopes:["doctor","preflight"],capabilityMethods:["listTemplates","getTemplate","createTemplate"]}]}};function W(e){return Q[e]}function ke(){return Object.values(Q)}import{fail as g,KMsgError as M,KMsgErrorCode as N,ok as O}from"@k-msg/core";function f(e){return typeof e==="object"&&e!==null&&!Array.isArray(e)}import{KMsgError as S,KMsgErrorCode as I}from"@k-msg/core";function h(e,r){if(e instanceof S)return e;return new S(I.PROVIDER_ERROR,e instanceof Error?e.message:String(e),{providerId:r})}function A(e,r){if(e instanceof S)return e;let t=f(e)?e:{},n=t.result_code,i=n!==void 0&&n!==null?String(n):"UNKNOWN",o=typeof t.message==="string"&&t.message.length>0?t.message:typeof t.msg==="string"&&t.msg.length>0?t.msg:e instanceof Error?e.message:"Unknown Aligo error",s=I.PROVIDER_ERROR;switch(i){case"-100":case"-101":s=I.AUTHENTICATION_FAILED;break;case"-102":case"-201":s=I.INSUFFICIENT_BALANCE;break;case"-103":case"-105":s=I.INVALID_REQUEST;break;case"-501":s=I.TEMPLATE_NOT_FOUND;break;default:s=I.PROVIDER_ERROR}return new S(s,`${o} (code: ${i})`,{providerId:r,resultCode:i})}import{fail as fe,KMsgError as z,KMsgErrorCode as L,ok as ge}from"@k-msg/core";import{KMsgError as K,KMsgErrorCode as T}from"@k-msg/core";function se(e){if(typeof DOMException<"u"&&e instanceof DOMException&&e.name==="TimeoutError")return!0;return typeof e==="object"&&e!==null&&"code"in e&&e.code===T.NETWORK_TIMEOUT}function de(e){return typeof DOMException<"u"&&e instanceof DOMException&&e.name==="AbortError"}function le(e){if(e instanceof Error)return e.message;if(typeof e==="string"&&e.length>0)return e;return"Provider request aborted"}function pe(e,r,t){if(!r?.aborted)return;if(e instanceof K)return e;let n=r.reason??e,i=de(n)?e:n;return new K(se(n)?T.NETWORK_TIMEOUT:T.REQUEST_ABORTED,le(i),{providerId:t})}function $(e,r){if(e instanceof K)return e;return new K(T.NETWORK_ERROR,e instanceof Error?e.message:String(e),{providerId:r})}function P(e,r,t){return pe(e,r,t)??$(e,t)}async function H(e,r,t,n){let i=e?.fetch??globalThis.fetch;if(typeof i!=="function")throw $(Error("No fetch implementation is available; provide ProviderRequestContext.fetch or use a runtime with native fetch support"),n);try{return await i(r,{...t,signal:e?.signal})}catch(o){throw P(o,e?.signal,n)}}import{KMsgError as Y,KMsgErrorCode as B}from"@k-msg/core";function ue(e,r){if(!e)return"";return e.replace(/#\{([^}]+)\}/g,(t,n)=>{let i=r[n];return i===void 0||i===null?t:String(i)})}function D(e){let r=typeof e.imageUrl==="string"&&e.imageUrl.trim().length>0?e.imageUrl.trim():void 0;if(r)return r;let t=e.media?.image;if(!t)return;if("ref"in t){let n=t.ref.trim();return n.length>0?n:void 0}throw new Y(B.INVALID_REQUEST,"Aligo MMS/FriendTalk image requires `options.imageUrl` or `options.media.image.ref` (url/path).",{providerId:e.providerId})}function _(e,r){switch(e){case"sendSMS":return"/send/";case"sendAlimTalk":return"/akv10/alimtalk/send/";case"sendFriendTalk":return r.friendtalkEndpoint||"/akv10/friendtalk/send/";default:return"/"}}function w(e){let r=e.getFullYear(),t=String(e.getMonth()+1).padStart(2,"0"),n=String(e.getDate()).padStart(2,"0"),i=String(e.getHours()).padStart(2,"0"),o=String(e.getMinutes()).padStart(2,"0");return{date:`${r}${t}${n}`,time:`${i}${o}`}}function G(e){if(typeof e==="number"&&Number.isFinite(e))return e;if(typeof e==="string"){let r=e.trim();if(!r)return;let t=Number(r);if(Number.isFinite(t))return t}return}function _e(e,r){let t=(typeof r?.kakaoChannelSenderKey==="string"&&r.kakaoChannelSenderKey.trim().length>0?r.kakaoChannelSenderKey.trim():e.config.senderKey)||"";if(!t)throw new Y(B.INVALID_REQUEST,"kakao channel senderKey is required (ctx.kakaoChannelSenderKey or config.senderKey)",{providerId:e.providerId});return t}function we(e){switch(typeof e.inspStatus==="string"?e.inspStatus.trim().toUpperCase():""){case"APR":return"APPROVED";case"REJ":return"REJECTED";case"REQ":case"REG":return"INSPECTION";default:return"PENDING"}}function R(e){if(typeof e!=="string")return;let r=e.trim();if(!r)return;let t=/^(\d{4})-(\d{2})-(\d{2})\s+(\d{2}):(\d{2}):(\d{2})$/.exec(r);if(!t)return;let n=Number(t[1]),i=Number(t[2]),o=Number(t[3]),s=Number(t[4]),d=Number(t[5]),a=Number(t[6]),l=new Date(n,i-1,o,s,d,a);return Number.isNaN(l.getTime())?void 0:l}function J(e,r){if(!e)return"";let t=e._full_text;if(t!==void 0&&t!==null)return String(t);if(!r)return Object.values(e).map(String).join(`
`);return ue(r,e)}async function u(e){let r=new FormData;for(let[t,n]of Object.entries(e.data))if(n!==void 0&&n!==null)r.append(t,String(n));try{let t=await H(e.context,`${e.host}${e.endpoint}`,{method:"POST",body:r},e.providerId);if(!t.ok)throw new z(L.NETWORK_ERROR,`HTTP error! status: ${t.status}`,{providerId:e.providerId});return await t.json()}catch(t){throw P(t,e.context?.signal,e.providerId)}}function b(e){let{providerId:r,response:t,fallbackMessage:n}=e,i=t.code,o=G(i);if(o===0)return ge(void 0);let s=typeof t.message==="string"&&t.message.length>0?t.message:n,d=o===509||o===-99?L.INVALID_REQUEST:L.PROVIDER_ERROR;return fe(new z(d,s,{providerId:r,originalCode:i,raw:t}))}async function X(e,r){try{let t={apikey:e.config.apiKey,userid:e.config.userId,...typeof r?.plusId==="string"&&r.plusId.trim().length>0?{plusid:r.plusId.trim()}:{},...typeof r?.senderKey==="string"&&r.senderKey.trim().length>0?{senderkey:r.senderKey.trim()}:{}},n=await u({host:e.alimtalkHost,endpoint:"/akv10/profile/list/",data:t,providerId:e.providerId}),i=b({providerId:e.providerId,response:n,fallbackMessage:"channel list failed"});if(i.isFailure)return i;let o=n.list,d=(Array.isArray(o)?o:[]).filter(f).map((a)=>({providerId:e.providerId,senderKey:String(a.senderKey??""),plusId:typeof a.uuid==="string"?a.uuid:void 0,name:typeof a.name==="string"?a.name:void 0,status:typeof a.status==="string"?a.status:void 0,createdAt:R(a.cdate),updatedAt:R(a.udate),raw:a})).filter((a)=>a.senderKey.length>0);return O(d)}catch(t){return g(h(t,e.providerId))}}async function Z(e){try{let r=await u({host:e.alimtalkHost,endpoint:"/akv10/category/",data:{apikey:e.config.apiKey,userid:e.config.userId},providerId:e.providerId}),t=b({providerId:e.providerId,response:r,fallbackMessage:"category list failed"});if(t.isFailure)return t;let n=f(r.data)?r.data:{},i=(o)=>{return(Array.isArray(o)?o:[]).filter(f).map((d)=>({code:String(d.code??""),name:String(d.name??""),parentCode:typeof d.parentCode==="string"&&d.parentCode.length>0?d.parentCode:void 0})).filter((d)=>d.code.length>0)};return O({first:i(n.firstBusinessType),second:i(n.secondBusinessType),third:i(n.thirdBusinessType)})}catch(r){return g(h(r,e.providerId))}}async function x(e,r){try{let t=r.plusId.trim(),n=r.phoneNumber.trim();if(!t||!n)return g(new M(N.INVALID_REQUEST,"plusId and phoneNumber are required",{providerId:e.providerId}));let i=await u({host:e.alimtalkHost,endpoint:"/akv10/profile/auth/",data:{apikey:e.config.apiKey,userid:e.config.userId,plusid:t,phonenumber:n},providerId:e.providerId}),o=b({providerId:e.providerId,response:i,fallbackMessage:"channel auth failed"});if(o.isFailure)return o;return O(void 0)}catch(t){return g(h(t,e.providerId))}}async function ee(e,r){try{let t=r.plusId.trim(),n=r.authNum.trim(),i=r.phoneNumber.trim(),o=r.categoryCode.trim();if(!t||!n||!i||!o)return g(new M(N.INVALID_REQUEST,"plusId, authNum, phoneNumber, categoryCode are required",{providerId:e.providerId}));let s=await u({host:e.alimtalkHost,endpoint:"/akv10/profile/add/",data:{apikey:e.config.apiKey,userid:e.config.userId,plusid:t,authnum:n,phonenumber:i,categorycode:o},providerId:e.providerId}),d=b({providerId:e.providerId,response:s,fallbackMessage:"channel add failed"});if(d.isFailure)return d;let a=s.data,l=Array.isArray(a)?a.find(f):f(a)?a:void 0;if(!l)return g(new M(N.PROVIDER_ERROR,"channel add returned empty data",{providerId:e.providerId,raw:s}));let v=String(l.senderKey??"");if(!v)return g(new M(N.PROVIDER_ERROR,"channel add did not return senderKey",{providerId:e.providerId,raw:l}));return O({providerId:e.providerId,senderKey:v,plusId:typeof l.uuid==="string"?l.uuid:t,name:typeof l.name==="string"?l.name:void 0,status:typeof l.status==="string"?l.status:void 0,createdAt:R(l.cdate),updatedAt:R(l.udate),raw:l})}catch(t){return g(h(t,e.providerId))}}import{fail as p,KMsgError as c,KMsgErrorCode as m,ok as U}from"@k-msg/core";function ce(e,r){if(e.type!=="ALIMTALK")return;if(e.failover?.enabled!==!0)return;return[{code:"FAILOVER_PARTIAL_PROVIDER",message:"Aligo failover mapping is partial. API-level fallback may be attempted for non-Kakao-user failures.",details:{providerId:r,mappedFields:["failover","fmessage_1","fsubject_1"],unsupportedFields:["fallbackChannel"]}}]}async function me(e,r){let t=r.from||e.config.sender||"";if(!t)return p(new c(m.INVALID_REQUEST,"from is required for SMS/LMS/MMS (options.from or config.sender)",{providerId:e.providerId}));let n={key:e.config.apiKey,user_id:e.config.userId,sender:t,receiver:r.to,msg:r.text,msg_type:r.type,title:r.subject,testmode_yn:e.config.testMode?"Y":"N"},i=r.options?.scheduledAt;if(i instanceof Date&&!Number.isNaN(i.getTime())){let{date:s,time:d}=w(i);n.rdate=s,n.rtime=d}if(r.type==="MMS"){let s=D({imageUrl:r.imageUrl,media:r.media,providerId:e.providerId});if(!s)return p(new c(m.INVALID_REQUEST,"image is required for MMS (options.imageUrl or options.media.image.ref)",{providerId:e.providerId}));n.image=s}let o=await u({host:e.smsHost,endpoint:_("sendSMS",e.config),data:n,providerId:e.providerId,context:e.requestContext});if(o.result_code!=="1")return p(A(o,e.providerId));return U({messageId:r.messageId||crypto.randomUUID(),providerId:e.providerId,providerMessageId:o.msg_id,status:"PENDING",type:r.type,to:r.to,raw:o})}async function Ie(e,r){let t=ce(r,e.providerId),n=(typeof r.kakao?.profileId==="string"?r.kakao.profileId:e.config.senderKey)||"";if(!n)return p(new c(m.INVALID_REQUEST,"kakao profileId is required (options.kakao.profileId or config.senderKey)",{providerId:e.providerId}));let i=r.from||e.config.sender||"";if(!i)return p(new c(m.INVALID_REQUEST,"from is required for ALIMTALK (options.from or config.sender)",{providerId:e.providerId}));let{variables:o,templateId:s}=r;if(!s||s.length===0)return p(new c(m.INVALID_REQUEST,"templateId is required for ALIMTALK",{providerId:e.providerId}));let d=typeof r.providerOptions?.templateContent==="string"?r.providerOptions.templateContent:void 0,a={apikey:e.config.apiKey,userid:e.config.userId,senderkey:n,tpl_code:s,sender:i,receiver_1:r.to,subject_1:"알림톡",message_1:J(o,d),testMode:e.config.testMode?"Y":"N"},l=typeof r.providerOptions?.failover==="string"?r.providerOptions.failover.trim().toUpperCase():"",v=l==="Y"||l==="N"?l:void 0,ie=r.failover?.enabled===!0?"Y":r.failover?.enabled===!1?"N":void 0,V=v??ie,F=typeof r.providerOptions?.fsubject_1==="string"&&r.providerOptions.fsubject_1.trim().length>0?r.providerOptions.fsubject_1.trim():typeof r.failover?.fallbackTitle==="string"&&r.failover.fallbackTitle.trim().length>0?r.failover.fallbackTitle.trim():void 0,j=typeof r.providerOptions?.fmessage_1==="string"&&r.providerOptions.fmessage_1.trim().length>0?r.providerOptions.fmessage_1.trim():typeof r.failover?.fallbackContent==="string"&&r.failover.fallbackContent.trim().length>0?r.failover.fallbackContent.trim():void 0;if(V)a.failover=V;if(F)a.fsubject_1=F;if(j)a.fmessage_1=j;let C=r.options?.scheduledAt;if(C instanceof Date&&!Number.isNaN(C.getTime())){let{date:oe,time:ae}=w(C);a.reserve="Y",a.reserve_date=oe,a.reserve_time=ae}let E=await u({host:e.alimtalkHost,endpoint:_("sendAlimTalk",e.config),data:a,providerId:e.providerId,context:e.requestContext});if(E.result_code!=="0")return p(A(E,e.providerId));return U({messageId:r.messageId||crypto.randomUUID(),providerId:e.providerId,providerMessageId:E.msg_id,status:"PENDING",type:r.type,to:r.to,...Array.isArray(t)&&t.length>0?{warnings:t}:{},raw:E})}async function ye(e,r){let t=(typeof r.kakao?.profileId==="string"?r.kakao.profileId:e.config.senderKey)||"";if(!t)return p(new c(m.INVALID_REQUEST,"kakao profileId is required (options.kakao.profileId or config.senderKey)",{providerId:e.providerId}));let n=r.from||e.config.sender||"";if(!n)return p(new c(m.INVALID_REQUEST,"from is required for FRIENDTALK (options.from or config.sender)",{providerId:e.providerId}));let i={apikey:e.config.apiKey,userid:e.config.userId,senderkey:t,sender:n,receiver_1:r.to,subject_1:"친구톡",message_1:r.text,testMode:e.config.testMode?"Y":"N"},o=D({imageUrl:r.imageUrl,media:r.media,providerId:e.providerId});if(o)i.image_1=o;let s=Array.isArray(r.kakao?.buttons)?r.kakao.buttons:r.buttons;if(s)i.button_1=JSON.stringify(s);let d=r.options?.scheduledAt;if(d instanceof Date&&!Number.isNaN(d.getTime())){let{date:l,time:v}=w(d);i.reserve="Y",i.reserve_date=l,i.reserve_time=v}let a=await u({host:e.alimtalkHost,endpoint:_("sendFriendTalk",e.config),data:i,providerId:e.providerId,context:e.requestContext});if(a.result_code!=="0")return p(A(a,e.providerId));return U({messageId:r.messageId||crypto.randomUUID(),providerId:e.providerId,providerMessageId:a.msg_id,status:"PENDING",type:r.type,to:r.to,raw:a})}async function re(e,r){try{switch(r.type){case"ALIMTALK":return await Ie(e,r);case"FRIENDTALK":return await ye(e,r);case"SMS":case"LMS":case"MMS":return await me(e,r);default:return p(new c(m.INVALID_REQUEST,`AligoProvider does not support type ${r.type}`,{providerId:e.providerId,type:r.type}))}}catch(t){return p(A(t,e.providerId))}}function ve(){return{apiKey:y("ALIGO_API_KEY")||"",userId:y("ALIGO_USER_ID")||"",senderKey:y("ALIGO_SENDER_KEY")||"",sender:y("ALIGO_SENDER")||"",friendtalkEndpoint:y("ALIGO_FRIENDTALK_ENDPOINT"),testMode:y("NODE_ENV")!=="production",debug:y("NODE_ENV")==="development"}}class k{id="aligo";name="Aligo Smart SMS";supportedTypes=["ALIMTALK","FRIENDTALK","SMS","LMS","MMS"];transportCapabilities={abortSignal:"supported",injectableFetch:"supported"};config;smsHost;alimtalkHost;getOnboardingSpec(){let e=W(this.id);if(!e)throw Error(`Onboarding spec missing for provider: ${this.id}`);return e}constructor(e){if(!e||typeof e!=="object")throw Error("AligoProvider requires a config object");if(!e.apiKey||e.apiKey.length===0)throw Error("AligoProvider requires `apiKey`");if(!e.userId||e.userId.length===0)throw Error("AligoProvider requires `userId`");this.config=e,this.smsHost=e.smsBaseUrl||"https://apis.aligo.in",this.alimtalkHost=e.alimtalkBaseUrl||"https://kakaoapi.aligo.in"}getRuntimeContext(e){return{providerId:this.id,config:this.config,smsHost:this.smsHost,alimtalkHost:this.alimtalkHost,requestContext:e}}async healthCheck(){let e=Date.now(),r=[];try{if(!this.config.apiKey)r.push("Missing apiKey");if(!this.config.userId)r.push("Missing userId");if(!this.config.sender)r.push("Missing sender (default from)");try{new URL(this.smsHost)}catch{r.push("Invalid smsBaseUrl")}try{new URL(this.alimtalkHost)}catch{r.push("Invalid alimtalkBaseUrl")}return{healthy:r.length===0,issues:r,latencyMs:Date.now()-e,data:{provider:this.id,smsBaseUrl:this.smsHost,alimtalkBaseUrl:this.alimtalkHost}}}catch(t){return r.push(t instanceof Error?t.message:String(t)),{healthy:!1,issues:r,latencyMs:Date.now()-e}}}async send(e,r){let t=e.messageId||crypto.randomUUID(),n={...e,messageId:t};return re(this.getRuntimeContext(r),n)}async listKakaoChannels(e){return X(this.getRuntimeContext(),e)}async listKakaoChannelCategories(){return Z(this.getRuntimeContext())}async requestKakaoChannelAuth(e){return x(this.getRuntimeContext(),e)}async addKakaoChannel(e){return ee(this.getRuntimeContext(),e)}}var te=(e)=>new k(e),q=()=>{let e=ve();if(!e.apiKey||!e.userId)throw Error("ALIGO_API_KEY and ALIGO_USER_ID are required");return new k(e)};class ne{static create(e){return new k(e)}static createDefault(){return q()}}export{q as createDefaultAligoSendProvider,q as createDefaultAligoProvider,te as createAligoSendProvider,te as createAligoProvider,ne as AligoSendProviderFactory,k as AligoSendProvider,k as AligoProvider};

//# debugId=DA4FE3D4C0B74F1864756E2164756E21
//# sourceMappingURL=send.mjs.map