@everfur/sdk 0.1.1 → 0.4.0

package/dist/notifications/index.js

@@ -0,0 +1,2 @@
+import {createContext,useMemo,useEffect,useContext,useState,useRef,useCallback}from'react';import {AppState}from'react-native';var Ge=Object.defineProperty;var n=(e,t)=>Ge(e,"name",{value:t,configurable:true});function T(e,t){return Object.freeze(t===void 0?{ok:true,value:e}:{ok:true,value:e,warning:t})}n(T,"ok");function u(e){return Object.freeze({ok:false,error:e})}n(u,"err");var j=class j extends Error{constructor(t,r){super(r),this.name="EverfurConfigError",this.kind=t,Object.setPrototypeOf(this,j.prototype);}};n(j,"EverfurConfigError");var P=j;var V=Object.freeze([Object.freeze({wireCode:"AccessDeniedException",envelope:"http_envelope",httpStatus:403,retryable:false}),Object.freeze({wireCode:"AuthorizationException",envelope:"http_envelope",httpStatus:401,retryable:false}),Object.freeze({wireCode:"ConflictException",envelope:"http_envelope",httpStatus:409,retryable:true}),Object.freeze({wireCode:"DAILY_QUOTA_EXCEEDED",envelope:"http_envelope",httpStatus:429,retryable:true}),Object.freeze({wireCode:"FILE_TOO_LARGE",envelope:"http_envelope",httpStatus:400,retryable:false}),Object.freeze({wireCode:"IDEMPOTENCY_KEY_IN_FLIGHT",envelope:"http_envelope",httpStatus:409,retryable:true}),Object.freeze({wireCode:"IDEMPOTENCY_KEY_REUSED_DIFFERENT_REQUEST",envelope:"http_envelope",httpStatus:409,retryable:false}),Object.freeze({wireCode:"INVALID_CONTENT_TYPE",envelope:"http_envelope",httpStatus:400,retryable:false}),Object.freeze({wireCode:"InternalFailureException",envelope:"http_envelope",httpStatus:500,retryable:true}),Object.freeze({wireCode:"MethodNotAllowedException",envelope:"http_envelope",httpStatus:405,retryable:false}),Object.freeze({wireCode:"NotImplementedException",envelope:"http_envelope",httpStatus:501,retryable:false}),Object.freeze({wireCode:"PaymentRequiredException",envelope:"http_envelope",httpStatus:402,retryable:false}),Object.freeze({wireCode:"ResourceNotFoundException",envelope:"http_envelope",httpStatus:404,retryable:false}),Object.freeze({wireCode:"ServiceUnavailableException",envelope:"http_envelope",httpStatus:503,retryable:true}),Object.freeze({wireCode:"TIER_UPGRADE_REQUIRED",envelope:"http_envelope",httpStatus:402,retryable:false}),Object.freeze({wireCode:"ThrottlingException",envelope:"http_envelope",httpStatus:429,retryable:true}),Object.freeze({wireCode:"ValidationException",envelope:"http_envelope",httpStatus:400,retryable:false}),Object.freeze({wireCode:"accessDenied",envelope:"http_envelope",httpStatus:403,retryable:false}),Object.freeze({wireCode:"access_denied",envelope:"oauth_error",httpStatus:302,retryable:false}),Object.freeze({wireCode:"attachment_unreadable",envelope:"http_envelope",httpStatus:400,retryable:false}),Object.freeze({wireCode:"authExpired",envelope:"http_envelope",httpStatus:401,retryable:true}),Object.freeze({wireCode:"authRejected",envelope:"http_envelope",httpStatus:401,retryable:false}),Object.freeze({wireCode:"consent_invalid",envelope:"http_envelope",httpStatus:422,retryable:false}),Object.freeze({wireCode:"consent_required",envelope:"http_envelope",httpStatus:422,retryable:false}),Object.freeze({wireCode:"consent_scope_wrong_route",envelope:"http_envelope",httpStatus:400,retryable:false}),Object.freeze({wireCode:"device_cipher_unavailable",envelope:"http_envelope",httpStatus:503,retryable:true}),Object.freeze({wireCode:"email_invalid",envelope:"http_envelope",httpStatus:422,retryable:false}),Object.freeze({wireCode:"event_cursor_invalid",envelope:"http_envelope",httpStatus:400,retryable:false}),Object.freeze({wireCode:"event_filter_invalid",envelope:"http_envelope",httpStatus:400,retryable:false}),Object.freeze({wireCode:"event_payload_invalid",envelope:"http_envelope",httpStatus:400,retryable:false}),Object.freeze({wireCode:"event_type_not_available",envelope:"http_envelope",httpStatus:400,retryable:false}),Object.freeze({wireCode:"event_type_unknown",envelope:"http_envelope",httpStatus:400,retryable:false}),Object.freeze({wireCode:"idempotency_key_invalid",envelope:"http_envelope",httpStatus:400,retryable:false}),Object.freeze({wireCode:"idempotency_key_required",envelope:"http_envelope",httpStatus:400,retryable:false}),Object.freeze({wireCode:"idempotency_key_reused",envelope:"http_envelope",httpStatus:409,retryable:false}),Object.freeze({wireCode:"insufficientCapability",envelope:"http_envelope",httpStatus:403,retryable:false}),Object.freeze({wireCode:"insufficient_scope",envelope:"http_envelope",httpStatus:403,retryable:false}),Object.freeze({wireCode:"internal_error",envelope:"sse_frame",httpStatus:200,retryable:false}),Object.freeze({wireCode:"invalidRequest",envelope:"http_envelope",httpStatus:400,retryable:false}),Object.freeze({wireCode:"invalid_client",envelope:"oauth_error",httpStatus:401,retryable:false}),Object.freeze({wireCode:"invalid_client_metadata",envelope:"oauth_error",httpStatus:400,retryable:false}),Object.freeze({wireCode:"invalid_grant",envelope:"oauth_error",httpStatus:400,retryable:false}),Object.freeze({wireCode:"invalid_redirect_uri",envelope:"oauth_error",httpStatus:400,retryable:false}),Object.freeze({wireCode:"invalid_request",envelope:"oauth_error",httpStatus:400,retryable:false}),Object.freeze({wireCode:"invalid_scope",envelope:"oauth_error",httpStatus:400,retryable:false}),Object.freeze({wireCode:"invalid_target",envelope:"oauth_error",httpStatus:400,retryable:false}),Object.freeze({wireCode:"mcp_connection_not_found",envelope:"http_envelope",httpStatus:404,retryable:false}),Object.freeze({wireCode:"mcp_request_conflict",envelope:"http_envelope",httpStatus:409,retryable:false}),Object.freeze({wireCode:"mcp_request_gone",envelope:"http_envelope",httpStatus:410,retryable:false}),Object.freeze({wireCode:"mcp_request_not_found",envelope:"http_envelope",httpStatus:404,retryable:false}),Object.freeze({wireCode:"not_found",envelope:"sse_frame",httpStatus:200,retryable:false}),Object.freeze({wireCode:"partner_visit_link_conflict",envelope:"http_envelope",httpStatus:409,retryable:false}),Object.freeze({wireCode:"partner_visit_owner_only",envelope:"http_envelope",httpStatus:403,retryable:false}),Object.freeze({wireCode:"partner_visit_pet_already_mapped",envelope:"http_envelope",httpStatus:409,retryable:false}),Object.freeze({wireCode:"payload_too_large",envelope:"http_envelope",httpStatus:413,retryable:false}),Object.freeze({wireCode:"petRefInUse",envelope:"http_envelope",httpStatus:409,retryable:false}),Object.freeze({wireCode:"pet_health_list_removals_unconfirmed",envelope:"http_envelope",httpStatus:422,retryable:false}),Object.freeze({wireCode:"pet_health_species_unsupported",envelope:"http_envelope",httpStatus:422,retryable:false}),Object.freeze({wireCode:"pet_not_registered",envelope:"http_envelope",httpStatus:404,retryable:false}),Object.freeze({wireCode:"provider_unsupported",envelope:"http_envelope",httpStatus:422,retryable:false}),Object.freeze({wireCode:"rateLimited",envelope:"http_envelope",httpStatus:429,retryable:true}),Object.freeze({wireCode:"record_species_unsupported",envelope:"http_envelope",httpStatus:422,retryable:false}),Object.freeze({wireCode:"record_subject_not_found",envelope:"http_envelope",httpStatus:404,retryable:false}),Object.freeze({wireCode:"record_upload_invalid",envelope:"http_envelope",httpStatus:400,retryable:false}),Object.freeze({wireCode:"records_consent_required",envelope:"http_envelope",httpStatus:409,retryable:false}),Object.freeze({wireCode:"sandbox_only",envelope:"http_envelope",httpStatus:403,retryable:false}),Object.freeze({wireCode:"session_required",envelope:"http_envelope",httpStatus:403,retryable:false}),Object.freeze({wireCode:"share_limit_reached",envelope:"http_envelope",httpStatus:429,retryable:false}),Object.freeze({wireCode:"slow_down",envelope:"oauth_error",httpStatus:429,retryable:true}),Object.freeze({wireCode:"species_unsupported",envelope:"http_envelope",httpStatus:422,retryable:false}),Object.freeze({wireCode:"tenant_filter_invalid",envelope:"http_envelope",httpStatus:400,retryable:false}),Object.freeze({wireCode:"tenant_has_no_capabilities",envelope:"http_envelope",httpStatus:409,retryable:false}),Object.freeze({wireCode:"tenant_resource_not_found",envelope:"http_envelope",httpStatus:404,retryable:false}),Object.freeze({wireCode:"tenant_surface_not_enabled",envelope:"http_envelope",httpStatus:409,retryable:false}),Object.freeze({wireCode:"timeout",envelope:"sse_frame",httpStatus:200,retryable:true}),Object.freeze({wireCode:"token_invalid",envelope:"http_envelope",httpStatus:422,retryable:false}),Object.freeze({wireCode:"unavailable",envelope:"sse_frame",httpStatus:200,retryable:true}),Object.freeze({wireCode:"unavailable",envelope:"http_envelope",httpStatus:503,retryable:true}),Object.freeze({wireCode:"unsupported_grant_type",envelope:"oauth_error",httpStatus:400,retryable:false}),Object.freeze({wireCode:"unsupported_response_type",envelope:"oauth_error",httpStatus:302,retryable:false}),Object.freeze({wireCode:"verify_mint_rate_limited",envelope:"http_envelope",httpStatus:429,retryable:true}),Object.freeze({wireCode:"verify_mint_refused",envelope:"http_envelope",httpStatus:403,retryable:false}),Object.freeze({wireCode:"verify_mint_unavailable",envelope:"http_envelope",httpStatus:503,retryable:true}),Object.freeze({wireCode:"verify_user_ref_invalid",envelope:"http_envelope",httpStatus:422,retryable:false}),Object.freeze({wireCode:"webhook_endpoint_update_empty",envelope:"http_envelope",httpStatus:400,retryable:false}),Object.freeze({wireCode:"webhook_endpoint_update_invalid",envelope:"http_envelope",httpStatus:400,retryable:false}),Object.freeze({wireCode:"webhook_url_rejected",envelope:"http_envelope",httpStatus:400,retryable:false})]);Object.freeze(V.map(e=>e.wireCode));var We=Object.freeze({ValidationException:"validationFailed",AuthorizationException:"authRejected",PaymentRequiredException:"paymentRequired",AccessDeniedException:"accessDenied",ResourceNotFoundException:"resourceNotFound",ConflictException:"conflict",ThrottlingException:"rateLimited",InternalFailureException:"internalError",NotImplementedException:"notImplemented",ServiceUnavailableException:"serviceUnavailable",MethodNotAllowedException:"validationFailed",authExpired:"authExpired",unavailable:"serviceUnavailable",session_required:"sessionRequired",accessDenied:"accessDenied",invalidRequest:"sdkUpdateRequired",authRejected:"authRejected",rateLimited:"rateLimited",insufficientCapability:"accessDenied",event_cursor_invalid:"validationFailed",event_filter_invalid:"validationFailed",event_payload_invalid:"validationFailed",event_type_unknown:"validationFailed",idempotency_key_invalid:"validationFailed",idempotency_key_required:"validationFailed",idempotency_key_reused:"idempotencyConflict",payload_too_large:"validationFailed",webhook_url_rejected:"validationFailed",webhook_endpoint_update_empty:"validationFailed",webhook_endpoint_update_invalid:"validationFailed",event_type_not_available:"conflict",record_subject_not_found:"resourceNotFound",records_consent_required:"conflict",record_species_unsupported:"validationFailed",record_upload_invalid:"validationFailed",FILE_TOO_LARGE:"validationFailed",INVALID_CONTENT_TYPE:"validationFailed",attachment_unreadable:"validationFailed",provider_unsupported:"validationFailed",token_invalid:"validationFailed",device_cipher_unavailable:"serviceUnavailable",email_invalid:"validationFailed",consent_required:"validationFailed",consent_invalid:"validationFailed",consent_scope_wrong_route:"validationFailed",IDEMPOTENCY_KEY_IN_FLIGHT:"idempotencyInFlight",IDEMPOTENCY_KEY_REUSED_DIFFERENT_REQUEST:"idempotencyConflict",DAILY_QUOTA_EXCEEDED:"quotaExceeded",TIER_UPGRADE_REQUIRED:"paymentRequired",not_found:"conversationNotFound",timeout:"streamTimeout",internal_error:"internalError",invalid_request:"validationFailed",invalid_client:"authRejected",invalid_grant:"authRejected",unsupported_grant_type:"validationFailed",invalid_scope:"validationFailed",invalid_target:"validationFailed",invalid_redirect_uri:"validationFailed",invalid_client_metadata:"validationFailed",unsupported_response_type:"validationFailed",access_denied:"accessDenied",slow_down:"rateLimited",mcp_request_not_found:"resourceNotFound",mcp_request_gone:"resourceNotFound",mcp_connection_not_found:"resourceNotFound",mcp_request_conflict:"conflict",sandbox_only:"accessDenied",tenant_has_no_capabilities:"conflict",verify_mint_refused:"accessDenied",verify_mint_rate_limited:"rateLimited",verify_mint_unavailable:"serviceUnavailable",verify_user_ref_invalid:"validationFailed",insufficient_scope:"accessDenied",tenant_filter_invalid:"validationFailed",tenant_resource_not_found:"resourceNotFound",tenant_surface_not_enabled:"conflict",pet_health_species_unsupported:"validationFailed",pet_health_list_removals_unconfirmed:"validationFailed",petRefInUse:"conflict",share_limit_reached:"conflict",pet_not_registered:"resourceNotFound",species_unsupported:"validationFailed",partner_visit_owner_only:"accessDenied",partner_visit_link_conflict:"conflict",partner_visit_pet_already_mapped:"conflict"}),ae=Object.freeze(V.map(e=>Object.freeze({wireCode:e.wireCode,envelope:e.envelope,retryable:e.retryable,normalized:We[e.wireCode]}))),$e=new Map(ae.map(e=>[e.envelope+e.wireCode.toUpperCase(),e])),Qe=Object.freeze(["http_envelope",...[...new Set(ae.map(e=>e.envelope))].filter(e=>e!=="http_envelope").sort()]);function z(e,t){if(typeof e!="string")return;let r=e.trim().toUpperCase();if(r.length!==0)for(let o of [t??"http_envelope",...Qe]){let i=$e.get(o+r);if(i)return i}}n(z,"contractErrorFor");function Xe(e){return e.envelope==="sse_frame"?`/errors#sse-${e.wireCode}`:e.envelope==="oauth_error"?`/errors#oauth-${e.wireCode}`:`/errors#${e.wireCode}`}n(Xe,"contractDocUrl");function se(e){return null}n(se,"publishedDocUrl");var Je=Object.freeze({authExpired:"authentication",authRejected:"authentication",sessionRequired:"authentication",accessDenied:"authorization",paymentRequired:"entitlement",quotaExceeded:"rateLimit",rateLimited:"rateLimit",validationFailed:"invalidRequest",sdkUpdateRequired:"invalidRequest",conversationNotFound:"notFound",petNotFound:"notFound",resourceNotFound:"notFound",conflict:"conflict",idempotencyConflict:"conflict",idempotencyInFlight:"conflict",streamTimeout:"connection",streamIncomplete:"connection",upstreamLlmTimeout:"connection",serviceUnavailable:"connection",internalError:"server",notImplemented:"server",mediaUploadFailed:"media",moderationBlocked:"policy",unknown:"unknown"});function le(e){return Je[e]}n(le,"categoryFor");function ue(e){let t=z(e);if(t)return t.normalized;let r=(e??"").trim().toUpperCase(),o=r.replace(/[^A-Z0-9]/g,"");if(o==="AUTHREJECTED")return "authRejected";if(r.startsWith("AUTH"))return "authExpired";switch(o){case "DAILYQUOTAEXCEEDED":case "QUOTAEXCEEDED":return "quotaExceeded";case "RATELIMITED":case "TOOMANYREQUESTS":return "rateLimited";case "IDEMPOTENCYKEYCONFLICT":case "IDEMPOTENCYCONFLICT":return "idempotencyConflict";case "ACCESSDENIED":case "FORBIDDEN":return "accessDenied";case "NOTFOUND":case "CONVERSATIONNOTFOUND":return "conversationNotFound";case "PETNOTFOUND":return "petNotFound";case "TIMEOUT":case "STREAMTIMEOUT":return "streamTimeout";case "MEDIAUPLOADFAILED":case "UNRECOGNIZEDVIDEOFORMAT":case "FILETOOSMALL":return "mediaUploadFailed";case "MODERATIONBLOCKED":return "moderationBlocked";case "UPSTREAMLLMTIMEOUT":return "upstreamLlmTimeout";case "INTERNALERROR":case "INTERNALSERVERERROR":return "internalError";case "STREAMINCOMPLETE":case "CHATSTREAMINCOMPLETE":return "streamIncomplete";case "INVALIDANALYSISTYPE":case "INVALIDUPLOADPURPOSE":return "unknown";default:return "unknown"}}n(ue,"fromWire");var Ze=new Set(["streamTimeout","rateLimited","internalError","upstreamLlmTimeout","streamIncomplete"]);function B(e){return Ze.has(e)}n(B,"isAutoRetryable");var et=new Set(["serviceUnavailable","conflict","idempotencyInFlight"]);function de(e){return B(e)||et.has(e)}n(de,"isRetryableCode");var tt=500,K=8e3,ce=4;function fe(e,t=Math.random){let r=Math.max(0,e),o=Math.min(tt*2**r,K);return Math.floor(t()*o)}n(fe,"backoffDelayMs");var rt=Object.freeze({authExpired:"Please sign in again to continue.",authRejected:"Please sign in again to continue.",sessionRequired:"This app needs to be updated to keep using Everfur.",accessDenied:"This feature isn't available on your account right now.",paymentRequired:"This is part of a paid plan.",quotaExceeded:"You have used today's messages. This resets tomorrow.",rateLimited:"You are sending messages quickly. Try again in a few seconds.",validationFailed:"Something in that request was not right. Check the details and try again.",sdkUpdateRequired:"This app needs to be updated to keep using Everfur.",conflict:"That is already running. Wait for it to finish, then try again.",idempotencyConflict:"That message was already delivered.",idempotencyInFlight:"That is still processing. Give it a moment.",conversationNotFound:"This conversation is no longer available.",petNotFound:"We could not find that pet. Please pick a pet and try again.",resourceNotFound:"We could not find that.",streamTimeout:"The response timed out. Tap retry to try again.",mediaUploadFailed:"We could not upload that photo. Please attach it again.",moderationBlocked:"This request cannot be answered here.",upstreamLlmTimeout:"The response timed out. Tap retry to try again.",internalError:"We hit a snag on our end. Please try again.",notImplemented:"That is not available yet.",serviceUnavailable:"That service is briefly unavailable. Try again shortly.",streamIncomplete:"The connection dropped mid-answer. Tap retry to continue.",unknown:"Something went wrong. Please try again."});function nt(e){return rt[e]}n(nt,"userFacingError");function pe(e,t,r){Object.defineProperty(e,t,{value:r,enumerable:false,writable:false,configurable:false});}n(pe,"defineHidden");var ot=/^[a-z][a-z0-9_]{0,63}$/;function E(e,t){let r=z(t?.wireCode,t?.wireEnvelope),o={code:e,category:le(e),retryable:t?.retryable??de(e),displayMessage:nt(e)};if(t?.httpStatus!==void 0&&(o.httpStatus=t.httpStatus),t?.requestId&&(o.requestId=t.requestId),typeof t?.reasonCode=="string"&&ot.test(t.reasonCode)&&(o.reasonCode=t.reasonCode),r);return t?.wireMessage&&pe(o,"wireMessage",t.wireMessage),t?.raw!==void 0&&t.raw!==null&&pe(o,"raw",t.raw),Object.freeze(o)}n(E,"makeEverfurError");function ye(e){return Object.freeze({kind:"error",terminal:true,code:e.code,retryable:e.retryable,wireMessage:e.wireMessage,synthesized:e.synthesized,lastEventId:e.lastEventId,serverRequestId:e.serverRequestId??null})}n(ye,"errorFrame");function st(e){let t={};return e.mode==="personalized"?t.authorization=`Bearer ${e.token}`:t["x-everfur-partner-key"]=e.publishableKey,e.userRef&&(t["x-everfur-user-ref"]=e.userRef),e.sessionId&&(t["x-everfur-session-id"]=e.sessionId),t}n(st,"authHeaders");function N(e,t){return {...e,headers:{...lt(e.headers),...st(t)}}}n(N,"withAuthHeaders");function lt(e){if(!e)return {};let t={};for(let[r,o]of Object.entries(e)){let i=r.toLowerCase();i==="authorization"||i==="x-everfur-partner-key"||(t[r]=o);}return t}n(lt,"stripAuthHeaders");async function ve(e,t){if(t.mode==="anonymous")return t.transport.request(N(e,{mode:"anonymous",publishableKey:t.publishableKey,userRef:t.userRef,...t.sessionId?{sessionId:t.sessionId}:{}}));let r;try{r=await t.identity.currentToken();}catch{return u(Y())}let o=await t.transport.request(N(e,{mode:"personalized",token:r,userRef:t.userRef,...t.sessionId?{sessionId:t.sessionId}:{}}));if(o.ok||o.error.httpStatus!==401)return o;let i;try{i=await t.identity.currentToken({forceRefresh:!0});}catch{return u(Y())}let a=await t.transport.request(N(e,{mode:"personalized",token:i,userRef:t.userRef,...t.sessionId?{sessionId:t.sessionId}:{}}));return !a.ok&&a.error.httpStatus===401?u(Y(a.error.httpStatus)):a}n(ve,"authedSend");function Y(e){return E("authRejected",{retryable:false,...e!==void 0?{httpStatus:e}:{}})}n(Y,"authRejectedError");function me(e){return E("internalError",{retryable:true,wireMessage:ut(e)})}n(me,"networkError");function ut(e){return e instanceof Error?e.message:typeof e=="string"?e:"network request failed"}n(ut,"describeCause");var dt=3e4,ct=K*2,ft="idempotency-key",pt=new Set(["POST","PUT","PATCH","DELETE"]),yt=Object.freeze({onEvent(){}}),vt=Object.freeze({setTimeout:n((e,t)=>setTimeout(e,t),"setTimeout"),clearTimeout:n(e=>clearTimeout(e),"clearTimeout"),now:n(()=>Date.now(),"now")});function mt(e){let t=e.trim().replace(/[^A-Za-z0-9_.:-]/g,"-");return t.length===0?null:`efs_${t}`.slice(0,128)}n(mt,"seededIdempotencyKey");function U(e){let t=e.observer??yt,r=e.timers??vt,o=e.rng??Math.random,i=e.sleep??((p,c)=>Ot(p,r,c)),a=e.maxAttempts??ce,s=e.unaryTimeoutMs??dt,l=e.newIdempotencyKey??_t(),d=n(p=>{try{t.onEvent(p);}catch{}},"emit");async function g(p,c,b){let S=b?.maxAttempts,A=Math.max(1,S??a),y=b?.idempotent??pt.has(c.method),v=b?.idempotencyKey===void 0?null:mt(b.idempotencyKey),f=y?v??l():null,m=Et(c,f),h=0;for(;;){let x=n(q=>Object.freeze({call:p,method:c.method,path:c.path,attempt:h,...f?{idempotencyKey:f}:{},...q}),"stamp");d(x({phase:"attempt"}));let ne=It(s,r),oe=kt(ne.signal,c.signal),F;try{F=await ve({...m,signal:oe.signal},e.auth);}catch(q){F=u(me(q));}finally{oe.dispose(),ne.cancel();}if(F.ok)return d(x({phase:"settled",ok:true,reason:"ok"})),F;let w=F.error,D=ht(w,h,{maxAttempts:A,rng:o,now:r.now(),aborted:c.signal?.aborted===true,...S!==void 0?{perCallMaxAttempts:S}:{},...e.errorPolicy!==void 0?{policy:e.errorPolicy}:{}}),L={ok:false,code:w.code,reason:D.reason,...w.httpStatus!==void 0?{httpStatus:w.httpStatus}:{},...w.requestId!==void 0?{requestId:w.requestId}:{}};if(!D.retry)return d(x({phase:"settled",...L})),u(w);if(d(x({phase:"retry",...L,delayMs:D.delayMs})),await i(D.delayMs,c.signal),c.signal?.aborted===true)return d(x({phase:"settled",...L,reason:"aborted"})),u(w);h+=1;}}n(g,"send");async function C(p){return N(p,await St(e.auth))}n(C,"authorize");async function*_(p,c,b){d(Object.freeze({call:p,phase:"stream.open",method:c.method,path:c.path,attempt:0}));try{yield*e.auth.transport.stream(c,b);}catch{yield ye({code:"internal_error",retryable:true,wireMessage:null,synthesized:true,lastEventId:null,serverRequestId:null});}}return n(_,"stream"),Object.freeze({send:g,authorize:C,stream:_})}n(U,"createRequestFunnel");function Et(e,t){let r={};for(let[o,i]of Object.entries(e.headers??{}))o.toLowerCase()!==ft&&(r[o]=i);return t!==null&&(r["Idempotency-Key"]=t),{...e,headers:r}}n(Et,"assembleHeaders");function _t(){let e=0;return ()=>`efk_${Date.now().toString(36)}_${(e++).toString(36)}_${Math.random().toString(36).slice(2,12)}`}n(_t,"defaultIdempotencyKeyFactory");var gt=10;function ht(e,t,r){if(r.aborted)return {retry:false,reason:"aborted"};let o=bt(e);if(o==="quota")return {retry:false,reason:"daily-quota-exhausted"};if(o!=="burst"&&!B(e.code))return {retry:false,reason:"terminal-code"};let i=o==="burst"?"burst-throttle":"retryable-code";if(n(()=>{if(r.policy===void 0)return  false;try{return !r.policy.shouldRetry(e.code,t)}catch{return  false}},"policyVetoedRetry")())return {retry:false,reason:"terminal-code"};let s=n(()=>{if(r.policy===void 0)return null;let g;try{g=r.policy.maxAttempts(e.code);}catch{return null}return typeof g!="number"||!Number.isFinite(g)?null:Math.max(1,Math.min(gt,Math.floor(g)))},"policyCeiling"),l=r.perCallMaxAttempts??s()??r.maxAttempts;if(t+1>=l)return {retry:false,reason:"attempts-exhausted"};let d=Rt(e,r.now);return d!==null?d>ct?{retry:false,reason:"server-reset-beyond-budget"}:{retry:true,reason:i,delayMs:d}:{retry:true,reason:i,delayMs:fe(t,r.rng)}}n(ht,"decideRetry");function bt(e){let t=e.code==="unknown"?ue(Tt(e.raw)):e.code;return t==="quotaExceeded"?"quota":t==="rateLimited"||e.httpStatus===429?"burst":null}n(bt,"throttleKind");function Rt(e,t){let r=wt(e.raw);if(r===null)return null;let o=r-t;return o>0?o:0}n(Rt,"retryOverrideMs");function wt(e){for(let t of _e(e)){let r=t.resets_at,o=Ct(r);if(o!==null)return o}return null}n(wt,"findResetsAt");function _e(e){if(!Ee(e))return [];let t=[e];for(let r of ["error","detail"]){let o=e[r];Ee(o)&&t.push(o);}return t}n(_e,"candidateScopes");function Ct(e){if(typeof e=="number"&&Number.isFinite(e))return e<1e11?Math.round(e*1e3):Math.round(e);if(typeof e=="string"&&e.trim().length>0){let t=Date.parse(e);return Number.isFinite(t)?t:null}return null}n(Ct,"parseInstantMs");function Tt(e){for(let t of _e(e)){let r=t.code;if(typeof r=="string"&&r.length>0)return r}return null}n(Tt,"rawWireCode");function Ee(e){return typeof e=="object"&&e!==null}n(Ee,"isRecord");async function St(e){return e.mode==="anonymous"?{mode:"anonymous",publishableKey:e.publishableKey,userRef:e.userRef,...e.sessionId?{sessionId:e.sessionId}:{}}:{mode:"personalized",token:await e.identity.currentToken(),userRef:e.userRef,...e.sessionId?{sessionId:e.sessionId}:{}}}n(St,"resolveDeviceAuth");function It(e,t){let r=new AbortController,o=t.setTimeout(()=>r.abort(),e);return {signal:r.signal,cancel:n(()=>t.clearTimeout(o),"cancel")}}n(It,"boundedSignal");function kt(e,t){let r=n(()=>{},"noop");if(!t)return {signal:e,dispose:r};let o=new AbortController;if(e.aborted||t.aborted)return o.abort(),{signal:o.signal,dispose:r};let i=n(()=>o.abort(),"onAbort");return e.addEventListener("abort",i,{once:true}),t.addEventListener("abort",i,{once:true}),{signal:o.signal,dispose:n(()=>{e.removeEventListener("abort",i),t.removeEventListener("abort",i);},"dispose")}}n(kt,"mergeSignals");function Ot(e,t,r){return e<=0||r?.aborted===true?Promise.resolve():new Promise(o=>{let i=t.setTimeout(()=>{r?.removeEventListener("abort",a),o();},e),a=n(()=>{t.clearTimeout(i),o();},"onAbort");r?.addEventListener("abort",a,{once:true});})}n(Ot,"delayAbortable");function xt(e){let t=e.raw;if(typeof t!="object"||t===null)return null;let r=t.code;return typeof r=="string"&&r.length>0?r:null}n(xt,"wireCodeOf");function ge(e,t){let r=xt(e);if(r===null)return e;let o=t[r];return o===void 0?e:E(o.code,{retryable:o.retryable,...e.httpStatus!==void 0?{httpStatus:e.httpStatus}:{},...e.requestId!==void 0?{requestId:e.requestId}:{},wireCode:r,reasonCode:r,...e.wireMessage!==void 0?{wireMessage:e.wireMessage}:{},raw:e.raw})}n(ge,"foldWireReason");var Ce=Object.freeze({provider_unsupported:"Everfur does not send through this push provider yet. Register an Expo push token (provider expo) or an FCM registration token (provider fcm); APNs direct is not available in this version.",token_invalid:"The token is not a push token of the given provider. Expo tokens look like ExponentPushToken[...]; FCM registration tokens are long opaque strings. Pass the token exactly as your notification library printed it.",device_cipher_unavailable:"Everfur could not seal the token at rest, so nothing was stored. Retry the registration later; the SDK retries it on the next launch and login.",credentials_missing:"Everfur holds no push credential for this provider on your tenant, so deliveries to it are skipped. Expo needs nothing unless you enabled push security (then your Expo access token). A bare app using FCM supplies its Firebase service-account JSON to Everfur; push credentials are set by Everfur on your tenant, never through the SDK."}),Ft=new Set(["provider_unsupported","token_invalid","device_cipher_unavailable","credentials_missing"]);function Pt(e){let t=e.reasonCode;return t!==void 0&&Ft.has(t)?Ce[t]:null}n(Pt,"explainNotificationsReason");var Te=new Set(["expo","fcm","apns"]),Se=new Set(["ios","android"]),he=4096,be=128,Re=64,Ie=/[- ]/;function R(e,t){return E("validationFailed",{retryable:false,wireMessage:e,...t?{reasonCode:t}:{}})}n(R,"invalid");function Nt(e){if(typeof e!="object"||e===null)return R("registerDevice needs an input object");let{token:t,provider:r,platform:o,installationId:i}=e;return typeof r!="string"||!Te.has(r)?R("provider must be expo, fcm or apns"):typeof o!="string"||!Se.has(o)?R("platform must be ios or android"):typeof t!="string"||t.trim().length===0||t.length>he||Ie.test(t)?R(`token must be a push token of 1..${he} characters with no whitespace`,"token_invalid"):i!==void 0&&(typeof i!="string"||i.length===0||i.length>be)?R(`installationId must be 1..${be} characters`):null}n(Nt,"validateRegister");function At(e){return typeof e!="string"||e.length===0||e.length>Re?R(`deviceId must be 1..${Re} characters`):Ie.test(e)||e.includes("/")||e==="."||e===".."?R("deviceId is not a device id"):null}n(At,"validateDeviceId");function Dt(e){if(typeof e!="object"||e===null)return R("setPreferences needs an input object");let{pushEnabled:t,emailEnabled:r}=e;return typeof t!="boolean"||typeof r!="boolean"?R("pushEnabled and emailEnabled must both be booleans: the route replaces both switches"):null}n(Dt,"validatePreferences");function I(e){return typeof e=="string"&&e.length>0?e:null}n(I,"str");function jt(e){if(typeof e!="object"||e===null)return null;let t=e,r=I(t.device_id),o=I(t.provider),i=I(t.platform),a=I(t.registered_at),s=I(t.last_seen_at);if(r===null||o===null||i===null||a===null||s===null||!Te.has(o)||!Se.has(i))return null;let l=t.installation_id;return Object.freeze({deviceId:r,provider:o,platform:i,installationId:typeof l=="string"&&l.length>0?l:null,registeredAt:a,lastSeenAt:s})}n(jt,"parseDevice");function zt(e){if(typeof e!="object"||e===null)return null;let t=e,r=I(t.updated_at);return typeof t.push_enabled!="boolean"||typeof t.email_enabled!="boolean"||r===null?null:Object.freeze({pushEnabled:t.push_enabled,emailEnabled:t.email_enabled,updatedAt:r})}n(zt,"parsePreferences");function we(e){return E("internalError",{retryable:false,wireMessage:`${e}: the response was not the documented shape`})}n(we,"malformed");var Ut=Object.freeze({provider_unsupported:{code:"validationFailed",retryable:false},token_invalid:{code:"validationFailed",retryable:false},device_cipher_unavailable:{code:"serviceUnavailable",retryable:true}});function H(e){return ge(e,Ut)}n(H,"refine");function G(e){return E("validationFailed",{retryable:false,wireMessage:`the Everfur runtime is disposed; ${e} was called after unmount`})}n(G,"disposed");function W(e){let t=n(()=>{let{services:r}=e.registry;return $({auth:r.authFor(null),...r.errorPolicy?{errorPolicy:r.errorPolicy}:{}})},"over");return {registerDevice:n((r,o)=>e.isDisposed?Promise.resolve(u(G("registerDevice"))):t().registerDevice(r,o),"registerDevice"),unregisterDevice:n((r,o)=>e.isDisposed?Promise.resolve(u(G("unregisterDevice"))):t().unregisterDevice(r,o),"unregisterDevice"),setPreferences:n((r,o)=>e.isDisposed?Promise.resolve(u(G("setPreferences"))):t().setPreferences(r,o),"setPreferences")}}n(W,"createNotificationsClient");function $(e){let t=e.funnel??U({auth:e.auth,...e.errorPolicy?{errorPolicy:e.errorPolicy}:{}}),r=n((o,i)=>i?{...o,signal:i}:o,"withSignal");return {async registerDevice(o,i){let a=Nt(o);if(a!==null)return u(a);let s={token:o.token,provider:o.provider,platform:o.platform};o.installationId!==void 0&&(s.installation_id=o.installationId);let l=await t.send("notifications.registerDevice",r({method:"POST",path:"/widget/v1/me/devices",body:s},i?.signal));if(!l.ok)return u(H(l.error));let d=jt(l.value);return d===null?u(we("registerDevice")):T(d)},async unregisterDevice(o,i){let a=At(o);if(a!==null)return u(a);let s=await t.send("notifications.unregisterDevice",r({method:"DELETE",path:`/widget/v1/me/devices/${encodeURIComponent(o)}`},i?.signal));return s.ok?T(void 0):u(H(s.error))},async setPreferences(o,i){let a=Dt(o);if(a!==null)return u(a);let s=await t.send("notifications.setPreferences",r({method:"PUT",path:"/widget/v1/me/notification-preferences",body:{push_enabled:o.pushEnabled,email_enabled:o.emailEnabled}},i?.signal));if(!s.ok)return u(H(s.error));let l=zt(s.value);return l===null?u(we("setPreferences")):T(l)}}}n($,"createNotificationsClientOver");var k="everfur.notifications.device";var ke=3e3;var Oe=Symbol.for("@everfur/sdk#EverfurContext@v1"),xe=globalThis,Fe=xe[Oe]??(xe[Oe]=createContext(null));Fe.displayName??="EverfurContext";function Q(){let e=useContext(Fe);if(e===null)throw new P("not-initialized","Everfur hooks must be called inside <EverfurProvider>. Wrap your tree once, high.");return e}n(Q,"useEverfurContext");var ze=1;async function J(e){try{let t=await e.getItem(k);if(t===null)return null;let r=JSON.parse(t);if(typeof r!="object"||r===null)return null;let{v:o,userRef:i,deviceId:a}=r;return o!==ze||typeof i!="string"||typeof a!="string"||a.length===0?null:{userRef:i,deviceId:a}}catch{return null}}n(J,"readStored");async function Vt(e,t){try{await e.setItem(k,JSON.stringify({v:ze,...t}));}catch{}}n(Vt,"writeStored");async function Ne(e){try{await e.removeItem(k);}catch{}}n(Ne,"clearStored");var Ae=Object.freeze({status:"signed_out",device:null,error:null}),De=Object.freeze({status:"no_token",device:null,error:null});function Z(){return E("sessionRequired",{retryable:false,wireMessage:"notifications need a signed-in user on the provider"})}n(Z,"noUser");function Ue(){let{runtime:e}=Q();return useMemo(()=>W(e),[e])}n(Ue,"useEverfurNotificationsClient");function Me(e){let{runtime:t,userRef:r}=Q(),{token:o,provider:i,platform:a,installationId:s}=e,l=t.registry.services.kv,d=Ue(),[g,C]=useState(r===null?Ae:De),_=useRef(null),p=useRef(0);useEffect(()=>{if(p.current+=1,_.current=null,C(r===null?Ae:De),r===null)return;let y=true;return J(l).then(v=>{if(!y||v===null||v.userRef!==r)return;let f=_.current;if(f===null){_.current=v;return}f.deviceId!==v.deviceId&&d.unregisterDevice(v.deviceId);}),()=>{y=false;}},[d,l,r]);let c=useCallback(async(y,v)=>{let f=p.current+=1;C({status:"registering",device:null,error:null});let m=await d.registerDevice({token:v,provider:i,platform:a,...s===void 0?{}:{installationId:s}});if(f!==p.current)return m;if(!m.ok)return C({status:m.error.httpStatus===404?"unavailable":"failed",device:null,error:m.error}),m;let h=_.current;return _.current={userRef:y,deviceId:m.value.deviceId},C({status:"registered",device:m.value,error:null}),await Vt(l,_.current),h!==null&&h.userRef===y&&h.deviceId!==m.value.deviceId&&d.unregisterDevice(h.deviceId),m},[d,l,i,a,s]);useEffect(()=>{r===null||o===null||c(r,o);},[c,r,o]),useEffect(()=>t.onBeforeLogout(async({userRef:y,auth:v})=>{let f=_.current??await J(l);if(f===null||f.userRef!==y)return;_.current=null;let m=U({auth:v,maxAttempts:1,unaryTimeoutMs:ke,...t.registry.services.errorPolicy?{errorPolicy:t.registry.services.errorPolicy}:{}}),h=await $({auth:v,funnel:m}).unregisterDevice(f.deviceId);(h.ok||h.error.httpStatus===404)&&await Ne(l);}),[t,l]);let b=useCallback(async()=>r===null?u(Z()):o===null?u(E("validationFailed",{retryable:false,reasonCode:"token_invalid",wireMessage:"no push token was given"})):c(r,o),[c,r,o]),S=useCallback(async()=>{if(r===null)return u(Z());let y=_.current??await J(l);if(y===null||y.userRef!==r)return T(void 0);let v=p.current+=1,f=await d.unregisterDevice(y.deviceId);return f.ok||f.error.httpStatus===404?(_.current=null,await Ne(l),v===p.current&&C({status:"unregistered",device:null,error:null}),f.ok?f:T(void 0)):f},[d,l,r]),A=useCallback(y=>r===null?Promise.resolve(u(Z())):d.setPreferences(y),[d,r]);return useMemo(()=>({status:g.status,device:g.device,error:g.error,register:b,unregister:S,setPreferences:A}),[g,b,S,A])}n(Me,"useEverfurNotifications");function Yt(e){let t=Me(e),{status:r,error:o,register:i}=t,a=r==="failed"&&o!==null&&o.retryable;return useEffect(()=>{if(!a)return;let s=AppState.addEventListener("change",l=>{l==="active"&&i();});return ()=>{s.remove();}},[a,i]),t}n(Yt,"useEverfurNotifications");var Le=Object.freeze({"visit.booked":"visit","visit.reminder":"join","visit.rescheduled":"visit","visit.followup_sent":"messages","visit.message_received":"messages","visit.completed":"summary","visit.ended":"visit","visit.cancelled":null,"visit.no_show":null});function qe(e){return Object.prototype.hasOwnProperty.call(Le,e)?Le[e]:"visit"}n(qe,"vetVisitIntentForEvent");var Be=1,Ke=Object.freeze(["record_request","pet","visit","case"]),Ye=Object.freeze(["record_request.updated","record.ready","pet.vaccination.due","visit.booked","visit.cancelled","visit.completed","visit.no_show","visit.rescheduled","visit.reminder","visit.followup_sent","visit.message_received","visit.ended","chat.follow_up_due","chat.reminder_due","record.activation"]),te=["v","event_id","event_type","target"],Ht=new Set(["kind","conversation_id","request_id","visit_ref","case_ref","pet_ref"]),Gt=new Set(Ye),Wt=new Set(Ke),$t=128,Qt=4096,Xt=/^evt_[A-Za-z0-9]{1,64}$/,Jt=/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,Zt=/[-]/;function O(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}n(O,"isRecord");function He(e){return Object.keys(e)}n(He,"keysOf");function er(e){if(O(e))return e;if(typeof e!="string"||e.length===0||e.length>Qt)return null;let t=JSON.parse(e);return O(t)?t:null}n(er,"decodeBlock");function tr(e,t){let r=e;for(let o of t){if(!O(r))return;r=r[o];}return r}n(tr,"at");var rr=[[],["data"],["request","content","data"],["notification","request","content","data"]];function nr(e){if(!O(e))return null;for(let t of rr){let r=tr(e,t);if(O(r)&&"everfur"in r)return r.everfur}return te.every(t=>t in e)?e:null}n(nr,"locateBlock");function re(e){return typeof e!="string"||e.length===0||e.length>$t||Zt.test(e)||e.includes("://")||e.toLowerCase().startsWith("everfur")?null:e}n(re,"opaqueString");function Ve(e,t){if(!(t in e))return {ok:true,value:null};let r=re(e[t]);return r===null?{ok:false}:{ok:true,value:r}}n(Ve,"optional");function ee(e,t){return t in e?re(e[t]):null}n(ee,"required");function or(e,t){if(!O(e))return null;let r=He(e);if(!r.includes("kind")||r.some(s=>!Ht.has(s)))return null;let o=e.kind;if(typeof o!="string"||!Wt.has(o))return null;for(let s of r)if(s!=="kind"&&re(e[s])===null)return null;let i=Ve(e,"pet_ref");if(!i.ok)return null;let a=i.value;switch(o){case "record_request":{let s=ee(e,"request_id");return s===null?null:Object.freeze({kind:"record_request",requestId:s,petRef:a})}case "pet":return a===null?null:Object.freeze({kind:"pet",petRef:a});case "visit":{let s=ee(e,"visit_ref");return s===null?null:Object.freeze({kind:"visit",visitRef:s,petRef:a,intent:qe(t)})}case "case":{let s=ee(e,"case_ref");if(s===null)return null;let l=Ve(e,"conversation_id");return !l.ok||l.value!==null&&!Jt.test(l.value)?null:Object.freeze({kind:"case",caseRef:s,conversationId:l.value,petRef:a})}default:return null}}n(or,"parseTarget");function ir(e){let t=He(e);if(t.length!==te.length||te.some(a=>!t.includes(a))||e.v!==Be)return null;let r=e.event_id;if(typeof r!="string"||!Xt.test(r))return null;let o=e.event_type;if(typeof o!="string"||!Gt.has(o))return null;let i=or(e.target,o);return i===null?null:Object.freeze({eventId:r,eventType:o,target:i})}n(ir,"parseBlock");function ar(e){try{let t=er(nr(e));return t===null?null:ir(t)}catch{return null}}n(ar,"parseEverfurNotification");
+export{Ye as EVERFUR_NOTIFICATION_EVENT_TYPES,Ke as EVERFUR_NOTIFICATION_TARGET_KINDS,Be as EVERFUR_NOTIFICATION_VERSION,Ce as NOTIFICATIONS_REASON_MESSAGES,W as createNotificationsClient,Pt as explainNotificationsReason,ar as parseEverfurNotification,Yt as useEverfurNotifications,Ue as useEverfurNotificationsClient};

