palbase 0.6.2 → 0.7.0

package/dist/refuse/ai.js

@@ -1,2 +1,2 @@
-/*! palbase 0.6.2 — Palbase SDK License (see LICENSE) */
+/*! palbase 0.7.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.6.2 — Palbase SDK License (see LICENSE) */
+/*! palbase 0.7.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.6.2 — Palbase SDK License (see LICENSE) */
+/*! palbase 0.7.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.6.2 — 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/U4OZ4HOF.js";import"../chunks/SUX2BJG4.js";import{m as b}from"../chunks/A76UZBAF.js";import"../chunks/SXH5AIQX.js";import{b as a}from"../chunks/IYCW6PWG.js";import"../chunks/KLANM6M6.js";import"../chunks/A3CDCPXX.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.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};

package/dist/server/testing.js

@@ -1,2 +1,2 @@
-/*! palbase 0.6.2 — Palbase SDK License (see LICENSE) */
-import{a,b,c,d}from"../chunks/DRTZ33XF.js";import"../chunks/KLANM6M6.js";import"../chunks/A3CDCPXX.js";export{a as TestApiError,d as api,b as createTestApi,c as testRun};
+/*! 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};

package/dist/web/index.js

@@ -1,2 +1,2 @@
-/*! palbase 0.6.2 — Palbase SDK License (see LICENSE) */
-import{a as t,b as o,c as r,d as p,e as a,f as y,g as i,h as m,i as f,j as C}from"../chunks/KL7FIRII.js";import{a as n,b as s,e as l}from"../chunks/IVEAUFGE.js";import"../chunks/GVFZM4BI.js";import"../chunks/2RG3I7LX.js";import"../chunks/A76UZBAF.js";import"../chunks/SXH5AIQX.js";import{b as e}from"../chunks/IYCW6PWG.js";import"../chunks/KLANM6M6.js";import"../chunks/A3CDCPXX.js";export{f as AI,y as Analytics,n as BackendError,p as Channel,m as ChatSession,e as PalbaseError,i as Purchases,a as RealtimeSocket,l as RoomError,t as SessionChangedError,C as createClient,s as isBackendError,r as localStore,o as memoryStore};
+/*! 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};

package/dist/web/palbe.js

@@ -1,2 +1,2 @@
-/*! palbase 0.6.2 — Palbase SDK License (see LICENSE) */
-import{c as e,d as r,h as t}from"../chunks/IVEAUFGE.js";import"../chunks/SXH5AIQX.js";import"../chunks/IYCW6PWG.js";import"../chunks/KLANM6M6.js";import"../chunks/A3CDCPXX.js";export{e as RESERVED_CLIENT_NAMES,t as __registerBackend,r as isClientName};
+/*! 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};

package/dist/web/paywall.js

@@ -1,2 +1,2 @@
-/*! palbase 0.6.2 — 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/GVFZM4BI.js";import"../chunks/IYCW6PWG.js";import"../chunks/KLANM6M6.js";import"../chunks/A3CDCPXX.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.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};

package/dist/web/ssr.js

@@ -1,2 +1,2 @@
-/*! palbase 0.6.2 — Palbase SDK License (see LICENSE) */
-import{j as f}from"../chunks/KL7FIRII.js";import"../chunks/IVEAUFGE.js";import"../chunks/GVFZM4BI.js";import"../chunks/2RG3I7LX.js";import"../chunks/A76UZBAF.js";import"../chunks/SXH5AIQX.js";import"../chunks/IYCW6PWG.js";import"../chunks/KLANM6M6.js";import"../chunks/A3CDCPXX.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.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};

package/dist/web/vite.js

