@sekyro/node 0.1.0-rc.10 → 0.1.0-rc.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1 +1 @@
1
- "use strict";var __defProp=Object.defineProperty;var __getOwnPropDesc=Object.getOwnPropertyDescriptor;var __getOwnPropNames=Object.getOwnPropertyNames;var __hasOwnProp=Object.prototype.hasOwnProperty;var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:!0})},__copyProps=(to,from,except,desc)=>{if(from&&typeof from=="object"||typeof from=="function")for(let key of __getOwnPropNames(from))!__hasOwnProp.call(to,key)&&key!==except&&__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable});return to};var __toCommonJS=mod=>__copyProps(__defProp({},"__esModule",{value:!0}),mod);var express_exports={};__export(express_exports,{requireLevel:()=>requireLevel});module.exports=__toCommonJS(express_exports);var KNOWN_FLAGS=["face_mismatch","duplicate","revoked"];function isRecord(v){return typeof v=="object"&&v!==null&&!Array.isArray(v)}function isFiniteNumber(v){return typeof v=="number"&&Number.isFinite(v)}function build(c){let out={v:1,level:c.level,assurance:c.assurance,verified_at:c.verified_at};c.rechecked_at!==void 0&&(out.rechecked_at=c.rechecked_at),out.session_id=c.session_id,c.subject_id!==void 0&&(out.subject_id=c.subject_id),out.env=c.env;let flags=new Set;for(let f of c.flags??[])KNOWN_FLAGS.includes(f)&&flags.add(f);return flags.size>0&&(out.flags=[...flags].sort()),out}function parseClaim(value){let v=value;if(typeof v=="string")try{v=JSON.parse(v)}catch{return null}if(!isRecord(v)||!isFiniteNumber(v.v))return null;if(v.v>1)return v;if(v.v!==1)return null;let level=v.level;return level!==0&&level!==1&&level!==2&&level!==3||typeof v.assurance!="string"||!isFiniteNumber(v.verified_at)||typeof v.session_id!="string"||v.env!=="live"&&v.env!=="sandbox"?null:build({level,assurance:v.assurance,verified_at:v.verified_at,rechecked_at:isFiniteNumber(v.rechecked_at)?v.rechecked_at:void 0,session_id:v.session_id,subject_id:typeof v.subject_id=="string"?v.subject_id:void 0,env:v.env,flags:Array.isArray(v.flags)?v.flags:void 0})}var DEFAULT_DENY_FLAGS=["revoked","face_mismatch"],fail=(reason,action,claim)=>({ok:!1,reason,action,claim});function evaluateGate(claim,policy,nowSec=Math.floor(Date.now()/1e3)){let parsed=parseClaim(claim);if(!parsed)return fail("no_claim","verify",null);if(parsed.v>1)return fail("unsupported_version","verify",parsed);if(policy.env!==void 0&&parsed.env!==policy.env)return fail("wrong_env","verify",parsed);let deny2=policy.denyFlags??DEFAULT_DENY_FLAGS;return parsed.flags?.some(f=>deny2.includes(f))?fail("flagged","block",parsed):parsed.level<policy.level?fail("level_too_low",parsed.level>=1?"step_up":"verify",parsed):policy.maxAgeDays!==void 0&&nowSec-parsed.verified_at>policy.maxAgeDays*86400?fail("stale","recheck",parsed):policy.maxRecheckAgeMinutes!==void 0&&nowSec-(parsed.rechecked_at??parsed.verified_at)>policy.maxRecheckAgeMinutes*60?fail("recheck_stale","recheck",parsed):policy.assurance&&!policy.assurance.includes(parsed.assurance)?fail("assurance_not_allowed","step_up",parsed):{ok:!0,claim:parsed}}function sekyroGate(source,tokenClaims,policy){let claims=tokenClaims??{};if("gate"in source)return source.gate(claims,policy);let effective=source.env!==void 0&&policy.env===void 0?{...policy,env:source.env}:policy;return evaluateGate(source.provider.readClaimFromToken(claims),effective)}function deny(res,result){let body={error:"sekyro_gate",reason:result.reason,action:result.action},r=res;if(typeof r.status=="function"){r.status(403).json(body);return}let n=res;n.statusCode=403,n.setHeader("content-type","application/json"),n.end(JSON.stringify(body))}function requireLevel(source,policy,opts){return(req,res,next)=>{Promise.resolve().then(()=>opts.claims(req)).then(claims=>{let result=sekyroGate(source,claims,policy);if(typeof req=="object"&&req!==null&&(req.sekyro=result),result.ok)return next();if(opts.onFail)return opts.onFail(result,req,res);deny(res,result)},err=>next(err))}}0&&(module.exports={requireLevel});
1
+ "use strict";var __defProp=Object.defineProperty;var __getOwnPropDesc=Object.getOwnPropertyDescriptor;var __getOwnPropNames=Object.getOwnPropertyNames;var __hasOwnProp=Object.prototype.hasOwnProperty;var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:!0})},__copyProps=(to,from,except,desc)=>{if(from&&typeof from=="object"||typeof from=="function")for(let key of __getOwnPropNames(from))!__hasOwnProp.call(to,key)&&key!==except&&__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable});return to};var __toCommonJS=mod=>__copyProps(__defProp({},"__esModule",{value:!0}),mod);var express_exports={};__export(express_exports,{requireLevel:()=>requireLevel});module.exports=__toCommonJS(express_exports);var KNOWN_FLAGS=["face_mismatch","duplicate","revoked"];function canonicalId(id){return id.replace(/^(ses|per)_/,"")}function isRecord(v){return typeof v=="object"&&v!==null&&!Array.isArray(v)}function isFiniteNumber(v){return typeof v=="number"&&Number.isFinite(v)}function build(c){let out={v:1,level:c.level,assurance:c.assurance,verified_at:c.verified_at};c.rechecked_at!==void 0&&(out.rechecked_at=c.rechecked_at),out.session_id=c.session_id,c.subject_id!==void 0&&(out.subject_id=canonicalId(c.subject_id)),out.env=c.env;let flags=new Set;for(let f of c.flags??[])KNOWN_FLAGS.includes(f)&&flags.add(f);return flags.size>0&&(out.flags=[...flags].sort()),out}function parseClaim(value){let v=value;if(typeof v=="string")try{v=JSON.parse(v)}catch{return null}if(!isRecord(v)||!isFiniteNumber(v.v))return null;if(v.v>1)return v;if(v.v!==1)return null;let level=v.level;return level!==0&&level!==1&&level!==2&&level!==3||typeof v.assurance!="string"||!isFiniteNumber(v.verified_at)||typeof v.session_id!="string"||v.env!=="live"&&v.env!=="sandbox"?null:build({level,assurance:v.assurance,verified_at:v.verified_at,rechecked_at:isFiniteNumber(v.rechecked_at)?v.rechecked_at:void 0,session_id:v.session_id,subject_id:typeof v.subject_id=="string"?v.subject_id:void 0,env:v.env,flags:Array.isArray(v.flags)?v.flags:void 0})}var DEFAULT_DENY_FLAGS=["revoked","face_mismatch"],fail=(reason,action,claim)=>({ok:!1,reason,action,claim});function evaluateGate(claim,policy,nowSec=Math.floor(Date.now()/1e3)){let parsed=parseClaim(claim);if(!parsed)return fail("no_claim","verify",null);if(parsed.v>1)return fail("unsupported_version","verify",parsed);if(policy.env!==void 0&&parsed.env!==policy.env)return fail("wrong_env","verify",parsed);let deny2=policy.denyFlags??DEFAULT_DENY_FLAGS;return parsed.flags?.some(f=>deny2.includes(f))?fail("flagged","block",parsed):parsed.level<policy.level?fail("level_too_low",parsed.level>=1?"step_up":"verify",parsed):policy.maxAgeDays!==void 0&&nowSec-parsed.verified_at>policy.maxAgeDays*86400?fail("stale","recheck",parsed):policy.maxRecheckAgeMinutes!==void 0&&nowSec-(parsed.rechecked_at??parsed.verified_at)>policy.maxRecheckAgeMinutes*60?fail("recheck_stale","recheck",parsed):policy.assurance&&!policy.assurance.includes(parsed.assurance)?fail("assurance_not_allowed","step_up",parsed):{ok:!0,claim:parsed}}function sekyroGate(source,tokenClaims,policy){let claims=tokenClaims??{};if("gate"in source)return source.gate(claims,policy);let effective=source.env!==void 0&&policy.env===void 0?{...policy,env:source.env}:policy;return evaluateGate(source.provider.readClaimFromToken(claims),effective)}function deny(res,result){let body={error:"sekyro_gate",reason:result.reason,action:result.action},r=res;if(typeof r.status=="function"){r.status(403).json(body);return}let n=res;n.statusCode=403,n.setHeader("content-type","application/json"),n.end(JSON.stringify(body))}function requireLevel(source,policy,opts){return(req,res,next)=>{Promise.resolve().then(()=>opts.claims(req)).then(claims=>{let result=sekyroGate(source,claims,policy);if(typeof req=="object"&&req!==null&&(req.sekyro=result),result.ok)return next();if(opts.onFail)return opts.onFail(result,req,res);deny(res,result)},err=>next(err))}}0&&(module.exports={requireLevel});
@@ -1,5 +1,5 @@
1
- import { C as Connector, P as ProviderAdapter, G as GatePolicy, a as GateResult } from '../../connector-C4NuetEm.cjs';
2
- import '../../client-Hkxwn6ZA.cjs';
1
+ import { C as Connector, P as ProviderAdapter, G as GatePolicy, a as GateResult } from '../../connector-C0M4NWwZ.cjs';
2
+ import '../../client-edr9f2Ec.cjs';
3
3
 
