palbase 0.7.0 → 0.8.0

package/dist/refuse/ai.js

@@ -1,2 +1,2 @@
-/*! palbase 0.7.0 — Palbase SDK License (see LICENSE) */
+/*! palbase 0.8.0 — Palbase SDK License (see LICENSE) */
 throw new Error("palbase/ai is for servers: it speaks with the project secret key, which never goes into a browser or a mobile app \u2014 call your backend, and let it ask the model");

package/dist/refuse/backend.js

@@ -1,2 +1,2 @@
-/*! palbase 0.7.0 — Palbase SDK License (see LICENSE) */
+/*! palbase 0.8.0 — Palbase SDK License (see LICENSE) */
 throw new Error("palbase/backend is a server framework: it runs on your backend, never in a browser or a mobile app \u2014 apps use palbase/web (or the native SDKs)");

package/dist/refuse/server.js

@@ -1,2 +1,2 @@
-/*! palbase 0.7.0 — Palbase SDK License (see LICENSE) */
+/*! palbase 0.8.0 — Palbase SDK License (see LICENSE) */
 throw new Error("palbase/server is for servers: its secret key never goes into a browser or a mobile app \u2014 apps use palbase/web (or the native SDKs) with the publishable key");

package/dist/server/index.js

@@ -1,2 +1,2 @@
-/*! palbase 0.7.0 — Palbase SDK License (see LICENSE) */
-import{a as c,b as d,c as e,d as f,e as g,f as h,g as i,h as j,i as k,j as l,k as m,l as n,m as o,n as p,o as q,p as r,q as s,r as t}from"../chunks/L3NTI4AZ.js";import"../chunks/KDSWK3XW.js";import{m as b}from"../chunks/AIIKXCWN.js";import"../chunks/ZBOJEH7K.js";import{b as a}from"../chunks/JS3TTUHS.js";import"../chunks/X3MTLJRV.js";import"../chunks/SU7BP6VF.js";export{j as AuthUnavailable,b as EVENT_TYPES,a as PalbaseError,o as ReservationSettled,i as TokenError,l as TokenVerifier,d as WebhookSignatureError,c as createServer,n as isEntitled,t as loadSecrets,q as pages,s as platformOwn,r as processOwn,m as requestAddress,k as sessionStanding,g as signatureHeader,f as verifySignature,e as verifyWebhook,h as verifyWebhookRequest,p as withReservation};
+/*! palbase 0.8.0 — Palbase SDK License (see LICENSE) */
+import{a as c,b as d,c as e,d as f,e as g,f as h,g as i,h as j,i as k,j as l,k as m,l as n,m as o,n as p,o as q,p as r,q as s,r as t}from"../chunks/Z5JVQNAZ.js";import"../chunks/KDWDPSL2.js";import{m as b}from"../chunks/EGNEXFTZ.js";import"../chunks/BO5KR2EQ.js";import{b as a}from"../chunks/PDOHT46N.js";import"../chunks/RO5Y5YU4.js";import"../chunks/JSJVV43D.js";export{j as AuthUnavailable,b as EVENT_TYPES,a as PalbaseError,o as ReservationSettled,i as TokenError,l as TokenVerifier,d as WebhookSignatureError,c as createServer,n as isEntitled,t as loadSecrets,q as pages,s as platformOwn,r as processOwn,m as requestAddress,k as sessionStanding,g as signatureHeader,f as verifySignature,e as verifyWebhook,h as verifyWebhookRequest,p as withReservation};

package/dist/server/testing.js

@@ -1,2 +1,2 @@
-/*! palbase 0.7.0 — Palbase SDK License (see LICENSE) */
-import{a,b,c,d}from"../chunks/G3BK7L3J.js";import"../chunks/X3MTLJRV.js";import"../chunks/SU7BP6VF.js";export{a as TestApiError,d as api,b as createTestApi,c as testRun};
+/*! palbase 0.8.0 — Palbase SDK License (see LICENSE) */
+import{a,b,c,d}from"../chunks/RBA6V3UO.js";import"../chunks/RO5Y5YU4.js";import"../chunks/JSJVV43D.js";export{a as TestApiError,d as api,b as createTestApi,c as testRun};

package/dist/web/index.js