package/dist/optionalModule-DbJmsq5f.d.cts

@@ -0,0 +1,21 @@
+/** The settled outcome of a guarded optional-module load. Never a throw. */
+type OptionalModule<T> = {
+    readonly available: true;
+    readonly module: T;
+} | {
+    readonly available: false;
+    readonly module: null;
+    readonly reason: string;
+};
+/**
+ * Load an optional native peer behind a guard. `load` is the host-provided thunk (typically a `require`).
+ * An optional `validate` type-guard rejects a present-but-wrong-shape module (a version whose surface drifted)
+ * without throwing. Returns a settled result; NEVER throws.
+ *
+ * @param name  human-readable peer name, only used to build the `reason` string.
+ * @param load  the thunk that resolves the module (e.g. `() => require('expo-secure-store')`).
+ * @param validate  optional shape guard; when it returns false the module is treated as unavailable.
+ */
+declare function optionalModule<T>(name: string, load: () => unknown, validate?: (candidate: unknown) => candidate is T): OptionalModule<T>;
+
+export { type OptionalModule as O, optionalModule as o };

package/dist/optionalModule-DbJmsq5f.d.ts

@@ -0,0 +1,21 @@
+/** The settled outcome of a guarded optional-module load. Never a throw. */
+type OptionalModule<T> = {
+    readonly available: true;
+    readonly module: T;
+} | {
+    readonly available: false;
+    readonly module: null;
+    readonly reason: string;
+};
+/**
+ * Load an optional native peer behind a guard. `load` is the host-provided thunk (typically a `require`).
+ * An optional `validate` type-guard rejects a present-but-wrong-shape module (a version whose surface drifted)
+ * without throwing. Returns a settled result; NEVER throws.
+ *
+ * @param name  human-readable peer name, only used to build the `reason` string.
+ * @param load  the thunk that resolves the module (e.g. `() => require('expo-secure-store')`).
+ * @param validate  optional shape guard; when it returns false the module is treated as unavailable.
+ */
+declare function optionalModule<T>(name: string, load: () => unknown, validate?: (candidate: unknown) => candidate is T): OptionalModule<T>;
+
+export { type OptionalModule as O, optionalModule as o };