4
4
  /**
5
5
  * `@sekyro/node/connect/express`: a route gate for Express (and any
@@ -1,5 +1,5 @@
1
- import { C as Connector, P as ProviderAdapter, G as GatePolicy, a as GateResult } from '../../connector-BInF_yHb.js';
2
- import '../../client-Hkxwn6ZA.js';
1
+ import { C as Connector, P as ProviderAdapter, G as GatePolicy, a as GateResult } from '../../connector-DKP_ebGH.js';
2
+ import '../../client-edr9f2Ec.js';
3
3
 
4
4
  /**
5
5
  * `@sekyro/node/connect/express`: a route gate for Express (and any
@@ -1 +1 @@
1
- import{sekyroGate}from"../../chunk-TAPXGI3Q.js";import"../../chunk-O5GJ3YJV.js";function deny(res,result){let body={error:"sekyro_gate",reason:result.reason,action:result.action},r=res;if(typeof r.status=="function"){r.status(403).json(body);return}let n=res;n.statusCode=403,n.setHeader("content-type","application/json"),n.end(JSON.stringify(body))}function requireLevel(source,policy,opts){return(req,res,next)=>{Promise.resolve().then(()=>opts.claims(req)).then(claims=>{let result=sekyroGate(source,claims,policy);if(typeof req=="object"&&req!==null&&(req.sekyro=result),result.ok)return next();if(opts.onFail)return opts.onFail(result,req,res);deny(res,result)},err=>next(err))}}export{requireLevel};
1
+ import{sekyroGate}from"../../chunk-SZQEL3LK.js";import"../../chunk-D53NUEJ6.js";function deny(res,result){let body={error:"sekyro_gate",reason:result.reason,action:result.action},r=res;if(typeof r.status=="function"){r.status(403).json(body);return}let n=res;n.statusCode=403,n.setHeader("content-type","application/json"),n.end(JSON.stringify(body))}function requireLevel(source,policy,opts){return(req,res,next)=>{Promise.resolve().then(()=>opts.claims(req)).then(claims=>{let result=sekyroGate(source,claims,policy);if(typeof req=="object"&&req!==null&&(req.sekyro=result),result.ok)return next();if(opts.onFail)return opts.onFail(result,req,res);deny(res,result)},err=>next(err))}}export{requireLevel};
@@ -1 +1 @@
1
- "use strict";var __defProp=Object.defineProperty;var __getOwnPropDesc=Object.getOwnPropertyDescriptor;var __getOwnPropNames=Object.getOwnPropertyNames;var __hasOwnProp=Object.prototype.hasOwnProperty;var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:!0})},__copyProps=(to,from,except,desc)=>{if(from&&typeof from=="object"||typeof from=="function")for(let key of __getOwnPropNames(from))!__hasOwnProp.call(to,key)&&key!==except&&__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable});return to};var __toCommonJS=mod=>__copyProps(__defProp({},"__esModule",{value:!0}),mod);var connect_exports={};__export(connect_exports,{CLAIM_VERSION:()=>CLAIM_VERSION,SekyroConnectError:()=>SekyroConnectError,createConnector:()=>createConnector,evaluateGate:()=>evaluateGate,memoryStore:()=>memoryStore,mergeClaim:()=>mergeClaim,parseClaim:()=>parseClaim});module.exports=__toCommonJS(connect_exports);var CLAIM_VERSION=1,KNOWN_FLAGS=["face_mismatch","duplicate","revoked"];function isRecord(v){return typeof v=="object"&&v!==null&&!Array.isArray(v)}function isFiniteNumber(v){return typeof v=="number"&&Number.isFinite(v)}function build(c){let out={v:1,level:c.level,assurance:c.assurance,verified_at:c.verified_at};c.rechecked_at!==void 0&&(out.rechecked_at=c.rechecked_at),out.session_id=c.session_id,c.subject_id!==void 0&&(out.subject_id=c.subject_id),out.env=c.env;let flags=new Set;for(let f of c.flags??[])KNOWN_FLAGS.includes(f)&&flags.add(f);return flags.size>0&&(out.flags=[...flags].sort()),out}function parseClaim(value){let v=value;if(typeof v=="string")try{v=JSON.parse(v)}catch{return null}if(!isRecord(v)||!isFiniteNumber(v.v))return null;if(v.v>1)return v;if(v.v!==1)return null;let level=v.level;return level!==0&&level!==1&&level!==2&&level!==3||typeof v.assurance!="string"||!isFiniteNumber(v.verified_at)||typeof v.session_id!="string"||v.env!=="live"&&v.env!=="sandbox"?null:build({level,assurance:v.assurance,verified_at:v.verified_at,rechecked_at:isFiniteNumber(v.rechecked_at)?v.rechecked_at:void 0,session_id:v.session_id,subject_id:typeof v.subject_id=="string"?v.subject_id:void 0,env:v.env,flags:Array.isArray(v.flags)?v.flags:void 0})}function toUnix(isoTime,now){let ms=Date.parse(isoTime);return Math.floor((Number.isFinite(ms)?ms:now())/1e3)}var same=(claim,rule)=>({claim,changed:!1,rule}),wrote=(claim,rule)=>({claim,changed:!0,rule});function mergeClaim(previous,event,opts){let now=opts.now??Date.now,prev=parseClaim(previous);if(prev&&prev.v>1)return same(prev,"unsupported_version");if(event.kind==="revoked"||event.kind==="deleted"){if(!prev)return same(null,"no_change");if(!(prev.subject_id===void 0?event.userInExternalRefs===!0:prev.subject_id===event.subjectId))return same(prev,"subject_mismatch");if(prev.level===0&&prev.flags?.includes("revoked"))return same(prev,"no_change");let{rechecked_at:_cleared,...kept}=prev;return wrote(build({...kept,level:0,subject_id:event.subjectId,flags:["revoked"]}),"revoked")}let r=event.result;if(r.env!==opts.env)return same(prev,"env_mismatch");let t=toUnix(r.verifiedAt,now);if(prev&&t<prev.verified_at)return same(prev,"stale_ignored");let revokedPrev=prev?.flags?.includes("revoked")===!0;if(prev&&revokedPrev&&(r.subjectId===void 0||r.subjectId===prev.subject_id))return same(prev,"revoked_ignored");if(r.outcome==="rejected"&&r.subjectConflict===!0)return!prev||prev.flags?.includes("face_mismatch")?same(prev,"no_change"):wrote(build({...prev,flags:[...prev.flags??[],"face_mismatch"]}),"face_mismatch");if(r.outcome!=="approved"||r.level===null||r.level===0)return same(prev,"not_approved");let level=r.level,assurance=r.assurance??"none",duplicate=r.duplicates===!0?["duplicate"]:[];if(!prev)return wrote(build({level,assurance,verified_at:t,session_id:r.sessionId,subject_id:r.subjectId,env:r.env,flags:duplicate}),"created");if(!revokedPrev&&(r.reuseMode==="recheck"||r.returning===!0&&level<=prev.level))return prev.rechecked_at!==void 0&&t<=prev.rechecked_at?same(prev,t<prev.rechecked_at?"stale_ignored":"no_change"):wrote(build({...prev,rechecked_at:t,subject_id:prev.subject_id??r.subjectId}),"rechecked");if(level>prev.level){let kept=(prev.flags??[]).filter(f=>f!=="face_mismatch"&&f!=="revoked");return wrote(build({...prev,level,assurance,verified_at:t,session_id:r.sessionId,subject_id:r.subjectId??prev.subject_id,flags:[...kept,...duplicate]}),"raised")}return level===prev.level&&t>prev.verified_at?wrote(build({...prev,assurance,verified_at:t,session_id:r.sessionId,subject_id:prev.subject_id??r.subjectId,flags:[...prev.flags??[],...duplicate]}),"renewed"):same(prev,"no_change")}var DEFAULT_DENY_FLAGS=["revoked","face_mismatch"],fail=(reason,action,claim)=>({ok:!1,reason,action,claim});function evaluateGate(claim,policy,nowSec=Math.floor(Date.now()/1e3)){let parsed=parseClaim(claim);if(!parsed)return fail("no_claim","verify",null);if(parsed.v>1)return fail("unsupported_version","verify",parsed);if(policy.env!==void 0&&parsed.env!==policy.env)return fail("wrong_env","verify",parsed);let deny=policy.denyFlags??DEFAULT_DENY_FLAGS;return parsed.flags?.some(f=>deny.includes(f))?fail("flagged","block",parsed):parsed.level<policy.level?fail("level_too_low",parsed.level>=1?"step_up":"verify",parsed):policy.maxAgeDays!==void 0&&nowSec-parsed.verified_at>policy.maxAgeDays*86400?fail("stale","recheck",parsed):policy.maxRecheckAgeMinutes!==void 0&&nowSec-(parsed.rechecked_at??parsed.verified_at)>policy.maxRecheckAgeMinutes*60?fail("recheck_stale","recheck",parsed):policy.assurance&&!policy.assurance.includes(parsed.assurance)?fail("assurance_not_allowed","step_up",parsed):{ok:!0,claim:parsed}}var import_jose=require("jose"),import_result_token=require("@sekyro/node"),import_webhooks=require("@sekyro/node");var MESSAGES={token_session_mismatch:"The result token is for another session than the webhook",external_ref_mismatch:"The session belongs to another user",session_not_terminal:"The session has not finished yet",invalid_options:"Invalid connector options",unavailable:"The Sekyro AI public key set could not be fetched; try again"},SekyroConnectError=class extends Error{name="SekyroConnectError";code;constructor(code,message=MESSAGES[code],cause){super(message,cause===void 0?void 0:{cause}),this.code=code}};function factsOf(d,tokenDuplicates){let out={};return d.returning===!0&&(out.returning=!0),d.subjectConflict===!0&&(out.subjectConflict=!0),(Array.isArray(d.duplicates)&&d.duplicates.length>0||(tokenDuplicates?.length??0)>0)&&(out.duplicates=!0),out}function fromVerifiedResult(v,d){let out={sessionId:v.sessionId,outcome:v.outcome,level:v.level,assurance:v.assurance,verifiedAt:v.verifiedAt,env:v.env,...factsOf(d,v.duplicates)};return v.subjectId!==void 0&&(out.subjectId=v.subjectId),v.reuseMode!==void 0&&(out.reuseMode=v.reuseMode),out}function fromWebhookData(d,env,nowMs){let out={sessionId:d.sessionId,outcome:d.outcome??null,level:d.level??null,assurance:d.assurance??null,verifiedAt:d.verifiedAt??new Date(nowMs).toISOString(),env,...factsOf(d)};return d.subjectId!==void 0&&(out.subjectId=d.subjectId),d.reuseMode!==void 0&&(out.reuseMode=d.reuseMode),out}function memoryStore(opts={}){let now=opts.now??Date.now,ids=new Map,subjects=new Map,evict=t=>{for(let[id,expiresAt]of ids)expiresAt<=t&&ids.delete(id)};return{async seen(id,ttlSec){let t=now();return evict(t),ids.has(id)?!0:(ids.set(id,t+ttlSec*1e3),!1)},async forget(id){ids.delete(id)},async setSubjectUser(subjectId,userId){subjects.delete(subjectId),subjects.set(subjectId,userId),subjects.size>1e5&&subjects.delete(subjects.keys().next().value)},async getSubjectUser(subjectId){return subjects.get(subjectId)},size(){return evict(now()),ids.size}}}var KNOWN_CONNECTOR_PROVIDERS=new Set(["auth0","clerk","firebase","keycloak","supabase","zitadel"]),CONNECT_TELEMETRY=Symbol.for("@sekyro/node.connect-telemetry"),TELEMETRY_TIMEOUT_MS=2e3,TELEMETRY_BATCH_MAX=50,QUEUE_MAX=500;function hooksOf(sekyro){let h=sekyro[CONNECT_TELEMETRY];return h&&typeof h.setConnector=="function"&&typeof h.postEvents=="function"?h:void 0}var OFF={record(){}};function connectTelemetry(opts){let hooks=hooksOf(opts.sekyro);if(!hooks)return OFF;let name=opts.provider.name;if(!opts.enabled||!KNOWN_CONNECTOR_PROVIDERS.has(name))return opts.enabled||hooks.setConnector(null),OFF;hooks.setConnector({provider:name,version:opts.provider.version??"unknown"});let queue=[],scheduled=!1,flush=()=>{for(scheduled=!1;queue.length>0;){let batch=queue.splice(0,TELEMETRY_BATCH_MAX);hooks.postEvents(batch,TELEMETRY_TIMEOUT_MS).catch(()=>{})}};return{record(event){if(queue.length>=QUEUE_MAX)return;let e={type:event.type,provider:name,at:new Date(opts.now()).toISOString()};if(typeof event.sessionId=="string"&&event.sessionId.length>0&&(e.sessionId=event.sessionId),typeof event.subjectId=="string"&&event.subjectId.length>0&&(e.subjectId=event.subjectId),queue.push(e),scheduled)return;scheduled=!0,setTimeout(flush,0).unref?.()}}}var DEDUP_TTL_SEC=24*3600,JTI_TTL_SEC=600;function isApiStatus(err,statuses){if(typeof err!="object"||err===null)return!1;let e=err;return e.name==="SekyroApiError"&&typeof e.status=="number"&&statuses.includes(e.status)}function linkOf(o){if(o.returnUrl===void 0&&o.state===void 0)return;let link={};return o.returnUrl!==void 0&&(link.returnUrl=o.returnUrl),o.state!==void 0&&(link.state=o.state),link}function perKeyLock(){let tails=new Map;return(key,fn)=>{let run=(tails.get(key)??Promise.resolve()).then(fn,fn),tail=run.then(()=>{},()=>{});return tails.set(key,tail),tail.then(()=>{tails.get(key)===tail&&tails.delete(key)}),run}}function assertUserId(method,userId){if(typeof userId!="string"||userId.length===0)throw new TypeError(`connector.${method}: \`userId\` must be a non-empty string`)}function createConnector(opts){let appIds=[opts?.appId].flat();if(appIds.length===0||appIds.some(id=>typeof id!="string"||id.length===0))throw new SekyroConnectError("invalid_options","`appId` must be a non-empty string or a non-empty array of them");if(opts.env!=="live"&&opts.env!=="sandbox")throw new SekyroConnectError("invalid_options","`env` must be 'live' or 'sandbox'");if(typeof opts.webhookSecret!="string"||opts.webhookSecret.length===0)throw new SekyroConnectError("invalid_options","`webhookSecret` is required");if(!opts.sekyro||!opts.provider)throw new SekyroConnectError("invalid_options","`sekyro` and `provider` are required");let{sekyro,provider,env}=opts,now=opts.now??Date.now,store=opts.store??memoryStore({now}),ids=Object.freeze([...appIds]),userLock=perKeyLock(),telemetry=connectTelemetry({sekyro,provider,enabled:opts.telemetry!==!1,now});function updateClaim(userId,fn){return typeof provider.update=="function"?provider.update(userId,fn):userLock(userId,async()=>{let out=fn(await provider.readUser(userId));return out.changed&&out.claim&&await provider.writeUser(userId,out.claim),out})}let log=event=>{if(opts.logger)try{opts.logger(event)}catch{}},notifyRevocationUnresolved=event=>{let handler=opts.onRevocationUnresolved;if(typeof handler!="function")return;let failed=()=>log({type:"revocation_handler_failed",subjectId:event.subjectId});queueMicrotask(()=>{try{Promise.resolve(handler(event)).catch(failed)}catch{failed()}})},tokenOptions={appId:[...ids],env,now};opts.issuer!==void 0&&(tokenOptions.issuer=opts.issuer),opts.jwksUrl!==void 0&&(tokenOptions.jwksUrl=opts.jwksUrl),opts.fetch!==void 0&&(tokenOptions.fetch=opts.fetch);async function verifiedFor(token,sessionId,userId){let v;try{v=await(0,import_result_token.verifyResultToken)(token,tokenOptions)}catch(err){let e=err;throw e?.name==="SekyroResultTokenError"&&e.code==="jwks_unavailable"?new SekyroConnectError("unavailable",void 0,err):err}if(v.sessionId!==sessionId)throw new SekyroConnectError("token_session_mismatch");if(v.externalRef!==void 0&&v.externalRef!==userId)throw new SekyroConnectError("external_ref_mismatch");return v}async function applyResult(event,userId,result){let out=await updateClaim(userId,previous=>mergeClaim(previous,{kind:"result",result},{env,now}));return out.rule==="env_mismatch"?(log({type:"env_mismatch",sessionId:result.sessionId}),{handled:!1,event,reason:"env_mismatch"}):!out.changed||!out.claim?{handled:!0,event,userId,claim:out.claim,rule:out.rule}:(out.claim.subject_id!==void 0&&store.setSubjectUser&&await store.setSubjectUser(out.claim.subject_id,userId),log({type:"write",userId,sessionId:result.sessionId,rule:out.rule}),telemetry.record({type:"claim_written",sessionId:result.sessionId,subjectId:out.claim.subject_id}),{handled:!0,event,userId,claim:out.claim,rule:out.rule})}async function handleTerminal(event,d,envelopeEnv,remember){if(d.appId===void 0||!ids.includes(d.appId))return{handled:!1,event,reason:"other_app"};let userId=d.externalRef;if(typeof userId!="string"||userId.length===0)return{handled:!1,event,reason:"no_external_ref"};let result;if(typeof d.resultToken=="string"&&d.resultToken.length>0){let v=await verifiedFor(d.resultToken,d.sessionId,userId),jti=(0,import_jose.decodeJwt)(d.resultToken).jti;if(typeof jti=="string"&&jti.length>0&&await remember(`jti:${jti}`,JTI_TTL_SEC))return{handled:!1,event,reason:"duplicate_delivery"};result=fromVerifiedResult(v,d)}else{if(opts.requireResultToken===!0)return{handled:!1,event,reason:"result_token_required"};log({type:"result_token_absent",sessionId:d.sessionId}),result=fromWebhookData(d,envelopeEnv,now())}return applyResult(event,userId,result)}async function resolveUsers(event,subjectId,refs){let clean=list=>Array.isArray(list)?[...new Set(list.filter(r=>typeof r=="string"&&r.length>0))]:[],fromEvent=clean(refs);if(fromEvent.length>0)return{users:fromEvent,fromRefs:!0};if(event==="subject.updated"){let fromApi=clean((await sekyro.subjects.get(subjectId)).externalRefs);if(fromApi.length>0)return{users:fromApi,fromRefs:!0}}let fromStore=await store.getSubjectUser?.(subjectId);return{users:fromStore?[fromStore]:[],fromRefs:!1}}async function handleSubjectGone(event,subjectId,refs){let{users,fromRefs}=await resolveUsers(event,subjectId,refs);if(users.length===0)return log({type:"revocation_unresolved",subjectId}),telemetry.record({type:"revocation_unresolved",subjectId}),notifyRevocationUnresolved({subjectId,provider:provider.name,reason:event==="subject.updated"?"revoked":"deleted"}),{handled:!1,event,reason:"revocation_unresolved"};let kind=event==="subject.updated"?"revoked":"deleted",first;for(let userId of users){let out=await updateClaim(userId,previous=>mergeClaim(previous,{kind,subjectId,userInExternalRefs:fromRefs},{env,now}));out.changed&&out.claim&&(log({type:"write",userId,rule:out.rule}),telemetry.record({type:"claim_written",subjectId})),first??={claim:out.claim,rule:out.rule}}return{handled:!0,event,userId:users[0],claim:first.claim,rule:first.rule}}async function routeEnvelope(envelope,remember){let event=envelope.event;switch(envelope.event){case"session.completed":case"session.failed":return await handleTerminal(envelope.event,envelope.data,envelope.env,remember);case"subject.updated":{let d=envelope.data;return d.status!=="revoked"||typeof d.subjectId!="string"?{handled:!1,event,reason:"ignored_event"}:await handleSubjectGone("subject.updated",d.subjectId,d.externalRefs)}case"subject.deleted":{let d=envelope.data;return typeof d.subjectId!="string"||d.subjectId.length===0?{handled:!1,event,reason:"ignored_event"}:await handleSubjectGone("subject.deleted",d.subjectId,d.externalRefs)}default:return{handled:!1,event,reason:"ignored_event"}}}async function handleEnvelope(envelope){let event=envelope.event,canForget=typeof store.forget=="function",recorded=[],deferred=[],remember=async(id,ttl)=>{if(!canForget)return deferred.push([id,ttl]),!1;let dup=await store.seen(id,ttl);return dup||recorded.push(id),dup};if(await remember(`wh:${envelope.id}`,DEDUP_TTL_SEC))return{handled:!1,event,reason:"duplicate_delivery"};let out;try{out=await routeEnvelope(envelope,remember)}catch(err){for(let id of recorded)await store.forget(id).catch(()=>{});throw err}for(let[id,ttl]of deferred)await store.seen(id,ttl);return out}async function createVia(userId,mode,o){assertUserId(mode==="recheck"?"recheck":"stepUp",userId);let input={mode};mode==="step_up"&&o.flow!==void 0&&(input.flow=o.flow),o.locale!==void 0&&(input.locale=o.locale),o.ttlMinutes!==void 0&&(input.ttlMinutes=o.ttlMinutes);let link=linkOf(o);return link&&(input.link=link),sekyro.subjects.createSession({externalRef:userId},input)}return{env,appIds:ids,async webhook(rawBody,headers){let envelope=(0,import_webhooks.verifyWebhook)(rawBody,(0,import_webhooks.signatureFromHeaders)(headers),opts.webhookSecret,{now}),out=await handleEnvelope(envelope);if(!out.handled&&out.reason!=="env_mismatch"&&out.reason!=="revocation_unresolved"){let data=envelope.data,skip={type:"skip",reason:out.reason};typeof data.sessionId=="string"&&(skip.sessionId=data.sessionId),typeof data.subjectId=="string"&&(skip.subjectId=data.subjectId),log(skip)}return out},async sync(userId,sessionId){assertUserId("sync",userId);let s=await sekyro.sessions.get(sessionId);if(s.externalRef!==userId)throw new SekyroConnectError("external_ref_mismatch");if(s.status!=="completed"&&s.status!=="failed")throw new SekyroConnectError("session_not_terminal");let{token}=await sekyro.sessions.resultToken(sessionId),v=await verifiedFor(token,sessionId,userId),out=await applyResult(s.status==="completed"?"session.completed":"session.failed",userId,fromVerifiedResult(v,s));return out.handled?{claim:out.claim,rule:out.rule}:{claim:null,rule:"env_mismatch"}},async start(userId,o={}){assertUserId("start",userId);let input={};o.flow!==void 0&&(input.flow=o.flow),o.locale!==void 0&&(input.locale=o.locale),o.ttlMinutes!==void 0&&(input.ttlMinutes=o.ttlMinutes),input.subject={externalRef:userId};let link=linkOf(o);return link&&(input.link=link),sekyro.sessions.create(input)},recheck(userId,o={}){return createVia(userId,"recheck",o)},stepUp(userId,o){return createVia(userId,"step_up",o)},async userDeleted(userId){assertUserId("userDeleted",userId);let policy=opts.onUserDeleted??"ignore";if(policy==="ignore")return{policy,subjects:0};let subjects=await sekyro.subjects.list({externalRef:userId});for(let s of subjects)try{policy==="revoke"?await sekyro.subjects.revoke(s.id):await sekyro.subjects.delete(s.id)}catch(err){if(!isApiStatus(err,[404,409]))throw err}return{policy,subjects:subjects.length}},async claimOf(userId){return parseClaim(await provider.readUser(userId))},async clearFlag(userId,flag){let out=await updateClaim(userId,previous=>{let claim=parseClaim(previous);return!claim||claim.v>1||!claim.flags?.includes(flag)?{claim,changed:!1,rule:"no_change"}:{claim:parseClaim({...claim,flags:claim.flags.filter(f=>f!==flag)}),changed:!0,rule:"no_change"}});return out.changed&&log({type:"flag_cleared",userId,flag}),out.claim},gate(tokenClaims,policy){return evaluateGate(provider.readClaimFromToken(tokenClaims),{...policy,env:policy.env??env},Math.floor(now()/1e3))}}}0&&(module.exports={CLAIM_VERSION,SekyroConnectError,createConnector,evaluateGate,memoryStore,mergeClaim,parseClaim});
1
+ "use strict";var __defProp=Object.defineProperty;var __getOwnPropDesc=Object.getOwnPropertyDescriptor;var __getOwnPropNames=Object.getOwnPropertyNames;var __hasOwnProp=Object.prototype.hasOwnProperty;var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:!0})},__copyProps=(to,from,except,desc)=>{if(from&&typeof from=="object"||typeof from=="function")for(let key of __getOwnPropNames(from))!__hasOwnProp.call(to,key)&&key!==except&&__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable});return to};var __toCommonJS=mod=>__copyProps(__defProp({},"__esModule",{value:!0}),mod);var connect_exports={};__export(connect_exports,{CLAIM_VERSION:()=>CLAIM_VERSION,SekyroConnectError:()=>SekyroConnectError,createConnector:()=>createConnector,evaluateGate:()=>evaluateGate,memoryStore:()=>memoryStore,mergeClaim:()=>mergeClaim,parseClaim:()=>parseClaim});module.exports=__toCommonJS(connect_exports);var CLAIM_VERSION=1,KNOWN_FLAGS=["face_mismatch","duplicate","revoked"];function canonicalId(id){return id.replace(/^(ses|per)_/,"")}function isRecord(v){return typeof v=="object"&&v!==null&&!Array.isArray(v)}function isFiniteNumber(v){return typeof v=="number"&&Number.isFinite(v)}function build(c){let out={v:1,level:c.level,assurance:c.assurance,verified_at:c.verified_at};c.rechecked_at!==void 0&&(out.rechecked_at=c.rechecked_at),out.session_id=c.session_id,c.subject_id!==void 0&&(out.subject_id=canonicalId(c.subject_id)),out.env=c.env;let flags=new Set;for(let f of c.flags??[])KNOWN_FLAGS.includes(f)&&flags.add(f);return flags.size>0&&(out.flags=[...flags].sort()),out}function parseClaim(value){let v=value;if(typeof v=="string")try{v=JSON.parse(v)}catch{return null}if(!isRecord(v)||!isFiniteNumber(v.v))return null;if(v.v>1)return v;if(v.v!==1)return null;let level=v.level;return level!==0&&level!==1&&level!==2&&level!==3||typeof v.assurance!="string"||!isFiniteNumber(v.verified_at)||typeof v.session_id!="string"||v.env!=="live"&&v.env!=="sandbox"?null:build({level,assurance:v.assurance,verified_at:v.verified_at,rechecked_at:isFiniteNumber(v.rechecked_at)?v.rechecked_at:void 0,session_id:v.session_id,subject_id:typeof v.subject_id=="string"?v.subject_id:void 0,env:v.env,flags:Array.isArray(v.flags)?v.flags:void 0})}function toUnix(isoTime,now){let ms=Date.parse(isoTime);return Math.floor((Number.isFinite(ms)?ms:now())/1e3)}var same=(claim,rule)=>({claim,changed:!1,rule}),wrote=(claim,rule)=>({claim,changed:!0,rule});function mergeClaim(previous,event,opts){let now=opts.now??Date.now,prev=parseClaim(previous);if(prev&&prev.v>1)return same(prev,"unsupported_version");if(event.kind==="revoked"||event.kind==="deleted"){if(!prev)return same(null,"no_change");if(!(prev.subject_id===void 0?event.userInExternalRefs===!0:prev.subject_id===canonicalId(event.subjectId)))return same(prev,"subject_mismatch");if(prev.level===0&&prev.flags?.includes("revoked"))return same(prev,"no_change");let{rechecked_at:_cleared,...kept}=prev;return wrote(build({...kept,level:0,subject_id:event.subjectId,flags:["revoked"]}),"revoked")}let r=event.result;if(r.env!==opts.env)return same(prev,"env_mismatch");let t=toUnix(r.verifiedAt,now);if(prev&&t<prev.verified_at)return same(prev,"stale_ignored");let revokedPrev=prev?.flags?.includes("revoked")===!0;if(prev&&revokedPrev&&(r.subjectId===void 0||canonicalId(r.subjectId)===prev.subject_id))return same(prev,"revoked_ignored");if(r.outcome==="rejected"&&r.subjectConflict===!0)return!prev||prev.flags?.includes("face_mismatch")?same(prev,"no_change"):wrote(build({...prev,flags:[...prev.flags??[],"face_mismatch"]}),"face_mismatch");if(r.outcome!=="approved"||r.level===null||r.level===0)return same(prev,"not_approved");let level=r.level,assurance=r.assurance??"none",duplicate=r.duplicates===!0?["duplicate"]:[];if(!prev)return wrote(build({level,assurance,verified_at:t,session_id:r.sessionId,subject_id:r.subjectId,env:r.env,flags:duplicate}),"created");if(!revokedPrev&&(r.reuseMode==="recheck"||r.returning===!0&&level<=prev.level))return prev.rechecked_at!==void 0&&t<=prev.rechecked_at?same(prev,t<prev.rechecked_at?"stale_ignored":"no_change"):wrote(build({...prev,rechecked_at:t,subject_id:prev.subject_id??r.subjectId}),"rechecked");if(level>prev.level){let kept=(prev.flags??[]).filter(f=>f!=="face_mismatch"&&f!=="revoked");return wrote(build({...prev,level,assurance,verified_at:t,session_id:r.sessionId,subject_id:r.subjectId??prev.subject_id,flags:[...kept,...duplicate]}),"raised")}return level===prev.level&&t>prev.verified_at?wrote(build({...prev,assurance,verified_at:t,session_id:r.sessionId,subject_id:prev.subject_id??r.subjectId,flags:[...prev.flags??[],...duplicate]}),"renewed"):same(prev,"no_change")}var DEFAULT_DENY_FLAGS=["revoked","face_mismatch"],fail=(reason,action,claim)=>({ok:!1,reason,action,claim});function evaluateGate(claim,policy,nowSec=Math.floor(Date.now()/1e3)){let parsed=parseClaim(claim);if(!parsed)return fail("no_claim","verify",null);if(parsed.v>1)return fail("unsupported_version","verify",parsed);if(policy.env!==void 0&&parsed.env!==policy.env)return fail("wrong_env","verify",parsed);let deny=policy.denyFlags??DEFAULT_DENY_FLAGS;return parsed.flags?.some(f=>deny.includes(f))?fail("flagged","block",parsed):parsed.level<policy.level?fail("level_too_low",parsed.level>=1?"step_up":"verify",parsed):policy.maxAgeDays!==void 0&&nowSec-parsed.verified_at>policy.maxAgeDays*86400?fail("stale","recheck",parsed):policy.maxRecheckAgeMinutes!==void 0&&nowSec-(parsed.rechecked_at??parsed.verified_at)>policy.maxRecheckAgeMinutes*60?fail("recheck_stale","recheck",parsed):policy.assurance&&!policy.assurance.includes(parsed.assurance)?fail("assurance_not_allowed","step_up",parsed):{ok:!0,claim:parsed}}var import_jose=require("jose"),import_result_token=require("@sekyro/node"),import_webhooks=require("@sekyro/node");var MESSAGES={token_session_mismatch:"The result token is for another session than the webhook",external_ref_mismatch:"The session belongs to another user",session_not_terminal:"The session has not finished yet",invalid_options:"Invalid connector options",unavailable:"The Sekyro AI public key set could not be fetched; try again"},SekyroConnectError=class extends Error{name="SekyroConnectError";code;constructor(code,message=MESSAGES[code],cause){super(message,cause===void 0?void 0:{cause}),this.code=code}};function factsOf(d,tokenDuplicates){let out={};return d.returning===!0&&(out.returning=!0),d.subjectConflict===!0&&(out.subjectConflict=!0),(Array.isArray(d.duplicates)&&d.duplicates.length>0||(tokenDuplicates?.length??0)>0)&&(out.duplicates=!0),out}function fromVerifiedResult(v,d){let out={sessionId:v.sessionId,outcome:v.outcome,level:v.level,assurance:v.assurance,verifiedAt:v.verifiedAt,env:v.env,...factsOf(d,v.duplicates)};return v.subjectId!==void 0&&(out.subjectId=canonicalId(v.subjectId)),v.reuseMode!==void 0&&(out.reuseMode=v.reuseMode),out}function fromWebhookData(d,env,nowMs){let out={sessionId:d.sessionId,outcome:d.outcome??null,level:d.level??null,assurance:d.assurance??null,verifiedAt:d.verifiedAt??new Date(nowMs).toISOString(),env,...factsOf(d)},person=d.personId??d.subjectId;return typeof person=="string"&&person.length>0&&(out.subjectId=canonicalId(person)),d.reuseMode!==void 0&&(out.reuseMode=d.reuseMode),out}function memoryStore(opts={}){let now=opts.now??Date.now,ids=new Map,subjects=new Map,evict=t=>{for(let[id,expiresAt]of ids)expiresAt<=t&&ids.delete(id)};return{async seen(id,ttlSec){let t=now();return evict(t),ids.has(id)?!0:(ids.set(id,t+ttlSec*1e3),!1)},async forget(id){ids.delete(id)},async setSubjectUser(subjectId,userId){subjects.delete(subjectId),subjects.set(subjectId,userId),subjects.size>1e5&&subjects.delete(subjects.keys().next().value)},async getSubjectUser(subjectId){return subjects.get(subjectId)},size(){return evict(now()),ids.size}}}var KNOWN_CONNECTOR_PROVIDERS=new Set(["auth0","clerk","firebase","keycloak","supabase","zitadel"]),CONNECT_TELEMETRY=Symbol.for("@sekyro/node.connect-telemetry"),TELEMETRY_TIMEOUT_MS=2e3,TELEMETRY_BATCH_MAX=50,QUEUE_MAX=500;function hooksOf(sekyro){let h=sekyro[CONNECT_TELEMETRY];return h&&typeof h.setConnector=="function"&&typeof h.postEvents=="function"?h:void 0}var OFF={record(){}};function connectTelemetry(opts){let hooks=hooksOf(opts.sekyro);if(!hooks)return OFF;let name=opts.provider.name;if(!opts.enabled||!KNOWN_CONNECTOR_PROVIDERS.has(name))return opts.enabled||hooks.setConnector(null),OFF;hooks.setConnector({provider:name,version:opts.provider.version??"unknown"});let queue=[],scheduled=!1,flush=()=>{for(scheduled=!1;queue.length>0;){let batch=queue.splice(0,TELEMETRY_BATCH_MAX);hooks.postEvents(batch,TELEMETRY_TIMEOUT_MS).catch(()=>{})}};return{record(event){if(queue.length>=QUEUE_MAX)return;let e={type:event.type,provider:name,at:new Date(opts.now()).toISOString()};if(typeof event.sessionId=="string"&&event.sessionId.length>0&&(e.sessionId=event.sessionId),typeof event.personId=="string"&&event.personId.length>0&&(e.personId=`per_${canonicalId(event.personId)}`),queue.push(e),scheduled)return;scheduled=!0,setTimeout(flush,0).unref?.()}}}var DEDUP_TTL_SEC=24*3600,JTI_TTL_SEC=600,TWIN_TTL_SEC=300;function isApiStatus(err,statuses){if(typeof err!="object"||err===null)return!1;let e=err;return e.name==="SekyroApiError"&&typeof e.status=="number"&&statuses.includes(e.status)}function linkOf(o){if(o.returnUrl===void 0&&o.state===void 0)return;let link={};return o.returnUrl!==void 0&&(link.returnUrl=o.returnUrl),o.state!==void 0&&(link.state=o.state),link}function perKeyLock(){let tails=new Map;return(key,fn)=>{let run=(tails.get(key)??Promise.resolve()).then(fn,fn),tail=run.then(()=>{},()=>{});return tails.set(key,tail),tail.then(()=>{tails.get(key)===tail&&tails.delete(key)}),run}}function personIdOf(d){let id=typeof d.personId=="string"&&d.personId.length>0?d.personId:d.subjectId;return typeof id=="string"&&id.length>0?canonicalId(id):void 0}function assertUserId(method,userId){if(typeof userId!="string"||userId.length===0)throw new TypeError(`connector.${method}: \`userId\` must be a non-empty string`)}function createConnector(opts){let appIds=[opts?.appId].flat();if(appIds.length===0||appIds.some(id=>typeof id!="string"||id.length===0))throw new SekyroConnectError("invalid_options","`appId` must be a non-empty string or a non-empty array of them");if(opts.env!=="live"&&opts.env!=="sandbox")throw new SekyroConnectError("invalid_options","`env` must be 'live' or 'sandbox'");if(typeof opts.webhookSecret!="string"||opts.webhookSecret.length===0)throw new SekyroConnectError("invalid_options","`webhookSecret` is required");if(!opts.sekyro||!opts.provider)throw new SekyroConnectError("invalid_options","`sekyro` and `provider` are required");let{sekyro,provider,env}=opts,now=opts.now??Date.now,store=opts.store??memoryStore({now}),ids=Object.freeze([...appIds]),userLock=perKeyLock(),telemetry=connectTelemetry({sekyro,provider,enabled:opts.telemetry!==!1,now});function updateClaim(userId,fn){return typeof provider.update=="function"?provider.update(userId,fn):userLock(userId,async()=>{let out=fn(await provider.readUser(userId));return out.changed&&out.claim&&await provider.writeUser(userId,out.claim),out})}let log=event=>{if(opts.logger)try{opts.logger(event)}catch{}},notifyRevocationUnresolved=event=>{let handler=opts.onRevocationUnresolved;if(typeof handler!="function")return;let failed=()=>log({type:"revocation_handler_failed",subjectId:event.subjectId});queueMicrotask(()=>{try{Promise.resolve(handler(event)).catch(failed)}catch{failed()}})},tokenOptions={appId:[...ids],env,now};opts.issuer!==void 0&&(tokenOptions.issuer=opts.issuer),opts.jwksUrl!==void 0&&(tokenOptions.jwksUrl=opts.jwksUrl),opts.fetch!==void 0&&(tokenOptions.fetch=opts.fetch);async function verifiedFor(token,sessionId,userId){let v;try{v=await(0,import_result_token.verifyResultToken)(token,tokenOptions)}catch(err){let e=err;throw e?.name==="SekyroResultTokenError"&&e.code==="jwks_unavailable"?new SekyroConnectError("unavailable",void 0,err):err}if(canonicalId(v.sessionId)!==canonicalId(sessionId))throw new SekyroConnectError("token_session_mismatch");if(v.externalRef!==void 0&&v.externalRef!==userId)throw new SekyroConnectError("external_ref_mismatch");return v}async function applyResult(event,userId,result){let out=await updateClaim(userId,previous=>mergeClaim(previous,{kind:"result",result},{env,now}));return out.rule==="env_mismatch"?(log({type:"env_mismatch",sessionId:result.sessionId}),{handled:!1,event,reason:"env_mismatch"}):!out.changed||!out.claim?{handled:!0,event,userId,claim:out.claim,rule:out.rule}:(out.claim.subject_id!==void 0&&store.setSubjectUser&&await store.setSubjectUser(out.claim.subject_id,userId),log({type:"write",userId,sessionId:result.sessionId,rule:out.rule}),telemetry.record({type:"claim_written",sessionId:result.sessionId,personId:out.claim.subject_id}),{handled:!0,event,userId,claim:out.claim,rule:out.rule})}async function handleTerminal(event,d,envelopeEnv,remember){if(d.appId===void 0||!ids.includes(d.appId))return{handled:!1,event,reason:"other_app"};let userId=d.externalRef;if(typeof userId!="string"||userId.length===0)return{handled:!1,event,reason:"no_external_ref"};let result;if(typeof d.resultToken=="string"&&d.resultToken.length>0){let v=await verifiedFor(d.resultToken,d.sessionId,userId),jti=(0,import_jose.decodeJwt)(d.resultToken).jti;if(typeof jti=="string"&&jti.length>0&&await remember(`jti:${jti}`,JTI_TTL_SEC))return{handled:!1,event,reason:"duplicate_delivery"};result=fromVerifiedResult(v,d)}else{if(opts.requireResultToken===!0)return{handled:!1,event,reason:"result_token_required"};log({type:"result_token_absent",sessionId:d.sessionId}),result=fromWebhookData(d,envelopeEnv,now())}return applyResult(event,userId,result)}async function resolveUsers(kind,subjectId,refs){let clean=list=>Array.isArray(list)?[...new Set(list.filter(r=>typeof r=="string"&&r.length>0))]:[],fromEvent=clean(refs);if(fromEvent.length>0)return{users:fromEvent,fromRefs:!0};if(kind==="revoked"){let fromApi=clean((await sekyro.people.get(subjectId)).externalRefs);if(fromApi.length>0)return{users:fromApi,fromRefs:!0}}let fromStore=await store.getSubjectUser?.(subjectId);return{users:fromStore?[fromStore]:[],fromRefs:!1}}async function handleSubjectGone(event,subjectId,refs){let kind=event.endsWith(".updated")?"revoked":"deleted",{users,fromRefs}=await resolveUsers(kind,subjectId,refs);if(users.length===0)return log({type:"revocation_unresolved",subjectId}),telemetry.record({type:"revocation_unresolved",personId:subjectId}),notifyRevocationUnresolved({subjectId,personId:`per_${subjectId}`,provider:provider.name,reason:kind}),{handled:!1,event,reason:"revocation_unresolved"};let first;for(let userId of users){let out=await updateClaim(userId,previous=>mergeClaim(previous,{kind,subjectId,userInExternalRefs:fromRefs},{env,now}));out.changed&&out.claim&&(log({type:"write",userId,rule:out.rule}),telemetry.record({type:"claim_written",personId:subjectId})),first??={claim:out.claim,rule:out.rule}}return{handled:!0,event,userId:users[0],claim:first.claim,rule:first.rule}}async function routeEnvelope(envelope,remember){let event=envelope.event;switch(envelope.event){case"session.completed":case"session.failed":return await handleTerminal(envelope.event,envelope.data,envelope.env,remember);case"person.updated":case"subject.updated":{let d=envelope.data,id=personIdOf(d);return d.status!=="revoked"||id===void 0?{handled:!1,event,reason:"ignored_event"}:await remember(`gone:revoked:${id}`,TWIN_TTL_SEC)?{handled:!1,event,reason:"duplicate_delivery"}:await handleSubjectGone(envelope.event,id,d.externalRefs)}case"person.deleted":case"subject.deleted":{let d=envelope.data,id=personIdOf(d);return id===void 0?{handled:!1,event,reason:"ignored_event"}:await remember(`gone:deleted:${id}`,TWIN_TTL_SEC)?{handled:!1,event,reason:"duplicate_delivery"}:await handleSubjectGone(envelope.event,id,d.externalRefs)}default:return{handled:!1,event,reason:"ignored_event"}}}async function handleEnvelope(envelope){let event=envelope.event,canForget=typeof store.forget=="function",recorded=[],deferred=[],remember=async(id,ttl)=>{if(!canForget)return deferred.push([id,ttl]),!1;let dup=await store.seen(id,ttl);return dup||recorded.push(id),dup};if(await remember(`wh:${envelope.id}`,DEDUP_TTL_SEC))return{handled:!1,event,reason:"duplicate_delivery"};let out;try{out=await routeEnvelope(envelope,remember)}catch(err){for(let id of recorded)await store.forget(id).catch(()=>{});throw err}for(let[id,ttl]of deferred)await store.seen(id,ttl);return out}async function createVia(userId,mode,o){assertUserId(mode==="recheck"?"recheck":"stepUp",userId);let input={mode};mode==="step_up"&&o.flow!==void 0&&(input.flow=o.flow),o.locale!==void 0&&(input.locale=o.locale),o.ttlMinutes!==void 0&&(input.ttlMinutes=o.ttlMinutes);let link=linkOf(o);return link&&(input.link=link),sekyro.people.createSession({externalRef:userId},input)}return{env,appIds:ids,async webhook(rawBody,headers){let envelope=(0,import_webhooks.verifyWebhook)(rawBody,(0,import_webhooks.signatureFromHeaders)(headers),opts.webhookSecret,{now}),out=await handleEnvelope(envelope);if(!out.handled&&out.reason!=="env_mismatch"&&out.reason!=="revocation_unresolved"){let data=envelope.data,skip={type:"skip",reason:out.reason};typeof data.sessionId=="string"&&(skip.sessionId=data.sessionId);let person=personIdOf(data);person!==void 0&&(skip.subjectId=person),log(skip)}return out},async sync(userId,sessionId){assertUserId("sync",userId);let s=await sekyro.sessions.get(sessionId);if(s.externalRef!==userId)throw new SekyroConnectError("external_ref_mismatch");if(s.status!=="completed"&&s.status!=="failed")throw new SekyroConnectError("session_not_terminal");let{token}=await sekyro.sessions.resultToken(sessionId),v=await verifiedFor(token,sessionId,userId),out=await applyResult(s.status==="completed"?"session.completed":"session.failed",userId,fromVerifiedResult(v,s));return out.handled?{claim:out.claim,rule:out.rule}:{claim:null,rule:"env_mismatch"}},async start(userId,o={}){assertUserId("start",userId);let input={};o.flow!==void 0&&(input.flow=o.flow),o.locale!==void 0&&(input.locale=o.locale),o.ttlMinutes!==void 0&&(input.ttlMinutes=o.ttlMinutes),input.person={externalRef:userId};let link=linkOf(o);return link&&(input.link=link),sekyro.sessions.create(input)},recheck(userId,o={}){return createVia(userId,"recheck",o)},stepUp(userId,o){return createVia(userId,"step_up",o)},async userDeleted(userId){assertUserId("userDeleted",userId);let policy=opts.onUserDeleted??"ignore";if(policy==="ignore")return{policy,subjects:0};let people=[];for await(let p of sekyro.people.iterate({externalRef:userId}))Array.isArray(p?.externalRefs)&&p.externalRefs.includes(userId)&&people.push(p);for(let p of people)try{policy==="revoke"?await sekyro.people.revoke(p.id):await sekyro.people.delete(p.id)}catch(err){if(!isApiStatus(err,[404,409]))throw err}return{policy,subjects:people.length}},async claimOf(userId){return parseClaim(await provider.readUser(userId))},async clearFlag(userId,flag){let out=await updateClaim(userId,previous=>{let claim=parseClaim(previous);return!claim||claim.v>1||!claim.flags?.includes(flag)?{claim,changed:!1,rule:"no_change"}:{claim:parseClaim({...claim,flags:claim.flags.filter(f=>f!==flag)}),changed:!0,rule:"no_change"}});return out.changed&&log({type:"flag_cleared",userId,flag}),out.claim},gate(tokenClaims,policy){return evaluateGate(provider.readClaimFromToken(tokenClaims),{...policy,env:policy.env??env},Math.floor(now()/1e3))}}}0&&(module.exports={CLAIM_VERSION,SekyroConnectError,createConnector,evaluateGate,memoryStore,mergeClaim,parseClaim});
@@ -1,5 +1,5 @@
1
- export { b as CLAIM_VERSION, c as ClaimFlag, C as Connector, d as ConnectorLogEvent, e as ConnectorOptions, f as ConnectorStore, g as GateAction, G as GatePolicy, h as GateReason, a as GateResult, M as MemoryStore, i as MergeEvent, j as MergeOutcome, k as MergeRule, P as ProviderAdapter, R as RevocationUnresolvedEvent, S as SekyroClaim, l as StartOptions, V as VerificationResultInput, W as WebhookOutcome, m as WebhookSkipReason, n as createConnector, o as evaluateGate, p as memoryStore, q as mergeClaim, r as parseClaim } from '../connector-C4NuetEm.cjs';
2
- import '../client-Hkxwn6ZA.cjs';
1
+ export { b as CLAIM_VERSION, c as ClaimFlag, C as Connector, d as ConnectorLogEvent, e as ConnectorOptions, f as ConnectorStore, g as GateAction, G as GatePolicy, h as GateReason, a as GateResult, M as MemoryStore, i as MergeEvent, j as MergeOutcome, k as MergeRule, P as ProviderAdapter, R as RevocationUnresolvedEvent, S as SekyroClaim, l as StartOptions, V as VerificationResultInput, W as WebhookOutcome, m as WebhookSkipReason, n as createConnector, o as evaluateGate, p as memoryStore, q as mergeClaim, r as parseClaim } from '../connector-C0M4NWwZ.cjs';
2
+ import '../client-edr9f2Ec.cjs';
3
3
 
4
4
  /**
5
5
  * Why a connector refused to act:
@@ -1,5 +1,5 @@
1
- export { b as CLAIM_VERSION, c as ClaimFlag, C as Connector, d as ConnectorLogEvent, e as ConnectorOptions, f as ConnectorStore, g as GateAction, G as GatePolicy, h as GateReason, a as GateResult, M as MemoryStore, i as MergeEvent, j as MergeOutcome, k as MergeRule, P as ProviderAdapter, R as RevocationUnresolvedEvent, S as SekyroClaim, l as StartOptions, V as VerificationResultInput, W as WebhookOutcome, m as WebhookSkipReason, n as createConnector, o as evaluateGate, p as memoryStore, q as mergeClaim, r as parseClaim } from '../connector-BInF_yHb.js';
2
- import '../client-Hkxwn6ZA.js';
1
+ export { b as CLAIM_VERSION, c as ClaimFlag, C as Connector, d as ConnectorLogEvent, e as ConnectorOptions, f as ConnectorStore, g as GateAction, G as GatePolicy, h as GateReason, a as GateResult, M as MemoryStore, i as MergeEvent, j as MergeOutcome, k as MergeRule, P as ProviderAdapter, R as RevocationUnresolvedEvent, S as SekyroClaim, l as StartOptions, V as VerificationResultInput, W as WebhookOutcome, m as WebhookSkipReason, n as createConnector, o as evaluateGate, p as memoryStore, q as mergeClaim, r as parseClaim } from '../connector-DKP_ebGH.js';
2
+ import '../client-edr9f2Ec.js';
3
3
 
4
4
  /**
5
5
  * Why a connector refused to act:
@@ -1 +1 @@
1
- import{CLAIM_VERSION,evaluateGate,mergeClaim,parseClaim}from"../chunk-O5GJ3YJV.js";import{decodeJwt}from"jose";import{verifyResultToken}from"@sekyro/node";import{signatureFromHeaders,verifyWebhook}from"@sekyro/node";var MESSAGES={token_session_mismatch:"The result token is for another session than the webhook",external_ref_mismatch:"The session belongs to another user",session_not_terminal:"The session has not finished yet",invalid_options:"Invalid connector options",unavailable:"The Sekyro AI public key set could not be fetched; try again"},SekyroConnectError=class extends Error{name="SekyroConnectError";code;constructor(code,message=MESSAGES[code],cause){super(message,cause===void 0?void 0:{cause}),this.code=code}};function factsOf(d,tokenDuplicates){let out={};return d.returning===!0&&(out.returning=!0),d.subjectConflict===!0&&(out.subjectConflict=!0),(Array.isArray(d.duplicates)&&d.duplicates.length>0||(tokenDuplicates?.length??0)>0)&&(out.duplicates=!0),out}function fromVerifiedResult(v,d){let out={sessionId:v.sessionId,outcome:v.outcome,level:v.level,assurance:v.assurance,verifiedAt:v.verifiedAt,env:v.env,...factsOf(d,v.duplicates)};return v.subjectId!==void 0&&(out.subjectId=v.subjectId),v.reuseMode!==void 0&&(out.reuseMode=v.reuseMode),out}function fromWebhookData(d,env,nowMs){let out={sessionId:d.sessionId,outcome:d.outcome??null,level:d.level??null,assurance:d.assurance??null,verifiedAt:d.verifiedAt??new Date(nowMs).toISOString(),env,...factsOf(d)};return d.subjectId!==void 0&&(out.subjectId=d.subjectId),d.reuseMode!==void 0&&(out.reuseMode=d.reuseMode),out}function memoryStore(opts={}){let now=opts.now??Date.now,ids=new Map,subjects=new Map,evict=t=>{for(let[id,expiresAt]of ids)expiresAt<=t&&ids.delete(id)};return{async seen(id,ttlSec){let t=now();return evict(t),ids.has(id)?!0:(ids.set(id,t+ttlSec*1e3),!1)},async forget(id){ids.delete(id)},async setSubjectUser(subjectId,userId){subjects.delete(subjectId),subjects.set(subjectId,userId),subjects.size>1e5&&subjects.delete(subjects.keys().next().value)},async getSubjectUser(subjectId){return subjects.get(subjectId)},size(){return evict(now()),ids.size}}}var KNOWN_CONNECTOR_PROVIDERS=new Set(["auth0","clerk","firebase","keycloak","supabase","zitadel"]),CONNECT_TELEMETRY=Symbol.for("@sekyro/node.connect-telemetry"),TELEMETRY_TIMEOUT_MS=2e3,TELEMETRY_BATCH_MAX=50,QUEUE_MAX=500;function hooksOf(sekyro){let h=sekyro[CONNECT_TELEMETRY];return h&&typeof h.setConnector=="function"&&typeof h.postEvents=="function"?h:void 0}var OFF={record(){}};function connectTelemetry(opts){let hooks=hooksOf(opts.sekyro);if(!hooks)return OFF;let name=opts.provider.name;if(!opts.enabled||!KNOWN_CONNECTOR_PROVIDERS.has(name))return opts.enabled||hooks.setConnector(null),OFF;hooks.setConnector({provider:name,version:opts.provider.version??"unknown"});let queue=[],scheduled=!1,flush=()=>{for(scheduled=!1;queue.length>0;){let batch=queue.splice(0,TELEMETRY_BATCH_MAX);hooks.postEvents(batch,TELEMETRY_TIMEOUT_MS).catch(()=>{})}};return{record(event){if(queue.length>=QUEUE_MAX)return;let e={type:event.type,provider:name,at:new Date(opts.now()).toISOString()};if(typeof event.sessionId=="string"&&event.sessionId.length>0&&(e.sessionId=event.sessionId),typeof event.subjectId=="string"&&event.subjectId.length>0&&(e.subjectId=event.subjectId),queue.push(e),scheduled)return;scheduled=!0,setTimeout(flush,0).unref?.()}}}var DEDUP_TTL_SEC=24*3600,JTI_TTL_SEC=600;function isApiStatus(err,statuses){if(typeof err!="object"||err===null)return!1;let e=err;return e.name==="SekyroApiError"&&typeof e.status=="number"&&statuses.includes(e.status)}function linkOf(o){if(o.returnUrl===void 0&&o.state===void 0)return;let link={};return o.returnUrl!==void 0&&(link.returnUrl=o.returnUrl),o.state!==void 0&&(link.state=o.state),link}function perKeyLock(){let tails=new Map;return(key,fn)=>{let run=(tails.get(key)??Promise.resolve()).then(fn,fn),tail=run.then(()=>{},()=>{});return tails.set(key,tail),tail.then(()=>{tails.get(key)===tail&&tails.delete(key)}),run}}function assertUserId(method,userId){if(typeof userId!="string"||userId.length===0)throw new TypeError(`connector.${method}: \`userId\` must be a non-empty string`)}function createConnector(opts){let appIds=[opts?.appId].flat();if(appIds.length===0||appIds.some(id=>typeof id!="string"||id.length===0))throw new SekyroConnectError("invalid_options","`appId` must be a non-empty string or a non-empty array of them");if(opts.env!=="live"&&opts.env!=="sandbox")throw new SekyroConnectError("invalid_options","`env` must be 'live' or 'sandbox'");if(typeof opts.webhookSecret!="string"||opts.webhookSecret.length===0)throw new SekyroConnectError("invalid_options","`webhookSecret` is required");if(!opts.sekyro||!opts.provider)throw new SekyroConnectError("invalid_options","`sekyro` and `provider` are required");let{sekyro,provider,env}=opts,now=opts.now??Date.now,store=opts.store??memoryStore({now}),ids=Object.freeze([...appIds]),userLock=perKeyLock(),telemetry=connectTelemetry({sekyro,provider,enabled:opts.telemetry!==!1,now});function updateClaim(userId,fn){return typeof provider.update=="function"?provider.update(userId,fn):userLock(userId,async()=>{let out=fn(await provider.readUser(userId));return out.changed&&out.claim&&await provider.writeUser(userId,out.claim),out})}let log=event=>{if(opts.logger)try{opts.logger(event)}catch{}},notifyRevocationUnresolved=event=>{let handler=opts.onRevocationUnresolved;if(typeof handler!="function")return;let failed=()=>log({type:"revocation_handler_failed",subjectId:event.subjectId});queueMicrotask(()=>{try{Promise.resolve(handler(event)).catch(failed)}catch{failed()}})},tokenOptions={appId:[...ids],env,now};opts.issuer!==void 0&&(tokenOptions.issuer=opts.issuer),opts.jwksUrl!==void 0&&(tokenOptions.jwksUrl=opts.jwksUrl),opts.fetch!==void 0&&(tokenOptions.fetch=opts.fetch);async function verifiedFor(token,sessionId,userId){let v;try{v=await verifyResultToken(token,tokenOptions)}catch(err){let e=err;throw e?.name==="SekyroResultTokenError"&&e.code==="jwks_unavailable"?new SekyroConnectError("unavailable",void 0,err):err}if(v.sessionId!==sessionId)throw new SekyroConnectError("token_session_mismatch");if(v.externalRef!==void 0&&v.externalRef!==userId)throw new SekyroConnectError("external_ref_mismatch");return v}async function applyResult(event,userId,result){let out=await updateClaim(userId,previous=>mergeClaim(previous,{kind:"result",result},{env,now}));return out.rule==="env_mismatch"?(log({type:"env_mismatch",sessionId:result.sessionId}),{handled:!1,event,reason:"env_mismatch"}):!out.changed||!out.claim?{handled:!0,event,userId,claim:out.claim,rule:out.rule}:(out.claim.subject_id!==void 0&&store.setSubjectUser&&await store.setSubjectUser(out.claim.subject_id,userId),log({type:"write",userId,sessionId:result.sessionId,rule:out.rule}),telemetry.record({type:"claim_written",sessionId:result.sessionId,subjectId:out.claim.subject_id}),{handled:!0,event,userId,claim:out.claim,rule:out.rule})}async function handleTerminal(event,d,envelopeEnv,remember){if(d.appId===void 0||!ids.includes(d.appId))return{handled:!1,event,reason:"other_app"};let userId=d.externalRef;if(typeof userId!="string"||userId.length===0)return{handled:!1,event,reason:"no_external_ref"};let result;if(typeof d.resultToken=="string"&&d.resultToken.length>0){let v=await verifiedFor(d.resultToken,d.sessionId,userId),jti=decodeJwt(d.resultToken).jti;if(typeof jti=="string"&&jti.length>0&&await remember(`jti:${jti}`,JTI_TTL_SEC))return{handled:!1,event,reason:"duplicate_delivery"};result=fromVerifiedResult(v,d)}else{if(opts.requireResultToken===!0)return{handled:!1,event,reason:"result_token_required"};log({type:"result_token_absent",sessionId:d.sessionId}),result=fromWebhookData(d,envelopeEnv,now())}return applyResult(event,userId,result)}async function resolveUsers(event,subjectId,refs){let clean=list=>Array.isArray(list)?[...new Set(list.filter(r=>typeof r=="string"&&r.length>0))]:[],fromEvent=clean(refs);if(fromEvent.length>0)return{users:fromEvent,fromRefs:!0};if(event==="subject.updated"){let fromApi=clean((await sekyro.subjects.get(subjectId)).externalRefs);if(fromApi.length>0)return{users:fromApi,fromRefs:!0}}let fromStore=await store.getSubjectUser?.(subjectId);return{users:fromStore?[fromStore]:[],fromRefs:!1}}async function handleSubjectGone(event,subjectId,refs){let{users,fromRefs}=await resolveUsers(event,subjectId,refs);if(users.length===0)return log({type:"revocation_unresolved",subjectId}),telemetry.record({type:"revocation_unresolved",subjectId}),notifyRevocationUnresolved({subjectId,provider:provider.name,reason:event==="subject.updated"?"revoked":"deleted"}),{handled:!1,event,reason:"revocation_unresolved"};let kind=event==="subject.updated"?"revoked":"deleted",first;for(let userId of users){let out=await updateClaim(userId,previous=>mergeClaim(previous,{kind,subjectId,userInExternalRefs:fromRefs},{env,now}));out.changed&&out.claim&&(log({type:"write",userId,rule:out.rule}),telemetry.record({type:"claim_written",subjectId})),first??={claim:out.claim,rule:out.rule}}return{handled:!0,event,userId:users[0],claim:first.claim,rule:first.rule}}async function routeEnvelope(envelope,remember){let event=envelope.event;switch(envelope.event){case"session.completed":case"session.failed":return await handleTerminal(envelope.event,envelope.data,envelope.env,remember);case"subject.updated":{let d=envelope.data;return d.status!=="revoked"||typeof d.subjectId!="string"?{handled:!1,event,reason:"ignored_event"}:await handleSubjectGone("subject.updated",d.subjectId,d.externalRefs)}case"subject.deleted":{let d=envelope.data;return typeof d.subjectId!="string"||d.subjectId.length===0?{handled:!1,event,reason:"ignored_event"}:await handleSubjectGone("subject.deleted",d.subjectId,d.externalRefs)}default:return{handled:!1,event,reason:"ignored_event"}}}async function handleEnvelope(envelope){let event=envelope.event,canForget=typeof store.forget=="function",recorded=[],deferred=[],remember=async(id,ttl)=>{if(!canForget)return deferred.push([id,ttl]),!1;let dup=await store.seen(id,ttl);return dup||recorded.push(id),dup};if(await remember(`wh:${envelope.id}`,DEDUP_TTL_SEC))return{handled:!1,event,reason:"duplicate_delivery"};let out;try{out=await routeEnvelope(envelope,remember)}catch(err){for(let id of recorded)await store.forget(id).catch(()=>{});throw err}for(let[id,ttl]of deferred)await store.seen(id,ttl);return out}async function createVia(userId,mode,o){assertUserId(mode==="recheck"?"recheck":"stepUp",userId);let input={mode};mode==="step_up"&&o.flow!==void 0&&(input.flow=o.flow),o.locale!==void 0&&(input.locale=o.locale),o.ttlMinutes!==void 0&&(input.ttlMinutes=o.ttlMinutes);let link=linkOf(o);return link&&(input.link=link),sekyro.subjects.createSession({externalRef:userId},input)}return{env,appIds:ids,async webhook(rawBody,headers){let envelope=verifyWebhook(rawBody,signatureFromHeaders(headers),opts.webhookSecret,{now}),out=await handleEnvelope(envelope);if(!out.handled&&out.reason!=="env_mismatch"&&out.reason!=="revocation_unresolved"){let data=envelope.data,skip={type:"skip",reason:out.reason};typeof data.sessionId=="string"&&(skip.sessionId=data.sessionId),typeof data.subjectId=="string"&&(skip.subjectId=data.subjectId),log(skip)}return out},async sync(userId,sessionId){assertUserId("sync",userId);let s=await sekyro.sessions.get(sessionId);if(s.externalRef!==userId)throw new SekyroConnectError("external_ref_mismatch");if(s.status!=="completed"&&s.status!=="failed")throw new SekyroConnectError("session_not_terminal");let{token}=await sekyro.sessions.resultToken(sessionId),v=await verifiedFor(token,sessionId,userId),out=await applyResult(s.status==="completed"?"session.completed":"session.failed",userId,fromVerifiedResult(v,s));return out.handled?{claim:out.claim,rule:out.rule}:{claim:null,rule:"env_mismatch"}},async start(userId,o={}){assertUserId("start",userId);let input={};o.flow!==void 0&&(input.flow=o.flow),o.locale!==void 0&&(input.locale=o.locale),o.ttlMinutes!==void 0&&(input.ttlMinutes=o.ttlMinutes),input.subject={externalRef:userId};let link=linkOf(o);return link&&(input.link=link),sekyro.sessions.create(input)},recheck(userId,o={}){return createVia(userId,"recheck",o)},stepUp(userId,o){return createVia(userId,"step_up",o)},async userDeleted(userId){assertUserId("userDeleted",userId);let policy=opts.onUserDeleted??"ignore";if(policy==="ignore")return{policy,subjects:0};let subjects=await sekyro.subjects.list({externalRef:userId});for(let s of subjects)try{policy==="revoke"?await sekyro.subjects.revoke(s.id):await sekyro.subjects.delete(s.id)}catch(err){if(!isApiStatus(err,[404,409]))throw err}return{policy,subjects:subjects.length}},async claimOf(userId){return parseClaim(await provider.readUser(userId))},async clearFlag(userId,flag){let out=await updateClaim(userId,previous=>{let claim=parseClaim(previous);return!claim||claim.v>1||!claim.flags?.includes(flag)?{claim,changed:!1,rule:"no_change"}:{claim:parseClaim({...claim,flags:claim.flags.filter(f=>f!==flag)}),changed:!0,rule:"no_change"}});return out.changed&&log({type:"flag_cleared",userId,flag}),out.claim},gate(tokenClaims,policy){return evaluateGate(provider.readClaimFromToken(tokenClaims),{...policy,env:policy.env??env},Math.floor(now()/1e3))}}}export{CLAIM_VERSION,SekyroConnectError,createConnector,evaluateGate,memoryStore,mergeClaim,parseClaim};
1
+ import{CLAIM_VERSION,canonicalId,evaluateGate,mergeClaim,parseClaim}from"../chunk-D53NUEJ6.js";import{decodeJwt}from"jose";import{verifyResultToken}from"@sekyro/node";import{signatureFromHeaders,verifyWebhook}from"@sekyro/node";var MESSAGES={token_session_mismatch:"The result token is for another session than the webhook",external_ref_mismatch:"The session belongs to another user",session_not_terminal:"The session has not finished yet",invalid_options:"Invalid connector options",unavailable:"The Sekyro AI public key set could not be fetched; try again"},SekyroConnectError=class extends Error{name="SekyroConnectError";code;constructor(code,message=MESSAGES[code],cause){super(message,cause===void 0?void 0:{cause}),this.code=code}};function factsOf(d,tokenDuplicates){let out={};return d.returning===!0&&(out.returning=!0),d.subjectConflict===!0&&(out.subjectConflict=!0),(Array.isArray(d.duplicates)&&d.duplicates.length>0||(tokenDuplicates?.length??0)>0)&&(out.duplicates=!0),out}function fromVerifiedResult(v,d){let out={sessionId:v.sessionId,outcome:v.outcome,level:v.level,assurance:v.assurance,verifiedAt:v.verifiedAt,env:v.env,...factsOf(d,v.duplicates)};return v.subjectId!==void 0&&(out.subjectId=canonicalId(v.subjectId)),v.reuseMode!==void 0&&(out.reuseMode=v.reuseMode),out}function fromWebhookData(d,env,nowMs){let out={sessionId:d.sessionId,outcome:d.outcome??null,level:d.level??null,assurance:d.assurance??null,verifiedAt:d.verifiedAt??new Date(nowMs).toISOString(),env,...factsOf(d)},person=d.personId??d.subjectId;return typeof person=="string"&&person.length>0&&(out.subjectId=canonicalId(person)),d.reuseMode!==void 0&&(out.reuseMode=d.reuseMode),out}function memoryStore(opts={}){let now=opts.now??Date.now,ids=new Map,subjects=new Map,evict=t=>{for(let[id,expiresAt]of ids)expiresAt<=t&&ids.delete(id)};return{async seen(id,ttlSec){let t=now();return evict(t),ids.has(id)?!0:(ids.set(id,t+ttlSec*1e3),!1)},async forget(id){ids.delete(id)},async setSubjectUser(subjectId,userId){subjects.delete(subjectId),subjects.set(subjectId,userId),subjects.size>1e5&&subjects.delete(subjects.keys().next().value)},async getSubjectUser(subjectId){return subjects.get(subjectId)},size(){return evict(now()),ids.size}}}var KNOWN_CONNECTOR_PROVIDERS=new Set(["auth0","clerk","firebase","keycloak","supabase","zitadel"]),CONNECT_TELEMETRY=Symbol.for("@sekyro/node.connect-telemetry"),TELEMETRY_TIMEOUT_MS=2e3,TELEMETRY_BATCH_MAX=50,QUEUE_MAX=500;function hooksOf(sekyro){let h=sekyro[CONNECT_TELEMETRY];return h&&typeof h.setConnector=="function"&&typeof h.postEvents=="function"?h:void 0}var OFF={record(){}};function connectTelemetry(opts){let hooks=hooksOf(opts.sekyro);if(!hooks)return OFF;let name=opts.provider.name;if(!opts.enabled||!KNOWN_CONNECTOR_PROVIDERS.has(name))return opts.enabled||hooks.setConnector(null),OFF;hooks.setConnector({provider:name,version:opts.provider.version??"unknown"});let queue=[],scheduled=!1,flush=()=>{for(scheduled=!1;queue.length>0;){let batch=queue.splice(0,TELEMETRY_BATCH_MAX);hooks.postEvents(batch,TELEMETRY_TIMEOUT_MS).catch(()=>{})}};return{record(event){if(queue.length>=QUEUE_MAX)return;let e={type:event.type,provider:name,at:new Date(opts.now()).toISOString()};if(typeof event.sessionId=="string"&&event.sessionId.length>0&&(e.sessionId=event.sessionId),typeof event.personId=="string"&&event.personId.length>0&&(e.personId=`per_${canonicalId(event.personId)}`),queue.push(e),scheduled)return;scheduled=!0,setTimeout(flush,0).unref?.()}}}var DEDUP_TTL_SEC=24*3600,JTI_TTL_SEC=600,TWIN_TTL_SEC=300;function isApiStatus(err,statuses){if(typeof err!="object"||err===null)return!1;let e=err;return e.name==="SekyroApiError"&&typeof e.status=="number"&&statuses.includes(e.status)}function linkOf(o){if(o.returnUrl===void 0&&o.state===void 0)return;let link={};return o.returnUrl!==void 0&&(link.returnUrl=o.returnUrl),o.state!==void 0&&(link.state=o.state),link}function perKeyLock(){let tails=new Map;return(key,fn)=>{let run=(tails.get(key)??Promise.resolve()).then(fn,fn),tail=run.then(()=>{},()=>{});return tails.set(key,tail),tail.then(()=>{tails.get(key)===tail&&tails.delete(key)}),run}}function personIdOf(d){let id=typeof d.personId=="string"&&d.personId.length>0?d.personId:d.subjectId;return typeof id=="string"&&id.length>0?canonicalId(id):void 0}function assertUserId(method,userId){if(typeof userId!="string"||userId.length===0)throw new TypeError(`connector.${method}: \`userId\` must be a non-empty string`)}function createConnector(opts){let appIds=[opts?.appId].flat();if(appIds.length===0||appIds.some(id=>typeof id!="string"||id.length===0))throw new SekyroConnectError("invalid_options","`appId` must be a non-empty string or a non-empty array of them");if(opts.env!=="live"&&opts.env!=="sandbox")throw new SekyroConnectError("invalid_options","`env` must be 'live' or 'sandbox'");if(typeof opts.webhookSecret!="string"||opts.webhookSecret.length===0)throw new SekyroConnectError("invalid_options","`webhookSecret` is required");if(!opts.sekyro||!opts.provider)throw new SekyroConnectError("invalid_options","`sekyro` and `provider` are required");let{sekyro,provider,env}=opts,now=opts.now??Date.now,store=opts.store??memoryStore({now}),ids=Object.freeze([...appIds]),userLock=perKeyLock(),telemetry=connectTelemetry({sekyro,provider,enabled:opts.telemetry!==!1,now});function updateClaim(userId,fn){return typeof provider.update=="function"?provider.update(userId,fn):userLock(userId,async()=>{let out=fn(await provider.readUser(userId));return out.changed&&out.claim&&await provider.writeUser(userId,out.claim),out})}let log=event=>{if(opts.logger)try{opts.logger(event)}catch{}},notifyRevocationUnresolved=event=>{let handler=opts.onRevocationUnresolved;if(typeof handler!="function")return;let failed=()=>log({type:"revocation_handler_failed",subjectId:event.subjectId});queueMicrotask(()=>{try{Promise.resolve(handler(event)).catch(failed)}catch{failed()}})},tokenOptions={appId:[...ids],env,now};opts.issuer!==void 0&&(tokenOptions.issuer=opts.issuer),opts.jwksUrl!==void 0&&(tokenOptions.jwksUrl=opts.jwksUrl),opts.fetch!==void 0&&(tokenOptions.fetch=opts.fetch);async function verifiedFor(token,sessionId,userId){let v;try{v=await verifyResultToken(token,tokenOptions)}catch(err){let e=err;throw e?.name==="SekyroResultTokenError"&&e.code==="jwks_unavailable"?new SekyroConnectError("unavailable",void 0,err):err}if(canonicalId(v.sessionId)!==canonicalId(sessionId))throw new SekyroConnectError("token_session_mismatch");if(v.externalRef!==void 0&&v.externalRef!==userId)throw new SekyroConnectError("external_ref_mismatch");return v}async function applyResult(event,userId,result){let out=await updateClaim(userId,previous=>mergeClaim(previous,{kind:"result",result},{env,now}));return out.rule==="env_mismatch"?(log({type:"env_mismatch",sessionId:result.sessionId}),{handled:!1,event,reason:"env_mismatch"}):!out.changed||!out.claim?{handled:!0,event,userId,claim:out.claim,rule:out.rule}:(out.claim.subject_id!==void 0&&store.setSubjectUser&&await store.setSubjectUser(out.claim.subject_id,userId),log({type:"write",userId,sessionId:result.sessionId,rule:out.rule}),telemetry.record({type:"claim_written",sessionId:result.sessionId,personId:out.claim.subject_id}),{handled:!0,event,userId,claim:out.claim,rule:out.rule})}async function handleTerminal(event,d,envelopeEnv,remember){if(d.appId===void 0||!ids.includes(d.appId))return{handled:!1,event,reason:"other_app"};let userId=d.externalRef;if(typeof userId!="string"||userId.length===0)return{handled:!1,event,reason:"no_external_ref"};let result;if(typeof d.resultToken=="string"&&d.resultToken.length>0){let v=await verifiedFor(d.resultToken,d.sessionId,userId),jti=decodeJwt(d.resultToken).jti;if(typeof jti=="string"&&jti.length>0&&await remember(`jti:${jti}`,JTI_TTL_SEC))return{handled:!1,event,reason:"duplicate_delivery"};result=fromVerifiedResult(v,d)}else{if(opts.requireResultToken===!0)return{handled:!1,event,reason:"result_token_required"};log({type:"result_token_absent",sessionId:d.sessionId}),result=fromWebhookData(d,envelopeEnv,now())}return applyResult(event,userId,result)}async function resolveUsers(kind,subjectId,refs){let clean=list=>Array.isArray(list)?[...new Set(list.filter(r=>typeof r=="string"&&r.length>0))]:[],fromEvent=clean(refs);if(fromEvent.length>0)return{users:fromEvent,fromRefs:!0};if(kind==="revoked"){let fromApi=clean((await sekyro.people.get(subjectId)).externalRefs);if(fromApi.length>0)return{users:fromApi,fromRefs:!0}}let fromStore=await store.getSubjectUser?.(subjectId);return{users:fromStore?[fromStore]:[],fromRefs:!1}}async function handleSubjectGone(event,subjectId,refs){let kind=event.endsWith(".updated")?"revoked":"deleted",{users,fromRefs}=await resolveUsers(kind,subjectId,refs);if(users.length===0)return log({type:"revocation_unresolved",subjectId}),telemetry.record({type:"revocation_unresolved",personId:subjectId}),notifyRevocationUnresolved({subjectId,personId:`per_${subjectId}`,provider:provider.name,reason:kind}),{handled:!1,event,reason:"revocation_unresolved"};let first;for(let userId of users){let out=await updateClaim(userId,previous=>mergeClaim(previous,{kind,subjectId,userInExternalRefs:fromRefs},{env,now}));out.changed&&out.claim&&(log({type:"write",userId,rule:out.rule}),telemetry.record({type:"claim_written",personId:subjectId})),first??={claim:out.claim,rule:out.rule}}return{handled:!0,event,userId:users[0],claim:first.claim,rule:first.rule}}async function routeEnvelope(envelope,remember){let event=envelope.event;switch(envelope.event){case"session.completed":case"session.failed":return await handleTerminal(envelope.event,envelope.data,envelope.env,remember);case"person.updated":case"subject.updated":{let d=envelope.data,id=personIdOf(d);return d.status!=="revoked"||id===void 0?{handled:!1,event,reason:"ignored_event"}:await remember(`gone:revoked:${id}`,TWIN_TTL_SEC)?{handled:!1,event,reason:"duplicate_delivery"}:await handleSubjectGone(envelope.event,id,d.externalRefs)}case"person.deleted":case"subject.deleted":{let d=envelope.data,id=personIdOf(d);return id===void 0?{handled:!1,event,reason:"ignored_event"}:await remember(`gone:deleted:${id}`,TWIN_TTL_SEC)?{handled:!1,event,reason:"duplicate_delivery"}:await handleSubjectGone(envelope.event,id,d.externalRefs)}default:return{handled:!1,event,reason:"ignored_event"}}}async function handleEnvelope(envelope){let event=envelope.event,canForget=typeof store.forget=="function",recorded=[],deferred=[],remember=async(id,ttl)=>{if(!canForget)return deferred.push([id,ttl]),!1;let dup=await store.seen(id,ttl);return dup||recorded.push(id),dup};if(await remember(`wh:${envelope.id}`,DEDUP_TTL_SEC))return{handled:!1,event,reason:"duplicate_delivery"};let out;try{out=await routeEnvelope(envelope,remember)}catch(err){for(let id of recorded)await store.forget(id).catch(()=>{});throw err}for(let[id,ttl]of deferred)await store.seen(id,ttl);return out}async function createVia(userId,mode,o){assertUserId(mode==="recheck"?"recheck":"stepUp",userId);let input={mode};mode==="step_up"&&o.flow!==void 0&&(input.flow=o.flow),o.locale!==void 0&&(input.locale=o.locale),o.ttlMinutes!==void 0&&(input.ttlMinutes=o.ttlMinutes);let link=linkOf(o);return link&&(input.link=link),sekyro.people.createSession({externalRef:userId},input)}return{env,appIds:ids,async webhook(rawBody,headers){let envelope=verifyWebhook(rawBody,signatureFromHeaders(headers),opts.webhookSecret,{now}),out=await handleEnvelope(envelope);if(!out.handled&&out.reason!=="env_mismatch"&&out.reason!=="revocation_unresolved"){let data=envelope.data,skip={type:"skip",reason:out.reason};typeof data.sessionId=="string"&&(skip.sessionId=data.sessionId);let person=personIdOf(data);person!==void 0&&(skip.subjectId=person),log(skip)}return out},async sync(userId,sessionId){assertUserId("sync",userId);let s=await sekyro.sessions.get(sessionId);if(s.externalRef!==userId)throw new SekyroConnectError("external_ref_mismatch");if(s.status!=="completed"&&s.status!=="failed")throw new SekyroConnectError("session_not_terminal");let{token}=await sekyro.sessions.resultToken(sessionId),v=await verifiedFor(token,sessionId,userId),out=await applyResult(s.status==="completed"?"session.completed":"session.failed",userId,fromVerifiedResult(v,s));return out.handled?{claim:out.claim,rule:out.rule}:{claim:null,rule:"env_mismatch"}},async start(userId,o={}){assertUserId("start",userId);let input={};o.flow!==void 0&&(input.flow=o.flow),o.locale!==void 0&&(input.locale=o.locale),o.ttlMinutes!==void 0&&(input.ttlMinutes=o.ttlMinutes),input.person={externalRef:userId};let link=linkOf(o);return link&&(input.link=link),sekyro.sessions.create(input)},recheck(userId,o={}){return createVia(userId,"recheck",o)},stepUp(userId,o){return createVia(userId,"step_up",o)},async userDeleted(userId){assertUserId("userDeleted",userId);let policy=opts.onUserDeleted??"ignore";if(policy==="ignore")return{policy,subjects:0};let people=[];for await(let p of sekyro.people.iterate({externalRef:userId}))Array.isArray(p?.externalRefs)&&p.externalRefs.includes(userId)&&people.push(p);for(let p of people)try{policy==="revoke"?await sekyro.people.revoke(p.id):await sekyro.people.delete(p.id)}catch(err){if(!isApiStatus(err,[404,409]))throw err}return{policy,subjects:people.length}},async claimOf(userId){return parseClaim(await provider.readUser(userId))},async clearFlag(userId,flag){let out=await updateClaim(userId,previous=>{let claim=parseClaim(previous);return!claim||claim.v>1||!claim.flags?.includes(flag)?{claim,changed:!1,rule:"no_change"}:{claim:parseClaim({...claim,flags:claim.flags.filter(f=>f!==flag)}),changed:!0,rule:"no_change"}});return out.changed&&log({type:"flag_cleared",userId,flag}),out.claim},gate(tokenClaims,policy){return evaluateGate(provider.readClaimFromToken(tokenClaims),{...policy,env:policy.env??env},Math.floor(now()/1e3))}}}export{CLAIM_VERSION,SekyroConnectError,createConnector,evaluateGate,memoryStore,mergeClaim,parseClaim};
@@ -1 +1 @@
1
- "use strict";var __defProp=Object.defineProperty;var __getOwnPropDesc=Object.getOwnPropertyDescriptor;var __getOwnPropNames=Object.getOwnPropertyNames;var __hasOwnProp=Object.prototype.hasOwnProperty;var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:!0})},__copyProps=(to,from,except,desc)=>{if(from&&typeof from=="object"||typeof from=="function")for(let key of __getOwnPropNames(from))!__hasOwnProp.call(to,key)&&key!==except&&__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable});return to};var __toCommonJS=mod=>__copyProps(__defProp({},"__esModule",{value:!0}),mod);var next_exports={};__export(next_exports,{gateRoute:()=>gateRoute,sekyroGate:()=>sekyroGate});module.exports=__toCommonJS(next_exports);var KNOWN_FLAGS=["face_mismatch","duplicate","revoked"];function isRecord(v){return typeof v=="object"&&v!==null&&!Array.isArray(v)}function isFiniteNumber(v){return typeof v=="number"&&Number.isFinite(v)}function build(c){let out={v:1,level:c.level,assurance:c.assurance,verified_at:c.verified_at};c.rechecked_at!==void 0&&(out.rechecked_at=c.rechecked_at),out.session_id=c.session_id,c.subject_id!==void 0&&(out.subject_id=c.subject_id),out.env=c.env;let flags=new Set;for(let f of c.flags??[])KNOWN_FLAGS.includes(f)&&flags.add(f);return flags.size>0&&(out.flags=[...flags].sort()),out}function parseClaim(value){let v=value;if(typeof v=="string")try{v=JSON.parse(v)}catch{return null}if(!isRecord(v)||!isFiniteNumber(v.v))return null;if(v.v>1)return v;if(v.v!==1)return null;let level=v.level;return level!==0&&level!==1&&level!==2&&level!==3||typeof v.assurance!="string"||!isFiniteNumber(v.verified_at)||typeof v.session_id!="string"||v.env!=="live"&&v.env!=="sandbox"?null:build({level,assurance:v.assurance,verified_at:v.verified_at,rechecked_at:isFiniteNumber(v.rechecked_at)?v.rechecked_at:void 0,session_id:v.session_id,subject_id:typeof v.subject_id=="string"?v.subject_id:void 0,env:v.env,flags:Array.isArray(v.flags)?v.flags:void 0})}var DEFAULT_DENY_FLAGS=["revoked","face_mismatch"],fail=(reason,action,claim)=>({ok:!1,reason,action,claim});function evaluateGate(claim,policy,nowSec=Math.floor(Date.now()/1e3)){let parsed=parseClaim(claim);if(!parsed)return fail("no_claim","verify",null);if(parsed.v>1)return fail("unsupported_version","verify",parsed);if(policy.env!==void 0&&parsed.env!==policy.env)return fail("wrong_env","verify",parsed);let deny=policy.denyFlags??DEFAULT_DENY_FLAGS;return parsed.flags?.some(f=>deny.includes(f))?fail("flagged","block",parsed):parsed.level<policy.level?fail("level_too_low",parsed.level>=1?"step_up":"verify",parsed):policy.maxAgeDays!==void 0&&nowSec-parsed.verified_at>policy.maxAgeDays*86400?fail("stale","recheck",parsed):policy.maxRecheckAgeMinutes!==void 0&&nowSec-(parsed.rechecked_at??parsed.verified_at)>policy.maxRecheckAgeMinutes*60?fail("recheck_stale","recheck",parsed):policy.assurance&&!policy.assurance.includes(parsed.assurance)?fail("assurance_not_allowed","step_up",parsed):{ok:!0,claim:parsed}}function sekyroGate(source,tokenClaims,policy){let claims=tokenClaims??{};if("gate"in source)return source.gate(claims,policy);let effective=source.env!==void 0&&policy.env===void 0?{...policy,env:source.env}:policy;return evaluateGate(source.provider.readClaimFromToken(claims),effective)}function gateRoute(result,routes){if(result.ok)return null;switch(result.action){case"verify":return routes.verify;case"step_up":return routes.stepUp;case"recheck":return routes.recheck;case"block":return routes.block}}0&&(module.exports={gateRoute,sekyroGate});
1
+ "use strict";var __defProp=Object.defineProperty;var __getOwnPropDesc=Object.getOwnPropertyDescriptor;var __getOwnPropNames=Object.getOwnPropertyNames;var __hasOwnProp=Object.prototype.hasOwnProperty;var __export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:!0})},__copyProps=(to,from,except,desc)=>{if(from&&typeof from=="object"||typeof from=="function")for(let key of __getOwnPropNames(from))!__hasOwnProp.call(to,key)&&key!==except&&__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable});return to};var __toCommonJS=mod=>__copyProps(__defProp({},"__esModule",{value:!0}),mod);var next_exports={};__export(next_exports,{gateRoute:()=>gateRoute,sekyroGate:()=>sekyroGate});module.exports=__toCommonJS(next_exports);var KNOWN_FLAGS=["face_mismatch","duplicate","revoked"];function canonicalId(id){return id.replace(/^(ses|per)_/,"")}function isRecord(v){return typeof v=="object"&&v!==null&&!Array.isArray(v)}function isFiniteNumber(v){return typeof v=="number"&&Number.isFinite(v)}function build(c){let out={v:1,level:c.level,assurance:c.assurance,verified_at:c.verified_at};c.rechecked_at!==void 0&&(out.rechecked_at=c.rechecked_at),out.session_id=c.session_id,c.subject_id!==void 0&&(out.subject_id=canonicalId(c.subject_id)),out.env=c.env;let flags=new Set;for(let f of c.flags??[])KNOWN_FLAGS.includes(f)&&flags.add(f);return flags.size>0&&(out.flags=[...flags].sort()),out}function parseClaim(value){let v=value;if(typeof v=="string")try{v=JSON.parse(v)}catch{return null}if(!isRecord(v)||!isFiniteNumber(v.v))return null;if(v.v>1)return v;if(v.v!==1)return null;let level=v.level;return level!==0&&level!==1&&level!==2&&level!==3||typeof v.assurance!="string"||!isFiniteNumber(v.verified_at)||typeof v.session_id!="string"||v.env!=="live"&&v.env!=="sandbox"?null:build({level,assurance:v.assurance,verified_at:v.verified_at,rechecked_at:isFiniteNumber(v.rechecked_at)?v.rechecked_at:void 0,session_id:v.session_id,subject_id:typeof v.subject_id=="string"?v.subject_id:void 0,env:v.env,flags:Array.isArray(v.flags)?v.flags:void 0})}var DEFAULT_DENY_FLAGS=["revoked","face_mismatch"],fail=(reason,action,claim)=>({ok:!1,reason,action,claim});function evaluateGate(claim,policy,nowSec=Math.floor(Date.now()/1e3)){let parsed=parseClaim(claim);if(!parsed)return fail("no_claim","verify",null);if(parsed.v>1)return fail("unsupported_version","verify",parsed);if(policy.env!==void 0&&parsed.env!==policy.env)return fail("wrong_env","verify",parsed);let deny=policy.denyFlags??DEFAULT_DENY_FLAGS;return parsed.flags?.some(f=>deny.includes(f))?fail("flagged","block",parsed):parsed.level<policy.level?fail("level_too_low",parsed.level>=1?"step_up":"verify",parsed):policy.maxAgeDays!==void 0&&nowSec-parsed.verified_at>policy.maxAgeDays*86400?fail("stale","recheck",parsed):policy.maxRecheckAgeMinutes!==void 0&&nowSec-(parsed.rechecked_at??parsed.verified_at)>policy.maxRecheckAgeMinutes*60?fail("recheck_stale","recheck",parsed):policy.assurance&&!policy.assurance.includes(parsed.assurance)?fail("assurance_not_allowed","step_up",parsed):{ok:!0,claim:parsed}}function sekyroGate(source,tokenClaims,policy){let claims=tokenClaims??{};if("gate"in source)return source.gate(claims,policy);let effective=source.env!==void 0&&policy.env===void 0?{...policy,env:source.env}:policy;return evaluateGate(source.provider.readClaimFromToken(claims),effective)}function gateRoute(result,routes){if(result.ok)return null;switch(result.action){case"verify":return routes.verify;case"step_up":return routes.stepUp;case"recheck":return routes.recheck;case"block":return routes.block}}0&&(module.exports={gateRoute,sekyroGate});
@@ -1,5 +1,5 @@
1
- import { a as GateResult, C as Connector, P as ProviderAdapter, G as GatePolicy } from '../../connector-C4NuetEm.cjs';
2
- import '../../client-Hkxwn6ZA.cjs';
1
+ import { a as GateResult, C as Connector, P as ProviderAdapter, G as GatePolicy } from '../../connector-C0M4NWwZ.cjs';
2
+ import '../../client-edr9f2Ec.cjs';
3
3
 
4
4
  /**
5
5
  * `@sekyro/node/connect/next`: gate helpers for Next.js middleware, route
@@ -1,5 +1,5 @@
1
- import { a as GateResult, C as Connector, P as ProviderAdapter, G as GatePolicy } from '../../connector-BInF_yHb.js';
2
- import '../../client-Hkxwn6ZA.js';
1
+ import { a as GateResult, C as Connector, P as ProviderAdapter, G as GatePolicy } from '../../connector-DKP_ebGH.js';
2
+ import '../../client-edr9f2Ec.js';
3
3
 
4
4
  /**
5
5
  * `@sekyro/node/connect/next`: gate helpers for Next.js middleware, route
@@ -1 +1 @@
1
- import{gateRoute,sekyroGate}from"../../chunk-TAPXGI3Q.js";import"../../chunk-O5GJ3YJV.js";export{gateRoute,sekyroGate};
1
+ import{gateRoute,sekyroGate}from"../../chunk-SZQEL3LK.js";import"../../chunk-D53NUEJ6.js";export{gateRoute,sekyroGate};
@@ -1,4 +1,4 @@
1
- import { W as WebhookEventType, L as Locale, C as CreatedSession, S as Sekyro, F as FetchLike } from './client-Hkxwn6ZA.cjs';
1
+ import { W as WebhookEventType, L as Locale, C as CreatedSession, S as Sekyro, F as FetchLike } from './client-edr9f2Ec.cjs';
2
2
 
3
3
  /**
4
4
  * The Sekyro claim contract and its only state machine, `mergeClaim` (spec
@@ -47,7 +47,8 @@ interface SekyroClaim {
47
47
  */