@@ -1,2 +1,2 @@
-/*! palbase 0.7.0 — Palbase SDK License (see LICENSE) */
-import{a as t,b as r,c as a,d as o,e as p,f as n,g as i,h as m}from"../chunks/3ALGILOX.js";import{a as y,b as s,e as l}from"../chunks/G7E26S3Y.js";import"../chunks/5ZJCEQV5.js";import"../chunks/OIA7KLRW.js";import"../chunks/AIIKXCWN.js";import"../chunks/ZBOJEH7K.js";import{b as e}from"../chunks/JS3TTUHS.js";import"../chunks/X3MTLJRV.js";import"../chunks/SU7BP6VF.js";export{n as Analytics,y as BackendError,o as Channel,l as GatewayError,e as PalbaseError,i as Purchases,p as RealtimeSocket,t as SessionChangedError,m as createClient,s as isBackendError,a as localStore,r as memoryStore};
+/*! palbase 0.8.0 — Palbase SDK License (see LICENSE) */
+import{a as h,b as g,c as w,d as C,e as v,f as E,g as S,h as k}from"../chunks/DB3SIBKB.js";import{a as T,b,f as P}from"../chunks/WEI32SAJ.js";import"../chunks/WINBISC2.js";import"../chunks/P4Z5E6ZI.js";import"../chunks/EGNEXFTZ.js";import"../chunks/BO5KR2EQ.js";import{b as m}from"../chunks/PDOHT46N.js";import"../chunks/RO5Y5YU4.js";import"../chunks/JSJVV43D.js";var R="oai-events";async function V(e){if(typeof e?.start!="function")throw new TypeError("connectVoice: start(sdp) is the round trip to the app's backend, which starts the voice (chats.voice.start) and answers { id, sdp }");let o=e.rtc??M(),t=e.signal;t?.throwIfAborted();let s=e.audio??O(),c=e.microphone===void 0,a=e.microphone??await o.getUserMedia({audio:!0});if(t?.aborted){if(c)for(let n of a.getTracks())n.stop();throw t.reason}let r=new o.RTCPeerConnection,d=!1,p=()=>{if(!d){if(d=!0,u.close(),r.close(),c)for(let n of a.getTracks())n.stop();s.srcObject!==null&&(s.srcObject=null)}};r.addEventListener("track",n=>{s.srcObject=n.streams[0]??new MediaStream([n.track]),s.play?.()?.catch?.(()=>{})}),r.addEventListener("connectionstatechange",()=>e.onState?.(r.connectionState));for(let n of a.getAudioTracks())r.addTrack(n,a);let u=r.createDataChannel(R);u.addEventListener("message",n=>{let i=x(n.data);i!==void 0&&e.onError?.(i)});let l=()=>p();t?.addEventListener("abort",l,{once:!0});try{await r.setLocalDescription(await r.createOffer()),t?.throwIfAborted(),await A(r,e.iceTimeoutMs??1e4,t);let n=r.localDescription?.sdp;if(!n)throw new Error("connectVoice: the peer connection made no offer");let i=await e.start(n);if(t?.throwIfAborted(),typeof i?.id!="string"||i.id===""||typeof i.sdp!="string"||i.sdp==="")throw new TypeError("connectVoice: start answered no voice \u2014 it is { id, sdp }, chats.voice.start's answer as the backend got it");return await r.setRemoteDescription({type:"answer",sdp:i.sdp}),t?.removeEventListener("abort",l),{id:i.id,peer:r,audio:s,microphone:a,get muted(){return a.getAudioTracks().every(y=>!y.enabled)},mute(y){for(let f of a.getAudioTracks())f.enabled=!y},close:p}}catch(n){throw t?.removeEventListener("abort",l),p(),t?.aborted?t.reason:n}}function A(e,o,t){return e.iceGatheringState==="complete"?Promise.resolve():t?.aborted?Promise.reject(t.reason):new Promise((s,c)=>{let a=()=>{clearTimeout(p),e.removeEventListener("icegatheringstatechange",r),t?.removeEventListener("abort",d)},r=()=>{e.iceGatheringState==="complete"&&(a(),s())},d=()=>{a(),c(t?.reason)},p=setTimeout(()=>{a(),c(new Error(`connectVoice: the network candidates were not gathered in ${o} ms`))},o);e.addEventListener("icegatheringstatechange",r),t?.addEventListener("abort",d,{once:!0})})}function x(e){if(typeof e=="string")try{let o=JSON.parse(e);return o.type!=="error"?void 0:typeof o.error?.message=="string"?o.error.message:typeof o.error?.code=="string"?o.error.code:"the voice failed"}catch{return}}function M(){let e=globalThis;if(typeof e.RTCPeerConnection!="function"||typeof e.navigator?.mediaDevices?.getUserMedia!="function")throw new TypeError("connectVoice: this runtime has no WebRTC (RTCPeerConnection, navigator.mediaDevices): a chat's voice is a browser's");let o=e.navigator.mediaDevices;return{RTCPeerConnection:e.RTCPeerConnection,getUserMedia:t=>o.getUserMedia(t)}}function O(){let e=globalThis.document;if(!e)throw new TypeError("connectVoice: give audio \u2014 the element the voice plays in \u2014 where there is no document");let o=e.createElement("audio");return o.autoplay=!0,o}export{E as Analytics,T as BackendError,C as Channel,P as GatewayError,m as PalbaseError,S as Purchases,v as RealtimeSocket,h as SessionChangedError,V as connectVoice,k as createClient,b as isBackendError,w as localStore,g as memoryStore};