package/dist/pets-DJv2sj2H.d.ts

@@ -0,0 +1,92 @@
+import { c as EverfurResult } from './EverfurResult-DN9pL2Ab.js';
+import { j as FetchLike } from './config-C7eb_IMD.js';
+import { P as PetHealthProfileInput, a as PetHealthProfile } from './profile-CSs1wlXT.js';
+
+/** How your backend reaches Everfur for pet writes. Build it once and reuse it. */
+interface PartnerServerClient {
+    /** The Everfur API base URL, for example `https://api.everfur.com/api/v1`. https only (loopback excepted). */
+    readonly apiBaseUrl: string;
+    /**
+     * `sk_partner_...`, or an `rk_partner_...` restricted key carrying `pets.profile.update`, `pets.health.update` to
+     * write or read the health profile, and `pets.profile.delete` to delete. Never shipped to a device.
+     */
+    readonly partnerSecretKey: string;
+    readonly contractVersion?: string;
+    readonly fetchImpl?: FetchLike;
+}
+/** Which pet: your member's id and your pet's id. */
+interface PartnerPetTarget {
+    /** Your stable member id; the session mint's user_ref rule (1 to 128 characters, no '@', printable). */
+    readonly userRef: string;
+    /** Your stable pet id, 1 to 128 characters. */
+    readonly petRef: string;
+}
+/**
+ * The profile fields, the body every partner pet write path shares. On `upsertPartnerPet` an absent or `null`
+ * identity field leaves the stored value unchanged. On `updatePartnerPet` `null` clears `name`, `species`, `breed`,
+ * `ageYears` or `weightKg`, and an empty `partnerLabelInstructions` retracts the label text.
+ *
+ * The health fields (`PetHealthProfileInput`) take the same rule on both: absent is unchanged and an explicit null
+ * clears a scalar. A health LIST you send is the complete set you hold for the pet (set-replace): items match your
+ * earlier rows by `ref`, else by name, rows you no longer name are removed, and `[]` clears your rows. Rows the
+ * member entered themselves are never touched. Any health field needs `pets.health.update` and a dog or a cat.
+ */
+interface PartnerPetProfile extends PetHealthProfileInput {
+    /** Up to 100 characters. */
+    readonly name?: string | null;
+    /** Up to 50 characters. Records needs `dog` or `cat`. */
+    readonly species?: string | null;
+    /** Up to 100 characters. */
+    readonly breed?: string | null;
+    /** 0 to 50. */
+    readonly ageYears?: number | null;
+    /** 0 to 500. */
+    readonly weightKg?: number | null;
+    /** Your own label text, stored verbatim and never interpreted by Everfur. */
+    readonly partnerLabelInstructions?: string | null;
+}
+/** A pet profile as Everfur stored it. */
+interface PartnerPet {
+    readonly petId: string;
+    readonly petRef: string;
+    readonly name: string | null;
+    readonly species: string | null;
+    readonly breed: string | null;
+    readonly ageYears: number | null;
+    readonly weightKg: number | null;
+    /** ISO 8601. */
+    readonly updatedAt: string;
+}
+/**
+ * A pet read back with its health profile (`getPartnerPet`). The scalars are the pet's one shared profile, whoever
+ * set them last; the lists are the rows YOUR integration wrote, with your refs, never the member's own or another
+ * partner's. `profileVersion` moves on every accepted write from any path (yours, the member's device, an inbound
+ * `pet.profile.updated`), so one integer tells you whether anything changed since you last looked.
+ */
+interface PartnerPetWithProfile extends PartnerPet, PetHealthProfile {
+}
+/**
+ * Create a member's pet profile, or merge fields into it (`PUT`). Creates the member on first use.
+ *
+ * Settles to an `EverfurResult` for HTTP and network failures. Throws `EverfurConfigError` for a request that can
+ * never be accepted: a malformed key, `userRef` or `petRef`.
+ */
+declare function upsertPartnerPet(client: PartnerServerClient, target: PartnerPetTarget, profile: PartnerPetProfile): Promise<EverfurResult<PartnerPet>>;
+/**
+ * Change fields of an existing pet profile (`PATCH`). Never creates a member or a pet: either unknown settles to the
+ * not-found error. At least one field is required.
+ */
+declare function updatePartnerPet(client: PartnerServerClient, target: PartnerPetTarget, changes: PartnerPetProfile): Promise<EverfurResult<PartnerPet>>;
+/**
+ * Read a member's pet back with its health profile (`GET`, PF-14), to reconcile what you hold against what Everfur
+ * holds. Needs `pets.health.update` on a restricted key. Never creates anything: an unknown member or pet settles to
+ * the not-found error.
+ *
+ * Settles to an `EverfurResult` for HTTP and network failures. Throws `EverfurConfigError` for a malformed key,
+ * `userRef` or `petRef`.
+ */
+declare function getPartnerPet(client: PartnerServerClient, target: PartnerPetTarget): Promise<EverfurResult<PartnerPetWithProfile>>;
+/** Delete a pet profile (`DELETE`). An unknown member or pet settles to the not-found error. */
+declare function deletePartnerPet(client: PartnerServerClient, target: PartnerPetTarget): Promise<EverfurResult<void>>;
+
+export { type PartnerServerClient as P, type PartnerPet as a, type PartnerPetProfile as b, type PartnerPetTarget as c, type PartnerPetWithProfile as d, deletePartnerPet as e, upsertPartnerPet as f, getPartnerPet as g, updatePartnerPet as u };