48
48
  interface VerificationResultInput {
49
49
  sessionId: string;
50
- outcome: "approved" | "rejected" | "review" | null;
50
+ /** `superseded` (a newer attempt took the review over) is never approved: the claim stays as it was. */
51
+ outcome: "approved" | "rejected" | "review" | "superseded" | null;
51
52
  level: 0 | 1 | 2 | 3 | null;
52
53
  assurance: string | null;
53
54
  /** ISO 8601. */
@@ -272,16 +273,21 @@ type ConnectorLogEvent = {
272
273
  };
273
274
  /**
274
275
  * Passed to {@link ConnectorOptions.onRevocationUnresolved}: Sekyro revoked or
275
- * deleted a subject and the connector found no user to clear the claim on.
276
+ * deleted a person and the connector found no user to clear the claim on.
276
277
  * Ids only: never provider data, a claim body or a token.
277
278
  * @public
278
279
  */
279
280
  interface RevocationUnresolvedEvent {
280
- /** The Sekyro subject that was revoked or deleted. */
281
+ /** The Sekyro person that was revoked or deleted, bare (24 hexadecimal characters). */
281
282
  subjectId: string;
283
+ /** The same person as `per_...`. */
284
+ personId: string;
282
285
  /** The provider adapter's name, for example `zitadel` or `supabase`. */
283
286
  provider: string;
284
- /** `revoked` for `subject.updated` with status `revoked`, `deleted` for `subject.deleted`. */
287
+ /**
288
+ * `revoked` for `person.updated` (or `subject.updated`) with status
289
+ * `revoked`, `deleted` for `person.deleted` (or `subject.deleted`).
290
+ */
285
291
  reason: "revoked" | "deleted";
286
292
  }
287
293
  /** Options of {@link createConnector}. @public */
@@ -296,9 +302,9 @@ interface ConnectorOptions {
296
302
  webhookSecret: string;
297
303
  /** Where the claim is stored. */
298
304
  provider: ProviderAdapter;
299
- /** What {@link Connector.userDeleted} does with the person's subjects. Default `ignore`. */
305
+ /** What {@link Connector.userDeleted} does with the user's Sekyro people. Default `ignore`. */
300
306
  onUserDeleted?: "ignore" | "revoke" | "delete";
301
- /** Delivery de-duplication and the subject-to-user map. Default {@link memoryStore}. */
307
+ /** Delivery de-duplication and the person-to-user map. Default {@link memoryStore}. */
302
308
  store?: ConnectorStore;
303
309
  /** Refuse to write a terminal webhook without a result token. Default `false`. */
304
310
  requireResultToken?: boolean;
@@ -313,9 +319,9 @@ interface ConnectorOptions {
313
319
  /** Receives every {@link ConnectorLogEvent}; the connector never writes to the console. */
314
320
  logger?: (event: ConnectorLogEvent) => void;
315
321
  /**
316
- * Called when Sekyro revokes or deletes a subject and the connector cannot
322
+ * Called when Sekyro revokes or deletes a person and the connector cannot
317
323
  * find the user (no `externalRefs`, no store entry), so no claim was
318
- * cleared. Find the user for `event.subjectId` and remove their access.
324
+ * cleared. Find the user for `event.personId` and remove their access.
319
325
  * Runs after the `revocation_unresolved` log line and telemetry event, in the
320
326
  * background: the webhook does not wait for it, and a throw or rejection is
321
327
  * caught and reported to `logger` as `revocation_handler_failed`.
@@ -326,7 +332,7 @@ interface ConnectorOptions {
326
332
  * Default `true`: every API call carries the `x-sekyro-connector` header
327
333
  * (`<provider>/<version>`), and after each claim write (and each
328
334
  * `revocation_unresolved`) the connector posts an event with ids only (type,
329
- * provider, session id, subject id, time; never the claim, a token or user
335
+ * provider, session id, person id, time; never the claim, a token or user
330
336
  * data), in the background with a 2-second timeout and no retry. Only the
331
337
  * six Sekyro provider packages send it. `false` sends neither.
332
338
  */
@@ -383,15 +389,18 @@ interface Connector {
383
389
  claim: SekyroClaim | null;
384
390
  rule: MergeRule;
385
391
  }>;
386
- /** Create a verification session for your user (`subject.externalRef` = `userId`). */
392
+ /** Create a verification session for your user (`person.externalRef` = `userId`). */
387
393
  start(userId: string, opts?: StartOptions): Promise<CreatedSession>;
388
- /** Create a re-check session for your user's subject. */
394
+ /** Create a re-check session for your user's Sekyro person. */
389
395
  recheck(userId: string, opts?: Omit<StartOptions, "flow">): Promise<CreatedSession>;
390
- /** Create a step-up session for your user's subject with an identity flow. */
396
+ /** Create a step-up session for your user's Sekyro person with an identity flow. */
391
397
  stepUp(userId: string, opts: StartOptions & {
392
398
  flow: string;
393
399
  }): Promise<CreatedSession>;
394
- /** Your app deleted the user: apply the `onUserDeleted` policy to the person's subjects. */
400
+ /**
401
+ * Your app deleted the user: apply the `onUserDeleted` policy to every
402
+ * Sekyro person carrying the user's id. `subjects` is how many it touched.
403
+ */
395
404
  userDeleted(userId: string): Promise<{
396
405
  policy: "ignore" | "revoke" | "delete";
397
406
  subjects: number;
@@ -1,4 +1,4 @@
1
- import { W as WebhookEventType, L as Locale, C as CreatedSession, S as Sekyro, F as FetchLike } from './client-Hkxwn6ZA.js';
1
+ import { W as WebhookEventType, L as Locale, C as CreatedSession, S as Sekyro, F as FetchLike } from './client-edr9f2Ec.js';
2
2
 
3
3
  /**
4
4
  * The Sekyro claim contract and its only state machine, `mergeClaim` (spec
@@ -47,7 +47,8 @@ interface SekyroClaim {
47
47
  */
48
48
  interface VerificationResultInput {
49
49
  sessionId: string;
50
- outcome: "approved" | "rejected" | "review" | null;
50
+ /** `superseded` (a newer attempt took the review over) is never approved: the claim stays as it was. */
51
+ outcome: "approved" | "rejected" | "review" | "superseded" | null;
51
52
  level: 0 | 1 | 2 | 3 | null;
52
53
  assurance: string | null;
53
54
  /** ISO 8601. */
@@ -272,16 +273,21 @@ type ConnectorLogEvent = {
272
273
  };
273
274
  /**
274
275
  * Passed to {@link ConnectorOptions.onRevocationUnresolved}: Sekyro revoked or
275
- * deleted a subject and the connector found no user to clear the claim on.
276
+ * deleted a person and the connector found no user to clear the claim on.
276
277
  * Ids only: never provider data, a claim body or a token.
277
278
  * @public
278
279
  */
279
280
  interface RevocationUnresolvedEvent {
280
- /** The Sekyro subject that was revoked or deleted. */
281
+ /** The Sekyro person that was revoked or deleted, bare (24 hexadecimal characters). */
281
282
  subjectId: string;
283
+ /** The same person as `per_...`. */
284
+ personId: string;
282
285
  /** The provider adapter's name, for example `zitadel` or `supabase`. */
283
286
  provider: string;
284
- /** `revoked` for `subject.updated` with status `revoked`, `deleted` for `subject.deleted`. */
287
+ /**
288
+ * `revoked` for `person.updated` (or `subject.updated`) with status
289
+ * `revoked`, `deleted` for `person.deleted` (or `subject.deleted`).
290
+ */
285
291
  reason: "revoked" | "deleted";
286
292
  }
287
293
  /** Options of {@link createConnector}. @public */
@@ -296,9 +302,9 @@ interface ConnectorOptions {
296
302
  webhookSecret: string;
297
303
  /** Where the claim is stored. */
298
304
  provider: ProviderAdapter;
299
- /** What {@link Connector.userDeleted} does with the person's subjects. Default `ignore`. */
305
+ /** What {@link Connector.userDeleted} does with the user's Sekyro people. Default `ignore`. */
300
306
  onUserDeleted?: "ignore" | "revoke" | "delete";
301
- /** Delivery de-duplication and the subject-to-user map. Default {@link memoryStore}. */
307
+ /** Delivery de-duplication and the person-to-user map. Default {@link memoryStore}. */
302
308
  store?: ConnectorStore;
303
309
  /** Refuse to write a terminal webhook without a result token. Default `false`. */
304
310
  requireResultToken?: boolean;
@@ -313,9 +319,9 @@ interface ConnectorOptions {
313
319
  /** Receives every {@link ConnectorLogEvent}; the connector never writes to the console. */
314
320
  logger?: (event: ConnectorLogEvent) => void;
315
321
  /**
316
- * Called when Sekyro revokes or deletes a subject and the connector cannot
322
+ * Called when Sekyro revokes or deletes a person and the connector cannot
317
323
  * find the user (no `externalRefs`, no store entry), so no claim was
318
- * cleared. Find the user for `event.subjectId` and remove their access.
324
+ * cleared. Find the user for `event.personId` and remove their access.
319
325
  * Runs after the `revocation_unresolved` log line and telemetry event, in the
320
326
  * background: the webhook does not wait for it, and a throw or rejection is
321
327
  * caught and reported to `logger` as `revocation_handler_failed`.
@@ -326,7 +332,7 @@ interface ConnectorOptions {
326
332
  * Default `true`: every API call carries the `x-sekyro-connector` header
327
333
  * (`<provider>/<version>`), and after each claim write (and each
328
334
  * `revocation_unresolved`) the connector posts an event with ids only (type,
329
- * provider, session id, subject id, time; never the claim, a token or user
335
+ * provider, session id, person id, time; never the claim, a token or user
330
336
  * data), in the background with a 2-second timeout and no retry. Only the
331
337
  * six Sekyro provider packages send it. `false` sends neither.
332
338
  */
@@ -383,15 +389,18 @@ interface Connector {
383
389
  claim: SekyroClaim | null;
384
390
  rule: MergeRule;
385
391
  }>;
386
- /** Create a verification session for your user (`subject.externalRef` = `userId`). */
392
+ /** Create a verification session for your user (`person.externalRef` = `userId`). */
387
393
  start(userId: string, opts?: StartOptions): Promise<CreatedSession>;
388
- /** Create a re-check session for your user's subject. */
394
+ /** Create a re-check session for your user's Sekyro person. */
389
395
  recheck(userId: string, opts?: Omit<StartOptions, "flow">): Promise<CreatedSession>;
390
- /** Create a step-up session for your user's subject with an identity flow. */
396
+ /** Create a step-up session for your user's Sekyro person with an identity flow. */
391
397
  stepUp(userId: string, opts: StartOptions & {
392
398
  flow: string;
393
399
  }): Promise<CreatedSession>;
394
- /** Your app deleted the user: apply the `onUserDeleted` policy to the person's subjects. */
400
+ /**
401
+ * Your app deleted the user: apply the `onUserDeleted` policy to every
402
+ * Sekyro person carrying the user's id. `subjects` is how many it touched.
403
+ */
395
404
  userDeleted(userId: string): Promise<{
396
405
  policy: "ignore" | "revoke" | "delete";
397
406
  subjects: number;