@turbobase/cli 1.8.0 → 1.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
|
@@ -3611,7 +3611,7 @@ ${o.map(k0).join(`
|
|
|
3611
3611
|
`))}async function wb(t,e,r=fo){let n=[...new Set(t.map(a=>a.trim()).filter(Boolean))];n.length===0&&x("name at least one skill slug. `turbobase skills list` shows them.");let o=await mo(e,r);if(!await ua(`Publish ${n.length} skill(s)?`,"Yes \u2014 publish them","their text is injected into every matching turn from now on",e))return;let i;try{i=await ae("publishing",()=>o.skillsPublish(n))}catch(a){se(a,"skills:publish","publish a skill"),x(`publish failed: ${a instanceof Error?a.message:String(a)}`)}_(g.green(`published ${i.published.length} skill(s) \u2014 live now.`)),i.unknown.length>0&&(q(g.yellow(`no such skill: ${i.unknown.join(", ")}`)),process.exitCode=1),q(g.dim(`release v${i.version.version_no} \xB7 undo with: turbobase skills unpublish ${i.published.join(" ")}`))}async function vb(t,e,r=fo){let n=[...new Set(t.map(a=>a.trim()).filter(Boolean))];n.length===0&&x("name at least one skill slug. `turbobase skills list` shows them.");let o=await mo(e,r);if(!await ua(`Move ${n.length} skill(s) back to draft?`,"Yes \u2014 unpublish them","they stop being injected immediately; the text and its history are kept",e))return;let i;try{i=await ae("unpublishing",()=>o.skillsUnpublish(n))}catch(a){se(a,"skills:publish","unpublish a skill"),x(`unpublish failed: ${a instanceof Error?a.message:String(a)}`)}_(g.green(`unpublished ${i.unpublished.length} skill(s) \u2014 retracted now.`)),q(g.dim(`release v${i.version.version_no} \xB7 re-publish with: turbobase skills publish ${i.unpublished.join(" ")}`)),i.unknown.length>0&&(q(g.yellow(`no such skill: ${i.unknown.join(", ")}`)),process.exitCode=1)}async function _b(t,e,r=fo){let n=Number(t);(!Number.isInteger(n)||n<1)&&x(`--version must be a release number (got '${t}'). \`turbobase skills releases\` lists them.`);let o=await mo(e,r);if(await ua(`Roll the skills back to release v${n}?`,"Yes \u2014 restore that release","content only: a skill an operator has since unpublished stays off",e))try{let i=await ae("rolling back",()=>o.skillsRollback(n));_(g.green(`rolled back to v${i.version.version_no}.`))}catch(i){se(i,"skills:publish","roll back a skills release"),x(`rollback failed: ${i instanceof Error?i.message:String(i)}`)}}async function xb(t,e=fo){let r=await mo(t,e),n;try{n=await ae("reading the releases",()=>r.skillsReleases())}catch(o){se(o,"skills:publish","read the skills releases"),x(`could not read the releases: ${o instanceof Error?o.message:String(o)}`)}if(n.items.length===0){q("no releases yet.");return}for(let o of n.items){let s=o.is_current?g.green("*"):" ",i=o.release_note?` \u2014 ${o.release_note}`:"";_(`${s} v${o.version_no} ${o.skill_count} skill(s) ${g.dim(o.published_at)}${o.published_by?g.dim(` by ${o.published_by}`):""}${g.dim(i)}`)}}async function kb(t,e,r=fo){let n=[...new Set((t??[]).map(l=>l.trim()).filter(Boolean))];n.length===0&&x("name at least one skill to delete. `turbobase skills list` shows the slugs.");let o=await mo(e,r);if(!await ua(n.length===1?`Delete the skill '${n[0]}'?`:`Delete ${n.length} skills?
|
|
3612
3612
|
${n.join(`
|
|
3613
3613
|
`)}`,"Yes \u2014 delete them","permanent: the rows and their text are removed. Prior releases keep their own copy.",e))return;let i=[],a=[];for(let l of n)try{i.push(await ae(`deleting ${l}`,()=>o.skillsDelete(l)))}catch(u){if(u instanceof le&&u.status===404){a.push(l);continue}i.length>0&&q(g.dim(`deleted before the error: ${i.map(p=>p.slug).join(", ")}`)),se(u,"skills:publish","delete a skill"),x(`delete failed on '${l}': ${u instanceof Error?u.message:String(u)}`)}i.length>0&&_(g.green(`deleted ${i.length} skill(s).`));let c=i.filter(l=>l.wasPublished).map(l=>l.slug);c.length>0&&q(g.yellow(`Published until now, so no longer injected: ${c.join(", ")}`)),a.length>0&&(q(g.yellow(`no such skill: ${a.join(", ")}`)),process.exitCode=1)}import{promises as $b}from"node:fs";import{join as G0,relative as J0,resolve as Y0,sep as X0}from"node:path";var Q0=new Set(["node_modules","dist","build","coverage",".git",".claude",".turbobase",".next",".svelte-kit",".vercel",".cache"]),eP=new Set([".mcp.json",".env"]);function tP(t){return eP.has(t)||t.startsWith(".env.")&&t!==".env.example"}function rP(t){return Buffer.compare(Buffer.from(t.toString("utf8"),"utf8"),t)===0}function nP(t){return t.includes(0)}async function Sb(t){let e=Y0(t),r={},n=[],o=[],s=[];async function i(a){let c=await $b.readdir(a,{withFileTypes:!0});for(let l of c){let u=G0(a,l.name);if(Q0.has(l.name))continue;if(l.isDirectory()){await i(u);continue}if(!l.isFile())continue;let p=J0(e,u).split(X0).join("/");if(tP(l.name)){o.push(p);continue}let b=await $b.readFile(u);if(!rP(b)){n.push(p);continue}nP(b)&&s.push(p),r[p]=b.toString("utf8")}}return await i(e),{files:r,skipped:n,secrets:o,unstorable:s}}import{randomBytes as oP}from"node:crypto";var sP="/_tb/app-assets",iP=16,aP=/^[0-9a-f]{32}$/;function Tb(){return oP(iP).toString("hex")}function cP(t){return aP.test(t)}function Eb(t){if(!cP(t))throw new Error(`not a build id: ${t}`);return`${sP}/${t}/`}var Rb=7;wu();var vu=50*1024*1024;import da from"node:fs/promises";import hs from"node:path";var _u={esbuild:"0.28.1","isolated-vm":"6.1.2"},xu="@turbobase/isolated-vm-prebuilds";function ku(t,e){return`${t}-${e}`}function $u(t=process.versions){return`abi${t.modules}`}var Pb=["darwin-x64","win32-arm64"];async function Ab(t){let e=t.platform??process.platform,r=t.arch??process.arch,n=ku(e,r),o=hs.join(t.home,"node_modules"),s=hs.join(o,...xu.split("/"),"prebuilds",n),i=hs.join(o,"isolated-vm","prebuilds",n),a;try{a=await da.readdir(s)}catch{return[]}let c=[];await da.mkdir(i,{recursive:!0});for(let l of a){if(!l.endsWith(".node"))continue;let u=hs.join(i,l);try{await da.copyFile(hs.join(s,l),u,da.constants?.COPYFILE_EXCL??1),c.push(l)}catch{}}return c}import{homedir as lP}from"node:os";import{join as Ib}from"node:path";import{promises as Su}from"node:fs";function Cb(){let t=process.env.TURBOBASE_HOME??Ib(lP(),".turbobase");return{dir:t,file:Ib(t,"sandboxes.json")}}var uP={s:1e3,m:6e4,h:36e5,d:864e5};function dP(t){let e=/^\s*(\d+)\s*([smhd])\s*$/.exec(t);if(!e)throw new Error(`invalid --ttl '${t}': expected <number><unit> where unit is s|m|h|d (e.g. 72h, 30m, 7d).`);let r=Number(e[1]);if(!Number.isFinite(r)||r<=0)throw new Error(`invalid --ttl '${t}': duration must be a positive integer.`);return r*uP[e[2]]}function pP(t,e=Date.now()){return new Date(e+dP(t)).toISOString()}function hP(t,e=Date.now()){let r=Date.parse(t);return Number.isNaN(r)?!0:r<=e}function fP(t){let e=/^\s*(\d+(?:\.\d+)?)\s*%?\s*$/.exec(t);if(!e)throw new Error(`invalid --sample '${t}': expected a percent like 2% (or a bare number).`);let r=Number(e[1]);if(!Number.isFinite(r)||r<0||r>100)throw new Error(`invalid --sample '${t}': percent must be between 0 and 100.`);return r/100}function mP(t,e){if(e>=1)return[...t];if(e<=0||t.length===0)return[];let r=Math.max(1,Math.round(1/e)),n=[];for(let o=0;o<t.length;o+=r)n.push(t[o]);return n}var gP="[REDACTED]",fs=class extends Error{constructor(e){super(e),this.name="SandboxDataCopyUnavailableError"}},Tu=class extends Error{table;column;constructor(e,r,n){super(`Refusing to copy ${e}.${r} into a sandbox: ${n}. A sandbox must never hold un-redacted PII \u2014 classify the column 'safe' (non-PII) or let redaction mask it, then retry.`),this.name="UnredactedPiiError",this.table=e,this.column=r}};function yP(t,e,r){let n={};for(let[o,s]of Object.entries(e)){let i=r[o];if(i===void 0)throw new Tu(t,o,"column has no PII classification (unknown = unsafe)");i==="pii"?n[o]=s==null?s:gP:n[o]=s}return n}function bP(t,e,r){return e.map(n=>yP(t,n,r))}var Ob=new Set(["localhost","127.0.0.1","::1","0.0.0.0"]),wP=["oraclecloud.com","us-ashburn-1","amazonaws.com","rds.","supabase.co","turbobase.app","turbobase.io"];function vP(t){let e=t.trim();try{let o=new URL(e);if(o.hostname)return o.hostname.toLowerCase()}catch{}let r=e.replace(/^[a-z]+:\/\//i,""),n=(r.split("/")[0]??r).split("@").pop()??r;return(n.split(":")[0]??n).toLowerCase()}function Eu(t){if(!t||!t.trim())throw new Error("local-only guard: empty database target \u2014 refusing to proceed.");let e=t.toLowerCase();for(let n of wP)if(e.includes(n))throw new Error(`local-only guard: target '${t}' looks like a cloud/prod context (matched '${n}'). \`turbobase sandbox create\` is LOCAL-ONLY and will never touch a cloud database.`);let r=vP(t);if(!Ob.has(r))throw new Error(`local-only guard: target host '${r}' is not a recognised local Postgres (${[...Ob].join(", ")}). \`turbobase sandbox create\` is LOCAL-ONLY.`)}function _P(t,e=xP){return`sbx-${t.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"").slice(0,24)||"tenant"}-${e()}`}function xP(){return Math.floor(Math.random()*16777215).toString(16).padStart(6,"0")}function kP(t){return`turbobase_${t.replace(/[^a-z0-9]+/gi,"_").toLowerCase()}`}function $P(t,e){return`${(e??process.env.TURBOBASE_SANDBOX_BASE_URL??"http://localhost:5173").replace(/\/+$/,"")}/?sandbox=${encodeURIComponent(t)}`}async function Ru(){let{file:t}=Cb();try{let e=await Su.readFile(t,"utf8"),r=JSON.parse(e);return Array.isArray(r)?r:[]}catch(e){if(e.code==="ENOENT")return[];throw e}}async function Nb(t){let{dir:e,file:r}=Cb();await Su.mkdir(e,{recursive:!0}),await Su.writeFile(r,`${JSON.stringify(t,null,2)}
|
|
3614
|
-
`,{mode:384})}async function SP(t){let e=await Ru();e.push(t),await Nb(e)}async function zb(t){let e=await Ru(),r=e.findIndex(o=>o.name===t);if(r===-1)return null;let[n]=e.splice(r,1);return await Nb(e),n??null}async function pa(){return Ru()}function Pu(t,e=Date.now()){let r=[],n=[];for(let o of t)hP(o.expiresAt,e)?n.push(o):r.push(o);return{active:r,expired:n}}async function jb(t,e){Eu(t.target());let r=t.dataCopyUnavailable?.();if(r)throw new fs(r);let n=fP(e.sample),o=e.now??Date.now(),s=(e.nameGen??(l=>_P(l)))(e.fromTenant),i=kP(s);await t.createDatabase(i),await t.replayMigrations(i);let a=await t.readSourceTables(e.fromTenant);for(let l of a){let u=mP(l.rows,n),p=bP(l.table,u,l.classification);p.length>0&&await t.copyRows(i,l.table,p)}let c={name:s,fromTenant:e.fromTenant,database:i,createdAt:new Date(o).toISOString(),expiresAt:pP(e.ttl,o),sampleFraction:n,url:$P(s,e.baseUrl)};return await SP(c),c}async function Lb(t,e){Eu(t.target());let n=(await pa()).find(o=>o.name===e);return n?(await t.dropDatabase(n.database),await zb(e),n):null}async function Au(t,e=Date.now()){Eu(t.target());let r=await pa(),{expired:n}=Pu(r,e),o=[];for(let s of n){try{await t.dropDatabase(s.database)}catch{continue}await zb(s.name),o.push(s)}return o}var ms={pat:{prefix:"tb_pat_",defaultScopes:["extensions:deploy"],allowedScopes:["extensions:deploy","catalog:read","mcp:authoring","analyzer:run","releases:write","solutions:write","skills:publish","docs:publish"],defaultTtlDays:90,mintable:!0,label:"Personal access token"},catalog:{prefix:"tb_cat_",defaultScopes:["catalog:read"],allowedScopes:["catalog:read"],defaultTtlDays:null,mintable:!0,label:"AI / catalog token"}},QZ=Object.keys(ms).filter(t=>ms[t].mintable);var rB=ms.pat.prefix,TP=Object.entries(ms).map(([t,e])=>[e.prefix,t]),EP=/^[A-Za-z0-9_-]{20,}$/;function RP(t){if(typeof t!="string")return null;for(let[e,r]of TP)if(t.startsWith(e)&&EP.test(t.slice(e.length)))return r;return null}function Db(t){return RP(t)==="pat"}ns();var PP=8e3,AP={revoked:"the instance REVOKED this token \u2014 mint a new PAT (Settings \u203A Access tokens) and run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`",expired:"this token has EXPIRED \u2014 mint a new PAT (Settings \u203A Access tokens) and run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`",unknown:"this instance has never seen this token \u2014 it was deleted, or it belongs to a DIFFERENT instance; check the base-url before minting a new PAT",suspended:"the user this token belongs to is SUSPENDED \u2014 an instance administrator has to restore the account; a new token will not help",malformed:"the stored credential is not shaped like a Turbobase PAT (tb_pat_\u2026) \u2014 sign in again",missing:"no token reached the instance \u2014 sign in again",transient:"the instance could not verify the token right now (a storage error, not a decision about the token) \u2014 retry"};function IP(t){return AP[t]??`the instance rejected this token (${t}) \u2014 run \`turbobase auth login\` to store a fresh PAT`}async function OP(t,e,r=fetch){let n;try{n=await r(`${t}/v1/catalog/records`,{method:"GET",headers:{Authorization:`Bearer ${e}`,Accept:"application/json"},signal:AbortSignal.timeout(PP)})}catch(s){return{state:"unreachable",detail:s instanceof Error?s.message:String(s)}}if(n.status===200||n.status===403)return{state:"accepted"};if(n.status===401){let s=await n.json().catch(()=>null);return{state:"rejected",reason:typeof s?.reason=="string"&&s.reason?s.reason:"unknown"}}return(n.headers.get("content-type")??"").includes("application/json")?{state:"accepted"}:{state:"unreachable",detail:`HTTP ${n.status} \u2014 this host does not serve the /v1 API`}}function Mb(t){return t.state==="accepted"?et()?g.green("accepted"):"accepted":t.state==="rejected"?et()?g.red(`rejected \xB7 ${t.reason}`):`rejected \xB7 ${t.reason}`:et()?g.yellow("unreachable"):"unreachable"}async function Ub(t={},e=fetch){let r=await Tr(),{file:n}=Bi();if(r.length===0){_("not signed in. Run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`."),q(g.dim(`no sign-ins stored in ${n}.`));return}let o=await Yt(),s=await Promise.all(r.map(async i=>({baseUrl:i.baseUrl,active:!!o&&i.baseUrl===o.baseUrl,updatedAt:i.updatedAt,check:t.probe===!1?{state:"accepted"}:await OP(i.baseUrl,i.token,e)})));if(t.probe===!1)for(let i of s)_(`${i.active?"* ":" "}${i.baseUrl} (updated ${i.updatedAt})`);else if(et())_(Xt(s.map(i=>[i.active?g.green("*"):" ",g.bold(i.baseUrl),Mb(i.check),g.dim(i.updatedAt)]),{head:["","instance","token","updated"]}));else for(let i of s)_(`${i.active?"* ":" "}${i.baseUrl} ${Mb(i.check)} (updated ${i.updatedAt})`);q(g.dim(`tokens read from ${n}`));for(let i of s)i.check.state==="rejected"?(q(g.red(`${i.baseUrl}: ${IP(i.check.reason)}.`)),q(g.dim(" then re-run `turbobase project init` \u2014 .mcp.json holds its own copy of the token, and until it is rewritten the authoring MCP tools stay absent from your session."))):i.check.state==="unreachable"&&q(g.yellow(`${i.baseUrl}: could not reach the instance (${i.check.detail}).`));o||q("no active default \u2014 run `turbobase auth use <base-url>` or pass --base-url.")}async function oM(t){let e=await Tr();e.length===0&&x("no stored sign-ins \u2014 run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`."),ft()||x("this command needs an explicit <base-url> in a non-interactive shell.");try{return await mt(t,e.map(r=>({value:r.baseUrl,label:r.baseUrl,description:`updated ${r.updatedAt}`})))}catch{x("cancelled.")}}async function sM(t,e){let r;try{r=await fetch(`${t}/v1/catalog/records`,{method:"GET",headers:{Authorization:`Bearer ${e}`,Accept:"application/json"},signal:AbortSignal.timeout(8e3)})}catch(o){return{ok:!1,kind:"unreachable",detail:o instanceof Error?o.message:String(o)}}let n=(r.headers.get("content-type")??"").includes("application/json");return r.status===200||r.status===403?{ok:!0}:r.status===401?{ok:!1,kind:"bad-token",detail:`HTTP ${r.status}`}:n?{ok:!0}:{ok:!1,kind:"wrong-host",detail:`HTTP ${r.status}`}}function iM(t){q(""),q("Sharing is ON. Two things reach the Turbobase product team from this instance:"),q(" \xB7 anonymized pattern cards from your proposals, solutions and INSTANCE-LEARNINGS.md \u2014"),q(" a pattern label, a record class, a fix shape, an outcome. No scripts, values or ids."),q(" \xB7 redacted prose from your projects\u2019 TURBOBASE-FEEDBACK.md \u2014 the findings you write"),q(" about OUR platform, with instance name, user names and ids masked before they leave."),q(`Turn it off: ${t}/admin/settings \u2192 Telemetry \u2192 "Share learnings and platform feedback".`),q("")}async function aM(t,e,r){let n=await Wg({baseUrl:t,token:e}),o=(await Tr()).length-1;if(_(`signed in to ${n.baseUrl} \u2014 now the active instance`+(o>0?` (${o} other${o===1?"":"s"} stored; commands default here).`:".")),iM(n.baseUrl),!r)return;let s=await sM(n.baseUrl,e);s.ok||(s.kind==="wrong-host"?(q(`warning: ${n.baseUrl} did not respond to the Turbobase API (/v1) \u2014 got ${s.detail}.`),q(" In local dev the Turbobase API is on :4100, not the app dev-server port (e.g. :5173)."),q(" The token is stored, but commands will fail against this base-url until it points at the API.")):s.kind==="bad-token"?q(`warning: ${n.baseUrl} rejected the token (401) \u2014 the PAT may be stale, revoked, or for a different instance.`):q(`warning: could not reach ${n.baseUrl} to verify the token (${s.detail}). Stored anyway.`))}async function cM(t){let e=await as(t),r=du(e);if(!r){let n=/\bdefineConduit\s*[<(]/.test(e);x(n?`could not parse id/on/from.source/from.recordType from ${t} \u2014 is it a defineConduit({...}) file?`:`could not parse id/recordType/event from ${t} \u2014 is it a defineHook({...}) file?`)}return{...r,sourceCode:e}}async function Vo(t,e,r,n){try{return await ye.access(t),"skipped"}catch{}return await ye.mkdir(Ho(t),{recursive:!0}),await ye.writeFile(t,e,{mode:n??(r?493:420)}),n!==void 0&&await ye.chmod(t,n),"wrote"}async function DS(t,e){if(US(t)!==".gitignore")return Vo(t,e.content,e.executable,e.mode);let r=await ye.readFile(t,"utf8").catch(()=>null);if(r===null)return Vo(t,e.content,e.executable,e.mode);let n=Cy(r);return n===null?"skipped":(await ye.writeFile(t,n,"utf8"),"merged")}function Vm(t){if(t!==void 0){if(t==="junit"||t==="json")return t;x(`unknown --reporter '${t}' (expected 'junit' or 'json').`)}}function sl(t){process.exit(t)}function lM(t){return{name:"turbobase ext test",cases:t.map(r=>{if(r.pass)return{name:r.name,status:"passed"};let n=r.error?"error":r.rejection?.code??"mismatch",o=r.error?`error: ${r.error}`:r.observed!==r.expected?`expected ${r.expected}, observed ${r.observed}`+(r.rejection?` (rejected: ${r.rejection.code??"rejected"}${r.rejection.message?` \u2014 ${r.rejection.message}`:""})`:""):`rejected: ${r.rejection?.code??"rejected"}${r.rejection?.message?` \u2014 ${r.rejection.message}`:""}`;return{name:r.name,status:"failed",detail:o,type:n}})}}function uM(t,e){let r=e.warnings.length===0?[{name:`${t} (${e.kind})`,status:"passed"}]:e.warnings.map(n=>({name:`${t}: ${n.rule}`,status:"failed",type:n.rule,detail:`${n.message} \u2192 fix: ${n.fix}`}));return{name:`turbobase ext lint ${t}`,cases:r}}function dM(t){let e=[];if(t.error)return e.push({name:`replay ${t.fixtureName}`,status:"failed",type:"error",detail:t.error}),{name:`turbobase ext replay ${t.fixtureName}`,cases:e};for(let r of t.guards)e.push(r.status==="failed"?{name:`guard: ${r.name}`,status:"failed",type:r.name,detail:r.detail}:{name:`guard: ${r.name}`,status:"passed",detail:r.status==="skipped-offline"?`skipped-offline: ${r.detail}`:void 0});return t.whenPassed&&t.applyBranch&&e.push({name:`apply-branch: ${t.applyBranch}`,status:"passed",detail:`${t.masterAction??""} (${t.wouldWriteBindings.length} binding(s) would be written)`.trim()}),{name:`turbobase ext replay ${t.fixtureName}`,cases:e}}function MS(t){return`${(Math.ceil(t/1048576*10)/10).toFixed(1).replace(/\.0$/,"")} MiB`}function Xm({includeInternal:t=!0}={}){let e=new yg;e.name("turbobase").description("Build apps, author extensions, and drive your Turbobase instance.").version("1.8.0").option("--no-color","Disable ANSI colour + animations (also honoured via NO_COLOR / non-TTY)."),e.addHelpText("beforeAll",d=>d.command.parent?"":`${su()}
|
|
3614
|
+
`,{mode:384})}async function SP(t){let e=await Ru();e.push(t),await Nb(e)}async function zb(t){let e=await Ru(),r=e.findIndex(o=>o.name===t);if(r===-1)return null;let[n]=e.splice(r,1);return await Nb(e),n??null}async function pa(){return Ru()}function Pu(t,e=Date.now()){let r=[],n=[];for(let o of t)hP(o.expiresAt,e)?n.push(o):r.push(o);return{active:r,expired:n}}async function jb(t,e){Eu(t.target());let r=t.dataCopyUnavailable?.();if(r)throw new fs(r);let n=fP(e.sample),o=e.now??Date.now(),s=(e.nameGen??(l=>_P(l)))(e.fromTenant),i=kP(s);await t.createDatabase(i),await t.replayMigrations(i);let a=await t.readSourceTables(e.fromTenant);for(let l of a){let u=mP(l.rows,n),p=bP(l.table,u,l.classification);p.length>0&&await t.copyRows(i,l.table,p)}let c={name:s,fromTenant:e.fromTenant,database:i,createdAt:new Date(o).toISOString(),expiresAt:pP(e.ttl,o),sampleFraction:n,url:$P(s,e.baseUrl)};return await SP(c),c}async function Lb(t,e){Eu(t.target());let n=(await pa()).find(o=>o.name===e);return n?(await t.dropDatabase(n.database),await zb(e),n):null}async function Au(t,e=Date.now()){Eu(t.target());let r=await pa(),{expired:n}=Pu(r,e),o=[];for(let s of n){try{await t.dropDatabase(s.database)}catch{continue}await zb(s.name),o.push(s)}return o}var ms={pat:{prefix:"tb_pat_",defaultScopes:["extensions:deploy"],allowedScopes:["extensions:deploy","catalog:read","mcp:authoring","analyzer:run","releases:write","solutions:write","skills:publish","docs:publish"],defaultTtlDays:90,mintable:!0,label:"Personal access token"},catalog:{prefix:"tb_cat_",defaultScopes:["catalog:read"],allowedScopes:["catalog:read"],defaultTtlDays:null,mintable:!0,label:"AI / catalog token"}},QZ=Object.keys(ms).filter(t=>ms[t].mintable);var rB=ms.pat.prefix,TP=Object.entries(ms).map(([t,e])=>[e.prefix,t]),EP=/^[A-Za-z0-9_-]{20,}$/;function RP(t){if(typeof t!="string")return null;for(let[e,r]of TP)if(t.startsWith(e)&&EP.test(t.slice(e.length)))return r;return null}function Db(t){return RP(t)==="pat"}ns();var PP=8e3,AP={revoked:"the instance REVOKED this token \u2014 mint a new PAT (Settings \u203A Access tokens) and run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`",expired:"this token has EXPIRED \u2014 mint a new PAT (Settings \u203A Access tokens) and run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`",unknown:"this instance has never seen this token \u2014 it was deleted, or it belongs to a DIFFERENT instance; check the base-url before minting a new PAT",suspended:"the user this token belongs to is SUSPENDED \u2014 an instance administrator has to restore the account; a new token will not help",malformed:"the stored credential is not shaped like a Turbobase PAT (tb_pat_\u2026) \u2014 sign in again",missing:"no token reached the instance \u2014 sign in again",transient:"the instance could not verify the token right now (a storage error, not a decision about the token) \u2014 retry"};function IP(t){return AP[t]??`the instance rejected this token (${t}) \u2014 run \`turbobase auth login\` to store a fresh PAT`}async function OP(t,e,r=fetch){let n;try{n=await r(`${t}/v1/catalog/records`,{method:"GET",headers:{Authorization:`Bearer ${e}`,Accept:"application/json"},signal:AbortSignal.timeout(PP)})}catch(s){return{state:"unreachable",detail:s instanceof Error?s.message:String(s)}}if(n.status===200||n.status===403)return{state:"accepted"};if(n.status===401){let s=await n.json().catch(()=>null);return{state:"rejected",reason:typeof s?.reason=="string"&&s.reason?s.reason:"unknown"}}return(n.headers.get("content-type")??"").includes("application/json")?{state:"accepted"}:{state:"unreachable",detail:`HTTP ${n.status} \u2014 this host does not serve the /v1 API`}}function Mb(t){return t.state==="accepted"?et()?g.green("accepted"):"accepted":t.state==="rejected"?et()?g.red(`rejected \xB7 ${t.reason}`):`rejected \xB7 ${t.reason}`:et()?g.yellow("unreachable"):"unreachable"}async function Ub(t={},e=fetch){let r=await Tr(),{file:n}=Bi();if(r.length===0){_("not signed in. Run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`."),q(g.dim(`no sign-ins stored in ${n}.`));return}let o=await Yt(),s=await Promise.all(r.map(async i=>({baseUrl:i.baseUrl,active:!!o&&i.baseUrl===o.baseUrl,updatedAt:i.updatedAt,check:t.probe===!1?{state:"accepted"}:await OP(i.baseUrl,i.token,e)})));if(t.probe===!1)for(let i of s)_(`${i.active?"* ":" "}${i.baseUrl} (updated ${i.updatedAt})`);else if(et())_(Xt(s.map(i=>[i.active?g.green("*"):" ",g.bold(i.baseUrl),Mb(i.check),g.dim(i.updatedAt)]),{head:["","instance","token","updated"]}));else for(let i of s)_(`${i.active?"* ":" "}${i.baseUrl} ${Mb(i.check)} (updated ${i.updatedAt})`);q(g.dim(`tokens read from ${n}`));for(let i of s)i.check.state==="rejected"?(q(g.red(`${i.baseUrl}: ${IP(i.check.reason)}.`)),q(g.dim(" then re-run `turbobase project init` \u2014 .mcp.json holds its own copy of the token, and until it is rewritten the authoring MCP tools stay absent from your session."))):i.check.state==="unreachable"&&q(g.yellow(`${i.baseUrl}: could not reach the instance (${i.check.detail}).`));o||q("no active default \u2014 run `turbobase auth use <base-url>` or pass --base-url.")}async function oM(t){let e=await Tr();e.length===0&&x("no stored sign-ins \u2014 run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`."),ft()||x("this command needs an explicit <base-url> in a non-interactive shell.");try{return await mt(t,e.map(r=>({value:r.baseUrl,label:r.baseUrl,description:`updated ${r.updatedAt}`})))}catch{x("cancelled.")}}async function sM(t,e){let r;try{r=await fetch(`${t}/v1/catalog/records`,{method:"GET",headers:{Authorization:`Bearer ${e}`,Accept:"application/json"},signal:AbortSignal.timeout(8e3)})}catch(o){return{ok:!1,kind:"unreachable",detail:o instanceof Error?o.message:String(o)}}let n=(r.headers.get("content-type")??"").includes("application/json");return r.status===200||r.status===403?{ok:!0}:r.status===401?{ok:!1,kind:"bad-token",detail:`HTTP ${r.status}`}:n?{ok:!0}:{ok:!1,kind:"wrong-host",detail:`HTTP ${r.status}`}}function iM(t){q(""),q("Sharing is ON. Two things reach the Turbobase product team from this instance:"),q(" \xB7 anonymized pattern cards from your proposals, solutions and INSTANCE-LEARNINGS.md \u2014"),q(" a pattern label, a record class, a fix shape, an outcome. No scripts, values or ids."),q(" \xB7 redacted prose from your projects\u2019 TURBOBASE-FEEDBACK.md \u2014 the findings you write"),q(" about OUR platform, with instance name, user names and ids masked before they leave."),q(`Turn it off: ${t}/admin/settings \u2192 Telemetry \u2192 "Share learnings and platform feedback".`),q("")}async function aM(t,e,r){let n=await Wg({baseUrl:t,token:e}),o=(await Tr()).length-1;if(_(`signed in to ${n.baseUrl} \u2014 now the active instance`+(o>0?` (${o} other${o===1?"":"s"} stored; commands default here).`:".")),iM(n.baseUrl),!r)return;let s=await sM(n.baseUrl,e);s.ok||(s.kind==="wrong-host"?(q(`warning: ${n.baseUrl} did not respond to the Turbobase API (/v1) \u2014 got ${s.detail}.`),q(" In local dev the Turbobase API is on :4100, not the app dev-server port (e.g. :5173)."),q(" The token is stored, but commands will fail against this base-url until it points at the API.")):s.kind==="bad-token"?q(`warning: ${n.baseUrl} rejected the token (401) \u2014 the PAT may be stale, revoked, or for a different instance.`):q(`warning: could not reach ${n.baseUrl} to verify the token (${s.detail}). Stored anyway.`))}async function cM(t){let e=await as(t),r=du(e);if(!r){let n=/\bdefineConduit\s*[<(]/.test(e);x(n?`could not parse id/on/from.source/from.recordType from ${t} \u2014 is it a defineConduit({...}) file?`:`could not parse id/recordType/event from ${t} \u2014 is it a defineHook({...}) file?`)}return{...r,sourceCode:e}}async function Vo(t,e,r,n){try{return await ye.access(t),"skipped"}catch{}return await ye.mkdir(Ho(t),{recursive:!0}),await ye.writeFile(t,e,{mode:n??(r?493:420)}),n!==void 0&&await ye.chmod(t,n),"wrote"}async function DS(t,e){if(US(t)!==".gitignore")return Vo(t,e.content,e.executable,e.mode);let r=await ye.readFile(t,"utf8").catch(()=>null);if(r===null)return Vo(t,e.content,e.executable,e.mode);let n=Cy(r);return n===null?"skipped":(await ye.writeFile(t,n,"utf8"),"merged")}function Vm(t){if(t!==void 0){if(t==="junit"||t==="json")return t;x(`unknown --reporter '${t}' (expected 'junit' or 'json').`)}}function sl(t){process.exit(t)}function lM(t){return{name:"turbobase ext test",cases:t.map(r=>{if(r.pass)return{name:r.name,status:"passed"};let n=r.error?"error":r.rejection?.code??"mismatch",o=r.error?`error: ${r.error}`:r.observed!==r.expected?`expected ${r.expected}, observed ${r.observed}`+(r.rejection?` (rejected: ${r.rejection.code??"rejected"}${r.rejection.message?` \u2014 ${r.rejection.message}`:""})`:""):`rejected: ${r.rejection?.code??"rejected"}${r.rejection?.message?` \u2014 ${r.rejection.message}`:""}`;return{name:r.name,status:"failed",detail:o,type:n}})}}function uM(t,e){let r=e.warnings.length===0?[{name:`${t} (${e.kind})`,status:"passed"}]:e.warnings.map(n=>({name:`${t}: ${n.rule}`,status:"failed",type:n.rule,detail:`${n.message} \u2192 fix: ${n.fix}`}));return{name:`turbobase ext lint ${t}`,cases:r}}function dM(t){let e=[];if(t.error)return e.push({name:`replay ${t.fixtureName}`,status:"failed",type:"error",detail:t.error}),{name:`turbobase ext replay ${t.fixtureName}`,cases:e};for(let r of t.guards)e.push(r.status==="failed"?{name:`guard: ${r.name}`,status:"failed",type:r.name,detail:r.detail}:{name:`guard: ${r.name}`,status:"passed",detail:r.status==="skipped-offline"?`skipped-offline: ${r.detail}`:void 0});return t.whenPassed&&t.applyBranch&&e.push({name:`apply-branch: ${t.applyBranch}`,status:"passed",detail:`${t.masterAction??""} (${t.wouldWriteBindings.length} binding(s) would be written)`.trim()}),{name:`turbobase ext replay ${t.fixtureName}`,cases:e}}function MS(t){return`${(Math.ceil(t/1048576*10)/10).toFixed(1).replace(/\.0$/,"")} MiB`}function Xm({includeInternal:t=!0}={}){let e=new yg;e.name("turbobase").description("Build apps, author extensions, and drive your Turbobase instance.").version("1.9.0").option("--no-color","Disable ANSI colour + animations (also honoured via NO_COLOR / non-TTY)."),e.addHelpText("beforeAll",d=>d.command.parent?"":`${su()}
|
|
3615
3615
|
`),e.hook("preAction",(d,f)=>{Hy(e.opts(),f.opts())});let r=e.command("auth").description("Sign in to an instance and manage stored credentials."),n=e.command("project").description("Set up the local project and the files an agent session reads."),o=e.command("ext").description("Author, test, ship, and observe extensions \u2014 hooks and conduits."),s=e.command("kb").description("Write into the instance's knowledge base."),i=e.command("skills").description("Write standing rules into the instance's agent skills.");r.command("login").description("Sign in to an instance by pasting a personal access token (PAT), stored in ~/.turbobase/credentials.").requiredOption("--base-url <url>","Instance base URL, e.g. https://acme.turbobase.app").option("--token <tb_pat_\u2026>","The PAT to store. Mint one in your app under Settings \u203A Access tokens.").option("--no-verify","Skip the post-login connectivity/token probe.").action(async d=>{let f=jt(d.baseUrl);d.token||x(`auth login needs --token. Mint a PAT in your Turbobase app (Settings \u203A Access tokens), then:
|
|
3616
3616
|
${us} auth login --base-url ${f} --token tb_pat_\u2026`),Db(d.token)||x("--token does not look like a Turbobase PAT (tb_pat_\u2026)."),await aM(f,d.token,d.verify)}),r.command("status").description("Show every stored sign-in, where its token was read from, and whether the instance still accepts it.").option("--no-probe","List the stored sign-ins without asking each instance about its token.").action(async d=>Ub({probe:d.probe})),r.command("use [base-url]").description("Make an already-stored instance the active default (omit the arg to pick interactively).").action(async d=>{let f=d??await oM("Pick the active instance:"),v=await Fi(f);if(!v){let T=await Tr();x(`no stored sign-in for ${jt(f)}.`+(T.length?` Stored: ${T.map(k=>k.baseUrl).join(", ")}.`:"")+` Run \`turbobase auth login --base-url ${jt(f)} --token tb_pat_\u2026\`.`)}_(`active instance \u2192 ${v.baseUrl}.`)}),r.command("logout").description("Remove a stored sign-in (defaults to the active instance).").option("--base-url <url>","Which instance to remove (defaults to the active/single one).").option("--all","Remove every stored sign-in.").action(async d=>{if(d.all){let T=await Tr();for(let k of T)await Hl(k.baseUrl);_(`removed ${T.length} stored sign-in${T.length===1?"":"s"}.`);return}let f=await Hl(d.baseUrl);f||x(d.baseUrl?`no stored sign-in for ${jt(d.baseUrl)}.`:"nothing to sign out of (or ambiguous \u2014 pass --base-url / --all).");let v=await Yt();_(`signed out of ${f}.`+(v?` Active instance \u2192 ${v.baseUrl}.`:""))}),n.command("types").description("Generate types.ts from the signed-in instance's catalog.").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("-o, --out <file>","Output file","types.ts").option("--records-only","Emit only record-shape interfaces (skip the OpenAPI half).").action(async d=>{let{baseUrl:f,token:v}=await ne(d.baseUrl),T;try{T=await En({baseUrl:f,token:v,recordsOnly:d.recordsOnly})}catch(y){let S=y instanceof Error?y.message:String(y);if(!d.recordsOnly&&/openapi\.json failed \(401/.test(S)){q("types-gen: /v1/catalog/openapi.json needs a browser session \u2014 emitting record shapes only. The record shapes are the half apps generate against; for the OpenAPI half, run it from a signed-in browser session.");try{T=await En({baseUrl:f,token:v,recordsOnly:!0})}catch(R){x(`types generation failed: ${R instanceof Error?R.message:String(R)}`)}}else x(`types generation failed: ${S}`)}let k=xe(process.cwd(),d.out);await ye.writeFile(k,T,"utf8"),_(`wrote ${k} (${T.split(`
|
|
3617
3617
|
`).length} lines).`)}),Wy(n),n.command("grounding").description("Write the instance's grounding brief (source primer + record anatomy + KB retrieval) to a file for agent sessions.").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--records <list>","Comma-separated record types to focus, e.g. purchaseOrder,itemReceipt.").option("--query <text>","Retrieval question for the knowledge base (e.g. what the app is about).").option("-o, --out <file>","Output file","INSTANCE.md").action(async d=>{let{baseUrl:f,token:v}=await ne(d.baseUrl),T=new URLSearchParams;d.records&&T.set("records",d.records),d.query&&T.set("query",d.query);let k=T.toString(),y=await fetch(`${f}/v1/catalog/grounding${k?`?${k}`:""}`,{headers:{Authorization:`Bearer ${v}`,Accept:"application/json"}});y.ok||x(`grounding fetch failed: GET /v1/catalog/grounding \u2192 ${y.status}`);let R=((await y.json()).markdown??"").trim(),C=xe(process.cwd(),d.out),N=d.records?` records=${d.records}`:"",j=`<!-- GENERATED by \`turbobase project grounding\` against ${f}${N} \u2014 do not edit; re-run to refresh. -->
|
|
@@ -3641,7 +3641,7 @@ samples init: ${R} written, ${C} skipped.`)});let Wt=e.command("guardrails").des
|
|
|
3641
3641
|
`+g.dim("create one with `turbobase guardrails create <name> --source <s> --record <r>`"));_(Xt(k.map(_i),{head:xi})),_(g.dim(" first match wins; lower PRIO is evaluated first."))}),Wt.command("create <name>").description("Create a rule gating PG\u2192source writes that match it.").option("--source <system>","Adapter id to scope to, or '*' for every source.","*").option("--record <type>","Record type to scope to, or '*' for every record.","*").option("--op <glob>","Raw op glob, when gating something other than a record write.").option("--target <glob>","Row address glob, e.g. 'salesOrder.12345'.").option("--actor <glob>","Only match this caller, e.g. 'agent:*' to gate AI writes but not human ones.").option("--decision <d>","allow | allow_with_audit | require_confirm | deny.","deny").option("--priority <n>","Lower is evaluated first (default 100).",d=>Number(d)).option("--when <expr>","Row predicate, e.g. 'total gt 10000'. Omit to match every row.").option("--reason <text>","Why this rule exists \u2014 shown to a blocked writer and in `list`.").option("--disabled","Create the rule parked, so it takes effect only when activated.").option("--confirm-freeze-all","Required for an unconditional deny across '*'/'*'.").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,f)=>{let{baseUrl:v,token:T}=await ne(f.baseUrl),k=new Q({baseUrl:v,token:T}),y;try{y=await k.guardrailCreate({name:d,source:f.source,record:f.record,decision:f.decision,...f.op?{op:f.op}:{},...f.target?{target:f.target}:{},...f.actor?{actor:f.actor}:{},...Number.isFinite(f.priority)?{priority:Number(f.priority)}:{},...f.when?{when:f.when}:{},...f.reason?{reason:f.reason}:{},...f.disabled?{enabled:!1}:{},...f.confirmFreezeAll?{confirmFreezeAll:!0}:{}})}catch(S){se(S,"extensions:deploy","create a guardrail"),x(`create guardrail failed: ${S instanceof Error?S.message:String(S)}`)}_(`${g.green("\u2713")} guardrail ${g.bold(y.name??y.id)} created${y.status==="active"?"":g.dim(` (${y.status} \u2014 activate it to take effect)`)}`),_(g.dim(` ${y.decision} ${y.source}/${y.record??y.op}${y.actor?` actor=${y.actor}`:""}${y.when?` where ${y.when}`:""} @prio ${y.priority}`)),_(g.dim(` verify with: turbobase guardrails test --source ${y.source==="*"?"<source>":y.source} --record <record>`))}),Wt.command("edit <name>").description("Change a rule \u2014 its decision, priority, predicate or reason.").option("--decision <d>","allow | allow_with_audit | require_confirm | deny.").option("--priority <n>","Lower is evaluated first.",d=>Number(d)).option("--when <expr>","New row predicate. Pass '' to match every row.").option("--reason <text>","Why this rule exists.").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,f)=>{f.decision===void 0&&f.priority===void 0&&f.when===void 0&&f.reason===void 0&&x("edit: nothing to change \u2014 pass --decision, --priority, --when or --reason.");let{baseUrl:v,token:T}=await ne(f.baseUrl),k=new Q({baseUrl:v,token:T}),y;try{y=await k.guardrailUpdate(d,{...f.decision!==void 0?{decision:f.decision}:{},...Number.isFinite(f.priority)?{priority:Number(f.priority)}:{},...f.when!==void 0?{when:f.when}:{},...f.reason!==void 0?{reason:f.reason}:{}})}catch(S){se(S,"extensions:deploy","edit a guardrail"),x(`edit guardrail failed: ${S instanceof Error?S.message:String(S)}`)}_(`${g.green("\u2713")} guardrail ${g.bold(y.name??y.id)} updated`),_(g.dim(` ${y.decision} ${y.source}/${y.record??y.op}${y.when?` where ${y.when}`:""} @prio ${y.priority}`))});for(let[d,f,v]of[["activate","active","activated"],["deactivate","inactive","deactivated"]])Wt.command(`${d} <name>`).description(f==="active"?"Arm a parked or proposed rule.":"Park a rule without deleting it \u2014 the reversible move mid-rollout.").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(T,k)=>{let{baseUrl:y,token:S}=await ne(k.baseUrl),R=new Q({baseUrl:y,token:S});try{await R.guardrailUpdate(T,{status:f})}catch(C){se(C,"extensions:deploy",`${d} a guardrail`),x(`${d} guardrail failed: ${C instanceof Error?C.message:String(C)}`)}_(`${g.green("\u2713")} guardrail ${g.bold(T)} ${v}`),f==="inactive"&&_(g.dim(" writes it was gating now fall through to the other rules."))});Wt.command("delete <name>").description("Remove a rule. Prefer `deactivate` if you may want it back.").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,f)=>{let{baseUrl:v,token:T}=await ne(f.baseUrl),k=new Q({baseUrl:v,token:T});try{await k.guardrailDelete(d)}catch(y){se(y,"extensions:deploy","delete a guardrail"),x(`delete guardrail failed: ${y instanceof Error?y.message:String(y)}`)}_(`${g.green("\u2713")} guardrail ${g.bold(d)} deleted`)}),Wt.command("posture [mode]").description("Show or set the GLOBAL default. 'allow' = deny-list (unmatched writes allowed, carve with deny rules). 'deny' = allow-list (unmatched writes denied, open with allow rules).").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,f)=>{let{baseUrl:v,token:T}=await ne(f.baseUrl),k=new Q({baseUrl:v,token:T}),y=C=>C==="deny"?"deny-by-default (allow-list)":"allow-by-default (deny-list)";if(d===void 0){let C;try{C=await k.guardrailPostureGet()}catch(N){se(N,"extensions:deploy","read the guardrail posture"),x(`read posture failed: ${N instanceof Error?N.message:String(N)}`)}_(`guardrail posture: ${g.bold(y(C.mode))}`),_(g.dim(C.mode==="deny"?" Unmatched writes are DENIED. Open records with `guardrails create <name> --decision allow`.":" Unmatched writes are allowed-with-audit. Freeze records with `guardrails create <name> --decision deny`."));return}let S=d.trim().toLowerCase();S!=="allow"&&S!=="deny"&&x("posture must be 'allow' or 'deny'.");let R;try{R=await k.guardrailPostureSet(S)}catch(C){se(C,"extensions:deploy","set the guardrail posture"),x(`set posture failed: ${C instanceof Error?C.message:String(C)}`)}_(`${g.green("\u2713")} guardrail posture set to ${g.bold(y(R.mode))}`),R.mode==="deny"&&_(g.dim(" Every record with no active ALLOW rule is now frozen for write-back. Verify with `guardrails test --source <s> --record <r>`."))}),Wt.command("test").description("What happens to this write? Runs the real evaluator; writes nothing.").requiredOption("--source <system>","Adapter id the write targets.").requiredOption("--record <type>","Record type the write targets.").option("--actor <actor>","Caller to simulate, e.g. 'agent:ai' or 'user:<id>'.").option("--external-id <id>","Source-side row id, for target-scoped rules.").option("--fields <json>","A candidate row as JSON, so `when` predicates can be decided.").option("--op <op>","Write op: 'delete' tests <record>.delete; omitted tests <record>.write.").option("--phase <phase>","boundary | cdc | worker | adapter. Defaults to worker (the last gate).").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--json","Emit raw JSON.").action(async d=>{let f;if(d.fields)try{f=JSON.parse(d.fields)}catch(R){x(`--fields must be valid JSON: ${R instanceof Error?R.message:String(R)}`)}let{baseUrl:v,token:T}=await ne(d.baseUrl),k=new Q({baseUrl:v,token:T}),y;try{y=await k.guardrailTest({source:d.source,record:d.record,...d.actor?{actor:d.actor}:{},...d.externalId?{externalId:d.externalId}:{},...f?{fields:f}:{},...d.op?{op:d.op}:{},...d.phase?{phase:d.phase}:{}})}catch(R){se(R,"extensions:deploy","test guardrails"),x(`guardrails test failed: ${R instanceof Error?R.message:String(R)}`)}if(d.json)return _(JSON.stringify(y,null,2));let S=`${d.source}/${y.op??d.record}`;y.degraded?(_(`${g.red("\u2717")} ${S} \u2014 guardrail policy is UNREADABLE; writes fail closed`),_(g.dim(` ${y.reason}`))):y.allowed?_(`${g.green("\u2713")} ${S} \u2014 ${y.decision}`+(y.blockedBy?g.dim(` (rule ${y.blockedBy})`):g.dim(" (no rule matched)"))):(_(`${g.red("\u2717")} ${S} \u2014 ${y.decision} by ${g.bold(y.blockedBy??"?")} at the ${y.phase} gate`),y.message&&_(g.dim(` ${y.message}`))),y.decision==="require_confirm"&&_(g.yellow(" this write is HELD for operator approval, not refused.")),y.allowed||(process.exitCode=1)});let un=e.command("tables").description("Author custom tables on your instance (create, evolve, inspect)."),ki=(d,f={})=>{let v=`${g.bold(d.table)} ${g.dim(d.displayName)}`;_(d.exists===!1?`${v} ${g.dim("(new)")}`:v);for(let T of d.fields){let k=[T.required?"required":null].filter(Boolean).join(", "),y=f.showClaimants&&T.claimedBy?.length?` ${g.dim(`\u2190 ${T.claimedBy.join(", ")}`)}`:"";_(` ${T.column.padEnd(28)} ${T.type}${k?` (${k})`:""}${y}`)}f.showClaimants&&d.claimants.length>1&&_(g.dim(` claimed by ${d.claimants.join(", ")}`))};function $i(d){if(d instanceof le&&d.status===409){let f=d.body;f?.error==="table_conflict"&&f.message&&(q(f.message),process.exit(1))}x(`tables: ${d instanceof Error?d.message:String(d)}`)}let Qm=async d=>{let f=At(xe(process.cwd(),d),"public","turbobase.json"),v=await ye.readFile(f,"utf8").catch(()=>null);if(v===null)return null;let T;try{T=JSON.parse(v)}catch(y){x(`${f} is not valid JSON: ${y instanceof Error?y.message:String(y)}`)}let k=T.tables;return k===void 0?{tables:[],manifestPath:f}:(Array.isArray(k)||x(`${f}: "tables" must be an array.`),{tables:k,manifestPath:f})};un.command("list").description("List the custom tables on your instance and who claims each one.").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--json","Emit raw JSON instead of a table.").action(async d=>{let{baseUrl:f,token:v}=await ne(d.baseUrl),T=new Q({baseUrl:f,token:v}),k;try{k=await T.tablesList()}catch(y){se(y,"extensions:deploy","list tables"),x(`list tables failed: ${y instanceof Error?y.message:String(y)}`)}if(d.json)return _(JSON.stringify(k,null,2));if(k.length===0)return _("no custom tables yet \u2014 create one with `turbobase tables create <slug>`.");_(Xt(k.map(y=>[y.table,y.displayName,String(y.fields.length),y.status,y.claimedBy.join(", ")||"\u2014"]),{head:["TABLE","NAME","FIELDS","STATUS","CLAIMED BY"]}))}),un.command("plan").description("Preview what this project's declared tables would do. Writes nothing; exits 1 on a conflict.").argument("[dir]","Project directory holding public/turbobase.json (default ./).").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--as <claimant>","Claim as `cli` or `app:<slug>` (default: the app slug in .turbobase, else cli).").action(async(d,f)=>{let v=await Qm(d??".");if(v||x(`no public/turbobase.json under ${xe(process.cwd(),d??".")}.`),v.tables.length===0)return _(`${v.manifestPath} declares no tables \u2014 nothing to plan.`);let{baseUrl:T,token:k}=await ne(f.baseUrl),y=new Q({baseUrl:T,token:k}),S;try{S=await ae("planning tables",()=>y.tablesPlan({claimedBy:f.as,tables:v.tables}))}catch(R){se(R,"extensions:deploy","plan tables"),$i(R)}_(`claiming as ${g.bold(S.claimedBy)}`);for(let R of S.tables)ki(R,{showClaimants:!0});_(""),_(g.dim("nothing was applied \u2014 run `turbobase tables apply` (or deploy the app) to make it so."))}),un.command("apply").description("Apply this project's declared tables to the instance.").argument("[dir]","Project directory holding public/turbobase.json (default ./).").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--as <claimant>","Claim as `cli` or `app:<slug>` (default: cli).").action(async(d,f)=>{let v=await Qm(d??".");if(v||x(`no public/turbobase.json under ${xe(process.cwd(),d??".")}.`),v.tables.length===0)return _(`${v.manifestPath} declares no tables \u2014 nothing to apply.`);let{baseUrl:T,token:k}=await ne(f.baseUrl),y=new Q({baseUrl:T,token:k}),S;try{S=await ae("applying tables",()=>y.tablesApply({claimedBy:f.as,tables:v.tables}))}catch(R){se(R,"extensions:deploy","apply tables"),$i(R)}for(let R of S.tables)ki(R,{showClaimants:!0});_(`applied ${S.tables.length} table${S.tables.length===1?"":"s"} as ${S.claimedBy}.`)}),un.command("create").description('Create a single table without a manifest (the CLI twin of "New custom table").').argument("<slug>","Table slug; the physical table is cr_<slug>.").requiredOption("-f, --field <name:type>","Field as name:type[:required] \u2014 text|number|date|bool|select. Repeatable.",(d,f)=>[...f??[],d],[]).option("--name <displayName>","Human label for the table (defaults to the slug).").option("--restrict-to-owner","Non-admins see only rows they created.").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,f)=>{let v=f.field.map(R=>{let[C,N,j]=R.split(":");return(!C||!N)&&x(`--field "${R}" must be name:type[:required] (e.g. title:text:required).`),j!==void 0&&j!=="required"&&x(`--field "${R}": the third part may only be "required".`),{name:C,type:N,...j==="required"?{required:!0}:{}}}),{baseUrl:T,token:k}=await ne(f.baseUrl),y=new Q({baseUrl:T,token:k}),S;try{S=await ae(`creating cr_${d}`,()=>y.tablesApply({tables:[{slug:d,displayName:f.name??d,fields:v,...f.restrictToOwner?{rowLevelOwner:!0}:{}}]}))}catch(R){se(R,"extensions:deploy","create a table"),$i(R)}for(let R of S.tables)ki(R);_(""),_(g.dim("grant access under Settings \u203A Users, or in the Records page permissions matrix."))}),un.command("drop").description("Drop a table and everything in it. Irreversible.").argument("<slug>","Table slug (without the cr_ prefix).").requiredOption("--confirm <slug>","Type the EXACT slug to confirm (fail-closed).").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,f)=>{f.confirm!==d&&x(`drop refused: --confirm "${f.confirm}" does not match "${d}".`);let{baseUrl:v,token:T}=await ne(f.baseUrl),k=new Q({baseUrl:v,token:T}),y;try{y=await ae(`dropping cr_${d}`,()=>k.tablesDrop(d,f.confirm))}catch(S){se(S,"extensions:deploy","drop a table"),x(`drop failed: ${S instanceof Error?S.message:String(S)}`)}if(!y.removed)return _(`no table named "${d}" on this instance \u2014 nothing dropped.`);_(`dropped ${y.table} and every row in it.`)});let al=e.command("sandbox").description("Ephemeral local authoring sandboxes.");al.command("create").description("Stand up a fresh local sandbox seeded with a sampled+redacted slice of an instance.").requiredOption("--from <instance>","Source instance to clone the data slice from.").option("--ttl <duration>","Time-to-live before reaping (e.g. 72h, 30m, 7d).","72h").option("--sample <pct>","Percent of each table to copy (e.g. 2%).","2%").option("--base-url <url>","Local base URL the sandbox is reachable at.").action(async d=>{process.env.TURBOBASE_SANDBOX="1";let f=Wm(),v;try{v=await jb(f,{fromTenant:d.from,ttl:d.ttl,sample:d.sample,baseUrl:d.baseUrl})}catch(T){T instanceof fs&&x(T.message),x(`sandbox create failed: ${T instanceof Error?T.message:String(T)}`)}_(`sandbox ${v.name} ready.`),_(` source: ${v.fromTenant} (sampled ${Math.round(v.sampleFraction*100)}%, redacted)`),_(` url: ${v.url}`),_(` expires: ${v.expiresAt}`)}),al.command("destroy").argument("<name>","The sandbox name to tear down.").description("Drop a sandbox database and remove it from the registry.").action(async d=>{let f=Wm();await Au(f).catch(()=>[]);let v;try{v=await Lb(f,d)}catch(T){x(`sandbox destroy failed: ${T instanceof Error?T.message:String(T)}`)}v||x(`no sandbox named '${d}'.`),_(`destroyed sandbox ${v.name} (dropped ${v.database}).`)}),al.command("list").description("List active sandboxes with TTL/expiry; reaps any past their TTL.").action(async()=>{let d=Wm(),f=await Au(d).catch(()=>[]),v=await pa(),{active:T}=Pu(v);if(T.length===0)_("no active sandboxes.");else{for(let k of T)_(` ${k.name} from=${k.fromTenant} expires=${k.expiresAt} ${k.url}`);_(`
|
|
3642
3642
|
${T.length} active sandbox(es).`)}f.length>0&&_(`(reaped ${f.length} expired sandbox(es).)`)}),o.command("export").description("Pull the live instance into turbobase/bundle.json (adopt an instance into a repo).").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--out <dir>","Directory to write the bundle into.",ta).action(async d=>{let{baseUrl:f,token:v}=await ne(d.baseUrl),T=new Q({baseUrl:f,token:v}),k;try{k=await ae("exporting instance config",()=>T.configExport())}catch(R){R instanceof le&&(R.status===401||R.status===403)&&x("ext export forbidden \u2014 the stored PAT lacks extensions:deploy. Re-run `turbobase auth login`."),x(`ext export failed: ${R instanceof Error?R.message:String(R)}`)}let y=typeof k.serialized=="string"?k.serialized:`${JSON.stringify(k.manifest??k,null,2)}
|
|
3643
3643
|
`,S=xe(process.cwd(),d.out,ls);await ye.mkdir(Ho(S),{recursive:!0}),await ye.writeFile(S,y,"utf8"),_(`wrote ${d.out}/${ls} (${y.split(`
|
|
3644
|
-
`).length} lines).`)});let eg=o.command("extras").description("Manage the optional native packages `ext test` and `ext replay` need."),qS=[{name:"esbuild",needs:"compiling an extension (`test`, `replay`)"},{name:"isolated-vm",needs:"executing an extension in the sandbox (`test`, `replay`)"}],tg=()=>process.env.TURBOBASE_HOME?.trim()||At(nM(),".turbobase"),ZS=()=>"1.
|
|
3644
|
+
`).length} lines).`)});let eg=o.command("extras").description("Manage the optional native packages `ext test` and `ext replay` need."),qS=[{name:"esbuild",needs:"compiling an extension (`test`, `replay`)"},{name:"isolated-vm",needs:"executing an extension in the sandbox (`test`, `replay`)"}],tg=()=>process.env.TURBOBASE_HOME?.trim()||At(nM(),".turbobase"),ZS=()=>"1.9.0",Si=async()=>Promise.all(qS.map(async d=>{try{return await import(d.name),{...d,present:!0}}catch{return{...d,present:!1}}}));eg.command("status").description("Report which optional native packages are installed.").action(async()=>{let d=await Si();for(let f of d)_(`${f.present?He.success("installed"):He.warn("missing")} ${g.bold(f.name)} \u2014 ${f.needs}`);d.some(f=>!f.present)&&_(`
|
|
3645
3645
|
run \`${us} ext extras install\` to fetch them into ${tg()}.`)}),eg.command("install").description("Install the optional native packages into $TURBOBASE_HOME (needs npm).").action(async()=>{let d=await Si();if(d.every(C=>C.present)){_(He.success("extras already installed \u2014 nothing to do."));return}let f=tg();await ye.mkdir(f,{recursive:!0});let v=d.filter(C=>!C.present).map(C=>C.name),T=ku(process.platform,process.arch),k=async(C,N)=>{let{code:j,stderr:K}=await vi("npm",["install","--prefix",f,"--no-audit","--no-fund",...C]);j!==0&&x(`extras install failed while installing ${N} (npm exited ${j}).
|
|
3646
3646
|
${K.trim()}
|
|
3647
3647
|
These are native packages \u2014 they need npm and a working toolchain. Everything except \`test\` and \`replay\` works without them.`)},y=v.filter(C=>C!=="isolated-vm");if(y.length>0){let C=y.map(N=>`${N}@${_u[N]??"latest"}`);_(`installing ${C.join(", ")} \u2192 ${f}/node_modules \u2026`),await k(C,y.join(", "))}if(v.includes("isolated-vm")){let C=`isolated-vm@${_u["isolated-vm"]}`;if(_(`installing ${C} \u2192 ${f}/node_modules \u2026`),await k(["--ignore-scripts",C],"isolated-vm"),Pb.includes(T)){let j=`${xu}@${ZS()}`;_(`fetching ${j} (no upstream binary for ${T}) \u2026`);let{code:K}=await vi("npm",["install","--prefix",f,"--no-audit","--no-fund","--ignore-scripts",j]);K!==0&&_(He.warn(`could not fetch ${j} \u2014 falling back to a source build.`))}let N=await Ab({home:f});N.length>0&&_(` ${He.success("prebuilt")} ${N.join(", ")} \u2192 isolated-vm/prebuilds/${T}`)}let S=await Si(),R=S.filter(C=>!C.present).map(C=>C.name);if(R.includes("isolated-vm")){_(He.warn(`no prebuilt isolated-vm for ${T} / Node ${process.versions.node} (${$u()}) \u2014 building from source. This needs Python and a C++ toolchain, and takes a few minutes.`));let{code:C}=await vi("npm",["rebuild","--prefix",f,"isolated-vm"]);C===0&&(S=await Si(),R=S.filter(N=>!N.present).map(N=>N.name))}R.length>0&&x(`npm succeeded but ${R.join(", ")} still will not load \u2014 no prebuilt binary for ${T} / Node ${process.versions.node} (${$u()}), and the source build did not produce one either. Everything except \`test\` and \`replay\` works without them.`),_(He.success("extras installed \u2014 `turbobase ext test` and `turbobase ext replay` are ready."))});let Wn=e.command("release").description("Ship a release to your instance: deploy | status | rollback | list.");return Wn.command("deploy").description("Enqueue a server-side release deploy. UPLOADS the SDF project src/ from the checkout (the producer swap) when present; else a solution-only live-fetch deploy. An approved target requires --approved-by.").requiredOption("--target <mode>","Deploy posture: auto (apply now) | approved (needs a recorded approval).").option("--solution <id>","The solution id the release delivers (omit for an upload-only deploy).").option("--project <dir>","SDF project dir whose src/ is uploaded (default: cwd).").option("--git-repo <repo>","Git provenance LINK: source repo (default $GITHUB_REPOSITORY or `git remote get-url origin`).").option("--git-ref <ref>","Git provenance LINK: ref/branch/tag (default $GITHUB_REF).").option("--ref <committish>","Git provenance: the ref/branch/tag/sha the upload was built from; resolved to a commit sha via `git rev-parse` (default $GITHUB_SHA or HEAD).").option("--pr-url <url>","Git provenance LINK: the PR this deploy came from (default $PR_URL).").option("--approved-by <email>","Record the approval (REQUIRED for --target approved).").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--follow","Poll the release deploy to completion (exit non-zero on failure).").option("--interval-ms <ms>","Poll interval for --follow (default 2000).").action(async d=>{let f=d.target==="approved"?"approved":d.target==="auto"?"auto":null;f||x(`--target must be 'auto' or 'approved' (got '${d.target}').`);let v=await yM(xe(process.cwd(),d.project??".")),T=Object.keys(v).length;!d.solution&&T===0&&x("release deploy needs --solution <id> (live-fetch) or an SDF project (a src/ dir under --project, default cwd) to upload.");let y=(d.ref?await Gm(["rev-parse",d.ref])??d.ref:null)??process.env.GITHUB_SHA??await Gm(["rev-parse","HEAD"]),S=d.gitRepo??process.env.GITHUB_REPOSITORY??await Gm(["remote","get-url","origin"]),R=d.gitRef??process.env.GITHUB_REF??null,C=d.prUrl??process.env.PR_URL??null,{baseUrl:N,token:j}=await ne(d.baseUrl),K=new Q({baseUrl:N,token:j}),U;try{U=await K.releaseDeploy({solutionId:d.solution??null,target:f,approvedBy:d.approvedBy??null,files:T>0?v:null,gitRepo:S,gitRef:R,gitSha:y,prUrl:C})}catch(te){se(te,"releases:write","release deploy"),te instanceof le&&te.status===404&&x("solution_not_found \u2014 no solution with that id."),x(`release deploy failed: ${te instanceof Error?te.message:String(te)}`)}_(`release ${U.releaseId} enqueued \u2192 taskId=${U.taskId} (target=${f}`+(T>0?`, uploaded ${T} bundle file(s)`:", live-fetch")+")."),d.follow&&await hu(()=>K.releaseStatus(U.releaseId),`release ${U.releaseId}`,d.intervalMs)}),Wn.command("pull").argument("<id>","The release id").description("Write the SDF project a FAILED release built into <dir>: owned/ (yours, editable) and context/ (the rest of the bundle, read-only). Edit owned/, then `release push`.").requiredOption("--dir <path>","Directory to write the project into (created if absent).").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,f)=>{let{baseUrl:v,token:T}=await ne(f.baseUrl),k=new Q({baseUrl:v,token:T}),y;try{y=await k.releaseFiles(d)}catch(C){C instanceof le&&C.status===404&&x(`release ${d} not found.`),C instanceof le&&C.status===409&&x(`no built project was retained for release ${d}. Files are kept for a FAILED attempt only \u2014 a shipped bundle is recoverable from the account.`),se(C,"releases:write","pull a release"),x(`release pull failed: ${C instanceof Error?C.message:String(C)}`)}let S=xe(process.cwd(),f.dir),R=0;for(let[C,N]of[["owned",y.owned],["context",y.context]])for(let[j,K]of Object.entries(N)){let U=At(S,C,j);await ye.mkdir(Ho(U),{recursive:!0}),await ye.writeFile(U,K,"utf8"),R++}await ye.writeFile(At(S,".turbobase-release.json"),JSON.stringify({releaseId:y.releaseId,version:y.version,contentDigest:y.contentDigest},null,2),"utf8"),_(`pulled release ${y.releaseId} (${y.status}) \u2192 ${S}
|
package/dist/turbobase.js
CHANGED
|
@@ -3564,7 +3564,7 @@ ${s.map(nv).join(`
|
|
|
3564
3564
|
`))}async function Sp(t,e,n=Nn){let r=[...new Set(t.map(a=>a.trim()).filter(Boolean))];r.length===0&&v("name at least one skill slug. `turbobase skills list` shows them.");let s=await Ln(e,n);if(!await Ws(`Publish ${r.length} skill(s)?`,"Yes \u2014 publish them","their text is injected into every matching turn from now on",e))return;let i;try{i=await Y("publishing",()=>s.skillsPublish(r))}catch(a){W(a,"skills:publish","publish a skill"),v(`publish failed: ${a instanceof Error?a.message:String(a)}`)}y(f.green(`published ${i.published.length} skill(s) \u2014 live now.`)),i.unknown.length>0&&(L(f.yellow(`no such skill: ${i.unknown.join(", ")}`)),process.exitCode=1),L(f.dim(`release v${i.version.version_no} \xB7 undo with: turbobase skills unpublish ${i.published.join(" ")}`))}async function _p(t,e,n=Nn){let r=[...new Set(t.map(a=>a.trim()).filter(Boolean))];r.length===0&&v("name at least one skill slug. `turbobase skills list` shows them.");let s=await Ln(e,n);if(!await Ws(`Move ${r.length} skill(s) back to draft?`,"Yes \u2014 unpublish them","they stop being injected immediately; the text and its history are kept",e))return;let i;try{i=await Y("unpublishing",()=>s.skillsUnpublish(r))}catch(a){W(a,"skills:publish","unpublish a skill"),v(`unpublish failed: ${a instanceof Error?a.message:String(a)}`)}y(f.green(`unpublished ${i.unpublished.length} skill(s) \u2014 retracted now.`)),L(f.dim(`release v${i.version.version_no} \xB7 re-publish with: turbobase skills publish ${i.unpublished.join(" ")}`)),i.unknown.length>0&&(L(f.yellow(`no such skill: ${i.unknown.join(", ")}`)),process.exitCode=1)}async function $p(t,e,n=Nn){let r=Number(t);(!Number.isInteger(r)||r<1)&&v(`--version must be a release number (got '${t}'). \`turbobase skills releases\` lists them.`);let s=await Ln(e,n);if(await Ws(`Roll the skills back to release v${r}?`,"Yes \u2014 restore that release","content only: a skill an operator has since unpublished stays off",e))try{let i=await Y("rolling back",()=>s.skillsRollback(r));y(f.green(`rolled back to v${i.version.version_no}.`))}catch(i){W(i,"skills:publish","roll back a skills release"),v(`rollback failed: ${i instanceof Error?i.message:String(i)}`)}}async function xp(t,e=Nn){let n=await Ln(t,e),r;try{r=await Y("reading the releases",()=>n.skillsReleases())}catch(s){W(s,"skills:publish","read the skills releases"),v(`could not read the releases: ${s instanceof Error?s.message:String(s)}`)}if(r.items.length===0){L("no releases yet.");return}for(let s of r.items){let o=s.is_current?f.green("*"):" ",i=s.release_note?` \u2014 ${s.release_note}`:"";y(`${o} v${s.version_no} ${s.skill_count} skill(s) ${f.dim(s.published_at)}${s.published_by?f.dim(` by ${s.published_by}`):""}${f.dim(i)}`)}}async function Tp(t,e,n=Nn){let r=[...new Set((t??[]).map(u=>u.trim()).filter(Boolean))];r.length===0&&v("name at least one skill to delete. `turbobase skills list` shows the slugs.");let s=await Ln(e,n);if(!await Ws(r.length===1?`Delete the skill '${r[0]}'?`:`Delete ${r.length} skills?
|
|
3565
3565
|
${r.join(`
|
|
3566
3566
|
`)}`,"Yes \u2014 delete them","permanent: the rows and their text are removed. Prior releases keep their own copy.",e))return;let i=[],a=[];for(let u of r)try{i.push(await Y(`deleting ${u}`,()=>s.skillsDelete(u)))}catch(p){if(p instanceof X&&p.status===404){a.push(u);continue}i.length>0&&L(f.dim(`deleted before the error: ${i.map(m=>m.slug).join(", ")}`)),W(p,"skills:publish","delete a skill"),v(`delete failed on '${u}': ${p instanceof Error?p.message:String(p)}`)}i.length>0&&y(f.green(`deleted ${i.length} skill(s).`));let l=i.filter(u=>u.wasPublished).map(u=>u.slug);l.length>0&&L(f.yellow(`Published until now, so no longer injected: ${l.join(", ")}`)),a.length>0&&(L(f.yellow(`no such skill: ${a.join(", ")}`)),process.exitCode=1)}import{promises as Rp}from"node:fs";import{join as Ev,relative as Pv,resolve as Av,sep as Iv}from"node:path";var Cv=new Set(["node_modules","dist","build","coverage",".git",".claude",".turbobase",".next",".svelte-kit",".vercel",".cache"]),Ov=new Set([".mcp.json",".env"]);function Nv(t){return Ov.has(t)||t.startsWith(".env.")&&t!==".env.example"}function Lv(t){return Buffer.compare(Buffer.from(t.toString("utf8"),"utf8"),t)===0}function jv(t){return t.includes(0)}async function Ep(t){let e=Av(t),n={},r=[],s=[],o=[];async function i(a){let l=await Rp.readdir(a,{withFileTypes:!0});for(let u of l){let p=Ev(a,u.name);if(Cv.has(u.name))continue;if(u.isDirectory()){await i(p);continue}if(!u.isFile())continue;let m=Pv(e,p).split(Iv).join("/");if(Nv(u.name)){s.push(m);continue}let _=await Rp.readFile(p);if(!Lv(_)){r.push(m);continue}jv(_)&&o.push(m),n[m]=_.toString("utf8")}}return await i(e),{files:n,skipped:r,secrets:s,unstorable:o}}import{randomBytes as Dv}from"node:crypto";var Uv="/_tb/app-assets",Mv=16,zv=/^[0-9a-f]{32}$/;function Pp(){return Dv(Mv).toString("hex")}function qv(t){return zv.test(t)}function Ap(t){if(!qv(t))throw new Error(`not a build id: ${t}`);return`${Uv}/${t}/`}var Ip=7;ma();var ga=50*1024*1024;import Js from"node:fs/promises";import Sr from"node:path";var ba={esbuild:"0.28.1","isolated-vm":"6.1.2"},ya="@turbobase/isolated-vm-prebuilds";function wa(t,e){return`${t}-${e}`}function va(t=process.versions){return`abi${t.modules}`}var Cp=["darwin-x64","win32-arm64"];async function Op(t){let e=t.platform??process.platform,n=t.arch??process.arch,r=wa(e,n),s=Sr.join(t.home,"node_modules"),o=Sr.join(s,...ya.split("/"),"prebuilds",r),i=Sr.join(s,"isolated-vm","prebuilds",r),a;try{a=await Js.readdir(o)}catch{return[]}let l=[];await Js.mkdir(i,{recursive:!0});for(let u of a){if(!u.endsWith(".node"))continue;let p=Sr.join(i,u);try{await Js.copyFile(Sr.join(o,u),p,Js.constants?.COPYFILE_EXCL??1),l.push(u)}catch{}}return l}import{homedir as Bv}from"node:os";import{join as Np}from"node:path";import{promises as ka}from"node:fs";function jp(){let t=process.env.TURBOBASE_HOME??Np(Bv(),".turbobase");return{dir:t,file:Np(t,"sandboxes.json")}}var Fv={s:1e3,m:6e4,h:36e5,d:864e5};function Hv(t){let e=/^\s*(\d+)\s*([smhd])\s*$/.exec(t);if(!e)throw new Error(`invalid --ttl '${t}': expected <number><unit> where unit is s|m|h|d (e.g. 72h, 30m, 7d).`);let n=Number(e[1]);if(!Number.isFinite(n)||n<=0)throw new Error(`invalid --ttl '${t}': duration must be a positive integer.`);return n*Fv[e[2]]}function Kv(t,e=Date.now()){return new Date(e+Hv(t)).toISOString()}function Vv(t,e=Date.now()){let n=Date.parse(t);return Number.isNaN(n)?!0:n<=e}function Gv(t){let e=/^\s*(\d+(?:\.\d+)?)\s*%?\s*$/.exec(t);if(!e)throw new Error(`invalid --sample '${t}': expected a percent like 2% (or a bare number).`);let n=Number(e[1]);if(!Number.isFinite(n)||n<0||n>100)throw new Error(`invalid --sample '${t}': percent must be between 0 and 100.`);return n/100}function Wv(t,e){if(e>=1)return[...t];if(e<=0||t.length===0)return[];let n=Math.max(1,Math.round(1/e)),r=[];for(let s=0;s<t.length;s+=n)r.push(t[s]);return r}var Jv="[REDACTED]",_r=class extends Error{constructor(e){super(e),this.name="SandboxDataCopyUnavailableError"}},Sa=class extends Error{table;column;constructor(e,n,r){super(`Refusing to copy ${e}.${n} into a sandbox: ${r}. A sandbox must never hold un-redacted PII \u2014 classify the column 'safe' (non-PII) or let redaction mask it, then retry.`),this.name="UnredactedPiiError",this.table=e,this.column=n}};function Yv(t,e,n){let r={};for(let[s,o]of Object.entries(e)){let i=n[s];if(i===void 0)throw new Sa(t,s,"column has no PII classification (unknown = unsafe)");i==="pii"?r[s]=o==null?o:Jv:r[s]=o}return r}function Zv(t,e,n){return e.map(r=>Yv(t,r,n))}var Lp=new Set(["localhost","127.0.0.1","::1","0.0.0.0"]),Xv=["oraclecloud.com","us-ashburn-1","amazonaws.com","rds.","supabase.co","turbobase.app","turbobase.io"];function Qv(t){let e=t.trim();try{let s=new URL(e);if(s.hostname)return s.hostname.toLowerCase()}catch{}let n=e.replace(/^[a-z]+:\/\//i,""),r=(n.split("/")[0]??n).split("@").pop()??n;return(r.split(":")[0]??r).toLowerCase()}function _a(t){if(!t||!t.trim())throw new Error("local-only guard: empty database target \u2014 refusing to proceed.");let e=t.toLowerCase();for(let r of Xv)if(e.includes(r))throw new Error(`local-only guard: target '${t}' looks like a cloud/prod context (matched '${r}'). \`turbobase sandbox create\` is LOCAL-ONLY and will never touch a cloud database.`);let n=Qv(t);if(!Lp.has(n))throw new Error(`local-only guard: target host '${n}' is not a recognised local Postgres (${[...Lp].join(", ")}). \`turbobase sandbox create\` is LOCAL-ONLY.`)}function ek(t,e=tk){return`sbx-${t.toLowerCase().replace(/[^a-z0-9]+/g,"-").replace(/^-+|-+$/g,"").slice(0,24)||"tenant"}-${e()}`}function tk(){return Math.floor(Math.random()*16777215).toString(16).padStart(6,"0")}function nk(t){return`turbobase_${t.replace(/[^a-z0-9]+/gi,"_").toLowerCase()}`}function rk(t,e){return`${(e??process.env.TURBOBASE_SANDBOX_BASE_URL??"http://localhost:5173").replace(/\/+$/,"")}/?sandbox=${encodeURIComponent(t)}`}async function $a(){let{file:t}=jp();try{let e=await ka.readFile(t,"utf8"),n=JSON.parse(e);return Array.isArray(n)?n:[]}catch(e){if(e.code==="ENOENT")return[];throw e}}async function Dp(t){let{dir:e,file:n}=jp();await ka.mkdir(e,{recursive:!0}),await ka.writeFile(n,`${JSON.stringify(t,null,2)}
|
|
3567
|
-
`,{mode:384})}async function sk(t){let e=await $a();e.push(t),await Dp(e)}async function Up(t){let e=await $a(),n=e.findIndex(s=>s.name===t);if(n===-1)return null;let[r]=e.splice(n,1);return await Dp(e),r??null}async function Ys(){return $a()}function xa(t,e=Date.now()){let n=[],r=[];for(let s of t)Vv(s.expiresAt,e)?r.push(s):n.push(s);return{active:n,expired:r}}async function Mp(t,e){_a(t.target());let n=t.dataCopyUnavailable?.();if(n)throw new _r(n);let r=Gv(e.sample),s=e.now??Date.now(),o=(e.nameGen??(u=>ek(u)))(e.fromTenant),i=nk(o);await t.createDatabase(i),await t.replayMigrations(i);let a=await t.readSourceTables(e.fromTenant);for(let u of a){let p=Wv(u.rows,r),m=Zv(u.table,p,u.classification);m.length>0&&await t.copyRows(i,u.table,m)}let l={name:o,fromTenant:e.fromTenant,database:i,createdAt:new Date(s).toISOString(),expiresAt:Kv(e.ttl,s),sampleFraction:r,url:rk(o,e.baseUrl)};return await sk(l),l}async function zp(t,e){_a(t.target());let r=(await Ys()).find(s=>s.name===e);return r?(await t.dropDatabase(r.database),await Up(e),r):null}async function Ta(t,e=Date.now()){_a(t.target());let n=await Ys(),{expired:r}=xa(n,e),s=[];for(let o of r){try{await t.dropDatabase(o.database)}catch{continue}await Up(o.name),s.push(o)}return s}var $r={pat:{prefix:"tb_pat_",defaultScopes:["extensions:deploy"],allowedScopes:["extensions:deploy","catalog:read","mcp:authoring","analyzer:run","releases:write","solutions:write","skills:publish","docs:publish"],defaultTtlDays:90,mintable:!0,label:"Personal access token"},catalog:{prefix:"tb_cat_",defaultScopes:["catalog:read"],allowedScopes:["catalog:read"],defaultTtlDays:null,mintable:!0,label:"AI / catalog token"}},DI=Object.keys($r).filter(t=>$r[t].mintable);var zI=$r.pat.prefix,ok=Object.entries($r).map(([t,e])=>[e.prefix,t]),ik=/^[A-Za-z0-9_-]{20,}$/;function ak(t){if(typeof t!="string")return null;for(let[e,n]of ok)if(t.startsWith(e)&&ik.test(t.slice(e.length)))return n;return null}function qp(t){return ak(t)==="pat"}pr();var lk=8e3,ck={revoked:"the instance REVOKED this token \u2014 mint a new PAT (Settings \u203A Access tokens) and run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`",expired:"this token has EXPIRED \u2014 mint a new PAT (Settings \u203A Access tokens) and run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`",unknown:"this instance has never seen this token \u2014 it was deleted, or it belongs to a DIFFERENT instance; check the base-url before minting a new PAT",suspended:"the user this token belongs to is SUSPENDED \u2014 an instance administrator has to restore the account; a new token will not help",malformed:"the stored credential is not shaped like a Turbobase PAT (tb_pat_\u2026) \u2014 sign in again",missing:"no token reached the instance \u2014 sign in again",transient:"the instance could not verify the token right now (a storage error, not a decision about the token) \u2014 retry"};function dk(t){return ck[t]??`the instance rejected this token (${t}) \u2014 run \`turbobase auth login\` to store a fresh PAT`}async function uk(t,e,n=fetch){let r;try{r=await n(`${t}/v1/catalog/records`,{method:"GET",headers:{Authorization:`Bearer ${e}`,Accept:"application/json"},signal:AbortSignal.timeout(lk)})}catch(o){return{state:"unreachable",detail:o instanceof Error?o.message:String(o)}}if(r.status===200||r.status===403)return{state:"accepted"};if(r.status===401){let o=await r.json().catch(()=>null);return{state:"rejected",reason:typeof o?.reason=="string"&&o.reason?o.reason:"unknown"}}return(r.headers.get("content-type")??"").includes("application/json")?{state:"accepted"}:{state:"unreachable",detail:`HTTP ${r.status} \u2014 this host does not serve the /v1 API`}}function Bp(t){return t.state==="accepted"?Ee()?f.green("accepted"):"accepted":t.state==="rejected"?Ee()?f.red(`rejected \xB7 ${t.reason}`):`rejected \xB7 ${t.reason}`:Ee()?f.yellow("unreachable"):"unreachable"}async function Fp(t={},e=fetch){let n=await Et(),{file:r}=Rs();if(n.length===0){y("not signed in. Run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`."),L(f.dim(`no sign-ins stored in ${r}.`));return}let s=await ut(),o=await Promise.all(n.map(async i=>({baseUrl:i.baseUrl,active:!!s&&i.baseUrl===s.baseUrl,updatedAt:i.updatedAt,check:t.probe===!1?{state:"accepted"}:await uk(i.baseUrl,i.token,e)})));if(t.probe===!1)for(let i of o)y(`${i.active?"* ":" "}${i.baseUrl} (updated ${i.updatedAt})`);else if(Ee())y(pt(o.map(i=>[i.active?f.green("*"):" ",f.bold(i.baseUrl),Bp(i.check),f.dim(i.updatedAt)]),{head:["","instance","token","updated"]}));else for(let i of o)y(`${i.active?"* ":" "}${i.baseUrl} ${Bp(i.check)} (updated ${i.updatedAt})`);L(f.dim(`tokens read from ${r}`));for(let i of o)i.check.state==="rejected"?(L(f.red(`${i.baseUrl}: ${dk(i.check.reason)}.`)),L(f.dim(" then re-run `turbobase project init` \u2014 .mcp.json holds its own copy of the token, and until it is rewritten the authoring MCP tools stay absent from your session."))):i.check.state==="unreachable"&&L(f.yellow(`${i.baseUrl}: could not reach the instance (${i.check.detail}).`));s||L("no active default \u2014 run `turbobase auth use <base-url>` or pass --base-url.")}async function I0(t){let e=await Et();e.length===0&&v("no stored sign-ins \u2014 run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`."),Ue()||v("this command needs an explicit <base-url> in a non-interactive shell.");try{return await Me(t,e.map(n=>({value:n.baseUrl,label:n.baseUrl,description:`updated ${n.updatedAt}`})))}catch{v("cancelled.")}}async function C0(t,e){let n;try{n=await fetch(`${t}/v1/catalog/records`,{method:"GET",headers:{Authorization:`Bearer ${e}`,Accept:"application/json"},signal:AbortSignal.timeout(8e3)})}catch(s){return{ok:!1,kind:"unreachable",detail:s instanceof Error?s.message:String(s)}}let r=(n.headers.get("content-type")??"").includes("application/json");return n.status===200||n.status===403?{ok:!0}:n.status===401?{ok:!1,kind:"bad-token",detail:`HTTP ${n.status}`}:r?{ok:!0}:{ok:!1,kind:"wrong-host",detail:`HTTP ${n.status}`}}function O0(t){L(""),L("Sharing is ON. Two things reach the Turbobase product team from this instance:"),L(" \xB7 anonymized pattern cards from your proposals, solutions and INSTANCE-LEARNINGS.md \u2014"),L(" a pattern label, a record class, a fix shape, an outcome. No scripts, values or ids."),L(" \xB7 redacted prose from your projects\u2019 TURBOBASE-FEEDBACK.md \u2014 the findings you write"),L(" about OUR platform, with instance name, user names and ids masked before they leave."),L(`Turn it off: ${t}/admin/settings \u2192 Telemetry \u2192 "Share learnings and platform feedback".`),L("")}async function N0(t,e,n){let r=await Zd({baseUrl:t,token:e}),s=(await Et()).length-1;if(y(`signed in to ${r.baseUrl} \u2014 now the active instance`+(s>0?` (${s} other${s===1?"":"s"} stored; commands default here).`:".")),O0(r.baseUrl),!n)return;let o=await C0(r.baseUrl,e);o.ok||(o.kind==="wrong-host"?(L(`warning: ${r.baseUrl} did not respond to the Turbobase API (/v1) \u2014 got ${o.detail}.`),L(" In local dev the Turbobase API is on :4100, not the app dev-server port (e.g. :5173)."),L(" The token is stored, but commands will fail against this base-url until it points at the API.")):o.kind==="bad-token"?L(`warning: ${r.baseUrl} rejected the token (401) \u2014 the PAT may be stale, revoked, or for a different instance.`):L(`warning: could not reach ${r.baseUrl} to verify the token (${o.detail}). Stored anyway.`))}async function L0(t){let e=await gr(t),n=aa(e);if(!n){let r=/\bdefineConduit\s*[<(]/.test(e);v(r?`could not parse id/on/from.source/from.recordType from ${t} \u2014 is it a defineConduit({...}) file?`:`could not parse id/recordType/event from ${t} \u2014 is it a defineHook({...}) file?`)}return{...n,sourceCode:e}}async function lr(t,e,n,r){try{return await re.access(t),"skipped"}catch{}return await re.mkdir(ar(t),{recursive:!0}),await re.writeFile(t,e,{mode:r??(n?493:420)}),r!==void 0&&await re.chmod(t,r),"wrote"}async function Fb(t,e){if(Kb(t)!==".gitignore")return lr(t,e.content,e.executable,e.mode);let n=await re.readFile(t,"utf8").catch(()=>null);if(n===null)return lr(t,e.content,e.executable,e.mode);let r=ju(n);return r===null?"skipped":(await re.writeFile(t,r,"utf8"),"merged")}function _d(t){if(t!==void 0){if(t==="junit"||t==="json")return t;v(`unknown --reporter '${t}' (expected 'junit' or 'json').`)}}function ki(t){process.exit(t)}function j0(t){return{name:"turbobase ext test",cases:t.map(n=>{if(n.pass)return{name:n.name,status:"passed"};let r=n.error?"error":n.rejection?.code??"mismatch",s=n.error?`error: ${n.error}`:n.observed!==n.expected?`expected ${n.expected}, observed ${n.observed}`+(n.rejection?` (rejected: ${n.rejection.code??"rejected"}${n.rejection.message?` \u2014 ${n.rejection.message}`:""})`:""):`rejected: ${n.rejection?.code??"rejected"}${n.rejection?.message?` \u2014 ${n.rejection.message}`:""}`;return{name:n.name,status:"failed",detail:s,type:r}})}}function D0(t,e){let n=e.warnings.length===0?[{name:`${t} (${e.kind})`,status:"passed"}]:e.warnings.map(r=>({name:`${t}: ${r.rule}`,status:"failed",type:r.rule,detail:`${r.message} \u2192 fix: ${r.fix}`}));return{name:`turbobase ext lint ${t}`,cases:n}}function U0(t){let e=[];if(t.error)return e.push({name:`replay ${t.fixtureName}`,status:"failed",type:"error",detail:t.error}),{name:`turbobase ext replay ${t.fixtureName}`,cases:e};for(let n of t.guards)e.push(n.status==="failed"?{name:`guard: ${n.name}`,status:"failed",type:n.name,detail:n.detail}:{name:`guard: ${n.name}`,status:"passed",detail:n.status==="skipped-offline"?`skipped-offline: ${n.detail}`:void 0});return t.whenPassed&&t.applyBranch&&e.push({name:`apply-branch: ${t.applyBranch}`,status:"passed",detail:`${t.masterAction??""} (${t.wouldWriteBindings.length} binding(s) would be written)`.trim()}),{name:`turbobase ext replay ${t.fixtureName}`,cases:e}}function Hb(t){return`${(Math.ceil(t/1048576*10)/10).toFixed(1).replace(/\.0$/,"")} MiB`}function Pd({includeInternal:t=!0}={}){let e=new A0;e.name("turbobase").description("Build apps, author extensions, and drive your Turbobase instance.").version("1.8.0").option("--no-color","Disable ANSI colour + animations (also honoured via NO_COLOR / non-TTY)."),e.addHelpText("beforeAll",d=>d.command.parent?"":`${ta()}
|
|
3567
|
+
`,{mode:384})}async function sk(t){let e=await $a();e.push(t),await Dp(e)}async function Up(t){let e=await $a(),n=e.findIndex(s=>s.name===t);if(n===-1)return null;let[r]=e.splice(n,1);return await Dp(e),r??null}async function Ys(){return $a()}function xa(t,e=Date.now()){let n=[],r=[];for(let s of t)Vv(s.expiresAt,e)?r.push(s):n.push(s);return{active:n,expired:r}}async function Mp(t,e){_a(t.target());let n=t.dataCopyUnavailable?.();if(n)throw new _r(n);let r=Gv(e.sample),s=e.now??Date.now(),o=(e.nameGen??(u=>ek(u)))(e.fromTenant),i=nk(o);await t.createDatabase(i),await t.replayMigrations(i);let a=await t.readSourceTables(e.fromTenant);for(let u of a){let p=Wv(u.rows,r),m=Zv(u.table,p,u.classification);m.length>0&&await t.copyRows(i,u.table,m)}let l={name:o,fromTenant:e.fromTenant,database:i,createdAt:new Date(s).toISOString(),expiresAt:Kv(e.ttl,s),sampleFraction:r,url:rk(o,e.baseUrl)};return await sk(l),l}async function zp(t,e){_a(t.target());let r=(await Ys()).find(s=>s.name===e);return r?(await t.dropDatabase(r.database),await Up(e),r):null}async function Ta(t,e=Date.now()){_a(t.target());let n=await Ys(),{expired:r}=xa(n,e),s=[];for(let o of r){try{await t.dropDatabase(o.database)}catch{continue}await Up(o.name),s.push(o)}return s}var $r={pat:{prefix:"tb_pat_",defaultScopes:["extensions:deploy"],allowedScopes:["extensions:deploy","catalog:read","mcp:authoring","analyzer:run","releases:write","solutions:write","skills:publish","docs:publish"],defaultTtlDays:90,mintable:!0,label:"Personal access token"},catalog:{prefix:"tb_cat_",defaultScopes:["catalog:read"],allowedScopes:["catalog:read"],defaultTtlDays:null,mintable:!0,label:"AI / catalog token"}},DI=Object.keys($r).filter(t=>$r[t].mintable);var zI=$r.pat.prefix,ok=Object.entries($r).map(([t,e])=>[e.prefix,t]),ik=/^[A-Za-z0-9_-]{20,}$/;function ak(t){if(typeof t!="string")return null;for(let[e,n]of ok)if(t.startsWith(e)&&ik.test(t.slice(e.length)))return n;return null}function qp(t){return ak(t)==="pat"}pr();var lk=8e3,ck={revoked:"the instance REVOKED this token \u2014 mint a new PAT (Settings \u203A Access tokens) and run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`",expired:"this token has EXPIRED \u2014 mint a new PAT (Settings \u203A Access tokens) and run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`",unknown:"this instance has never seen this token \u2014 it was deleted, or it belongs to a DIFFERENT instance; check the base-url before minting a new PAT",suspended:"the user this token belongs to is SUSPENDED \u2014 an instance administrator has to restore the account; a new token will not help",malformed:"the stored credential is not shaped like a Turbobase PAT (tb_pat_\u2026) \u2014 sign in again",missing:"no token reached the instance \u2014 sign in again",transient:"the instance could not verify the token right now (a storage error, not a decision about the token) \u2014 retry"};function dk(t){return ck[t]??`the instance rejected this token (${t}) \u2014 run \`turbobase auth login\` to store a fresh PAT`}async function uk(t,e,n=fetch){let r;try{r=await n(`${t}/v1/catalog/records`,{method:"GET",headers:{Authorization:`Bearer ${e}`,Accept:"application/json"},signal:AbortSignal.timeout(lk)})}catch(o){return{state:"unreachable",detail:o instanceof Error?o.message:String(o)}}if(r.status===200||r.status===403)return{state:"accepted"};if(r.status===401){let o=await r.json().catch(()=>null);return{state:"rejected",reason:typeof o?.reason=="string"&&o.reason?o.reason:"unknown"}}return(r.headers.get("content-type")??"").includes("application/json")?{state:"accepted"}:{state:"unreachable",detail:`HTTP ${r.status} \u2014 this host does not serve the /v1 API`}}function Bp(t){return t.state==="accepted"?Ee()?f.green("accepted"):"accepted":t.state==="rejected"?Ee()?f.red(`rejected \xB7 ${t.reason}`):`rejected \xB7 ${t.reason}`:Ee()?f.yellow("unreachable"):"unreachable"}async function Fp(t={},e=fetch){let n=await Et(),{file:r}=Rs();if(n.length===0){y("not signed in. Run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`."),L(f.dim(`no sign-ins stored in ${r}.`));return}let s=await ut(),o=await Promise.all(n.map(async i=>({baseUrl:i.baseUrl,active:!!s&&i.baseUrl===s.baseUrl,updatedAt:i.updatedAt,check:t.probe===!1?{state:"accepted"}:await uk(i.baseUrl,i.token,e)})));if(t.probe===!1)for(let i of o)y(`${i.active?"* ":" "}${i.baseUrl} (updated ${i.updatedAt})`);else if(Ee())y(pt(o.map(i=>[i.active?f.green("*"):" ",f.bold(i.baseUrl),Bp(i.check),f.dim(i.updatedAt)]),{head:["","instance","token","updated"]}));else for(let i of o)y(`${i.active?"* ":" "}${i.baseUrl} ${Bp(i.check)} (updated ${i.updatedAt})`);L(f.dim(`tokens read from ${r}`));for(let i of o)i.check.state==="rejected"?(L(f.red(`${i.baseUrl}: ${dk(i.check.reason)}.`)),L(f.dim(" then re-run `turbobase project init` \u2014 .mcp.json holds its own copy of the token, and until it is rewritten the authoring MCP tools stay absent from your session."))):i.check.state==="unreachable"&&L(f.yellow(`${i.baseUrl}: could not reach the instance (${i.check.detail}).`));s||L("no active default \u2014 run `turbobase auth use <base-url>` or pass --base-url.")}async function I0(t){let e=await Et();e.length===0&&v("no stored sign-ins \u2014 run `turbobase auth login --base-url <instance> --token tb_pat_\u2026`."),Ue()||v("this command needs an explicit <base-url> in a non-interactive shell.");try{return await Me(t,e.map(n=>({value:n.baseUrl,label:n.baseUrl,description:`updated ${n.updatedAt}`})))}catch{v("cancelled.")}}async function C0(t,e){let n;try{n=await fetch(`${t}/v1/catalog/records`,{method:"GET",headers:{Authorization:`Bearer ${e}`,Accept:"application/json"},signal:AbortSignal.timeout(8e3)})}catch(s){return{ok:!1,kind:"unreachable",detail:s instanceof Error?s.message:String(s)}}let r=(n.headers.get("content-type")??"").includes("application/json");return n.status===200||n.status===403?{ok:!0}:n.status===401?{ok:!1,kind:"bad-token",detail:`HTTP ${n.status}`}:r?{ok:!0}:{ok:!1,kind:"wrong-host",detail:`HTTP ${n.status}`}}function O0(t){L(""),L("Sharing is ON. Two things reach the Turbobase product team from this instance:"),L(" \xB7 anonymized pattern cards from your proposals, solutions and INSTANCE-LEARNINGS.md \u2014"),L(" a pattern label, a record class, a fix shape, an outcome. No scripts, values or ids."),L(" \xB7 redacted prose from your projects\u2019 TURBOBASE-FEEDBACK.md \u2014 the findings you write"),L(" about OUR platform, with instance name, user names and ids masked before they leave."),L(`Turn it off: ${t}/admin/settings \u2192 Telemetry \u2192 "Share learnings and platform feedback".`),L("")}async function N0(t,e,n){let r=await Zd({baseUrl:t,token:e}),s=(await Et()).length-1;if(y(`signed in to ${r.baseUrl} \u2014 now the active instance`+(s>0?` (${s} other${s===1?"":"s"} stored; commands default here).`:".")),O0(r.baseUrl),!n)return;let o=await C0(r.baseUrl,e);o.ok||(o.kind==="wrong-host"?(L(`warning: ${r.baseUrl} did not respond to the Turbobase API (/v1) \u2014 got ${o.detail}.`),L(" In local dev the Turbobase API is on :4100, not the app dev-server port (e.g. :5173)."),L(" The token is stored, but commands will fail against this base-url until it points at the API.")):o.kind==="bad-token"?L(`warning: ${r.baseUrl} rejected the token (401) \u2014 the PAT may be stale, revoked, or for a different instance.`):L(`warning: could not reach ${r.baseUrl} to verify the token (${o.detail}). Stored anyway.`))}async function L0(t){let e=await gr(t),n=aa(e);if(!n){let r=/\bdefineConduit\s*[<(]/.test(e);v(r?`could not parse id/on/from.source/from.recordType from ${t} \u2014 is it a defineConduit({...}) file?`:`could not parse id/recordType/event from ${t} \u2014 is it a defineHook({...}) file?`)}return{...n,sourceCode:e}}async function lr(t,e,n,r){try{return await re.access(t),"skipped"}catch{}return await re.mkdir(ar(t),{recursive:!0}),await re.writeFile(t,e,{mode:r??(n?493:420)}),r!==void 0&&await re.chmod(t,r),"wrote"}async function Fb(t,e){if(Kb(t)!==".gitignore")return lr(t,e.content,e.executable,e.mode);let n=await re.readFile(t,"utf8").catch(()=>null);if(n===null)return lr(t,e.content,e.executable,e.mode);let r=ju(n);return r===null?"skipped":(await re.writeFile(t,r,"utf8"),"merged")}function _d(t){if(t!==void 0){if(t==="junit"||t==="json")return t;v(`unknown --reporter '${t}' (expected 'junit' or 'json').`)}}function ki(t){process.exit(t)}function j0(t){return{name:"turbobase ext test",cases:t.map(n=>{if(n.pass)return{name:n.name,status:"passed"};let r=n.error?"error":n.rejection?.code??"mismatch",s=n.error?`error: ${n.error}`:n.observed!==n.expected?`expected ${n.expected}, observed ${n.observed}`+(n.rejection?` (rejected: ${n.rejection.code??"rejected"}${n.rejection.message?` \u2014 ${n.rejection.message}`:""})`:""):`rejected: ${n.rejection?.code??"rejected"}${n.rejection?.message?` \u2014 ${n.rejection.message}`:""}`;return{name:n.name,status:"failed",detail:s,type:r}})}}function D0(t,e){let n=e.warnings.length===0?[{name:`${t} (${e.kind})`,status:"passed"}]:e.warnings.map(r=>({name:`${t}: ${r.rule}`,status:"failed",type:r.rule,detail:`${r.message} \u2192 fix: ${r.fix}`}));return{name:`turbobase ext lint ${t}`,cases:n}}function U0(t){let e=[];if(t.error)return e.push({name:`replay ${t.fixtureName}`,status:"failed",type:"error",detail:t.error}),{name:`turbobase ext replay ${t.fixtureName}`,cases:e};for(let n of t.guards)e.push(n.status==="failed"?{name:`guard: ${n.name}`,status:"failed",type:n.name,detail:n.detail}:{name:`guard: ${n.name}`,status:"passed",detail:n.status==="skipped-offline"?`skipped-offline: ${n.detail}`:void 0});return t.whenPassed&&t.applyBranch&&e.push({name:`apply-branch: ${t.applyBranch}`,status:"passed",detail:`${t.masterAction??""} (${t.wouldWriteBindings.length} binding(s) would be written)`.trim()}),{name:`turbobase ext replay ${t.fixtureName}`,cases:e}}function Hb(t){return`${(Math.ceil(t/1048576*10)/10).toFixed(1).replace(/\.0$/,"")} MiB`}function Pd({includeInternal:t=!0}={}){let e=new A0;e.name("turbobase").description("Build apps, author extensions, and drive your Turbobase instance.").version("1.9.0").option("--no-color","Disable ANSI colour + animations (also honoured via NO_COLOR / non-TTY)."),e.addHelpText("beforeAll",d=>d.command.parent?"":`${ta()}
|
|
3568
3568
|
`),e.hook("preAction",(d,h)=>{Wu(e.opts(),h.opts())});let n=e.command("auth").description("Sign in to an instance and manage stored credentials."),r=e.command("project").description("Set up the local project and the files an agent session reads."),s=e.command("ext").description("Author, test, ship, and observe extensions \u2014 hooks and conduits."),o=e.command("kb").description("Write into the instance's knowledge base."),i=e.command("skills").description("Write standing rules into the instance's agent skills.");n.command("login").description("Sign in to an instance by pasting a personal access token (PAT), stored in ~/.turbobase/credentials.").requiredOption("--base-url <url>","Instance base URL, e.g. https://acme.turbobase.app").option("--token <tb_pat_\u2026>","The PAT to store. Mint one in your app under Settings \u203A Access tokens.").option("--no-verify","Skip the post-login connectivity/token probe.").action(async d=>{let h=Xe(d.baseUrl);d.token||v(`auth login needs --token. Mint a PAT in your Turbobase app (Settings \u203A Access tokens), then:
|
|
3569
3569
|
${wr} auth login --base-url ${h} --token tb_pat_\u2026`),qp(d.token)||v("--token does not look like a Turbobase PAT (tb_pat_\u2026)."),await N0(h,d.token,d.verify)}),n.command("status").description("Show every stored sign-in, where its token was read from, and whether the instance still accepts it.").option("--no-probe","List the stored sign-ins without asking each instance about its token.").action(async d=>Fp({probe:d.probe})),n.command("use [base-url]").description("Make an already-stored instance the active default (omit the arg to pick interactively).").action(async d=>{let h=d??await I0("Pick the active instance:"),b=await Es(h);if(!b){let x=await Et();v(`no stored sign-in for ${Xe(h)}.`+(x.length?` Stored: ${x.map(k=>k.baseUrl).join(", ")}.`:"")+` Run \`turbobase auth login --base-url ${Xe(h)} --token tb_pat_\u2026\`.`)}y(`active instance \u2192 ${b.baseUrl}.`)}),n.command("logout").description("Remove a stored sign-in (defaults to the active instance).").option("--base-url <url>","Which instance to remove (defaults to the active/single one).").option("--all","Remove every stored sign-in.").action(async d=>{if(d.all){let x=await Et();for(let k of x)await qi(k.baseUrl);y(`removed ${x.length} stored sign-in${x.length===1?"":"s"}.`);return}let h=await qi(d.baseUrl);h||v(d.baseUrl?`no stored sign-in for ${Xe(d.baseUrl)}.`:"nothing to sign out of (or ambiguous \u2014 pass --base-url / --all).");let b=await ut();y(`signed out of ${h}.`+(b?` Active instance \u2192 ${b.baseUrl}.`:""))}),r.command("types").description("Generate types.ts from the signed-in instance's catalog.").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("-o, --out <file>","Output file","types.ts").option("--records-only","Emit only record-shape interfaces (skip the OpenAPI half).").action(async d=>{let{baseUrl:h,token:b}=await V(d.baseUrl),x;try{x=await an({baseUrl:h,token:b,recordsOnly:d.recordsOnly})}catch(g){let $=g instanceof Error?g.message:String(g);if(!d.recordsOnly&&/openapi\.json failed \(401/.test($)){L("types-gen: /v1/catalog/openapi.json needs a browser session \u2014 emitting record shapes only. The record shapes are the half apps generate against; for the OpenAPI half, run it from a signed-in browser session.");try{x=await an({baseUrl:h,token:b,recordsOnly:!0})}catch(R){v(`types generation failed: ${R instanceof Error?R.message:String(R)}`)}}else v(`types generation failed: ${$}`)}let k=le(process.cwd(),d.out);await re.writeFile(k,x,"utf8"),y(`wrote ${k} (${x.split(`
|
|
3570
3570
|
`).length} lines).`)}),Zu(r),r.command("grounding").description("Write the instance's grounding brief (source primer + record anatomy + KB retrieval) to a file for agent sessions.").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--records <list>","Comma-separated record types to focus, e.g. purchaseOrder,itemReceipt.").option("--query <text>","Retrieval question for the knowledge base (e.g. what the app is about).").option("-o, --out <file>","Output file","INSTANCE.md").action(async d=>{let{baseUrl:h,token:b}=await V(d.baseUrl),x=new URLSearchParams;d.records&&x.set("records",d.records),d.query&&x.set("query",d.query);let k=x.toString(),g=await fetch(`${h}/v1/catalog/grounding${k?`?${k}`:""}`,{headers:{Authorization:`Bearer ${b}`,Accept:"application/json"}});g.ok||v(`grounding fetch failed: GET /v1/catalog/grounding \u2192 ${g.status}`);let R=((await g.json()).markdown??"").trim(),A=le(process.cwd(),d.out),I=d.records?` records=${d.records}`:"",O=`<!-- GENERATED by \`turbobase project grounding\` against ${h}${I} \u2014 do not edit; re-run to refresh. -->
|
|
@@ -3594,7 +3594,7 @@ samples init: ${R} written, ${A} skipped.`)});let dt=e.command("guardrails").des
|
|
|
3594
3594
|
`+f.dim("create one with `turbobase guardrails create <name> --source <s> --record <r>`"));y(pt(k.map(gs),{head:bs})),y(f.dim(" first match wins; lower PRIO is evaluated first."))}),dt.command("create <name>").description("Create a rule gating PG\u2192source writes that match it.").option("--source <system>","Adapter id to scope to, or '*' for every source.","*").option("--record <type>","Record type to scope to, or '*' for every record.","*").option("--op <glob>","Raw op glob, when gating something other than a record write.").option("--target <glob>","Row address glob, e.g. 'salesOrder.12345'.").option("--actor <glob>","Only match this caller, e.g. 'agent:*' to gate AI writes but not human ones.").option("--decision <d>","allow | allow_with_audit | require_confirm | deny.","deny").option("--priority <n>","Lower is evaluated first (default 100).",d=>Number(d)).option("--when <expr>","Row predicate, e.g. 'total gt 10000'. Omit to match every row.").option("--reason <text>","Why this rule exists \u2014 shown to a blocked writer and in `list`.").option("--disabled","Create the rule parked, so it takes effect only when activated.").option("--confirm-freeze-all","Required for an unconditional deny across '*'/'*'.").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{let{baseUrl:b,token:x}=await V(h.baseUrl),k=new F({baseUrl:b,token:x}),g;try{g=await k.guardrailCreate({name:d,source:h.source,record:h.record,decision:h.decision,...h.op?{op:h.op}:{},...h.target?{target:h.target}:{},...h.actor?{actor:h.actor}:{},...Number.isFinite(h.priority)?{priority:Number(h.priority)}:{},...h.when?{when:h.when}:{},...h.reason?{reason:h.reason}:{},...h.disabled?{enabled:!1}:{},...h.confirmFreezeAll?{confirmFreezeAll:!0}:{}})}catch($){W($,"extensions:deploy","create a guardrail"),v(`create guardrail failed: ${$ instanceof Error?$.message:String($)}`)}y(`${f.green("\u2713")} guardrail ${f.bold(g.name??g.id)} created${g.status==="active"?"":f.dim(` (${g.status} \u2014 activate it to take effect)`)}`),y(f.dim(` ${g.decision} ${g.source}/${g.record??g.op}${g.actor?` actor=${g.actor}`:""}${g.when?` where ${g.when}`:""} @prio ${g.priority}`)),y(f.dim(` verify with: turbobase guardrails test --source ${g.source==="*"?"<source>":g.source} --record <record>`))}),dt.command("edit <name>").description("Change a rule \u2014 its decision, priority, predicate or reason.").option("--decision <d>","allow | allow_with_audit | require_confirm | deny.").option("--priority <n>","Lower is evaluated first.",d=>Number(d)).option("--when <expr>","New row predicate. Pass '' to match every row.").option("--reason <text>","Why this rule exists.").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{h.decision===void 0&&h.priority===void 0&&h.when===void 0&&h.reason===void 0&&v("edit: nothing to change \u2014 pass --decision, --priority, --when or --reason.");let{baseUrl:b,token:x}=await V(h.baseUrl),k=new F({baseUrl:b,token:x}),g;try{g=await k.guardrailUpdate(d,{...h.decision!==void 0?{decision:h.decision}:{},...Number.isFinite(h.priority)?{priority:Number(h.priority)}:{},...h.when!==void 0?{when:h.when}:{},...h.reason!==void 0?{reason:h.reason}:{}})}catch($){W($,"extensions:deploy","edit a guardrail"),v(`edit guardrail failed: ${$ instanceof Error?$.message:String($)}`)}y(`${f.green("\u2713")} guardrail ${f.bold(g.name??g.id)} updated`),y(f.dim(` ${g.decision} ${g.source}/${g.record??g.op}${g.when?` where ${g.when}`:""} @prio ${g.priority}`))});for(let[d,h,b]of[["activate","active","activated"],["deactivate","inactive","deactivated"]])dt.command(`${d} <name>`).description(h==="active"?"Arm a parked or proposed rule.":"Park a rule without deleting it \u2014 the reversible move mid-rollout.").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(x,k)=>{let{baseUrl:g,token:$}=await V(k.baseUrl),R=new F({baseUrl:g,token:$});try{await R.guardrailUpdate(x,{status:h})}catch(A){W(A,"extensions:deploy",`${d} a guardrail`),v(`${d} guardrail failed: ${A instanceof Error?A.message:String(A)}`)}y(`${f.green("\u2713")} guardrail ${f.bold(x)} ${b}`),h==="inactive"&&y(f.dim(" writes it was gating now fall through to the other rules."))});dt.command("delete <name>").description("Remove a rule. Prefer `deactivate` if you may want it back.").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{let{baseUrl:b,token:x}=await V(h.baseUrl),k=new F({baseUrl:b,token:x});try{await k.guardrailDelete(d)}catch(g){W(g,"extensions:deploy","delete a guardrail"),v(`delete guardrail failed: ${g instanceof Error?g.message:String(g)}`)}y(`${f.green("\u2713")} guardrail ${f.bold(d)} deleted`)}),dt.command("posture [mode]").description("Show or set the GLOBAL default. 'allow' = deny-list (unmatched writes allowed, carve with deny rules). 'deny' = allow-list (unmatched writes denied, open with allow rules).").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{let{baseUrl:b,token:x}=await V(h.baseUrl),k=new F({baseUrl:b,token:x}),g=A=>A==="deny"?"deny-by-default (allow-list)":"allow-by-default (deny-list)";if(d===void 0){let A;try{A=await k.guardrailPostureGet()}catch(I){W(I,"extensions:deploy","read the guardrail posture"),v(`read posture failed: ${I instanceof Error?I.message:String(I)}`)}y(`guardrail posture: ${f.bold(g(A.mode))}`),y(f.dim(A.mode==="deny"?" Unmatched writes are DENIED. Open records with `guardrails create <name> --decision allow`.":" Unmatched writes are allowed-with-audit. Freeze records with `guardrails create <name> --decision deny`."));return}let $=d.trim().toLowerCase();$!=="allow"&&$!=="deny"&&v("posture must be 'allow' or 'deny'.");let R;try{R=await k.guardrailPostureSet($)}catch(A){W(A,"extensions:deploy","set the guardrail posture"),v(`set posture failed: ${A instanceof Error?A.message:String(A)}`)}y(`${f.green("\u2713")} guardrail posture set to ${f.bold(g(R.mode))}`),R.mode==="deny"&&y(f.dim(" Every record with no active ALLOW rule is now frozen for write-back. Verify with `guardrails test --source <s> --record <r>`."))}),dt.command("test").description("What happens to this write? Runs the real evaluator; writes nothing.").requiredOption("--source <system>","Adapter id the write targets.").requiredOption("--record <type>","Record type the write targets.").option("--actor <actor>","Caller to simulate, e.g. 'agent:ai' or 'user:<id>'.").option("--external-id <id>","Source-side row id, for target-scoped rules.").option("--fields <json>","A candidate row as JSON, so `when` predicates can be decided.").option("--op <op>","Write op: 'delete' tests <record>.delete; omitted tests <record>.write.").option("--phase <phase>","boundary | cdc | worker | adapter. Defaults to worker (the last gate).").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--json","Emit raw JSON.").action(async d=>{let h;if(d.fields)try{h=JSON.parse(d.fields)}catch(R){v(`--fields must be valid JSON: ${R instanceof Error?R.message:String(R)}`)}let{baseUrl:b,token:x}=await V(d.baseUrl),k=new F({baseUrl:b,token:x}),g;try{g=await k.guardrailTest({source:d.source,record:d.record,...d.actor?{actor:d.actor}:{},...d.externalId?{externalId:d.externalId}:{},...h?{fields:h}:{},...d.op?{op:d.op}:{},...d.phase?{phase:d.phase}:{}})}catch(R){W(R,"extensions:deploy","test guardrails"),v(`guardrails test failed: ${R instanceof Error?R.message:String(R)}`)}if(d.json)return y(JSON.stringify(g,null,2));let $=`${d.source}/${g.op??d.record}`;g.degraded?(y(`${f.red("\u2717")} ${$} \u2014 guardrail policy is UNREADABLE; writes fail closed`),y(f.dim(` ${g.reason}`))):g.allowed?y(`${f.green("\u2713")} ${$} \u2014 ${g.decision}`+(g.blockedBy?f.dim(` (rule ${g.blockedBy})`):f.dim(" (no rule matched)"))):(y(`${f.red("\u2717")} ${$} \u2014 ${g.decision} by ${f.bold(g.blockedBy??"?")} at the ${g.phase} gate`),g.message&&y(f.dim(` ${g.message}`))),g.decision==="require_confirm"&&y(f.yellow(" this write is HELD for operator approval, not refused.")),g.allowed||(process.exitCode=1)});let sn=e.command("tables").description("Author custom tables on your instance (create, evolve, inspect)."),ys=(d,h={})=>{let b=`${f.bold(d.table)} ${f.dim(d.displayName)}`;y(d.exists===!1?`${b} ${f.dim("(new)")}`:b);for(let x of d.fields){let k=[x.required?"required":null].filter(Boolean).join(", "),g=h.showClaimants&&x.claimedBy?.length?` ${f.dim(`\u2190 ${x.claimedBy.join(", ")}`)}`:"";y(` ${x.column.padEnd(28)} ${x.type}${k?` (${k})`:""}${g}`)}h.showClaimants&&d.claimants.length>1&&y(f.dim(` claimed by ${d.claimants.join(", ")}`))};function ws(d){if(d instanceof X&&d.status===409){let h=d.body;h?.error==="table_conflict"&&h.message&&(L(h.message),process.exit(1))}v(`tables: ${d instanceof Error?d.message:String(d)}`)}let Ad=async d=>{let h=Ye(le(process.cwd(),d),"public","turbobase.json"),b=await re.readFile(h,"utf8").catch(()=>null);if(b===null)return null;let x;try{x=JSON.parse(b)}catch(g){v(`${h} is not valid JSON: ${g instanceof Error?g.message:String(g)}`)}let k=x.tables;return k===void 0?{tables:[],manifestPath:h}:(Array.isArray(k)||v(`${h}: "tables" must be an array.`),{tables:k,manifestPath:h})};sn.command("list").description("List the custom tables on your instance and who claims each one.").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--json","Emit raw JSON instead of a table.").action(async d=>{let{baseUrl:h,token:b}=await V(d.baseUrl),x=new F({baseUrl:h,token:b}),k;try{k=await x.tablesList()}catch(g){W(g,"extensions:deploy","list tables"),v(`list tables failed: ${g instanceof Error?g.message:String(g)}`)}if(d.json)return y(JSON.stringify(k,null,2));if(k.length===0)return y("no custom tables yet \u2014 create one with `turbobase tables create <slug>`.");y(pt(k.map(g=>[g.table,g.displayName,String(g.fields.length),g.status,g.claimedBy.join(", ")||"\u2014"]),{head:["TABLE","NAME","FIELDS","STATUS","CLAIMED BY"]}))}),sn.command("plan").description("Preview what this project's declared tables would do. Writes nothing; exits 1 on a conflict.").argument("[dir]","Project directory holding public/turbobase.json (default ./).").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--as <claimant>","Claim as `cli` or `app:<slug>` (default: the app slug in .turbobase, else cli).").action(async(d,h)=>{let b=await Ad(d??".");if(b||v(`no public/turbobase.json under ${le(process.cwd(),d??".")}.`),b.tables.length===0)return y(`${b.manifestPath} declares no tables \u2014 nothing to plan.`);let{baseUrl:x,token:k}=await V(h.baseUrl),g=new F({baseUrl:x,token:k}),$;try{$=await Y("planning tables",()=>g.tablesPlan({claimedBy:h.as,tables:b.tables}))}catch(R){W(R,"extensions:deploy","plan tables"),ws(R)}y(`claiming as ${f.bold($.claimedBy)}`);for(let R of $.tables)ys(R,{showClaimants:!0});y(""),y(f.dim("nothing was applied \u2014 run `turbobase tables apply` (or deploy the app) to make it so."))}),sn.command("apply").description("Apply this project's declared tables to the instance.").argument("[dir]","Project directory holding public/turbobase.json (default ./).").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--as <claimant>","Claim as `cli` or `app:<slug>` (default: cli).").action(async(d,h)=>{let b=await Ad(d??".");if(b||v(`no public/turbobase.json under ${le(process.cwd(),d??".")}.`),b.tables.length===0)return y(`${b.manifestPath} declares no tables \u2014 nothing to apply.`);let{baseUrl:x,token:k}=await V(h.baseUrl),g=new F({baseUrl:x,token:k}),$;try{$=await Y("applying tables",()=>g.tablesApply({claimedBy:h.as,tables:b.tables}))}catch(R){W(R,"extensions:deploy","apply tables"),ws(R)}for(let R of $.tables)ys(R,{showClaimants:!0});y(`applied ${$.tables.length} table${$.tables.length===1?"":"s"} as ${$.claimedBy}.`)}),sn.command("create").description('Create a single table without a manifest (the CLI twin of "New custom table").').argument("<slug>","Table slug; the physical table is cr_<slug>.").requiredOption("-f, --field <name:type>","Field as name:type[:required] \u2014 text|number|date|bool|select. Repeatable.",(d,h)=>[...h??[],d],[]).option("--name <displayName>","Human label for the table (defaults to the slug).").option("--restrict-to-owner","Non-admins see only rows they created.").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{let b=h.field.map(R=>{let[A,I,O]=R.split(":");return(!A||!I)&&v(`--field "${R}" must be name:type[:required] (e.g. title:text:required).`),O!==void 0&&O!=="required"&&v(`--field "${R}": the third part may only be "required".`),{name:A,type:I,...O==="required"?{required:!0}:{}}}),{baseUrl:x,token:k}=await V(h.baseUrl),g=new F({baseUrl:x,token:k}),$;try{$=await Y(`creating cr_${d}`,()=>g.tablesApply({tables:[{slug:d,displayName:h.name??d,fields:b,...h.restrictToOwner?{rowLevelOwner:!0}:{}}]}))}catch(R){W(R,"extensions:deploy","create a table"),ws(R)}for(let R of $.tables)ys(R);y(""),y(f.dim("grant access under Settings \u203A Users, or in the Records page permissions matrix."))}),sn.command("drop").description("Drop a table and everything in it. Irreversible.").argument("<slug>","Table slug (without the cr_ prefix).").requiredOption("--confirm <slug>","Type the EXACT slug to confirm (fail-closed).").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{h.confirm!==d&&v(`drop refused: --confirm "${h.confirm}" does not match "${d}".`);let{baseUrl:b,token:x}=await V(h.baseUrl),k=new F({baseUrl:b,token:x}),g;try{g=await Y(`dropping cr_${d}`,()=>k.tablesDrop(d,h.confirm))}catch($){W($,"extensions:deploy","drop a table"),v(`drop failed: ${$ instanceof Error?$.message:String($)}`)}if(!g.removed)return y(`no table named "${d}" on this instance \u2014 nothing dropped.`);y(`dropped ${g.table} and every row in it.`)});let _i=e.command("sandbox").description("Ephemeral local authoring sandboxes.");_i.command("create").description("Stand up a fresh local sandbox seeded with a sampled+redacted slice of an instance.").requiredOption("--from <instance>","Source instance to clone the data slice from.").option("--ttl <duration>","Time-to-live before reaping (e.g. 72h, 30m, 7d).","72h").option("--sample <pct>","Percent of each table to copy (e.g. 2%).","2%").option("--base-url <url>","Local base URL the sandbox is reachable at.").action(async d=>{process.env.TURBOBASE_SANDBOX="1";let h=xd(),b;try{b=await Mp(h,{fromTenant:d.from,ttl:d.ttl,sample:d.sample,baseUrl:d.baseUrl})}catch(x){x instanceof _r&&v(x.message),v(`sandbox create failed: ${x instanceof Error?x.message:String(x)}`)}y(`sandbox ${b.name} ready.`),y(` source: ${b.fromTenant} (sampled ${Math.round(b.sampleFraction*100)}%, redacted)`),y(` url: ${b.url}`),y(` expires: ${b.expiresAt}`)}),_i.command("destroy").argument("<name>","The sandbox name to tear down.").description("Drop a sandbox database and remove it from the registry.").action(async d=>{let h=xd();await Ta(h).catch(()=>[]);let b;try{b=await zp(h,d)}catch(x){v(`sandbox destroy failed: ${x instanceof Error?x.message:String(x)}`)}b||v(`no sandbox named '${d}'.`),y(`destroyed sandbox ${b.name} (dropped ${b.database}).`)}),_i.command("list").description("List active sandboxes with TTL/expiry; reaps any past their TTL.").action(async()=>{let d=xd(),h=await Ta(d).catch(()=>[]),b=await Ys(),{active:x}=xa(b);if(x.length===0)y("no active sandboxes.");else{for(let k of x)y(` ${k.name} from=${k.fromTenant} expires=${k.expiresAt} ${k.url}`);y(`
|
|
3595
3595
|
${x.length} active sandbox(es).`)}h.length>0&&y(`(reaped ${h.length} expired sandbox(es).)`)}),s.command("export").description("Pull the live instance into turbobase/bundle.json (adopt an instance into a repo).").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--out <dir>","Directory to write the bundle into.",Ms).action(async d=>{let{baseUrl:h,token:b}=await V(d.baseUrl),x=new F({baseUrl:h,token:b}),k;try{k=await Y("exporting instance config",()=>x.configExport())}catch(R){R instanceof X&&(R.status===401||R.status===403)&&v("ext export forbidden \u2014 the stored PAT lacks extensions:deploy. Re-run `turbobase auth login`."),v(`ext export failed: ${R instanceof Error?R.message:String(R)}`)}let g=typeof k.serialized=="string"?k.serialized:`${JSON.stringify(k.manifest??k,null,2)}
|
|
3596
3596
|
`,$=le(process.cwd(),d.out,yr);await re.mkdir(ar($),{recursive:!0}),await re.writeFile($,g,"utf8"),y(`wrote ${d.out}/${yr} (${g.split(`
|
|
3597
|
-
`).length} lines).`)});let Id=s.command("extras").description("Manage the optional native packages `ext test` and `ext replay` need."),Vb=[{name:"esbuild",needs:"compiling an extension (`test`, `replay`)"},{name:"isolated-vm",needs:"executing an extension in the sandbox (`test`, `replay`)"}],Cd=()=>process.env.TURBOBASE_HOME?.trim()||Ye(P0(),".turbobase"),Gb=()=>"1.
|
|
3597
|
+
`).length} lines).`)});let Id=s.command("extras").description("Manage the optional native packages `ext test` and `ext replay` need."),Vb=[{name:"esbuild",needs:"compiling an extension (`test`, `replay`)"},{name:"isolated-vm",needs:"executing an extension in the sandbox (`test`, `replay`)"}],Cd=()=>process.env.TURBOBASE_HOME?.trim()||Ye(P0(),".turbobase"),Gb=()=>"1.9.0",vs=async()=>Promise.all(Vb.map(async d=>{try{return await import(d.name),{...d,present:!0}}catch{return{...d,present:!1}}}));Id.command("status").description("Report which optional native packages are installed.").action(async()=>{let d=await vs();for(let h of d)y(`${h.present?ve.success("installed"):ve.warn("missing")} ${f.bold(h.name)} \u2014 ${h.needs}`);d.some(h=>!h.present)&&y(`
|
|
3598
3598
|
run \`${wr} ext extras install\` to fetch them into ${Cd()}.`)}),Id.command("install").description("Install the optional native packages into $TURBOBASE_HOME (needs npm).").action(async()=>{let d=await vs();if(d.every(A=>A.present)){y(ve.success("extras already installed \u2014 nothing to do."));return}let h=Cd();await re.mkdir(h,{recursive:!0});let b=d.filter(A=>!A.present).map(A=>A.name),x=wa(process.platform,process.arch),k=async(A,I)=>{let{code:O,stderr:M}=await ms("npm",["install","--prefix",h,"--no-audit","--no-fund",...A]);O!==0&&v(`extras install failed while installing ${I} (npm exited ${O}).
|
|
3599
3599
|
${M.trim()}
|
|
3600
3600
|
These are native packages \u2014 they need npm and a working toolchain. Everything except \`test\` and \`replay\` works without them.`)},g=b.filter(A=>A!=="isolated-vm");if(g.length>0){let A=g.map(I=>`${I}@${ba[I]??"latest"}`);y(`installing ${A.join(", ")} \u2192 ${h}/node_modules \u2026`),await k(A,g.join(", "))}if(b.includes("isolated-vm")){let A=`isolated-vm@${ba["isolated-vm"]}`;if(y(`installing ${A} \u2192 ${h}/node_modules \u2026`),await k(["--ignore-scripts",A],"isolated-vm"),Cp.includes(x)){let O=`${ya}@${Gb()}`;y(`fetching ${O} (no upstream binary for ${x}) \u2026`);let{code:M}=await ms("npm",["install","--prefix",h,"--no-audit","--no-fund","--ignore-scripts",O]);M!==0&&y(ve.warn(`could not fetch ${O} \u2014 falling back to a source build.`))}let I=await Op({home:h});I.length>0&&y(` ${ve.success("prebuilt")} ${I.join(", ")} \u2192 isolated-vm/prebuilds/${x}`)}let $=await vs(),R=$.filter(A=>!A.present).map(A=>A.name);if(R.includes("isolated-vm")){y(ve.warn(`no prebuilt isolated-vm for ${x} / Node ${process.versions.node} (${va()}) \u2014 building from source. This needs Python and a C++ toolchain, and takes a few minutes.`));let{code:A}=await ms("npm",["rebuild","--prefix",h,"isolated-vm"]);A===0&&($=await vs(),R=$.filter(I=>!I.present).map(I=>I.name))}R.length>0&&v(`npm succeeded but ${R.join(", ")} still will not load \u2014 no prebuilt binary for ${x} / Node ${process.versions.node} (${va()}), and the source build did not produce one either. Everything except \`test\` and \`replay\` works without them.`),y(ve.success("extras installed \u2014 `turbobase ext test` and `turbobase ext replay` are ready."))});let $n=e.command("release").description("Ship a release to your instance: deploy | status | rollback | list.");return $n.command("deploy").description("Enqueue a server-side release deploy. UPLOADS the SDF project src/ from the checkout (the producer swap) when present; else a solution-only live-fetch deploy. An approved target requires --approved-by.").requiredOption("--target <mode>","Deploy posture: auto (apply now) | approved (needs a recorded approval).").option("--solution <id>","The solution id the release delivers (omit for an upload-only deploy).").option("--project <dir>","SDF project dir whose src/ is uploaded (default: cwd).").option("--git-repo <repo>","Git provenance LINK: source repo (default $GITHUB_REPOSITORY or `git remote get-url origin`).").option("--git-ref <ref>","Git provenance LINK: ref/branch/tag (default $GITHUB_REF).").option("--ref <committish>","Git provenance: the ref/branch/tag/sha the upload was built from; resolved to a commit sha via `git rev-parse` (default $GITHUB_SHA or HEAD).").option("--pr-url <url>","Git provenance LINK: the PR this deploy came from (default $PR_URL).").option("--approved-by <email>","Record the approval (REQUIRED for --target approved).").option("--base-url <url>","Instance base URL (defaults to the active instance).").option("--follow","Poll the release deploy to completion (exit non-zero on failure).").option("--interval-ms <ms>","Poll interval for --follow (default 2000).").action(async d=>{let h=d.target==="approved"?"approved":d.target==="auto"?"auto":null;h||v(`--target must be 'auto' or 'approved' (got '${d.target}').`);let b=await H0(le(process.cwd(),d.project??".")),x=Object.keys(b).length;!d.solution&&x===0&&v("release deploy needs --solution <id> (live-fetch) or an SDF project (a src/ dir under --project, default cwd) to upload.");let g=(d.ref?await Td(["rev-parse",d.ref])??d.ref:null)??process.env.GITHUB_SHA??await Td(["rev-parse","HEAD"]),$=d.gitRepo??process.env.GITHUB_REPOSITORY??await Td(["remote","get-url","origin"]),R=d.gitRef??process.env.GITHUB_REF??null,A=d.prUrl??process.env.PR_URL??null,{baseUrl:I,token:O}=await V(d.baseUrl),M=new F({baseUrl:I,token:O}),N;try{N=await M.releaseDeploy({solutionId:d.solution??null,target:h,approvedBy:d.approvedBy??null,files:x>0?b:null,gitRepo:$,gitRef:R,gitSha:g,prUrl:A})}catch(K){W(K,"releases:write","release deploy"),K instanceof X&&K.status===404&&v("solution_not_found \u2014 no solution with that id."),v(`release deploy failed: ${K instanceof Error?K.message:String(K)}`)}y(`release ${N.releaseId} enqueued \u2192 taskId=${N.taskId} (target=${h}`+(x>0?`, uploaded ${x} bundle file(s)`:", live-fetch")+")."),d.follow&&await ca(()=>M.releaseStatus(N.releaseId),`release ${N.releaseId}`,d.intervalMs)}),$n.command("pull").argument("<id>","The release id").description("Write the SDF project a FAILED release built into <dir>: owned/ (yours, editable) and context/ (the rest of the bundle, read-only). Edit owned/, then `release push`.").requiredOption("--dir <path>","Directory to write the project into (created if absent).").option("--base-url <url>","Instance base URL (defaults to the active instance).").action(async(d,h)=>{let{baseUrl:b,token:x}=await V(h.baseUrl),k=new F({baseUrl:b,token:x}),g;try{g=await k.releaseFiles(d)}catch(A){A instanceof X&&A.status===404&&v(`release ${d} not found.`),A instanceof X&&A.status===409&&v(`no built project was retained for release ${d}. Files are kept for a FAILED attempt only \u2014 a shipped bundle is recoverable from the account.`),W(A,"releases:write","pull a release"),v(`release pull failed: ${A instanceof Error?A.message:String(A)}`)}let $=le(process.cwd(),h.dir),R=0;for(let[A,I]of[["owned",g.owned],["context",g.context]])for(let[O,M]of Object.entries(I)){let N=Ye($,A,O);await re.mkdir(ar(N),{recursive:!0}),await re.writeFile(N,M,"utf8"),R++}await re.writeFile(Ye($,".turbobase-release.json"),JSON.stringify({releaseId:g.releaseId,version:g.version,contentDigest:g.contentDigest},null,2),"utf8"),y(`pulled release ${g.releaseId} (${g.status}) \u2192 ${$}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@turbobase/cli",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.9.0",
|
|
4
4
|
"description": "Author, test, and deploy Turbobase extensions (hooks + conduits) against a tenant over HTTP + a personal access token.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "SEE LICENSE IN LICENSE",
|