package/dist/pets-JVCXgRgR.d.cts

@@ -0,0 +1,92 @@
+import { c as EverfurResult } from './EverfurResult-DN9pL2Ab.cjs';
+import { j as FetchLike } from './config--Wu1Umhd.cjs';
+import { P as PetHealthProfileInput, a as PetHealthProfile } from './profile-CSs1wlXT.cjs';
+
+/** How your backend reaches Everfur for pet writes. Build it once and reuse it. */
+interface PartnerServerClient {
+    /** The Everfur API base URL, for example `https://api.everfur.com/api/v1`. https only (loopback excepted). */
+    readonly apiBaseUrl: string;
+    /**
+     * `sk_partner_...`, or an `rk_partner_...` restricted key carrying `pets.profile.update`, `pets.health.update` to
+     * write or read the health profile, and `pets.profile.delete` to delete. Never shipped to a device.
+     */
+    readonly partnerSecretKey: string;
+    readonly contractVersion?: string;
+    readonly fetchImpl?: FetchLike;
+}
+/** Which pet: your member's id and your pet's id. */
+interface PartnerPetTarget {
+    /** Your stable member id; the session mint's user_ref rule (1 to 128 characters, no '@', printable). */
+    readonly userRef: string;
+    /** Your stable pet id, 1 to 128 characters. */
+    readonly petRef: string;
+}
+/**
+ * The profile fields, the body every partner pet write path shares. On `upsertPartnerPet` an absent or `null`
+ * identity field leaves the stored value unchanged. On `updatePartnerPet` `null` clears `name`, `species`, `breed`,
+ * `ageYears` or `weightKg`, and an empty `partnerLabelInstructions` retracts the label text.
+ *
+ * The health fields (`PetHealthProfileInput`) take the same rule on both: absent is unchanged and an explicit null
+ * clears a scalar. A health LIST you send is the complete set you hold for the pet (set-replace): items match your
+ * earlier rows by `ref`, else by name, rows you no longer name are removed, and `[]` clears your rows. Rows the
+ * member entered themselves are never touched. Any health field needs `pets.health.update` and a dog or a cat.
+ */
+interface PartnerPetProfile extends PetHealthProfileInput {
+    /** Up to 100 characters. */
+    readonly name?: string | null;
+    /** Up to 50 characters. Records needs `dog` or `cat`. */
+    readonly species?: string | null;
+    /** Up to 100 characters. */
+    readonly breed?: string | null;
+    /** 0 to 50. */
+    readonly ageYears?: number | null;
+    /** 0 to 500. */
+    readonly weightKg?: number | null;
+    /** Your own label text, stored verbatim and never interpreted by Everfur. */
+    readonly partnerLabelInstructions?: string | null;
+}
+/** A pet profile as Everfur stored it. */
+interface PartnerPet {
+    readonly petId: string;
+    readonly petRef: string;
+    readonly name: string | null;
+    readonly species: string | null;
+    readonly breed: string | null;
+    readonly ageYears: number | null;
+    readonly weightKg: number | null;
+    /** ISO 8601. */
+    readonly updatedAt: string;
+}
+/**
+ * A pet read back with its health profile (`getPartnerPet`). The scalars are the pet's one shared profile, whoever
+ * set them last; the lists are the rows YOUR integration wrote, with your refs, never the member's own or another
+ * partner's. `profileVersion` moves on every accepted write from any path (yours, the member's device, an inbound
+ * `pet.profile.updated`), so one integer tells you whether anything changed since you last looked.
+ */
+interface PartnerPetWithProfile extends PartnerPet, PetHealthProfile {
+}
+/**
+ * Create a member's pet profile, or merge fields into it (`PUT`). Creates the member on first use.
+ *
+ * Settles to an `EverfurResult` for HTTP and network failures. Throws `EverfurConfigError` for a request that can
+ * never be accepted: a malformed key, `userRef` or `petRef`.
+ */
+declare function upsertPartnerPet(client: PartnerServerClient, target: PartnerPetTarget, profile: PartnerPetProfile): Promise<EverfurResult<PartnerPet>>;
+/**
+ * Change fields of an existing pet profile (`PATCH`). Never creates a member or a pet: either unknown settles to the
+ * not-found error. At least one field is required.
+ */
+declare function updatePartnerPet(client: PartnerServerClient, target: PartnerPetTarget, changes: PartnerPetProfile): Promise<EverfurResult<PartnerPet>>;
+/**
+ * Read a member's pet back with its health profile (`GET`, PF-14), to reconcile what you hold against what Everfur
+ * holds. Needs `pets.health.update` on a restricted key. Never creates anything: an unknown member or pet settles to
+ * the not-found error.
+ *
+ * Settles to an `EverfurResult` for HTTP and network failures. Throws `EverfurConfigError` for a malformed key,
+ * `userRef` or `petRef`.
+ */
+declare function getPartnerPet(client: PartnerServerClient, target: PartnerPetTarget): Promise<EverfurResult<PartnerPetWithProfile>>;
+/** Delete a pet profile (`DELETE`). An unknown member or pet settles to the not-found error. */
+declare function deletePartnerPet(client: PartnerServerClient, target: PartnerPetTarget): Promise<EverfurResult<void>>;
+
+export { type PartnerServerClient as P, type PartnerPet as a, type PartnerPetProfile as b, type PartnerPetTarget as c, type PartnerPetWithProfile as d, deletePartnerPet as e, upsertPartnerPet as f, getPartnerPet as g, updatePartnerPet as u };