package/dist/web/palbe.js

@@ -1,2 +1,2 @@
-/*! palbase 0.7.0 — Palbase SDK License (see LICENSE) */
-import{c as e,d as r,h as t}from"../chunks/G7E26S3Y.js";import"../chunks/OIA7KLRW.js";import"../chunks/ZBOJEH7K.js";import"../chunks/JS3TTUHS.js";import"../chunks/X3MTLJRV.js";import"../chunks/SU7BP6VF.js";export{e as RESERVED_CLIENT_NAMES,t as __registerBackend,r as isClientName};
+/*! palbase 0.8.0 — Palbase SDK License (see LICENSE) */
+import{c as e,d as r,i as t}from"../chunks/WEI32SAJ.js";import"../chunks/P4Z5E6ZI.js";import"../chunks/BO5KR2EQ.js";import"../chunks/PDOHT46N.js";import"../chunks/RO5Y5YU4.js";import"../chunks/JSJVV43D.js";export{e as RESERVED_CLIENT_NAMES,t as __registerBackend,r as isClientName};

package/dist/web/paywall.js

@@ -1,2 +1,2 @@
-/*! palbase 0.7.0 — Palbase SDK License (see LICENSE) */
-import{a as e,b as a,c as t,d as l,e as o,f as p,g as r,h as y,i as s,j as P,k as i,l as n,m as w,n as f,o as d,p as m,q as u,r as A,s as c,t as v}from"../chunks/5ZJCEQV5.js";import"../chunks/JS3TTUHS.js";import"../chunks/X3MTLJRV.js";import"../chunks/SU7BP6VF.js";export{w as PAYWALL_COMPONENTS,i as PAYWALL_ICONS,n as PAYWALL_SCHEMA,c as Paywall,a as assetId,p as attributesHeader,f as countdownValues,v as defaultPaywall,e as fontFamily,s as formatPeriod,y as formatPrice,o as htmlDocument,P as packageValues,d as packagesOf,r as parseDuration,t as prepareAssets,A as renderPaywall,m as resolvePaywall,u as resolvePaywallWithPaths,l as unzip};
+/*! palbase 0.8.0 — Palbase SDK License (see LICENSE) */
+import{a as e,b as a,c as t,d as l,e as o,f as p,g as r,h as y,i as s,j as P,k as i,l as n,m as w,n as f,o as d,p as m,q as u,r as A,s as c,t as v}from"../chunks/WINBISC2.js";import"../chunks/PDOHT46N.js";import"../chunks/RO5Y5YU4.js";import"../chunks/JSJVV43D.js";export{w as PAYWALL_COMPONENTS,i as PAYWALL_ICONS,n as PAYWALL_SCHEMA,c as Paywall,a as assetId,p as attributesHeader,f as countdownValues,v as defaultPaywall,e as fontFamily,s as formatPeriod,y as formatPrice,o as htmlDocument,P as packageValues,d as packagesOf,r as parseDuration,t as prepareAssets,A as renderPaywall,m as resolvePaywall,u as resolvePaywallWithPaths,l as unzip};

package/dist/web/ssr.js