@@ -1,3 +1,3 @@
-/*! palbase 0.6.2 — Palbase SDK License (see LICENSE) */
-import"../chunks/A3CDCPXX.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.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:
 ${s.text}`)}finally{x(m,{recursive:!0,force:!0})}}export{F as palbase};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "palbase",
-  "version": "0.6.2",
+  "version": "0.7.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.6.2",
+    "palgres": "0.7.0",
     "reflect-metadata": "^0.2.2",
     "typescript": "~6.0.3",
     "zod": "^4.6.5"

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

@@ -213,17 +213,15 @@ export interface AI {
      * Made once, at a module's top level.
      */
     tool<S extends StandardSchema>(tool: BackendToolOptions<S>): BackendTool<S>;
-    /** A tool the app's code answers (pb.ai.chat(id).tools({ name: fn })): the turn waits for it. */
+    /** 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;
     /**
      * 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
-     * machine for it — clients: true, and the app's users start chats with it
-     * themselves. Made once, at a module's top level.
+     * machine for it. Made once, at a module's top level.
      */
     agent(name: string, define: (ctx: AgentContext) => TurnDefinition | Promise<TurnDefinition>, options?: {
         machine?: string;
-        clients?: boolean;
     }): BackendAgent;
     /**
      * A GitHub repository a chat's workspace works in, whose tokens this

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

@@ -1,4 +1,3 @@
-import { type ChatStream, type FollowChatOptions } from '../../internal/src/chat.js';
 import type * as modules from '../../internal/src/modules/index.js';
 import { type ToolResult } from '../../internal/src/tool-output.js';
 import { type AgentDefinitionInput, type BackendAgent, type BackendRepo } from './tools.js';
@@ -10,7 +9,7 @@ export type Endpoint = modules.ai.Endpoint;
 export type Decision = modules.ai.Decision;
 /** What the project allows its chats. */
 export interface AISettings {
-    /** The app's users talk to the project's agents with their own session: start a chat with a named agent, write to the chats they are in. */
+    /** The app's users reach the chats they are members of with their own session (the server starts every chat). */
     clients: boolean;
     /** How many messages one user sends a minute. */
     userMessagesPerMinute: number;
@@ -163,28 +162,59 @@ export interface Chats {
         messages: ChatMessage[];
         nextCursor?: string;
     }>;
-    /** What happens in the chat as typed parts, as it happens, followed again after a cut from where the reader is: read with for await, stopped with break or signal. */
-    stream(id: string, options?: FollowChatOptions): ChatStream;
+    /**
+     * What happens in the chat — its messages, its turns, the answer as it is written, the tools and subagents — as a
+     * source a gateway pipes into its channel: `ctx.pipe(Palbase.ai.chats.events(id))`. The platform writes the chat
+     * into the channel itself from then on; the backend is not in the stream, and the gateway's members hear it.
+     */
+    events(id: string): ChatEvents;
     /** Stops the turn it is working on: what it wrote stays. Its response's id, or null when none ran. */
     stop(id: string): Promise<string | null>;
-    /** A tool call that waits for a person's yes (a tool event's approval_id): made. */
-    approve(id: string, approvalId: string, reason?: string): Promise<Decision>;
+    /**
+     * A tool call that waits for a person's yes (a tool event's approval_id): made. As a member (as), the server is held to
+     * their rules — a turn another member began is not theirs to decide (403 not_your_turn); without it, the server decides any.
+     */
+    approve(id: string, approvalId: string, options?: {
+        reason?: string;
+        as?: string;
+    }): Promise<Decision>;
     /** Not made: the agent is told, with the reason, and goes on. */
-    deny(id: string, approvalId: string, reason?: string): Promise<Decision>;
-    /** The answer of a client tool's call (a tool event's call_id): true when it is the one taken, false when another came first. */
+    deny(id: string, approvalId: string, options?: {
+        reason?: string;
+        as?: string;
+    }): Promise<Decision>;
+    /**
+     * The answer of a client tool's call (a tool event's call_id): true when it is the one taken, false when another came
+     * first. As a member (as): the app of the member whose turn it is answers it (403 not_your_turn otherwise).
+     */
     answer(id: string, callId: string, output: ToolResult, options?: {
         isError?: boolean;
+        as?: string;
     }): Promise<boolean>;
-    /** A message for one of the agent's subagents at work (an agent event's run_id), at its next step. */
+    /** A message for one of the agent's subagents at work (an agent event's run_id), at its next step — as a member, held to their rules. */
     sendToSubagent(id: string, runId: string, text: string, options?: {
         clientId?: string;
+        as?: string;
     }): Promise<{
         runId: string;
         clientId: string;
     }>;
 }
+/** A chat's stream as a gateway pipes it into its channel (gateways' PipeSource). */
+export interface ChatEvents {
+    readonly kind: 'ai.chat';
+    readonly chatId: string;
+    /** Writes the chat into the channel from now on — from its start, for a channel that had not been its own. */
+    pipe(topic: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+    /** Writes it nowhere from now on. */
+    unpipe(options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+}
 export interface Agents {
-    /** Names an agent: its definition, or a backend's ai.agent (its chats' turns ask the backend's machine); clients: true lets the app's users start chats with it. */
+    /** Names an agent: its definition, or a backend's ai.agent (its chats' turns ask the backend's machine). */
     put(name: string, definition: AgentDefinitionInput | BackendAgent): Promise<Agent>;
     put(agent: BackendAgent): Promise<Agent>;
     list(): Promise<Agent[]>;

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

@@ -4,7 +4,7 @@ export { AISchemaError, prepare } from './schema.js';
 export { ToolError } from './tools.js';
 export type { Infer, StandardSchema } from './schema.js';
 export { partial } from './partial.js';
-export type { AISettings, Agent, Agents, Chat, ChatMessage, Chats, CreateChat, Decision, Endpoint, EndpointInput, Endpoints, MemberInput, Repo, Repos, SendMessage, Settings, TurnArtifact, TurnCost } from './chats.js';
+export type { AISettings, Agent, Agents, Chat, ChatEvents, ChatMessage, Chats, CreateChat, Decision, Endpoint, EndpointInput, Endpoints, MemberInput, Repo, Repos, SendMessage, Settings, TurnArtifact, TurnCost } from './chats.js';
 export type { AgentContext, AgentDefinitionInput, BackendAgent, BackendRepo, BackendTool, BackendToolOptions, ChatContext, ClientTool, ClientToolOptions, HttpsToolRef, McpToolRef, SubagentDefinition, Tool, ToolContext, TurnDefinition, } from './tools.js';
-export type { AgentEvent, ChatEvent, ChatPosition, ChatStream, MessageEvent, ResetEvent, TextEvent, ToolEvent, ToolStatus, TurnEvent, TurnStatus, WaitingReason } from '../../internal/src/chat.js';
+export type { AgentEvent, ChatEvent, MessageEvent, ResetEvent, TextEvent, ToolEvent, ToolStatus, TurnEvent, TurnStatus, WaitingReason } from '../../internal/src/chat.js';
 export type { ToolPart, ToolResult } from '../../internal/src/tool-output.js';

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

@@ -73,7 +73,7 @@ export interface ClientToolOptions<S extends StandardSchema> {
     input?: S;
     approval?: boolean;
 }
-/** A tool the app's code answers (pb.ai.chat(id).tools({ name: fn })): the turn waits for its answer. */
+/** A tool the app answers — through its gateway, whose backend gives the answer (chats.answer): the turn waits for it. */
 export interface ClientTool {
     readonly source: 'client';
     readonly name: string;
@@ -116,19 +116,15 @@ export interface AgentDefinitionInput {
     subagents?: SubagentDefinition[];
     /** How many tool calls a turn makes at most (1–200): past it the agent is told it has no tools left and answers. */
     maxToolCalls?: number;
-    /** A named agent's: the app's users start chats with it themselves (when the project lets them). Left out, the server's alone. */
-    clients?: boolean;
 }
-/** What a backend's agent is for one turn: whether users reach it is the named agent's, said when it is put. */
-export type TurnDefinition = Omit<AgentDefinitionInput, 'clients'>;
+/** What a backend's agent is for one turn. */
+export type TurnDefinition = AgentDefinitionInput;
 /** An agent the backend defines at each turn's start: put with ai.agents.put(agent), its chats' turns ask its machine. */
 export interface BackendAgent {
     readonly kind: 'agent';
     readonly name: string;
     /** The project's machine that defines it (default backend). */
     readonly machine?: string;
-    /** The app's users start chats with it themselves (put with it). */
-    readonly clients: boolean;
     /** The definition for a turn, said as the platform takes it, with the backend tools it hands out. */
     resolve(ctx: AgentContext): Promise<{
         definition: AgentDefinition;
@@ -193,7 +189,6 @@ export declare function backendRepo(options: {
 }): BackendRepo;
 export declare function backendAgent(name: string, define: (ctx: AgentContext) => TurnDefinition | Promise<TurnDefinition>, options?: {
     machine?: string;
-    clients?: boolean;
 }): BackendAgent;
 /** A tool as the platform takes it (ToolRef). */
 export declare function toolRef(t: Tool, what: string): ToolRef;

package/types/backend/src/container.d.ts

@@ -28,8 +28,8 @@ export declare class Container {
     readonly cronProviders: Ctor[];
     /** The providers that are @Task classes: the platform runs them as their tasks come due. */
     readonly taskProviders: Ctor[];
-    /** The providers that are @Room classes. */
-    readonly rooms: Ctor[];
+    /** The providers that are @Gateway classes. */
+    readonly gateways: Ctor[];
     constructor(modules: Function[]);
     private collect;
     private validate;

package/types/backend/src/engine.d.ts

@@ -1,7 +1,6 @@
 import { type PalbaseServer, type TokenUser, type TokenVerifier, type WebhookEvent } from '../../server/src/index.js';
 import { type AuthSpec, type RateLimitConfig } from './decorators.js';
 import { type ContractOptions } from './openapi.js';
-import { type ChannelsDef } from './channels.js';
 import { type StringsTable } from './i18n.js';
 import type { RequestTelemetry } from './requests.js';
 /** The signed-in user, as @User() gives it. */
@@ -63,8 +62,6 @@ export interface AppOptions {
     cors?: CorsOptions;
     /** The framework's own handlers of the platform's events (user.deleted → forget), run before the app's @On. */
     events?: Record<string, ((event: WebhookEvent) => Promise<unknown>)[]>;
-    /** The app's channels; the ones defineChannels declared in this process unless given (a test's own). */
-    channels?: ChannelsDef;
     /** The app's database: each request (and each delivery) one transaction, as its caller or as the service role. */
     database?: {
         app: RequestDatabases;
@@ -104,7 +101,7 @@ export interface AppOptions {
      *   never to be done (TaskFailure, or a payload its schema refuses), or the
      *   failure the platform tries again;
      * - its @Upload routes' two steps, from storage (upload.ts), and its
-     *   @Room classes' joins, messages and moments, from realtime (rooms.ts):
+     *   @Gateway classes' joins, messages and moments, from realtime (gateways.ts):
      *   platform-calls.ts;
      * - its ai tools and agents (@palbase/ai's ai.tool and ai.agent), from the
      *   ai module: POST /_palbase/ai/tools runs the tool an agent called (its

package/types/backend/src/gateways.d.ts

@@ -0,0 +1,250 @@
+import type { realtime } from '../../internal/src/modules/index.js';
+import { type StandardSchemaV1 } from './decorators.js';
+import { type SignedUser } from './platform-calls.js';
+export declare const GATEWAY: unique symbol;
+export declare const GATEWAY_HOOKS: unique symbol;
+/** The moments a gateway's methods are told of. */
+export type GatewayHook = 'authorize' | 'first' | 'connect' | 'disconnect' | 'empty';
+export interface GatewayOptions {
+    /**
+     * Who may join, decided by realtime: 'owner' — the pattern's one {param}
+     * is the joining user's id; 'public' — any signed-in user. Left out, an
+     * @Authorize method decides.
+     */
+    access?: 'owner' | 'public';
+    /**
+     * Members broadcast to each other, as realtime carries it — a gateway of
+     * no method only: one with methods takes its members' messages itself
+     * (@Subscribe).
+     */
+    publish?: boolean;
+    /**
+     * Keeps what it sends: true a day, or { keepSeconds } (1 to 604800). A
+     * member that was away is sent what it missed, in order, once — a chat's
+     * stream that a phone walking out of range does not lose.
+     */
+    durable?: boolean | {
+        keepSeconds: number;
+    };
+    /**
+     * How long it is held after its last member left before it is empty
+     * (@OnEmpty), in milliseconds: 60000 unless said.
+     */
+    graceMs?: number;
+    /**
+     * It carries a chat of the project's agents (ctx.pipe(Palbase.ai.chats.events(id))):
+     * its event `chat` is the platform's — the chat's parts — and every
+     * generated client holds the chat's state for its view (messages, the
+     * answer as it is written, tools, approvals). Kept a day unless durable
+     * says how long: a member that comes later, or was away, has the chat.
+     */
+    chat?: boolean;
+}
+/**
+ * Something the platform writes into a gateway's channel itself, the backend
+ * not in it: a chat's stream (Palbase.ai.chats.events(id)).
+ */
+export interface PipeSource {
+    pipe(topic: string, options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+}
+/** The platform's event of a chat-carrying gateway: one part of the chat (its type, the journal's number, its data). */
+export declare const ChatPart: StandardSchemaV1<{
+    type: string;
+    id?: number;
+    data: Record<string, unknown>;
+}>;
+/**
+ * Thrown by a @Subscribe: the member's message is refused, with this reason —
+ * the client's GatewayError.reason, a word the app chose for its own app to
+ * act on ('not_your_turn', 'too_many_messages'). What the method wrote is
+ * rolled back. Anything else a method throws is the app's log's: its words
+ * could carry anything, and the member is told handler_failed.
+ */
+export declare class GatewayRefusal extends Error {
+    readonly reason: string;
+    constructor(reason: string);
+}
+/** What a gateway class declares its events with: `static readonly events = { name: schema }`. */
+export interface GatewayEvents {
+    readonly events?: Readonly<Record<string, StandardSchemaV1>>;
+}
+/** A gateway as its decorators declare it. */
+export interface GatewayDeclaration {
+    /** The class's name: its client's, in every generated client. */
+    name: string;
+    pattern: string;
+    access?: 'owner' | 'public';
+    publish: boolean;
+    /** How long it keeps what it sends, in seconds: 0 keeps nothing. */
+    logKeepSeconds: number;
+    /** It carries a chat (GatewayOptions.chat): its event `chat` is the chat's parts. */
+    chat: boolean;
+    events: Record<string, StandardSchemaV1>;
+    graceMs: number;
+    /** Each moment, the method told of it. */
+    hooks: Partial<Record<GatewayHook, string>>;
+    /** Each message a member may send: its method, its payload's schema, and its ack's when said — an object of no prototype, whatever the names. */
+    messages: Record<string, {
+        fn: string;
+        schema: StandardSchemaV1;
+        reply?: StandardSchemaV1;
+    }>;
+}
+/** Whether the machine serves it — a method of it is told of something — or realtime decides it alone. */
+export declare const servedByTheApp: (g: GatewayDeclaration) => boolean;
+/** Who a member is, to a gateway's methods. */
+export interface GatewayUser {
+    /** The user's id; "" in @OnFirst and @OnEmpty, which no one in particular caused. */
+    id: string;
+}
+/** What @Authorize is given: who asks to join, and the channel's parameters. */
+export interface GatewayAuthorizeContext {
+    user: GatewayUser;
+    params: Readonly<Record<string, string>>;
+}
+/**
+ * What @Authorize answers: true lets the user in to hear and to send; an
+ * object says which — { read: false } is no way in, { write: false } a
+ * listener who may not send; null, undefined or false keep the user out. So
+ * does any other answer, and a method that throws: only a grant lets anyone
+ * in, and the app's log says what was answered instead.
+ */
+export type GatewayGrant = boolean | null | undefined | {
+    read?: boolean;
+    write?: boolean;
+};
+/** What a gateway's moments are given (@OnFirst, @OnConnect, @OnDisconnect, @OnEmpty). */
+export interface GatewayContext {
+    /** The channel: "chat:42". */
+    channel: string;
+    /** The pattern's parameters: { chatId: "42" }. */
+    params: Readonly<Record<string, string>>;
+    /**
+     * The channel's own: aborted when it empties (before @OnEmpty runs), or
+     * when owner.release() gives it up — what @OnFirst started stops on it.
+     */
+    signal: AbortSignal;
+    /** Its members now, across realtime's replicas; 0 in a @Subscribe. */
+    count: number;
+    user: GatewayUser;
+    /**
+     * An event to the channel's members — in @OnConnect, to the member who
+     * joined alone. Sent in the order emitted, and never thrown: what could
+     * not be sent is in the app's log.
+     */
+    emit(event: string, payload?: unknown): void;
+    /**
+     * The platform writes `source` into this channel from now on — a chat's
+     * stream: `ctx.pipe(Palbase.ai.chats.events(chatId))`. The backend is not
+     * in the stream after; the gateway's members hear it.
+     */
+    pipe(source: PipeSource): Promise<void>;
+    owner: {
+        /** Runs `work` past the method, until the channel's signal aborts: an upstream's loop. Its failure is logged, never the app's crash. */
+        hold(work: (signal: AbortSignal) => unknown): void;
+        /** Gives the channel up now: its signal aborts, and the next member to come finds it unheld (@OnFirst again). */
+        release(): void;
+    };
+}
+/** What a @Subscribe is given: the channel's context, the member, and the payload as its schema made it. */
+export interface GatewayMessageContext<P = unknown> extends GatewayContext {
+    payload: P;
+}
+/** v2 held a room a minute after its last member: twice the slowest client's heartbeat, and margin. */
+export declare const DEFAULT_GRACE_MS = 60000;
+/** A durable gateway keeps what it sends a day unless it says; a week at most. */
+export declare const DEFAULT_KEEP_SECONDS = 86400;
+export declare const MAX_KEEP_SECONDS = 604800;
+/** The most a @Subscribe's ack carries (realtime's roomReplyMax). */
+export declare const MAX_REPLY_BYTES: number;
+/**
+ * Why `pattern` is no gateway's, or undefined. A pattern is a channel's: ':'
+ * segments, a "{name}" segment taking exactly one — and realtime takes a
+ * pattern it cannot decide for no channel at all, silently: the gateway
+ * would compile, ship and never be joined. So everything it would not take is
+ * refused here, by name, while someone is looking.
+ */
+export declare function patternProblem(pattern: string): string | undefined;
+/**
+ * A class whose methods manage the channels `pattern` names (see the top of
+ * this file). It is a provider a module lists (its constructor injected as
+ * any provider's), built once: what @OnFirst starts and @OnEmpty stops lives
+ * in it. Its events are its class's `static readonly events`.
+ */
+export declare function Gateway(pattern: string, options?: GatewayOptions): ClassDecorator;
+/** Who may join: answers a GatewayGrant (GatewayAuthorizeContext) — for a gateway with no access of realtime's. */
+export declare const Authorize: () => MethodDecorator;
+/**
+ * The channel is occupied and held by no one: start what it needs. Told once
+ * across realtime's replicas when its first member comes — before that
+ * member is answered — and again only after it emptied.
+ */
+export declare const OnFirst: () => MethodDecorator;
+/** A member joined (after it was answered): what it emits goes to that member alone. */
+export declare const OnConnect: () => MethodDecorator;
+/** A member left. */
+export declare const OnDisconnect: () => MethodDecorator;
+/** Nobody has been on the channel for its graceMs: stop what @OnFirst started. Its signal is aborted already. */
+export declare const OnEmpty: () => MethodDecorator;
+/**
+ * A message a member sends, `name`, its payload checked against `schema`
+ * before the method runs (GatewayMessageContext): a payload that does not
+ * fit never reaches it, and the member hears why. What the method returns
+ * is the member's ack — `reply` its schema in every generated client.
+ */
+export declare function Subscribe(name: string, schema: StandardSchemaV1, options?: {
+    reply?: StandardSchemaV1;
+}): MethodDecorator;
+/** The gateway a class declares, or undefined: a gateway is one by its decorator, never its name. */
+export declare function gatewayOf(cls: Function): GatewayDeclaration | undefined;
+/** A gateway's channel's parameters, or undefined when the channel is not one of its. */
+export declare function matchChannel(pattern: string, channel: string): Record<string, string> | undefined;
+/** The channel of a gateway's parameters: each named by its pattern, a whole segment — or why not. */
+export declare function channelOf(pattern: string, params: Readonly<Record<string, unknown>>): string | {
+    problem: string;
+};
+/** One event to a gateway's members, as realtime's broadcast takes it: its channel (topic), and conn_id for one membership alone. */
+type GatewayBroadcast = realtime.BroadcastMessage;
+export interface GatewayDeps {
+    /**
+     * `work` as the platform's caller names it — in a transaction as `user`,
+     * or as the app itself when the moment is no one's (first, empty) —
+     * committed unless it throws, or the platform hung up before it ended.
+     */
+    run<T>(user: SignedUser | undefined, where: string, signal: AbortSignal | undefined, work: () => Promise<T>): Promise<T>;
+    /** realtime's POST /realtime/broadcast, as the app (its secret key). */
+    broadcast(messages: GatewayBroadcast[]): Promise<unknown>;
+    /** The platform's infrastructure, not the method, failed: the call is answered 503, and realtime asks again. */
+    isOutage(e: unknown): boolean;
+}
+/** What a gateway's call is answered: JSON, nothing (204), or a refusal. */
+export type GatewayAnswer = {
+    status: 200;
+    body: unknown;
+} | {
+    status: 204;
+} | {
+    status: number;
+    code: string;
+    message: string;
+    retryAfter?: number;
+};
+export interface Gateways {
+    readonly declarations: readonly GatewayDeclaration[];
+    /** The platform's call about a gateway — authorize, message or lifecycle — its JSON body. */
+    serve(kind: string, body: unknown, signal?: AbortSignal): Promise<GatewayAnswer>;
+    /** An event to a gateway's channel from anywhere in the app (Palbase.gateways.to). */
+    emit(cls: Function, params: Readonly<Record<string, unknown>>, event: string, payload: unknown): void;
+    /** A source piped into a gateway's channel from anywhere in the app (Palbase.gateways.to(…).pipe). */
+    pipe(cls: Function, params: Readonly<Record<string, unknown>>, source: PipeSource): Promise<void>;
+    /** Every channel let go: what was held is aborted (the app is stopping). */
+    close(): void;
+}
+/** The app's gateways, served: `classes` its providers that are gateways, each with its instance. */
+export declare function createGateways(classes: {
+    cls: Function;
+    instance: object;
+}[], deps: GatewayDeps): Gateways;
+export {};

package/types/backend/src/index.d.ts

@@ -1,9 +1,9 @@
 import 'reflect-metadata';
 export { Body, Client, Controller, Delete, Get, getRegisteredControllers, getRoutes, Headers, Cron, Injectable, Module, On, OptionalUser, Param, Patch, Post, Put, Query, QueryParams, Req, RequestId, Resolve, TraceId, User, Webhook, type AuthConfig, type AuthSpec, type ControllerOptions, type EventHandler, type CronMeta, type CronOptions, type ModuleDef, type OnOptions, type ParamResolver, type RateLimitConfig, type ResolveContext, type RouteInfo, type RouteOptions, type SignatureSpec, type StandardSchemaV1, type Token, type WebhookOptions, type WebhookProvider, } from './decorators.js';
 export { Task, TaskFailure, Tasks, type EnqueueOptions, type PayloadOf, type QueuedTask, type TaskClass, type TaskMeta, type TaskOptions, type TasksService } from './tasks.js';
-export { defineChannels, ownerOnly, publicChannel, type ChannelAuthorizeCtx, type ChannelEntry, type ChannelGrant, type ChannelsDef, type ChannelsInput } from './channels.js';
 export { Upload, UploadedObject, type UploadConfig } from './upload.js';
-export { OnAuthorize, OnEmpty, OnFirst, OnJoin, OnLeave, OnMessage, Room, type RoomAuthorizeContext, type RoomContext, type RoomGrant, type RoomMessageContext, type RoomOptions, type RoomUser, } from './rooms.js';
+export { Authorize, ChatPart, Gateway, GatewayRefusal, OnConnect, OnDisconnect, OnEmpty, OnFirst, Subscribe, type GatewayAuthorizeContext, type GatewayContext, type GatewayEvents, type GatewayGrant, type GatewayMessageContext, type GatewayOptions, type GatewayUser, type PipeSource, } from './gateways.js';
+export type { GatewaysApi, GatewayTarget } from './runtime.js';
 export { getWebhookManifest, type WebhookEventHandler, type WebhookMeta } from './webhooks.js';
 export { DiError, type DiErrorKind } from './container.js';
 export { BadRequest, Conflict, DeadlockDetected, Forbidden, HttpError, NotFound, PalError, SerializationFailure, TooManyRequests, Unauthorized, UniqueViolation, defineError, type DefinedError, type DefinedErrorWithData, type Envelope, type FieldIssue, } from './errors.js';

package/types/backend/src/openapi.d.ts

@@ -1,7 +1,6 @@
 import type { RateLimitConfig, StandardSchemaV1 } from './decorators.js';
 import type { RegisteredError } from './errors.js';
-import type { ChannelRow } from './channels.js';
-import type { RoomDeclaration } from './rooms.js';
+import { type GatewayDeclaration } from './gateways.js';
 import type { Route } from './router.js';
 /** Where the platform delivers the project's events to the app. */
 export declare const PLATFORM_EVENTS_PATH = "/webhooks/palbase";
@@ -33,10 +32,8 @@ export interface ContractOptions {
     routes?: (route: Route) => RouteContract | undefined;
     /** The release's errors by wire code (defineError's registry): what a thrown code is typed as. */
     errors?: ReadonlyMap<string, RegisteredError>;
-    /** The app's @Room classes, as their decorators declare them. */
-    rooms?: readonly RoomDeclaration[];
-    /** The owner and public channels defineChannels declares, in its order: x-palbase-channels, decided by realtime itself. */
-    channels?: readonly ChannelRow[];
+    /** The app's @Gateway classes, as their decorators declare them. */
+    gateways?: readonly GatewayDeclaration[];
 }
 /** What a route answers and throws, as its source declares. */
 export interface RouteContract {