package/dist/petsRepository-B_gKbAzJ.d.cts

@@ -0,0 +1,142 @@
+import { c as EverfurResult } from './EverfurResult-DN9pL2Ab.cjs';
+import { A as AuthContext } from './identity-C2-08BZW.cjs';
+import { P as PetRef } from './ids-B2GAAifq.cjs';
+import { P as PetHealthProfileInput, a as PetHealthProfile } from './profile-CSs1wlXT.cjs';
+
+/**
+ * Server-declared bounds on `WidgetPetInput`, mirrored so a violation is refused before the wire rather
+ * than returning a refusal after the caller has already driven a registration flow. Every field is optional
+ * server-side: `POST` with an empty body registers a bare pet, which is all consent needs.
+ *
+ * WHICH STATUS THE SERVER WOULD HAVE ANSWERED, because the two are not interchangeable: a body that does not
+ * PARSE is a 400 `ValidationException` (an unknown key, the birth date pair split, a `ref` repeated in a
+ * list), rendered by the app-wide validation handler. The 422s are raised AFTER the body parses: an
+ * unsupported species and an empty PATCH body. Every rule mirrored here is refused locally, so a partner
+ * using this SDK meets neither.
+ */
+declare const PET_NAME_MAX = 100;
+declare const PET_SPECIES_MAX = 50;
+declare const PET_BREED_MAX = 100;
+declare const PET_AGE_YEARS_MAX = 50;
+declare const PET_WEIGHT_KG_MAX = 500;
+/**
+ * The optional profile fields. Omit all of them to register the pet without describing it.
+ *
+ * The five identity fields merge: an absent one leaves the stored value unchanged. The health fields
+ * (`PetHealthProfileInput`) follow the partner pet body's own rules: an explicit null clears a scalar, and a list you
+ * send REPLACES the rows your integration wrote for that list (`[]` clears them). A registration is an upsert, so
+ * sending a list on a later `registerPet` replaces the earlier one rather than adding to it. Health fields need a
+ * SIGNED session (403 `identitySignatureRequired` otherwise) and a pet that is a dog or a cat.
+ */
+interface PetProfileInput extends PetHealthProfileInput {
+    readonly name?: string;
+    readonly species?: string;
+    readonly breed?: string;
+    readonly ageYears?: number;
+    readonly weightKg?: number;
+}
+/** The registered profile, as the server echoes it back. */
+interface RegisteredPet {
+    readonly petRef: string;
+    readonly name: string | null;
+    readonly species: string | null;
+    readonly breed: string | null;
+    readonly ageYears: number | null;
+    readonly weightKg: number | null;
+}
+/**
+ * A partial profile change for `updatePet`. An omitted field is left unchanged; `null` clears it. At least one
+ * field is required. The server refuses clearing or changing `species` to an unsupported value once the pet
+ * uses Records (Records needs a dog or a cat). A health list you send replaces your rows for that list; `[]`
+ * clears them.
+ */
+interface PetProfilePatch extends PetHealthProfileInput {
+    readonly name?: string | null;
+    readonly species?: string | null;
+    readonly breed?: string | null;
+    readonly ageYears?: number | null;
+    readonly weightKg?: number | null;
+}
+/**
+ * One row of `GET /widget/v1/pets` (`WidgetPetResponse`, widget_schemas.py): the profile the partner registered,
+ * keyed by its `petRef`. The roster carries the identity fields only, never health data: the health profile is its
+ * own signed read (`getPetProfile`). `ageYears` is the registered whole-or-fractional age. Unknown wire fields are
+ * dropped at the boundary.
+ */
+interface WidgetPet {
+    /** The server's own id for the row; opaque, never a scope key (`petRef` is). */
+    readonly petId: string | null;
+    readonly petRef: PetRef;
+    readonly name: string | null;
+    readonly species: string | null;
+    readonly breed: string | null;
+    readonly ageYears: number | null;
+    readonly weightKg: number | null;
+    readonly updatedAt: string | null;
+}
+/**
+ * One pet read back WITH its health profile (`GET /widget/v1/pets/{pet_ref}/profile`, `WidgetPetProfileResponse`):
+ * the list row's fields plus `profileVersion`, the health scalars and your integration's four lists.
+ */
+interface WidgetPetProfile extends WidgetPet, PetHealthProfile {
+}
+interface PetsRepository {
+    /**
+     * `GET /widget/v1/pets` - every pet registered for the current user, as the server lists them. Settles
+     * `ok(readonly WidgetPet[])` on 200 (an empty list when none); `err(EverfurError)` otherwise. A row without a
+     * `pet_ref` is dropped rather than failing the page. Never throws.
+     */
+    list(opts?: {
+        signal?: AbortSignal;
+    }): Promise<EverfurResult<readonly WidgetPet[]>>;
+    /**
+     * `POST /widget/v1/pets/{pet_ref}` - create or update the widget pet profile. Idempotent by construction:
+     * the route is an upsert, so calling it for an already-registered pet updates rather than duplicates.
+     *
+     * Settles: `ok(RegisteredPet)` on 201, `err(EverfurError)` otherwise. Never throws.
+     */
+    registerPet(petRef: PetRef, profile?: PetProfileInput, opts?: {
+        signal?: AbortSignal;
+    }): Promise<EverfurResult<RegisteredPet>>;
+    /**
+     * `PATCH /widget/v1/pets/{pet_ref}` - change part of a registered pet's profile. Settles `ok(RegisteredPet)`
+     * on 200; an unknown pet is the not-found error; an empty change is refused before the wire.
+     */
+    updatePet(petRef: PetRef, patch: PetProfilePatch, opts?: {
+        signal?: AbortSignal;
+    }): Promise<EverfurResult<RegisteredPet>>;
+    /**
+     * `GET /widget/v1/pets/{pet_ref}/profile` - one pet with its health profile, so a partner app can show what
+     * Everfur holds. A SIGNED session only: any other session settles to the route's 403 `identitySignatureRequired`.
+     * An unknown pet is the not-found error. Never throws.
+     */
+    getPetProfile(petRef: PetRef, opts?: {
+        signal?: AbortSignal;
+    }): Promise<EverfurResult<WidgetPetProfile>>;
+    /**
+     * `DELETE /widget/v1/pets/{pet_ref}` - delete the pet profile. The server also retires the pet's Records
+     * data. Settles `ok(undefined)` on 204; an unknown pet is the not-found error.
+     */
+    deletePet(petRef: PetRef, opts?: {
+        signal?: AbortSignal;
+    }): Promise<EverfurResult<void>>;
+    /**
+     * `DELETE /widget/v1/me` - permanently erase everything Everfur holds for the current user (right to
+     * erasure). Settles `ok(undefined)` on 204. A 503 means the erasure did not finish: it is retryable and a
+     * repeat call resumes it. Sent once per call (never auto-retried, so two erasures never overlap), with a
+     * per-attempt deadline of `ERASE_USER_DATA_TIMEOUT_MS`. The next request for the same user starts a fresh,
+     * empty user.
+     */
+    eraseUserData(opts?: {
+        signal?: AbortSignal;
+    }): Promise<EverfurResult<void>>;
+}
+/**
+ * The allowlist mapper for one `GET /widget/v1/pets` row: the named fields, each type-checked; anything else on
+ * the wire is dropped. null for a row that is not an object or carries no `pet_ref` (nothing to scope by).
+ */
+declare function widgetPetFromWire(raw: unknown): WidgetPet | null;
+/** Build the repository over a device AuthContext (personalized bearer XOR anonymous pk). */
+declare function createPetsRepository(auth: AuthContext): PetsRepository;
+
+export { type PetProfileInput as P, type RegisteredPet as R, type WidgetPet as W, type PetProfilePatch as a, type WidgetPetProfile as b, PET_AGE_YEARS_MAX as c, PET_BREED_MAX as d, PET_NAME_MAX as e, PET_SPECIES_MAX as f, PET_WEIGHT_KG_MAX as g, type PetsRepository as h, createPetsRepository as i, widgetPetFromWire as w };