@@ -1,2 +1,2 @@
-/*! palbase 0.7.0 — Palbase SDK License (see LICENSE) */
-import{h as f}from"../chunks/3ALGILOX.js";import"../chunks/G7E26S3Y.js";import"../chunks/5ZJCEQV5.js";import"../chunks/OIA7KLRW.js";import"../chunks/AIIKXCWN.js";import"../chunks/ZBOJEH7K.js";import"../chunks/JS3TTUHS.js";import"../chunks/X3MTLJRV.js";import"../chunks/SU7BP6VF.js";var C=Object.freeze({"Cache-Control":"private, no-cache, no-store, must-revalidate, max-age=0",Expires:"0",Pragma:"no-cache"}),x={path:"/",sameSite:"lax",secure:!0,httpOnly:!1,maxAge:400*24*60*60},u=3180,k=5*6e4;function d(t){let e=/^pb_([a-z0-9]+)_c/.exec(t)?.[1];if(e===void 0)throw new TypeError("publishableKey is the project publishable key (pb_<ref>_c\u2026)");return`pb-${e}-session`}var y=t=>{let e=new TextEncoder().encode(JSON.stringify(t)),o="";for(let s of e)o+=String.fromCharCode(s);return btoa(o).replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/,"")},b=t=>{try{let e=atob(t.replace(/-/g,"+").replace(/_/g,"/")),o=JSON.parse(new TextDecoder().decode(Uint8Array.from(e,s=>s.charCodeAt(0))));return typeof o.accessToken!="string"||typeof o.refreshToken!="string"||typeof o.expiresAt!="number"||typeof o.userId!="string"?null:o}catch{return null}};function m(t,e,o={},s=!1){let c={...x,...o},g=async()=>new Map((await e.getAll()).map(n=>[n.name,n.value])),S=n=>n===t||n.startsWith(`${t}.`)&&/^\d+$/.test(n.slice(t.length+1)),h=async n=>{if(!e.setAll)return;let i=n===null?[]:n.length<=u?[[t,n]]:Array.from({length:Math.ceil(n.length/u)},(r,l)=>[`${t}.${l}`,n.slice(l*u,(l+1)*u)]),p=new Set(i.map(([r])=>r)),a=i.map(([r,l])=>({name:r,value:l,options:c}));for(let r of(await g()).keys())S(r)&&!p.has(r)&&a.push({name:r,value:"",options:{...c,maxAge:0}});a.length>0&&await e.setAll(a,{...C})};return{async load(){let n=await g(),i=n.get(t);if(i===void 0){let p="";for(let a=0;n.has(`${t}.${a}`);a++)p+=n.get(`${t}.${a}`);i=p}return i?b(i):null},save:n=>h(y(n)),clear:()=>h(null),shared:s}}function A(t){let{cookies:e,cookieOptions:o,...s}=t,c=t.refresh??(e.setAll?"before":"never");return f({...s,refresh:c,storage:m(d(t.publishableKey),e,o)})}function O(){let t=()=>{let e=globalThis.document;if(!e)throw new Error("documentCookies: there is no document here \u2014 a server gives its request's cookies to createServerClient");return e};return{getAll:()=>t().cookie.split(";").map(e=>e.trim()).filter(e=>e.includes("=")).map(e=>{let o=e.indexOf("=");return{name:e.slice(0,o),value:e.slice(o+1)}}),setAll(e){for(let o of e){let s=o.options,c=[`Path=${s.path??"/"}`,s.domain?`Domain=${s.domain}`:"",s.maxAge!==void 0?`Max-Age=${s.maxAge}`:"",s.expires?`Expires=${s.expires.toUTCString()}`:"",s.sameSite?`SameSite=${s.sameSite.charAt(0).toUpperCase()}${s.sameSite.slice(1)}`:"",s.secure?"Secure":""].filter(Boolean);t().cookie=[`${o.name}=${o.value}`,...c].join("; ")}}}}function $(t){let{cookieOptions:e,...o}=t,s=globalThis.location?.protocol==="https:";return f({...o,storage:m(d(t.publishableKey),O(),{secure:s,...e},!0)})}async function v(t){let e=await t.auth.currentSession();if(!e||(e.expiresAt-Date.now()<=k&&await t.auth.refreshSession().catch(()=>{}),!await t.auth.currentSession()))return null;try{return(await t.auth.api.verifyTokenUser()).data}catch(o){if(o.status===401)return null;throw o}}export{C as NO_STORE_HEADERS,x as SESSION_COOKIE_OPTIONS,m as cookieSessionStore,$ as createBrowserClient,A as createServerClient,O as documentCookies,v as keepSession,d as sessionCookieName};
+/*! palbase 0.8.0 — Palbase SDK License (see LICENSE) */
+import{h as f}from"../chunks/DB3SIBKB.js";import"../chunks/WEI32SAJ.js";import"../chunks/WINBISC2.js";import"../chunks/P4Z5E6ZI.js";import"../chunks/EGNEXFTZ.js";import"../chunks/BO5KR2EQ.js";import"../chunks/PDOHT46N.js";import"../chunks/RO5Y5YU4.js";import"../chunks/JSJVV43D.js";var C=Object.freeze({"Cache-Control":"private, no-cache, no-store, must-revalidate, max-age=0",Expires:"0",Pragma:"no-cache"}),x={path:"/",sameSite:"lax",secure:!0,httpOnly:!1,maxAge:400*24*60*60},u=3180,k=5*6e4;function d(t){let e=/^pb_([a-z0-9]+)_c/.exec(t)?.[1];if(e===void 0)throw new TypeError("publishableKey is the project publishable key (pb_<ref>_c\u2026)");return`pb-${e}-session`}var y=t=>{let e=new TextEncoder().encode(JSON.stringify(t)),o="";for(let s of e)o+=String.fromCharCode(s);return btoa(o).replace(/\+/g,"-").replace(/\//g,"_").replace(/=+$/,"")},b=t=>{try{let e=atob(t.replace(/-/g,"+").replace(/_/g,"/")),o=JSON.parse(new TextDecoder().decode(Uint8Array.from(e,s=>s.charCodeAt(0))));return typeof o.accessToken!="string"||typeof o.refreshToken!="string"||typeof o.expiresAt!="number"||typeof o.userId!="string"?null:o}catch{return null}};function m(t,e,o={},s=!1){let c={...x,...o},g=async()=>new Map((await e.getAll()).map(n=>[n.name,n.value])),S=n=>n===t||n.startsWith(`${t}.`)&&/^\d+$/.test(n.slice(t.length+1)),h=async n=>{if(!e.setAll)return;let i=n===null?[]:n.length<=u?[[t,n]]:Array.from({length:Math.ceil(n.length/u)},(r,l)=>[`${t}.${l}`,n.slice(l*u,(l+1)*u)]),p=new Set(i.map(([r])=>r)),a=i.map(([r,l])=>({name:r,value:l,options:c}));for(let r of(await g()).keys())S(r)&&!p.has(r)&&a.push({name:r,value:"",options:{...c,maxAge:0}});a.length>0&&await e.setAll(a,{...C})};return{async load(){let n=await g(),i=n.get(t);if(i===void 0){let p="";for(let a=0;n.has(`${t}.${a}`);a++)p+=n.get(`${t}.${a}`);i=p}return i?b(i):null},save:n=>h(y(n)),clear:()=>h(null),shared:s}}function A(t){let{cookies:e,cookieOptions:o,...s}=t,c=t.refresh??(e.setAll?"before":"never");return f({...s,refresh:c,storage:m(d(t.publishableKey),e,o)})}function O(){let t=()=>{let e=globalThis.document;if(!e)throw new Error("documentCookies: there is no document here \u2014 a server gives its request's cookies to createServerClient");return e};return{getAll:()=>t().cookie.split(";").map(e=>e.trim()).filter(e=>e.includes("=")).map(e=>{let o=e.indexOf("=");return{name:e.slice(0,o),value:e.slice(o+1)}}),setAll(e){for(let o of e){let s=o.options,c=[`Path=${s.path??"/"}`,s.domain?`Domain=${s.domain}`:"",s.maxAge!==void 0?`Max-Age=${s.maxAge}`:"",s.expires?`Expires=${s.expires.toUTCString()}`:"",s.sameSite?`SameSite=${s.sameSite.charAt(0).toUpperCase()}${s.sameSite.slice(1)}`:"",s.secure?"Secure":""].filter(Boolean);t().cookie=[`${o.name}=${o.value}`,...c].join("; ")}}}}function $(t){let{cookieOptions:e,...o}=t,s=globalThis.location?.protocol==="https:";return f({...o,storage:m(d(t.publishableKey),O(),{secure:s,...e},!0)})}async function v(t){let e=await t.auth.currentSession();if(!e||(e.expiresAt-Date.now()<=k&&await t.auth.refreshSession().catch(()=>{}),!await t.auth.currentSession()))return null;try{return(await t.auth.api.verifyTokenUser()).data}catch(o){if(o.status===401)return null;throw o}}export{C as NO_STORE_HEADERS,x as SESSION_COOKIE_OPTIONS,m as cookieSessionStore,$ as createBrowserClient,A as createServerClient,O as documentCookies,v as keepSession,d as sessionCookieName};

package/dist/web/vite.js

@@ -1,3 +1,3 @@
-/*! palbase 0.7.0 — Palbase SDK License (see LICENSE) */
-import"../chunks/SU7BP6VF.js";import{execFile as $}from"node:child_process";import{existsSync as y,mkdtempSync as k,readFileSync as S,rmSync as x,writeFileSync as P}from"node:fs";import{createRequire as O}from"node:module";import{tmpdir as W}from"node:os";import{dirname as g,join as o,relative as u,resolve as v,sep as d}from"node:path";var E=/\.(?:ts|js|mts|mjs)$/;function F(n){if(!/^[a-z][a-z0-9-]*$/.test(n.app))throw new TypeError(`palbase({ app }): ${JSON.stringify(n.app)} is an app's slug (palbase apps:list)`);let c=process.cwd(),p="",i="",f=()=>v(c,n.dir??"palbase"),m=()=>{let e=n.environments[p];if(!e)throw new Error(`palbase: the mode "${p}" is not built against any environment \u2014 say which in vite.config: palbase({ environments: { ${JSON.stringify(p)}: '<environment slug>' } })`);return e};return{name:"palbase",enforce:"pre",config(e,s){p=s.mode,i=s.command??"";let r=e.build?.rollupOptions?.onwarn;return{build:{rollupOptions:{onwarn(t,a){let l=String(t.exporter??t.id??"");if(t.code==="MISSING_EXPORT"&&l.includes(`${d}environments${d}`))throw new Error(`palbase: ${t.message} \u2014 ${m()}'s backend has no such route (palbase apps:sync brings what it has)`);r?r(t,a):a(t)}}}}},configResolved(e){c=e.root,p=e.mode,i=e.command??i},async buildStart(){i!=="build"||n.typecheck===!1||await j(c,m(),n.tsconfig)},resolveId(e,s){if(!s)return null;let r=f();if(e==="palbase"||e.startsWith("palbase/")){let w=u(r,s);return w.startsWith("..")||w===""?null:this.resolve(e,o(c,"index.html"),{skipSelf:!0})}if(!(e.startsWith(".")||e.startsWith("/")))return null;let t=v(g(s),e);if(E.test(t)||(t+=".ts"),g(t)!==r&&g(t)!==o(r,"palbe"))return null;let a=u(r,t),l=`${n.app}.ts`;if(a!==l&&!a.startsWith(`palbe${d}`))return null;let h=m(),b=o(r,"environments",h,a===l?l:o("palbe",a.slice(`palbe${d}`.length)));if(!y(b))throw new Error(`palbase: ${u(c,b)} is not there \u2014 palbase apps:sync writes it (is ${n.app} set in ${h}, and has ${h} that machine?)`);return b}}}async function j(n,c,p){let i=p?v(n,p):["tsconfig.app.json","tsconfig.json"].map(e=>o(n,e)).find(y);if(!i)return;if(!y(i))throw new Error(`palbase({ tsconfig }): ${u(n,i)} is not there`);let f;try{let e=O(o(n,"package.json")).resolve("typescript/package.json"),s=JSON.parse(S(e,"utf8")).bin?.tsc;if(!s)throw new Error("no tsc");f=o(g(e),s)}catch{throw new Error("palbase: the build type-checks the app against its environment with the app's TypeScript, and the app has none (npm i -D typescript) \u2014 or say palbase({ typecheck: false })")}let m=k(o(W(),"palbase-typecheck-"));try{let e=o(m,"tsconfig.json");P(e,JSON.stringify({extends:i,compilerOptions:{noEmit:!0,composite:!1,incremental:!1,moduleSuffixes:[`.${c}`,""]}}));let s=await new Promise(r=>$(process.execPath,[f,"-p",e,"--pretty","false"],{cwd:n,maxBuffer:16<<20},(t,a,l)=>r({code:t?typeof t.code=="number"?t.code:1:0,text:`${a}${l}`.trim()})));if(s.code!==0)throw new Error(`palbase: the app does not type-check against ${c}, the environment this build is made for \u2014 a route its backend does not have, or a call that does not fit it:
+/*! palbase 0.8.0 — Palbase SDK License (see LICENSE) */
+import"../chunks/JSJVV43D.js";import{execFile as $}from"node:child_process";import{existsSync as y,mkdtempSync as k,readFileSync as S,rmSync as x,writeFileSync as P}from"node:fs";import{createRequire as O}from"node:module";import{tmpdir as W}from"node:os";import{dirname as g,join as o,relative as u,resolve as v,sep as d}from"node:path";var E=/\.(?:ts|js|mts|mjs)$/;function F(n){if(!/^[a-z][a-z0-9-]*$/.test(n.app))throw new TypeError(`palbase({ app }): ${JSON.stringify(n.app)} is an app's slug (palbase apps:list)`);let c=process.cwd(),p="",i="",f=()=>v(c,n.dir??"palbase"),m=()=>{let e=n.environments[p];if(!e)throw new Error(`palbase: the mode "${p}" is not built against any environment \u2014 say which in vite.config: palbase({ environments: { ${JSON.stringify(p)}: '<environment slug>' } })`);return e};return{name:"palbase",enforce:"pre",config(e,s){p=s.mode,i=s.command??"";let r=e.build?.rollupOptions?.onwarn;return{build:{rollupOptions:{onwarn(t,a){let l=String(t.exporter??t.id??"");if(t.code==="MISSING_EXPORT"&&l.includes(`${d}environments${d}`))throw new Error(`palbase: ${t.message} \u2014 ${m()}'s backend has no such route (palbase apps:sync brings what it has)`);r?r(t,a):a(t)}}}}},configResolved(e){c=e.root,p=e.mode,i=e.command??i},async buildStart(){i!=="build"||n.typecheck===!1||await j(c,m(),n.tsconfig)},resolveId(e,s){if(!s)return null;let r=f();if(e==="palbase"||e.startsWith("palbase/")){let w=u(r,s);return w.startsWith("..")||w===""?null:this.resolve(e,o(c,"index.html"),{skipSelf:!0})}if(!(e.startsWith(".")||e.startsWith("/")))return null;let t=v(g(s),e);if(E.test(t)||(t+=".ts"),g(t)!==r&&g(t)!==o(r,"palbe"))return null;let a=u(r,t),l=`${n.app}.ts`;if(a!==l&&!a.startsWith(`palbe${d}`))return null;let h=m(),b=o(r,"environments",h,a===l?l:o("palbe",a.slice(`palbe${d}`.length)));if(!y(b))throw new Error(`palbase: ${u(c,b)} is not there \u2014 palbase apps:sync writes it (is ${n.app} set in ${h}, and has ${h} that machine?)`);return b}}}async function j(n,c,p){let i=p?v(n,p):["tsconfig.app.json","tsconfig.json"].map(e=>o(n,e)).find(y);if(!i)return;if(!y(i))throw new Error(`palbase({ tsconfig }): ${u(n,i)} is not there`);let f;try{let e=O(o(n,"package.json")).resolve("typescript/package.json"),s=JSON.parse(S(e,"utf8")).bin?.tsc;if(!s)throw new Error("no tsc");f=o(g(e),s)}catch{throw new Error("palbase: the build type-checks the app against its environment with the app's TypeScript, and the app has none (npm i -D typescript) \u2014 or say palbase({ typecheck: false })")}let m=k(o(W(),"palbase-typecheck-"));try{let e=o(m,"tsconfig.json");P(e,JSON.stringify({extends:i,compilerOptions:{noEmit:!0,composite:!1,incremental:!1,moduleSuffixes:[`.${c}`,""]}}));let s=await new Promise(r=>$(process.execPath,[f,"-p",e,"--pretty","false"],{cwd:n,maxBuffer:16<<20},(t,a,l)=>r({code:t?typeof t.code=="number"?t.code:1:0,text:`${a}${l}`.trim()})));if(s.code!==0)throw new Error(`palbase: the app does not type-check against ${c}, the environment this build is made for \u2014 a route its backend does not have, or a call that does not fit it:
 ${s.text}`)}finally{x(m,{recursive:!0,force:!0})}}export{F as palbase};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "palbase",
-  "version": "0.7.0",
+  "version": "0.8.0",
   "description": "Palbase for JavaScript: the web client (palbase/web), the server SDK (palbase/server), the backend framework (palbase/backend), AI (palbase/ai) and the CLI (npx palbase).",
   "license": "SEE LICENSE IN LICENSE",
   "homepage": "https://palbase.studio",
@@ -109,7 +109,7 @@
     "README.md"
   ],
   "dependencies": {
-    "palgres": "0.7.0",
+    "palgres": "0.8.0",
     "reflect-metadata": "^0.2.2",
     "typescript": "~6.0.3",
     "zod": "^4.6.5"

package/types/ai/src/ai.d.ts

@@ -3,10 +3,13 @@ import { type RetryPolicy } from '../../internal/src/retry.js';
 import * as modules from '../../internal/src/modules/index.js';
 import { type Infer, type PreparedSchema, type StandardSchema } from './schema.js';
 import { type Agents, type Chats, type Endpoints, type Repos, type Settings } from './chats.js';
-import { type AgentContext, type BackendAgent, type BackendRepo, type BackendTool, type BackendToolOptions, type ClientTool, type ClientToolOptions, type HttpsToolRef, type McpToolRef, type TurnDefinition } from './tools.js';
+import { type AgentContext, type BackendAgent, type BackendRepo, type BackendTool, type BackendToolOptions, type DeferredAnswer, type RepoTokenContext, type RepoTokens, type ClientTool, type ClientToolOptions, type HttpsToolRef, type McpToolRef, type TurnDefinition } from './tools.js';
 type Module = ReturnType<typeof modules.ai.client>;
 export type Response = Awaited<ReturnType<Module['getResponse']>>['data'];
 export type Usage = Awaited<ReturnType<Module['listUsage']>>['data']['usage'][number];
+export type Models = modules.ai.Models;
+/** A text model a turn may name, as the engine's catalogue says it (ai.models().chat). */
+export type ChatModel = modules.ai.ChatModel;
 export interface AIOptions {
     /** The project's address (https://<ref>.<domain>); default PALBASE_URL. */
     url?: string;
@@ -38,11 +41,13 @@ export interface Message {
     content: string;
 }
 /**
- * A picture a question is about: a file of the project's own storage, or an
- * https address. Upload a photo to the project's storage first
- * (storage.from(bucket).upload(path, file)), then give its bucket and path:
- * the model reads it through a link signed for the while it answers, and
- * the platform keeps no copy of it.
+ * A picture a question is about: a file of the project's own storage, an
+ * https address, or its bytes. A file of the storage ({ bucket, path }) is
+ * read by the model through a link signed for the while it answers, and the
+ * platform keeps no copy of it. Its bytes ({ mediaType, data }: png, jpeg,
+ * webp or gif — a screenshot the server holds — base64 or a Uint8Array, 5 MiB
+ * each and 6 MiB together) are kept in the project's storage while the
+ * question is answered, then deleted.
  *
  * Do not take bucket and path from the end user as they send them: the
  * question is asked with the project's secret key, and the model can be
@@ -54,6 +59,9 @@ export type AskImage = {
     path: string;
 } | {
     url: string;
+} | {
+    mediaType: 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif' | (string & {});
+    data: string | Uint8Array;
 };
 /** What a one-shot answer may call: the backend's ai.tool, the project's HTTPS tools and MCP servers — never an app's client tool. */
 export type AskTool = BackendTool<StandardSchema> | HttpsToolRef | McpToolRef;
@@ -63,11 +71,11 @@ export interface Ask {
     messages?: Message[];
     instructions?: string;
     model?: Model;
-    /** Pictures the question is about (4 at most), in the project's storage ({ bucket, path }) or at an https address ({ url }) — a user's own file, checked by you (AskImage). */
+    /** Pictures the question is about (4 at most): in the project's storage ({ bucket, path }), at an https address ({ url }), or their bytes ({ mediaType, data }) — a user's own file, checked by you (AskImage). */
     images?: AskImage[];
     /** What the model may call to answer: an ai.tool runs on the backend's machine; an app's client tool is a chat's alone. */
     tools?: AskTool[];
-    /** How many tool calls the answer makes at most (1–200): past it the model is told it has no tools left, and answers. */
+    /** How many tool calls the answer makes at most (1–10 000, the engine's own bound): past it the model is told it has no tools left, and answers. */
     maxToolCalls?: number;
     /** The caller's own labels: returned with the response and its event. */
     metadata?: Record<string, string>;
@@ -183,10 +191,20 @@ export interface AI {
     embed(text: string, options?: Embed): Promise<number[]>;
     /** Pictures for a prompt: waits for the job (it takes the provider up to minutes). */
     image(request: ImageRequest): Promise<Images>;
-    models(): Promise<Awaited<ReturnType<Module['listModels']>>['data']>;
-    /** Uses of models and their cost, newest first. */
+    /**
+     * What the project may name: the roles, the embedding and picture models — and chat, every text model a turn may
+     * name (an agent's, a response's) with the efforts it takes, its window, its token limits and its price: what a
+     * model picker offers a person. unavailable: the providers whose models could not be listed just now.
+     */
+    models(): Promise<Models>;
+    /**
+     * Uses of models and their cost, newest first. Each carries its labels (metadata): its caller's — and a chat's turn
+     * the chat's labels and the chat (chat). With metadata, only the uses that carry every one of those labels: a
+     * product's spend, a task's — a deleted chat's too.
+     */
     usage(options?: {
         kind?: 'text' | 'embedding' | 'image';
+        metadata?: Record<string, string>;
         limit?: number;
         cursor?: string;
     }): Promise<{
@@ -215,6 +233,14 @@ export interface AI {
     tool<S extends StandardSchema>(tool: BackendToolOptions<S>): BackendTool<S>;
     /** A tool the app answers — through its gateway, whose backend gives the answer (chats.answer): the turn waits for it. */
     clientTool<S extends StandardSchema>(tool: ClientToolOptions<S>): ClientTool;
+    /**
+     * What a backend tool's run returns when its work outlasts a call (110 seconds): a chat's call waits, and the
+     * project's server answers it later with chats.answer(ctx.chatId, ctx.callId, output), within expiresInSeconds
+     * (a minute to a day; an hour).
+     */
+    deferred(options?: {
+        expiresInSeconds?: number;
+    }): DeferredAnswer;
     /**
      * An agent the backend defines at each turn's start, from the turn's
      * context: put it with ai.agents.put(agent), and its chats' turns ask the
@@ -233,12 +259,15 @@ export interface AI {
         repository: string;
         defaultBranch?: string;
         machine?: string;
-        token: (ctx: {
-            repo: string;
-            repository: string;
-            signal: AbortSignal;
-        }) => string | Promise<string>;
+        token: (ctx: RepoTokenContext) => string | Promise<string>;
     }): BackendRepo;
+    /**
+     * The tokens of the repositories put by name at run time (ai.repos.put(name, { repository, backend })) — one a
+     * product makes for itself — that no ai.repo of this backend names: each clone and push of a chat's workspace asks
+     * this machine, and give answers with a token for that one operation, or null for one it gives none for. Given
+     * once, at a module's top level; an ai.repo answers for its own repository first.
+     */
+    repoTokens(give: RepoTokens): void;
     /** The project's repositories a chat's workspace works in (chats.create({ workspace })). */
     readonly repos: Repos;
     /** The generated client of the ai module, for what the methods above do not say. */