package/dist/petsRepository-Bk6GDwLs.d.ts

@@ -0,0 +1,142 @@
+import { c as EverfurResult } from './EverfurResult-DN9pL2Ab.js';
+import { A as AuthContext } from './identity-CEi9GRFZ.js';
+import { P as PetRef } from './ids-B2GAAifq.js';
+import { P as PetHealthProfileInput, a as PetHealthProfile } from './profile-CSs1wlXT.js';
+
+/**
+ * Server-declared bounds on `WidgetPetInput`, mirrored so a violation is refused before the wire rather
+ * than returning a refusal after the caller has already driven a registration flow. Every field is optional
+ * server-side: `POST` with an empty body registers a bare pet, which is all consent needs.
+ *
+ * WHICH STATUS THE SERVER WOULD HAVE ANSWERED, because the two are not interchangeable: a body that does not
+ * PARSE is a 400 `ValidationException` (an unknown key, the birth date pair split, a `ref` repeated in a
+ * list), rendered by the app-wide validation handler. The 422s are raised AFTER the body parses: an
+ * unsupported species and an empty PATCH body. Every rule mirrored here is refused locally, so a partner
+ * using this SDK meets neither.
+ */
+declare const PET_NAME_MAX = 100;
+declare const PET_SPECIES_MAX = 50;
+declare const PET_BREED_MAX = 100;
+declare const PET_AGE_YEARS_MAX = 50;
+declare const PET_WEIGHT_KG_MAX = 500;
+/**
+ * The optional profile fields. Omit all of them to register the pet without describing it.
+ *
+ * The five identity fields merge: an absent one leaves the stored value unchanged. The health fields
+ * (`PetHealthProfileInput`) follow the partner pet body's own rules: an explicit null clears a scalar, and a list you
+ * send REPLACES the rows your integration wrote for that list (`[]` clears them). A registration is an upsert, so
+ * sending a list on a later `registerPet` replaces the earlier one rather than adding to it. Health fields need a
+ * SIGNED session (403 `identitySignatureRequired` otherwise) and a pet that is a dog or a cat.
+ */
+interface PetProfileInput extends PetHealthProfileInput {
+    readonly name?: string;
+    readonly species?: string;
+    readonly breed?: string;
+    readonly ageYears?: number;
+    readonly weightKg?: number;
+}
+/** The registered profile, as the server echoes it back. */
+interface RegisteredPet {
+    readonly petRef: string;
+    readonly name: string | null;
+    readonly species: string | null;
+    readonly breed: string | null;
+    readonly ageYears: number | null;
+    readonly weightKg: number | null;
+}
+/**
+ * A partial profile change for `updatePet`. An omitted field is left unchanged; `null` clears it. At least one
+ * field is required. The server refuses clearing or changing `species` to an unsupported value once the pet
+ * uses Records (Records needs a dog or a cat). A health list you send replaces your rows for that list; `[]`
+ * clears them.
+ */
+interface PetProfilePatch extends PetHealthProfileInput {
+    readonly name?: string | null;
+    readonly species?: string | null;
+    readonly breed?: string | null;
+    readonly ageYears?: number | null;
+    readonly weightKg?: number | null;
+}
+/**
+ * One row of `GET /widget/v1/pets` (`WidgetPetResponse`, widget_schemas.py): the profile the partner registered,
+ * keyed by its `petRef`. The roster carries the identity fields only, never health data: the health profile is its
+ * own signed read (`getPetProfile`). `ageYears` is the registered whole-or-fractional age. Unknown wire fields are
+ * dropped at the boundary.
+ */
+interface WidgetPet {
+    /** The server's own id for the row; opaque, never a scope key (`petRef` is). */
+    readonly petId: string | null;
+    readonly petRef: PetRef;
+    readonly name: string | null;
+    readonly species: string | null;
+    readonly breed: string | null;
+    readonly ageYears: number | null;
+    readonly weightKg: number | null;
+    readonly updatedAt: string | null;
+}
+/**
+ * One pet read back WITH its health profile (`GET /widget/v1/pets/{pet_ref}/profile`, `WidgetPetProfileResponse`):
+ * the list row's fields plus `profileVersion`, the health scalars and your integration's four lists.
+ */
+interface WidgetPetProfile extends WidgetPet, PetHealthProfile {
+}
+interface PetsRepository {
+    /**
+     * `GET /widget/v1/pets` - every pet registered for the current user, as the server lists them. Settles
+     * `ok(readonly WidgetPet[])` on 200 (an empty list when none); `err(EverfurError)` otherwise. A row without a
+     * `pet_ref` is dropped rather than failing the page. Never throws.
+     */
+    list(opts?: {
+        signal?: AbortSignal;
+    }): Promise<EverfurResult<readonly WidgetPet[]>>;
+    /**
+     * `POST /widget/v1/pets/{pet_ref}` - create or update the widget pet profile. Idempotent by construction:
+     * the route is an upsert, so calling it for an already-registered pet updates rather than duplicates.
+     *
+     * Settles: `ok(RegisteredPet)` on 201, `err(EverfurError)` otherwise. Never throws.
+     */
+    registerPet(petRef: PetRef, profile?: PetProfileInput, opts?: {
+        signal?: AbortSignal;
+    }): Promise<EverfurResult<RegisteredPet>>;
+    /**
+     * `PATCH /widget/v1/pets/{pet_ref}` - change part of a registered pet's profile. Settles `ok(RegisteredPet)`
+     * on 200; an unknown pet is the not-found error; an empty change is refused before the wire.
+     */
+    updatePet(petRef: PetRef, patch: PetProfilePatch, opts?: {
+        signal?: AbortSignal;
+    }): Promise<EverfurResult<RegisteredPet>>;
+    /**
+     * `GET /widget/v1/pets/{pet_ref}/profile` - one pet with its health profile, so a partner app can show what
+     * Everfur holds. A SIGNED session only: any other session settles to the route's 403 `identitySignatureRequired`.
+     * An unknown pet is the not-found error. Never throws.
+     */
+    getPetProfile(petRef: PetRef, opts?: {
+        signal?: AbortSignal;
+    }): Promise<EverfurResult<WidgetPetProfile>>;
+    /**
+     * `DELETE /widget/v1/pets/{pet_ref}` - delete the pet profile. The server also retires the pet's Records
+     * data. Settles `ok(undefined)` on 204; an unknown pet is the not-found error.
+     */
+    deletePet(petRef: PetRef, opts?: {
+        signal?: AbortSignal;
+    }): Promise<EverfurResult<void>>;
+    /**
+     * `DELETE /widget/v1/me` - permanently erase everything Everfur holds for the current user (right to
+     * erasure). Settles `ok(undefined)` on 204. A 503 means the erasure did not finish: it is retryable and a
+     * repeat call resumes it. Sent once per call (never auto-retried, so two erasures never overlap), with a
+     * per-attempt deadline of `ERASE_USER_DATA_TIMEOUT_MS`. The next request for the same user starts a fresh,
+     * empty user.
+     */
+    eraseUserData(opts?: {
+        signal?: AbortSignal;
+    }): Promise<EverfurResult<void>>;
+}
+/**
+ * The allowlist mapper for one `GET /widget/v1/pets` row: the named fields, each type-checked; anything else on
+ * the wire is dropped. null for a row that is not an object or carries no `pet_ref` (nothing to scope by).
+ */
+declare function widgetPetFromWire(raw: unknown): WidgetPet | null;
+/** Build the repository over a device AuthContext (personalized bearer XOR anonymous pk). */
+declare function createPetsRepository(auth: AuthContext): PetsRepository;
+
+export { type PetProfileInput as P, type RegisteredPet as R, type WidgetPet as W, type PetProfilePatch as a, type WidgetPetProfile as b, PET_AGE_YEARS_MAX as c, PET_BREED_MAX as d, PET_NAME_MAX as e, PET_SPECIES_MAX as f, PET_WEIGHT_KG_MAX as g, type PetsRepository as h, createPetsRepository as i, widgetPetFromWire as w };