@hyperscale0/cli 1.0.0-beta.18 → 1.0.0-beta.19
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.
- package/hyperscale.js +15 -15
- package/package.json +2 -2
package/hyperscale.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
import{spawn as
|
|
2
|
+
import{spawn as xe}from"node:child_process";import{createHash as We}from"node:crypto";import{createServer as ze}from"node:http";import{createInterface as Ge}from"node:readline/promises";import{chmod as ee,mkdir as Xe,readdir as Qe,readFile as D,rename as Ze,unlink as et,writeFile as tt}from"node:fs/promises";import{homedir as nt}from"node:os";import{basename as ot,dirname as re,join as M}from"node:path";var pe="https://hyperscale0.ai",le="sandbox",me="hyperscale-cli-session",rt="/v1/personal-access-tokens/current",ie=process.platform==="darwin"?"/usr/bin/security":null,it="config.json",ae="https://hyperscale0.ai/desk/security/tokens",_="https://hyperscale0.ai/request-access",j=`Mint a founder PAT in Hyperscale Portal at ${ae}. Open Security, then Personal access tokens.`,at=`Not logged in. Run "hyperscale auth login" to open Hyperscale Portal sign-in. In a headless environment, ${j} Then set HYPERSCALE_TOKEN or pass --token. Unapproved founders can request access at ${_}.`,st=`Run "hyperscale auth login". For headless use, ${j} Unapproved founders can request access at ${_}.`,se=3e4,ct=2e3,ut=120*1e3,dt=/^prd_(sandbox|live)_[a-z0-9]{8,64}$/,pt=`hyperscale <command> [options]
|
|
3
3
|
|
|
4
4
|
Commands:
|
|
5
5
|
start Create a Product and run its first published journey step
|
|
@@ -88,18 +88,18 @@ Examples:
|
|
|
88
88
|
printf '{"limit":5}' | hyperscale call account.list
|
|
89
89
|
hyperscale call account.retrieve --input '{"accountId":"acct_sandbox_..."}'
|
|
90
90
|
`,ke={start:{usage:"start [--blueprint <slug>] [--name <name>] [--json]",summary:"Choose a catalog company, create its Product, and run its first published runnable journey step.",options:["--blueprint <slug> Skip the prompt and choose this catalog Blueprint.","--name <name> Product name. Defaults to the selected Blueprint name.","--json Print one machine document, including the one-time API key under shown_once."],notes:["The command requires an active founder login.","Without --blueprint, start requires an interactive terminal and asks which company to build.","Scripts and agents must pass --blueprint <slug>.","Machine output returns the Product API key only under shown_once.","A Blueprint without a published runnable journey stops after composition and names the next command."],example:"hyperscale start --blueprint vehicle-escrow-marketplace --json"},"auth login":{usage:"auth login [--no-browser] [--token <pat>]",summary:"Sign in through the portal callback or save a founder PAT.",options:["--no-browser Skip the portal callback. Print where to mint a PAT when no token is set.","--token <pat> Founder PAT. Defaults to HYPERSCALE_TOKEN.","--json Print the saved session summary as one JSON document."],notes:["Without a PAT, the CLI opens portal sign-in and accepts one localhost callback.","Headless environments should pass --no-browser and set HYPERSCALE_TOKEN or --token to a portal-minted founder PAT.","Set HYPERSCALE_CREDENTIAL_STORE=file to use the 0600 profile file instead of macOS Keychain."],example:"hyperscale auth login --no-browser"},"auth status":{usage:"auth status [--json]",summary:"Verify and show the active founder PAT and selected Product.",options:["--json Print machine-readable JSON."],example:"hyperscale auth status --json"},"auth logout":{usage:"auth logout [--revoke] [--json]",summary:"Forget the local founder PAT. Optionally revoke it first.",options:["--revoke Revoke the PAT before deleting local state.","--json Print machine-readable JSON."],example:"hyperscale auth logout --revoke"},"blueprint list":{usage:"blueprint list [--json]",summary:"List public Blueprints without authentication.",options:["--json Print the complete collection as JSON."],example:"hyperscale blueprint list"},"blueprint show":{usage:"blueprint show <id> [--json]",summary:"Show one public Blueprint.",options:["--json Print the complete Blueprint as JSON."],example:"hyperscale blueprint show luxury-goods-consignment-escrow"},"product create":{usage:"product create --blueprint <id> --name <name> [--json]",summary:"Create and select a Product. The command refuses a duplicate name.",options:["--blueprint <id> Required Blueprint id.","--name <name> Required Product name.","--json Print the creation summary as JSON."],example:'hyperscale product create --blueprint luxury-goods-consignment-escrow --name "Luxury Consignment"'},"product list":{usage:"product list [--json]",summary:"List Products in the signed-in company.",options:["--json Print the complete collection as JSON."],example:"hyperscale product list"},"product show":{usage:"product show [id] [--json]",summary:"Show a Product summary, or the complete Product document as JSON.",options:["--json Print the complete Product document."],example:"hyperscale product show prd_sandbox_..."},"product select":{usage:"product select <id> [--json]",summary:"Verify a Product and save it as the default for later commands.",options:["--token <pat> Founder PAT. Defaults to HYPERSCALE_TOKEN or the stored login.","--base-url <url> API origin. Defaults to the active founder profile.","--environment <name> sandbox or live. Defaults to the active founder profile.","--json Print the selected Product id as JSON."],notes:["The CLI stores the selection in the active founder profile.","Product show, compose plan/apply, and key commands use it when --product is absent.","Product create and start select the Product they create."],example:"hyperscale product select prd_sandbox_..."},"product actions":{usage:"product actions [operation-id] [--product <id>] [--json]",summary:"List frozen public actions or show one action's full schemas.",options:["--product <id> Product to inspect. Defaults to the selected Product.","--api-key <key> Product API key. Defaults to HYPERSCALE_API_KEY.","--json Print machine-readable JSON."],notes:["Setup operation details include the public input schema used by hyperscale call.","When that schema has no required fields, omit --input or pass {}."],example:"hyperscale product actions escrow_order.placeBuyerHold --json"},"product run":{usage:"product run <operation-id> [--input <json> | --input-file <path>] [--idempotency-key <key>] [--json]",summary:"Run one frozen public action with a Product API key.",options:["--input <json> JSON input object. Stdin is used when piped.","--input-file <path> Read the JSON input object from a file.","--product <id> Product to call. Defaults to the selected Product.","--api-key <key> Product API key. Defaults to HYPERSCALE_API_KEY.","--idempotency-key <key> Send this exact Idempotency-Key header. The default is a generated UUID.","--json Print the key, receipt ids, and output as JSON."],notes:["Reuse an Idempotency-Key only with the same operation and input.",'If a bounded validation value appears as "[Truncated]", run "hyperscale product actions <operation-id>" for the full input schema.'],example:`hyperscale product run escrow_order.placeBuyerHold --input '{"escrowOrderId":"eord_sandbox_..."}' --idempotency-key hold-001`},"compose check":{usage:"compose check <file.hsx> [--catalog-revision <id>] [--json]",summary:"Ask the server to compile and check an HSX program.",options:["--catalog-revision <id> Compile against this immutable tenant catalog revision.","--json Print diagnostics and the verdict as JSON."],example:"hyperscale compose check product.hsx"},"compose plan":{usage:"compose plan <file.hsx> [--product <id>] [--catalog-revision <id>] [--json]",summary:"Diff an HSX program against a Product.",options:["--product <id> Product to compare. Defaults to the selected Product.","--catalog-revision <id> Compile against this immutable tenant catalog revision.","--json Print the plan as JSON."],example:"hyperscale compose plan product.hsx --json"},"compose apply":{usage:"compose apply <file.hsx> (--confirm (--pricing-identity <id> | --plan-file <path>) | --yes) [--product <id>] [--catalog-revision <id>] [--json]",summary:"Recompose a Product from checked HSX.",options:["--confirm Confirm the mutation for a person, who must also name the candidate price they reviewed.","--yes Confirm the mutation without a prompt for an agent; accepts the candidate price current at apply time.","--pricing-identity <id> Candidate pricing identity from compose plan.","--plan-file <path> Saved JSON plan file from compose plan --json.","--product <id> Product to recompose. Defaults to the selected Product.","--catalog-revision <id> Compile and persist against this immutable tenant catalog revision.","--json Print the result as JSON."],example:"hyperscale compose apply product.hsx --yes --pricing-identity <id>"},"key create":{usage:"key create [--name <name>] [--product <id>] [--json]",summary:"Create a sandbox Product API key.",options:["--name <name> Key name. Defaults to Founder CLI.","--product <id> Product for the key. Defaults to the selected Product.","--json Print the one-time secret and key metadata as JSON."],example:'hyperscale key create --name "Founder laptop"'},"key list":{usage:"key list [--product <id>] [--json]",summary:"List keys for one Product.",options:["--product <id> Product to inspect. Defaults to the selected Product.","--json Print the collection as JSON."],example:"hyperscale key list --json"},"key revoke":{usage:"key revoke <id> [--product <id>] [--json]",summary:"Revoke one Product API key.",options:["--product <id> Product that owns the key. Defaults to the selected Product.","--json Print the result as JSON."],example:"hyperscale key revoke key_sandbox_..."},"activity list":{usage:"activity list [--json]",summary:"List company activity with timestamps and resource targets.",options:["--json Print the complete collection as JSON."],example:"hyperscale activity list"},whoami:{usage:"whoami [--json]",summary:"Show the user and company the founder PAT resolves to.",options:["--json Print machine-readable JSON."],example:"hyperscale whoami --json"},"ops list":{usage:"ops list [filter] [--product <id>] [--json]",summary:"List callable operations from the Product machine document.",options:["--product <id> Product to inspect. The Product API key must belong to it.","--api-key <key> Product API key. Defaults to HYPERSCALE_API_KEY.","--json Print matching operations as JSON."],example:"hyperscale ops list account"},call:{usage:"call <operation> [--input <json> | --input-file <path>] [--idempotency-key <key>] [--product <id>]",summary:"Call one operation from the Product machine document.",options:["--input <json> JSON input object. Stdin is used when piped.","--input-file <path> Read the JSON input object from a file.","--product <id> Product to call. The Product API key must belong to it.","--api-key <key> Product API key. Defaults to HYPERSCALE_API_KEY.","--idempotency-key <key> Send this exact Idempotency-Key header for a mutation. The default is a generated UUID."],notes:["Reuse an Idempotency-Key only with the same operation and input."],example:`hyperscale call account.create --input '{"currency":"SAR"}'`}};function lt(e){let n=Object.keys(ke).sort((r,i)=>i.split(" ").length-r.split(" ").length).find(r=>r.split(" ").every((s,c)=>e[c]===s));if(!n)throw new u(`No help for ${e.join(" ")}. Run "hyperscale --help" to list commands.`);let o=ke[n];return[`Usage: hyperscale ${o.usage}`,"",o.summary,"","Options:",...o.options.map(r=>` ${r}`),...o.notes?["","Notes:",...o.notes.map(r=>` ${r}`)]:[],"","Example:",` ${o.example}`,""].join(`
|
|
91
|
-
`)}var u=class extends Error{constructor(t,n={}){super(t),typeof n.code=="string"&&(this.code=n.code),n.details!==void 0&&(this.details=n.details),Number.isInteger(n.exitCode)&&(this.exitCode=n.exitCode),typeof n.fix=="string"&&(this.fix=n.fix)}},O=class extends u{constructor(t,{requestId:n,status:o,code:r,details:i,operationId:s,receiptId:c,traceId:d,structuredError:p}={}){super(t,{code:r,details:i}),this.requestId=n,this.status=o,this.operationId=s??null,this.receiptId=c??null,this.traceId=d??null,this.structuredError=p}};function te(){return new u(at,{fix:st})}function
|
|
92
|
-
`)}function H(e){return We("sha256").update(`${e.baseUrl}\0${e.environment}\0${e.email}`).digest("hex")}async function G(e,t){return ie===null?{error:null,status:null,stdout:"",unavailable:!0}:await new Promise(n=>{let o={...process.env};delete o.HYPERSCALE_API_KEY,delete o.HYPERSCALE_TOKEN;let r=
|
|
91
|
+
`)}var u=class extends Error{constructor(t,n={}){super(t),typeof n.code=="string"&&(this.code=n.code),n.details!==void 0&&(this.details=n.details),Number.isInteger(n.exitCode)&&(this.exitCode=n.exitCode),typeof n.fix=="string"&&(this.fix=n.fix)}},O=class extends u{constructor(t,{requestId:n,status:o,code:r,details:i,operationId:s,receiptId:c,traceId:d,structuredError:p}={}){super(t,{code:r,details:i}),this.requestId=n,this.status=o,this.operationId=s??null,this.receiptId=c??null,this.traceId=d??null,this.structuredError=p}};function te(){return new u(at,{fix:st})}function ve(e){let t=e??"<id>";return new u(`This command needs a Product API key. Create one with "hyperscale key create --name 'Founder CLI' --product ${t}", then set HYPERSCALE_API_KEY or pass --api-key.`)}var K=class extends u{constructor(t,n){super(t),this.code="check_failed",this.details=n,this.exitCode=2}},Ee=new Set(["--api-key","--base-url","--blueprint","--catalog-revision","--environment","--idempotency-key","--input","--input-file","--name","--plan-file","--pricing-identity","--product","--token"]);function mt(e){let t=[],n={};for(let o=0;o<e.length;o+=1){let r=e[o];if(!r.startsWith("--")){t.push(r);continue}if(Ee.has(r)){let i=e[o+1];if(i===void 0)throw new u(`${r} needs a value`);n[r]=i,o+=1;continue}if(r==="--help"||r==="--version"||r==="--json"||r==="--confirm"||r==="--yes"||r==="--no-browser"||r==="--passkey"||r==="--revoke"){n[r]=!0;continue}throw new u(`Unknown option: ${r}`)}return{flags:n,positional:t}}function $e(e,t){let n=e["--api-key"]??t.HYPERSCALE_API_KEY;if(!n)throw ve();let o=e["--environment"]??t.HYPERSCALE_ENVIRONMENT??le;if(o!=="sandbox"&&o!=="live")throw new u(`Unknown environment: ${o}. Use sandbox or live.`);let r=(e["--base-url"]??t.HYPERSCALE_BASE_URL??pe).replace(/\/+$/,"");return{apiKey:n,baseUrl:r,environment:o}}function L(e,t,n={}){let o=e["--environment"]??t.HYPERSCALE_ENVIRONMENT??n.environment??le;if(o!=="sandbox"&&o!=="live")throw new u(`Unknown environment: ${o}. Use sandbox or live.`);let r=(e["--base-url"]??t.HYPERSCALE_BASE_URL??n.baseUrl??pe).replace(/\/+$/,""),i;try{i=new URL(r)}catch{i=null}let s=i?.origin??null;if(!s||s!==r)throw new u(`Invalid API origin: ${r}. Use an origin such as https://hyperscale0.ai.`);let c=["localhost","127.0.0.1","[::1]","::1"].includes(i.hostname);if(i.protocol!=="https:"&&!(i.protocol==="http:"&&c))throw new u(`Refusing cleartext API origin ${r}. Use HTTPS unless the API runs on loopback.`);return{baseUrl:r,environment:o}}function Oe(e){return e.HYPERSCALE_CONFIG_DIR??M(nt(),".config","hyperscale")}function Ce(e){return M(Oe(e),it)}function b(e,t){return M(Oe(t),`session-${H(e)}.json`)}function V(e){let t=e.HYPERSCALE_CREDENTIAL_STORE??"auto";if(t==="auto"||t==="file")return t;throw new u(`Unknown HYPERSCALE_CREDENTIAL_STORE value: ${t}. Use auto or file.`)}async function fe(e,t){let n=b(e,t),o=`${ot(n)}.`,r;try{r=await Qe(re(n),{withFileTypes:!0})}catch(i){if(i&&i.code==="ENOENT")return;throw i}for(let i of r){if(!i.isFile()||!i.name.startsWith(o))continue;let s=i.name.slice(o.length);/^\d+\.[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}\.tmp$/.test(s)&&await U(M(re(n),i.name))}}async function ft(e){try{return JSON.parse(await D(e,"utf8"))}catch(t){if(t&&t.code==="ENOENT")return null;throw t instanceof SyntaxError?new u(`${e} is not valid JSON`):t}}async function N(e,t){let n=ht(e);await Xe(n,{mode:448,recursive:!0}),await ee(n,448);let o=`${e}.${process.pid}.${globalThis.crypto.randomUUID()}.tmp`;await tt(o,t,{flag:"wx",mode:384}),await ee(o,384);try{await Ze(o,e),await ee(e,384)}catch(r){throw await U(o),r}}function ht(e){return re(e)}async function U(e){try{await et(e)}catch(t){if(!t||t.code!=="ENOENT")throw t}}function yt(e,t){if(!e||typeof e!="object"||Array.isArray(e))throw new u(`${t} does not contain a CLI profile`);let{baseUrl:n,email:o,environment:r,selectedProduct:i}=e;if(typeof n!="string"||typeof o!="string"||r!=="sandbox"&&r!=="live"||!(i===null||typeof i=="string"))throw new u(`${t} does not contain a valid CLI profile`);return{baseUrl:n,email:o,environment:r,selectedProduct:i}}async function W(e){let t=Ce(e),n=await ft(t);return n===null?null:yt(n,t)}async function z(e,t){let n={email:t.email,baseUrl:t.baseUrl,environment:t.environment,selectedProduct:t.selectedProduct??null};await N(Ce(e),`${JSON.stringify(n,null,2)}
|
|
92
|
+
`)}function H(e){return We("sha256").update(`${e.baseUrl}\0${e.environment}\0${e.email}`).digest("hex")}async function G(e,t){return ie===null?{error:null,status:null,stdout:"",unavailable:!0}:await new Promise(n=>{let o={...process.env};delete o.HYPERSCALE_API_KEY,delete o.HYPERSCALE_TOKEN;let r=xe(ie,e,{env:o,stdio:["pipe","pipe","pipe"]}),i=[],s=!1,c=p=>{s||(s=!0,clearTimeout(d),n(p))},d=setTimeout(()=>{r.kill("SIGKILL"),c({error:null,status:null,stdout:"",unavailable:!0})},ct);r.stdout.on("data",p=>i.push(p)),r.stderr.on("data",()=>{}),r.stdin.on("error",()=>{}),r.once("error",p=>c({error:p,status:null,stdout:"",unavailable:!0})),r.once("close",p=>c({error:null,status:p,stdout:Buffer.concat(i).toString("utf8"),unavailable:!1})),t===void 0?r.stdin.end():r.stdin.end(`${t}
|
|
93
93
|
`)})}async function he(){return(await G(["show-keychain-info"])).status===0}function Re(e){try{let t=typeof e=="string"?JSON.parse(e):e;if(t&&typeof t=="object"&&!Array.isArray(t)&&typeof t.token=="string"&&typeof t.tenantId=="string"&&(t.personalAccessTokenId===void 0||typeof t.personalAccessTokenId=="string")&&(t.tokenName===void 0||typeof t.tokenName=="string"))return{token:t.token,tenantId:t.tenantId,...t.personalAccessTokenId?{personalAccessTokenId:t.personalAccessTokenId}:{},...t.tokenName?{tokenName:t.tokenName}:{}}}catch{}return null}async function wt(e,t,n){await fe(e,n);let o=H(e);if(V(n)==="auto"&&await he()){let r=JSON.stringify(t),i=["add-generic-password","-a",o,"-s",me,"-U","-X",Buffer.from(r,"utf8").toString("hex")].join(" ");if((await G(["-i"],i)).status===0)return await U(b(e,n)),"keychain"}return await N(b(e,n),`${JSON.stringify({account:o,activeStore:"file",credential:t})}
|
|
94
94
|
`),"file"}async function gt(e,t){let n=H(e);try{let o=JSON.parse(await D(b(e,t),"utf8"));if(!o||typeof o!="object"||Array.isArray(o)||o.account!==n)return{state:"invalid"};if(o.revoked===!0)return{state:"revoked"};let r=Re(o.credential);return r?{activeStore:o.activeStore==="file"?"file":null,credential:r,state:"valid"}:{state:"invalid"}}catch(o){return o&&o.code==="ENOENT"?{state:"missing"}:{state:"invalid"}}}async function Ne(e,t){await fe(e,t);let n=V(t),o=await gt(e,t);if(o.state==="revoked")return null;if(o.state==="valid"&&(o.activeStore==="file"||n==="file"))return o.credential;if(n==="file")return null;let r=null;if(await he()){let i=await G(["find-generic-password","-a",H(e),"-s",me,"-w"]);i.status===0&&(r=Re(i.stdout.trim()))}return r||(o.state==="valid"?o.credential:null)}async function _e(e,t){await fe(e,t);let n=H(e);if(V(t)==="file")return await N(b(e,t),`${JSON.stringify({account:n,revoked:!0})}
|
|
95
95
|
`),{keychainDeleted:!0};if(ie===null)return await U(b(e,t)),{keychainDeleted:!0};if(!await he())return await N(b(e,t),`${JSON.stringify({account:n,revoked:!0})}
|
|
96
96
|
`),{keychainDeleted:!1};let o=await G(["delete-generic-password","-a",n,"-s",me]);return o.status!==0&&o.status!==44?(await N(b(e,t),`${JSON.stringify({account:n,revoked:!0})}
|
|
97
|
-
`),{keychainDeleted:!1}):(await U(b(e,t)),{keychainDeleted:!0})}function je(e,t){return e["--token"]!==void 0?e["--token"]:t.HYPERSCALE_TOKEN||void 0}async function $(e,t,n=!1){let o=await W(t),r=je(e,t);if(r!==void 0){if(!r)throw te();let c=L(e,t,o??{}),d=await
|
|
97
|
+
`),{keychainDeleted:!1}):(await U(b(e,t)),{keychainDeleted:!0})}function je(e,t){return e["--token"]!==void 0?e["--token"]:t.HYPERSCALE_TOKEN||void 0}async function $(e,t,n=!1){let o=await W(t),r=je(e,t);if(r!==void 0){if(!r)throw te();let c=L(e,t,o??{}),d=await v(c,r),p=o?.baseUrl===c.baseUrl&&o.environment===c.environment&&o.email===d.email;return{...c,email:d.email,identity:d,personalAccessTokenId:d.personalAccessTokenId,selectedProduct:p?o.selectedProduct:null,tenantId:d.tenantId,token:r,tokenName:d.name}}if(!o){if(n)return null;throw te()}let i=L(e,t,o);if(i.baseUrl!==o.baseUrl||i.environment!==o.environment)throw new u(`The active founder login belongs to ${o.baseUrl} (${o.environment}). Log in again to change it.`);let s=await Ne(o,t);if(!s){if(n)return null;throw te()}return{...o,...s}}function B(e){return e.replace(new RegExp("\\p{Cc}","gu"),t=>`
|
|
98
98
|
\r`.includes(t)?t:"")}function q(e){try{return new URL(e).origin}catch{return null}}function y(e,t){let n=e;for(let o of t)typeof o=="string"&&o.length>0&&(n=n.replaceAll(o,"[redacted]"));return n}function Le(e,t=[]){if(!e?.ok||!e?.headers)return;let n=e.headers.get("x-request-id"),o=e.headers.get("hyperscale-operation-id"),r=e.headers.get("hyperscale-receipt-id"),i=n?y(n,t):null,s=o?y(o,t):null,c=r?y(r,t):null;i&&process.stderr.write(`Request id: ${i}
|
|
99
99
|
`),s&&process.stderr.write(`Operation: ${s}
|
|
100
100
|
`),c&&process.stderr.write(`Receipt: ${c}
|
|
101
|
-
`)}async function X(e,t,n={},o){let r=`${e.baseUrl}${t}`,i=q(e.baseUrl);if(q(r)!==i)throw new u(`The requested path ${t} leaves the ${i} origin; refusing the request.`);try{let s=await fetch(r,{...n,headers:{accept:"application/json",...o?{authorization:`Bearer ${o}`}:{},"x-hyperscale-environment":e.environment,...n.headers},signal:AbortSignal.timeout(se),redirect:"manual"});if(s.status>=300&&s.status<400)throw new u(`${r} redirected, so no credential was sent on. Point --base-url at the origin the API answers on.`);return Le(s,[o].filter(Boolean)),{response:s,text:B(await s.text())}}catch(s){throw s instanceof u?s:new u(`Could not reach ${r}: ${s.message}`)}}async function P(e,t,n={},o,r=[]){let{response:i,text:s}=await X(e,t,n,o);if(!i.ok)throw Z(i,s,r);try{return JSON.parse(s)}catch{throw new u(`HTTP ${i.status} returned invalid JSON`)}}function
|
|
102
|
-
Request id: ${c}`:""}`,{code:o.code,details:o.details,operationId:d,receiptId:p,requestId:c,status:e.status,structuredError:o.structuredError,traceId:m})}function ye(e,t){return{authenticated:!0,baseUrl:e.baseUrl,email:t.email,environment:e.environment,expiresAt:t.expiresAt,personalAccessTokenId:t.personalAccessTokenId,role:t.role,scopes:t.scopes,selectedProduct:e.selectedProduct,teamId:t.teamId,tenantId:t.tenantId,tokenName:t.name,userId:t.userId}}function bt(e){if(!e||typeof e!="object"||typeof e.userId!="string"||typeof e.email!="string"||typeof e.tenantId!="string"||typeof e.teamId!="string"||typeof e.role!="string"||typeof e.personalAccessTokenId!="string"||typeof e.name!="string"||!Array.isArray(e.scopes)||e.scopes.some(t=>typeof t!="string")||typeof e.expiresAt!="string"||e.status!=="active")throw new u("personal_access_token.current returned invalid data");return e}async function
|
|
101
|
+
`)}async function X(e,t,n={},o){let r=`${e.baseUrl}${t}`,i=q(e.baseUrl);if(q(r)!==i)throw new u(`The requested path ${t} leaves the ${i} origin; refusing the request.`);try{let s=await fetch(r,{...n,headers:{accept:"application/json",...o?{authorization:`Bearer ${o}`}:{},"x-hyperscale-environment":e.environment,...n.headers},signal:AbortSignal.timeout(se),redirect:"manual"});if(s.status>=300&&s.status<400)throw new u(`${r} redirected, so no credential was sent on. Point --base-url at the origin the API answers on.`);return Le(s,[o].filter(Boolean)),{response:s,text:B(await s.text())}}catch(s){throw s instanceof u?s:new u(`Could not reach ${r}: ${s.message}`)}}async function P(e,t,n={},o,r=[]){let{response:i,text:s}=await X(e,t,n,o);if(!i.ok)throw Z(i,s,r);try{return JSON.parse(s)}catch{throw new u(`HTTP ${i.status} returned invalid JSON`)}}function T(e,t=globalThis.crypto.randomUUID()){return{body:JSON.stringify(e),headers:{"content-type":"application/json","idempotency-key":t},method:"POST"}}async function It(){let e=[];for await(let t of process.stdin)e.push(Buffer.from(t));return Buffer.concat(e).toString("utf8")}async function Q(e,t,n={},o){let r=`${e.baseUrl}${t}`,i=q(e.baseUrl);if(q(r)!==i)throw new u(`The product document puts ${t} on another origin than the ${i} you configured; refusing to send the key there.`);try{let s=await fetch(r,{...n,headers:{accept:"application/json",authorization:`Bearer ${e.apiKey}`,"x-hyperscale-environment":e.environment,...n.headers},signal:AbortSignal.timeout(se),redirect:"manual"});if(s.status>=300&&s.status<400)throw new u(`${r} redirected, so the key was not sent on. Point --base-url at the origin the API answers on; the usual cause is http:// where it serves https://.`);return Le(s,[e.apiKey].filter(Boolean)),{response:s,text:B(await s.text())}}catch(s){throw s instanceof u?s:o&&(s?.name==="TimeoutError"||s?.name==="AbortError")?new u(`product run ${o} timed out after ${se/1e3} seconds.`):new u(`Could not reach ${r}: ${s.message}`)}}async function Ue(e){let{response:t,text:n}=await Q(e,"/v1/product.json");if(!t.ok)throw Z(t,n,[e.apiKey]);let o=kt(n);if(!o)throw new u("The product document is not in the expected format; upgrade the CLI.");if(e.productId&&o.productId===void 0)throw new u(`The server's product document names no Product, so "--product ${e.productId}" cannot be checked against the API key. The platform predates Product identity in the descriptor: redeploy it, or drop --product.`);if(e.productId&&o.productId&&e.productId!==o.productId)throw new u(`Selected Product ${e.productId} does not match API key Product ${o.productId}. Run "hyperscale product select ${o.productId}" or pass "--product ${o.productId}". Or set HYPERSCALE_API_KEY to a key for ${e.productId}, or pass that key with --api-key.`);let r=o.operations.map(i=>{if(typeof i.summary!="string"||typeof i.description!="string")throw new u(`The product document carries no prose for ${i.operationId}. The server descriptor predates operation prose. Redeploy the platform, then recompose the Product.`);return{description:i.description,idempotency:i.idempotency,method:i.method,name:i.name,operationId:i.operationId,path:i.path,summary:i.summary}});return{compositionId:o.composition.id,operations:r,packageName:o.sdk?o.sdk.packageName.trim():null,title:o.title.trim()}}function kt(e){let t;try{t=JSON.parse(e)}catch{return null}let n=ce(t),o=r=>typeof r=="string";if(!R(n)||n.schemaVersion!==1||!(n.productId===void 0||o(n.productId))||!o(n.title)||!R(n.composition)||!o(n.composition.id)||!Array.isArray(n.operations))return null;for(let r of n.operations)if(!R(r)||!o(r.method)||!o(r.path)||!o(r.name)||!o(r.operationId)||!o(r.idempotency))return null;return n.sdk!==void 0&&(!R(n.sdk)||!o(n.sdk.packageName))?null:n}function R(e){return typeof e=="object"&&e!==null&&!Array.isArray(e)}function ce(e){return typeof e=="string"?B(e):Array.isArray(e)?e.map(ce):R(e)?Object.fromEntries(Object.entries(e).map(([t,n])=>[B(t),ce(n)])):e}function De(e){let t=e.get("x-trace-id");if(t&&t.trim()!=="")return t.trim();let n=e.get("traceparent");if(n){let o=/^00-([0-9a-fA-F]{32})-[0-9a-fA-F]{16}-[0-9a-fA-F]{2}$/.exec(n.trim());if(o)return o[1]}return null}function $t(e){if(!e||e.trim()==="")return null;try{return JSON.parse(e)}catch{return e}}function Pt(e,t=[],n){let o;try{o=JSON.parse(e)}catch{o=null}let r=o&&typeof o=="object"&&o.error&&typeof o.error=="object"?o.error:null,i=typeof r?.code=="string"?r.code:void 0,s=typeof r?.message=="string"?r.message:e.trim(),c=y(s,t),d=i&&typeof r?.message=="string"?`${i}: ${c}`:c,p=r?.details!==void 0?F(r.details,t):void 0,m=o&&typeof o=="object"&&typeof o.requestId=="string"?o.requestId:void 0,l=n?`HTTP ${n}`:"HTTP error";return{code:i,details:p,humanMessage:d,redactedMessage:c,requestId:m,structuredError:{code:i??"http_error",message:c||l,...p!==void 0?{details:p}:{}}}}function Z(e,t,n=[]){let o=Pt(t,n,e.status),r=e.headers.get("x-request-id")??o.requestId??null,i=e.headers.get("hyperscale-operation-id")??null,s=e.headers.get("hyperscale-receipt-id")??null,c=r?y(r,n):null,d=i?y(i,n):null,p=s?y(s,n):null,m=De(e.headers),l=o.humanMessage;return new O(`HTTP ${e.status}${l?` \xB7 ${l}`:""}${c?`
|
|
102
|
+
Request id: ${c}`:""}`,{code:o.code,details:o.details,operationId:d,receiptId:p,requestId:c,status:e.status,structuredError:o.structuredError,traceId:m})}function ye(e,t){return{authenticated:!0,baseUrl:e.baseUrl,email:t.email,environment:e.environment,expiresAt:t.expiresAt,personalAccessTokenId:t.personalAccessTokenId,role:t.role,scopes:t.scopes,selectedProduct:e.selectedProduct,teamId:t.teamId,tenantId:t.tenantId,tokenName:t.name,userId:t.userId}}function bt(e){if(!e||typeof e!="object"||typeof e.userId!="string"||typeof e.email!="string"||typeof e.tenantId!="string"||typeof e.teamId!="string"||typeof e.role!="string"||typeof e.personalAccessTokenId!="string"||typeof e.name!="string"||!Array.isArray(e.scopes)||e.scopes.some(t=>typeof t!="string")||typeof e.expiresAt!="string"||e.status!=="active")throw new u("personal_access_token.current returned invalid data");return e}async function v(e,t){try{return bt(await P(e,rt,{},t,[t]))}catch(n){throw!(n instanceof O)||n.status!==401?n:new u(`That founder PAT was not accepted (HTTP 401). ${j}${n.requestId?` Request id: ${n.requestId}.`:""}`,{code:"founder_pat_rejected",fix:j})}}function St(e,t){return e.HYPERSCALE_CLI_BROWSER?{command:e.HYPERSCALE_CLI_BROWSER,args:[t]}:e.HYPERSCALE_NO_BROWSER==="1"||e.CI==="1"||e.CI==="true"||process.platform==="linux"&&!e.DISPLAY&&!e.WAYLAND_DISPLAY?null:process.platform==="darwin"?{command:"/usr/bin/open",args:[t]}:process.platform==="win32"?{command:"rundll32.exe",args:["url.dll,FileProtocolHandler",t]}:{command:"xdg-open",args:[t]}}async function At(e,t){let n=St(e,t);return n?new Promise(o=>{let r=xe(n.command,n.args,{detached:!0,stdio:"ignore"});r.once("error",()=>o(!1)),r.once("spawn",()=>{r.unref(),o(!0)})}):!1}function ne(e){return new Promise(t=>{if(!e.listening){t();return}e.close(()=>t())})}async function Tt(e,t){let n=globalThis.crypto.randomUUID(),o=!1,r,i=new Promise((g,h)=>{r={reject:h,resolve:g}}),s=ze((g,h)=>{let I=new URL(g.url??"/","http://127.0.0.1");if(g.method!=="GET"||I.pathname!=="/callback"){h.writeHead(404,{"content-type":"text/plain; charset=utf-8"}),h.end(`Not found.
|
|
103
103
|
`);return}if(o){h.writeHead(409,{"content-type":"text/plain; charset=utf-8"}),h.end(`Login callback was already received.
|
|
104
104
|
`);return}if(I.searchParams.get("state")!==n){h.writeHead(400,{"content-type":"text/plain; charset=utf-8"}),h.end(`Login state did not match. Return to the terminal.
|
|
105
105
|
`);return}if(I.searchParams.get("error")!==null){o=!0,h.writeHead(200,{"content-type":"text/plain; charset=utf-8"}),h.end(`Login declined. Return to the terminal.
|
|
@@ -107,20 +107,20 @@ Request id: ${c}`:""}`,{code:o.code,details:o.details,operationId:d,receiptId:p,
|
|
|
107
107
|
`);return}o=!0,h.writeHead(200,{"content-type":"text/plain; charset=utf-8"}),h.end(`Login received. Return to the terminal.
|
|
108
108
|
`),r.resolve({grant:S,tenantId:A})});await new Promise((g,h)=>{let I=S=>h(S);s.once("error",I),s.listen(0,"127.0.0.1",()=>{s.off("error",I),g()})}),s.once("error",g=>r.reject(g));let c=s.address();if(!c||typeof c=="string")throw await ne(s),new u("Could not bind the localhost login callback");let d=`http://127.0.0.1:${c.port}/callback`,p=new URL("/auth/cli",e.baseUrl);p.searchParams.set("callback",d),p.searchParams.set("state",n);let m=new URL("/signin",e.baseUrl);m.searchParams.set("returnTo",`${p.pathname}${p.search}`);let l=m.toString();if(!await At(t,l))return await ne(s),null;process.stderr.write(`Opening portal sign-in: ${l}
|
|
109
109
|
`);let k=setTimeout(()=>{r.reject(new u("Portal login timed out. Run hyperscale auth login to start a new callback.",{code:"auth_callback_timeout"}))},ut);try{return await i}finally{clearTimeout(k),await ne(s)}}function Pe(e){let t={authenticated:!1,browserOpened:!1,next:["export HYPERSCALE_TOKEN=hyperscale_pat_...","hyperscale auth login --no-browser"],patMintUrl:ae,requestAccessUrl:_};if(e["--json"]){w(t);return}a("No browser detected. Mint a founder PAT in the portal, then run:");for(let n of t.next)a(` ${n}`);a(`PAT desk: ${ae}`),a(`No access yet: ${_}`)}async function be(e,t,n,o,r){let i=await W(r),s={email:t.email,...e,selectedProduct:i&&i.email===t.email&&i.baseUrl===e.baseUrl&&i.environment===e.environment?i.selectedProduct:null},c=await wt(s,{personalAccessTokenId:t.personalAccessTokenId,token:n,tokenName:t.name,tenantId:t.tenantId},r);try{await z(r,s)}catch(p){throw await _e(s,r),p}if(c==="file"){let p=V(r)==="file"?"Founder PAT file storage is active.":"macOS Keychain is unavailable.";process.stderr.write(`${p} The founder PAT is in ${b(s,r)} with mode 0600.
|
|
110
|
-
`)}let d=ye(s,t);o["--json"]?w(d):a(`Logged in as ${t.email} with PAT ${t.name}.`)}async function
|
|
111
|
-
`)}function
|
|
110
|
+
`)}let d=ye(s,t);o["--json"]?w(d):a(`Logged in as ${t.email} with PAT ${t.name}.`)}async function xt(e,t){let n=L(e,t),o=je(e,t);if(o){if(!o.startsWith("hyperscale_pat_"))throw new u("Founder PATs start with hyperscale_pat_. Product API keys belong in HYPERSCALE_API_KEY.");let d=await v(n,o);await be(n,d,o,e,t);return}if(e["--no-browser"]){Pe(e);return}let r=await Tt(n,t);if(!r){Pe(e);return}let i=await P(n,"/v1/personal-access-token-login-grants/exchange",T({tenantId:r.tenantId,grant:r.grant}),void 0,[r.grant]),s=i?.secret;if(typeof s!="string"||!s.startsWith("hyperscale_pat_")||i?.tenantId!==r.tenantId)throw new u("CLI login grant exchange returned an invalid PAT");let c=await v(n,s);await be(n,c,s,e,t)}async function vt(e,t){let n=await $(e,t),o=n.identity??await v(n,n.token),r=ye(n,o);if(e["--json"]){w(r);return}a(`User: ${o.email}`),a(`Tenant: ${o.tenantId}`),a(`Role: ${o.role}`),a(`Token: ${o.name}`),a(`Scopes: ${o.scopes.join(", ")}`),a(`Expires: ${o.expiresAt}`),a(`API: ${n.baseUrl}`),a(`Environment: ${n.environment}`),a(`Product: ${n.selectedProduct??"not selected"}`)}async function Et(e,t){let n=await W(t);if(!n){e["--json"]?w({status:"signed_out"}):a("Already logged out.");return}let o=await Ne(n,t);if(e["--revoke"]&&!o)throw new u("The local founder PAT is missing, so the CLI cannot revoke it.");let r=o?.personalAccessTokenId,i=o?.tokenName;if(e["--revoke"]&&o){if(!r||!i){let d=await v(n,o.token);r=d.personalAccessTokenId,i=d.name}await P(n,`/v1/personal-access-tokens/${encodeURIComponent(r)}/revoke`,T({tenantId:o.tenantId,personalAccessTokenId:r}),o.token,[o.token])}let s=await _e(n,t),c=e["--revoke"]===!0;Ot(e,{cleanup:s,personalAccessTokenId:r,revoked:c,status:"signed_out",tokenName:i})}function Ot(e,t){let n=t.cleanup.keychainDeleted?"complete":"tombstoned";if(e["--json"])w({credentialCleanup:n,...t.personalAccessTokenId?{personalAccessTokenId:t.personalAccessTokenId}:{},...t.revoked===void 0?{}:{revoked:t.revoked},status:t.status,...t.tokenName?{tokenName:t.tokenName}:{},...t.revoked===!1?{tokenStillValid:!0}:{}});else{let o=t.tokenName&&t.personalAccessTokenId?`${t.tokenName} (${t.personalAccessTokenId})`:"with unavailable local metadata";t.revoked?a(`Revoked founder PAT ${o} and forgot local state.`):(a(`Forgot local founder PAT ${o}.`),a("The PAT stays valid until expiry; revoke at /desk/security/tokens."))}t.cleanup.keychainDeleted||process.stderr.write(`Keychain cleanup failed. A 0600 profile tombstone blocks the stale founder PAT.
|
|
111
|
+
`)}function E(e,t){if(!e||typeof e!="object"||!Array.isArray(e.items))throw new u(`${t} returned an invalid collection`);return e.items}async function C(e,t,n,o,r,i=[]){let s=[],c=new Set,d,p;for(;;){let k=new URLSearchParams(n);d&&k.set("cursor",d);let g=k.size>0?`?${k}`:"",h=await P(e,`${t}${g}`,{},r,i);p===void 0&&(p=h),s.push(...E(h,o));let I=h.nextCursor;if(typeof I!="string"||I.length===0)break;if(c.has(I))throw new u(`${o} repeated cursor ${I}`);c.add(I),d=I}let{items:m,nextCursor:l,...f}=p;return{...f,items:s}}async function Ct(e,t){let n=await C(e,"/v1/blueprints",{},"blueprint.list"),o=E(n,"blueprint.list");if(t["--json"]){w(n);return}a("ID Name Summary");for(let r of o)a(`${r.id} ${r.name}${r.summary?` ${r.summary}`:""}`);a("Next:"),a(" hyperscale blueprint show <id>"),a(" hyperscale product create --blueprint <id> --name <name>")}async function Rt(e,t,n){if(!n)throw new u("blueprint show needs a Blueprint id");let o=await P(e,`/v1/blueprints/${encodeURIComponent(n)}`),r=Nt(o,e.baseUrl);if(t["--json"]){w(r);return}a(`${r.name} (${r.id})`),a(r.summary),a(r.description),a("Nouns:");for(let i of r.customInstruments??[])a(` ${i.name} (${i.id}): ${i.summary}`);for(let i of r.instruments??[])a(` ${i.title} (${i.id}): ${i.summary}`);a("Verbs:");for(let i of r.verbs??[])a(` ${i.alias} -> ${i.operation}: ${i.summary}`);a("Parties:");for(let i of r.parties??[])a(` ${i.instrumentId}.${i.role} -> ${i.accountField}`);a("Money flows:");for(let i of r.moneyFlows??[]){let s=i.sourceAccount??"action input",c=i.destinationAccount??"action input",d=i.amountPath??"action input";a(` ${i.action} [${i.kind}]: ${s} -> ${c}; amount ${d}`)}a("Fee forms:");for(let i of r.feeForms??[]){let s=i.bps?`${i.bps} bps`:i.amountSar?`SAR ${i.amountSar}`:i.includedQuantity?`${i.includedQuantity} included`:i.kind;a(` ${i.id}: ${s} per ${i.unit}. ${i.summary}`)}r.priceEstimate&&(a("Price estimate:"),a(` monthlySar: SAR ${Number(r.priceEstimate.monthlySar).toLocaleString("en-US")}`),a(` setupSar: SAR ${Number(r.priceEstimate.setupSar).toLocaleString("en-US")}`),a(` complexityScore: ${r.priceEstimate.complexityScore}`)),a("Dials:");for(let i of r.dials??[])a(` ${i.instrumentId}.${i.key} (${i.kind}): ${i.summary}`);a("Journeys:");for(let i of r.journeys??[])a(` ${i.title} (${i.id}): ${i.summary}`),a(` ${i.steps.join(" -> ")}`);r.hsxStructured&&(a("HSX:"),a(` Source:
|
|
112
112
|
${Se(r.hsxStructured.source," ")}`),r.hsxStructured.document&&a(` Structured document:
|
|
113
113
|
${Se(JSON.stringify(r.hsxStructured.document,null,2)," ")}`)),a("Terms:");for(let[i,s]of Object.entries(r.terminology))a(` ${i}: ${s.definition}`),a(` ${s.href}`);a("Next:"),a(` hyperscale product create --blueprint ${r.id} --name <name>`)}function Nt(e,t){let n=_t(e?.hsx);return{...e,...n?{hsxStructured:n}:{},terminology:{firedBy:{definition:"Who invokes an action: tenant through the Product surface, operator through a console session, or machine when a due condition arrives.",href:`${t}/glossary#action-caller`},publicIntents:{definition:"The retired name for publicActions. publicActions contains the canonical action IDs frozen into a composed Product.",href:`${t}/glossary#public-actions`},trustFile:{definition:"The evidence attached to a business record for later review, such as inspection, authentication, delivery, or proof-of-work records.",href:`${t}/glossary#trust-file`}}}}function _t(e){if(typeof e!="string"||e.length===0)return;try{let n=JSON.parse(e);if(n&&typeof n=="object"&&!Array.isArray(n))return{document:n,language:"hsx-json",source:e,verdict:"valid"}}catch{}let t=compile(e);return{diagnostics:t.diagnostics,...t.artifacts?{document:t.artifacts.document,frame:t.artifacts.frame}:{},language:"hsx-text",source:e,verdict:t.verdict}}function Se(e,t){return e.split(`
|
|
114
114
|
`).map(n=>`${t}${n}`).join(`
|
|
115
|
-
`)}function we(e,t=[]){let n=e.headers.get("hyperscale-operation-id"),o=e.headers.get("hyperscale-receipt-id"),r=n?y(n,t):void 0,i=o?y(o,t):void 0;return{...r?{operationId:r}:{},...i?{receiptId:i}:{}}}function ge(e,t,n=[]){if(!e.ok)throw Z(e,t,n);try{return JSON.parse(t)}catch{throw new u(`HTTP ${e.status} returned invalid JSON`)}}function jt(e,t){t.operationId&&a(`${e} operation: ${t.operationId}`),t.receiptId&&a(`${e} receipt: ${t.receiptId}`)}function Lt(e,t){let n=e instanceof u?e:new u("hyperscale start failed after the Product was created",{code:"start_failed_after_compose"});return n.shownOnce=t,n}function Ut(e){if(!e["--blueprint"]&&!(process.stdin.isTTY&&process.stderr.isTTY))throw new u("hyperscale start needs an interactive terminal to choose a company. Pass --blueprint <slug> in scripts and non-interactive environments.",{code:"start_blueprint_required",fix:'Run "hyperscale blueprint list", then pass --blueprint <slug>.'})}function Dt(e){return
|
|
115
|
+
`)}function we(e,t=[]){let n=e.headers.get("hyperscale-operation-id"),o=e.headers.get("hyperscale-receipt-id"),r=n?y(n,t):void 0,i=o?y(o,t):void 0;return{...r?{operationId:r}:{},...i?{receiptId:i}:{}}}function ge(e,t,n=[]){if(!e.ok)throw Z(e,t,n);try{return JSON.parse(t)}catch{throw new u(`HTTP ${e.status} returned invalid JSON`)}}function jt(e,t){t.operationId&&a(`${e} operation: ${t.operationId}`),t.receiptId&&a(`${e} receipt: ${t.receiptId}`)}function Lt(e,t){let n=e instanceof u?e:new u("hyperscale start failed after the Product was created",{code:"start_failed_after_compose"});return n.shownOnce=t,n}function Ut(e){if(!e["--blueprint"]&&!(process.stdin.isTTY&&process.stderr.isTTY))throw new u("hyperscale start needs an interactive terminal to choose a company. Pass --blueprint <slug> in scripts and non-interactive environments.",{code:"start_blueprint_required",fix:'Run "hyperscale blueprint list", then pass --blueprint <slug>.'})}function Dt(e){return E(e,"blueprint.list").map(t=>{if(typeof t?.id!="string"||t.id.length===0||typeof t?.name!="string"||t.name.length===0)throw new u("blueprint.list returned an invalid start choice");return{id:t.id,name:t.name,summary:typeof t.summary=="string"?t.summary:""}})}async function Ht(e,t){let n=await C(t,"/v1/blueprints",{},"blueprint.list"),o=Dt(n);if(o.length===0)throw new u("The Blueprint catalog has no companies to build.");let r=e["--blueprint"];if(r){let l=o.find(({id:f})=>f===r);if(l)return l;throw new u(`Unknown Blueprint: ${r}`,{fix:'Run "hyperscale blueprint list" and pass one listed slug to --blueprint.'})}process.stderr.write(`Which company do you want to build?
|
|
116
116
|
`);for(let[l,f]of o.entries()){let k=f.summary.replace(/\s+/g," ").trim();process.stderr.write(` ${l+1}. ${f.name} (${f.id})${k?`: ${k}`:""}
|
|
117
|
-
`)}let i=Ge({input:process.stdin,output:process.stderr,terminal:!0}),s=new AbortController,c=()=>s.abort();process.stdin.once("end",c),process.stdin.readableEnded&&s.abort();let d;try{try{d=(await i.question("Choose a number or Blueprint slug: ",{signal:s.signal})).trim()}catch(l){throw l?.name!=="AbortError"&&l?.code!=="ABORT_ERR"?l:new u("Start cancelled before a Blueprint was chosen.",{code:"start_cancelled"})}}finally{process.stdin.off("end",c),i.close()}let p=Number(d),m=Number.isInteger(p)?o[p-1]:o.find(({id:l})=>l===d);if(m)return m;throw new u(`No Blueprint matches ${JSON.stringify(d)}.`,{fix:"Run hyperscale start again and choose a listed number or slug."})}async function Ae(e,t){Ut(e);let n={};try{await Jt(e,t,n)}catch(o){throw typeof n.apiKey!="string"?o:Lt(o,n.apiKey)}}async function Jt(e,t,n){let o=await $(e,t),r=await
|
|
118
|
-
`),{file:n,issues:p.issues,...d});return{check:p,receipt:d,context:i,productId:s,program:r,catalogRevisionId:e["--catalog-revision"]}}async function zt(e,t,n){let o=await Ie(e,t,n,"none");if(e["--json"]){w({command:"composer.check",file:n,issues:o.check.issues,ok:!0,...o.receipt});return}a(`Check passed: ${n}`)}async function Je(e,t){let n=await X(e.context,"/v1/composer/plan",
|
|
119
|
-
`),{actions:i,file:t,...r,...e.productId?{productId:e.productId}:{}});return{...o,...r}}async function Gt(e,t,n){let o=await Ie(e,t,n,"optional"),r=await Je(o,n);if(e["--json"]){w({command:"composer.plan",file:n,check:{...o.check,...o.receipt},plan:r,...o.productId?{productId:o.productId}:{}});return}a(r.summary);for(let i of r.actions)a(`${i.kind} ${i.target} ${i.detail}`);r.pricing?.scheduled?(a(`Current billing price: SAR ${r.pricing.current.monthlySar}/mo`),a(`Candidate price from ${r.pricing.scheduled.effectiveAt}: SAR ${r.pricing.scheduled.monthlySar}/mo`),a(`Pricing identity: ${r.pricing.scheduled.pricingIdentity}`)):(a(`Monthly: SAR ${r.pricing.monthlySar}`),a(`Activation: SAR ${r.pricing.activationSar}`))}async function Xt(e,t,n){if(!e["--confirm"]&&!e["--yes"])throw new u("compose apply changes the selected Product. Pass --confirm, or --yes for an agent.");let o=e["--pricing-identity"];if(!o&&e["--plan-file"]){let c=e["--plan-file"];try{let d=await D(c,"utf8"),p=JSON.parse(d);o=p.plan?.pricing?.scheduled?.pricingIdentity??p.pricing?.scheduled?.pricingIdentity??p.pricingIdentity}catch(d){throw new u(`Failed to read saved plan file ${c}: ${d.message}`)}}let r=await Ie(e,t,n,"required"),i=await Je(r,n);if(i.pricing?.scheduled&&!o){if(!e["--yes"])throw new u(`compose apply --confirm requires --pricing-identity (or --plan-file). Run "hyperscale compose plan ${n}" to review candidate pricing and copy the pricing identity, or pass --yes to accept the current candidate.`);o=i.pricing.scheduled.pricingIdentity}let s=await P(r.context,"/v1/products/recompose",
|
|
120
|
-
`),{code:s,...i.error.details?{details:F(i.error.details,n)}:{},...l?{fix:l}:{}});return h&&(A.requestId=h),I&&(A.operationId=I),S&&(A.receiptId=S),A}function F(e,t){return typeof e=="string"?y(e,t):Array.isArray(e)?e.map(n=>F(n,t)):e&&typeof e=="object"?Object.fromEntries(Object.entries(e).map(([n,o])=>[y(n,t),F(o,t)])):e}function cn(e,t){if(!e||typeof e!="object")return[];if(Array.isArray(e.issues))return e.issues.flatMap(o=>{if(!o||typeof o!="object")return[];let i=(Array.isArray(o.path)?o.path.join("."):"input")||"input";return typeof o.message=="string"?[`${i}: ${y(o.message,t)}`]:[]});let n=[];return ue(e,"",n,t),n}function ue(e,t,n,o){if(Array.isArray(e)){if(e.every(r=>r===null||typeof r!="object")){n.push(`${
|
|
121
|
-
`)}function w(e){a(JSON.stringify(e,null,2))}function kn(e){for(let t=0;t<e.length;t+=1){let n=e[t];if(!n.startsWith("--"))return n;
|
|
117
|
+
`)}let i=Ge({input:process.stdin,output:process.stderr,terminal:!0}),s=new AbortController,c=()=>s.abort();process.stdin.once("end",c),process.stdin.readableEnded&&s.abort();let d;try{try{d=(await i.question("Choose a number or Blueprint slug: ",{signal:s.signal})).trim()}catch(l){throw l?.name!=="AbortError"&&l?.code!=="ABORT_ERR"?l:new u("Start cancelled before a Blueprint was chosen.",{code:"start_cancelled"})}}finally{process.stdin.off("end",c),i.close()}let p=Number(d),m=Number.isInteger(p)?o[p-1]:o.find(({id:l})=>l===d);if(m)return m;throw new u(`No Blueprint matches ${JSON.stringify(d)}.`,{fix:"Run hyperscale start again and choose a listed number or slug."})}async function Ae(e,t){Ut(e);let n={};try{await Jt(e,t,n)}catch(o){throw typeof n.apiKey!="string"?o:Lt(o,n.apiKey)}}async function Jt(e,t,n){let o=await $(e,t),r=await v(o,o.token),i=await Ht(e,o),s=e["--name"]??i.name;e["--json"]||a(`Authenticated: ${r.email}`);let c=await X(o,"/v1/products/blueprint-compose",T({blueprintId:i.id,name:s,tenantId:o.tenantId}),o.token),d=ge(c.response,c.text,[o.token]);if(typeof d?.productId!="string"||!dt.test(d.productId)||typeof d?.productBuildId!="string"||d?.blueprintId!==i.id)throw new u("product.blueprint.compose returned an invalid start Product");let p=d?.shown_once;if(typeof p!="string"||p.length===0)throw new u("The composed Product did not return its one-time API key. Choose a new Product name and run hyperscale start again.",{code:"start_api_key_unavailable"});n.apiKey=p;let m=we(c.response);await z(t,{...o,selectedProduct:d.productId}),e["--json"]||(a(`Product: ${d.productId}`),a(`Blueprint: ${d.blueprintId}`),jt("Compose",m));let l=[`hyperscale compose plan product.hsx --product ${d.productId}`],f="Composition completed. Run SDK journeys against your Product.",k={blueprintId:d.blueprintId,composeOnly:!0,nextCommands:l,notice:f,productBuildId:d.productBuildId,productId:d.productId,receipts:[{stage:"product.blueprint.compose",...m}],...typeof d.startKeyId=="string"?{startKeyId:d.startKeyId}:{},shown_once:p};if(e["--json"]){w(k);return}a(f),a(`Shown once Product API key: ${p}`),a("Next:");for(let g of l)a(` ${g}`);a(" Run journeys with the Hyperscale SDK using the Product API key above.")}async function Kt(e,t){let n=e["--blueprint"],o=e["--name"];if(!n)throw new u("product create needs --blueprint <id>");if(!o)throw new u("product create needs --name <name>");let r=await $(e,t),i;try{i=await C(r,"/v1/products",{tenantId:r.tenantId},"product.list",r.token,[r.token])}catch(l){if(!(l instanceof O)||l.status!==403)throw l}let s=o.trim().toLocaleLowerCase("en-US"),c=(i?E(i,"product.list"):[]).find(l=>{let f=l?.displayName??l?.name;return typeof f=="string"&&f.trim().toLocaleLowerCase("en-US")===s});if(c){let l=c.productId??c.id??"<id>";throw new u(`A Product named ${JSON.stringify(o.trim())} already exists as ${l}.`,{code:"duplicate_product_name",fix:`Use "hyperscale product select ${l}" or choose another --name.`})}let d=await P(r,"/v1/products/blueprint-compose",T({blueprintId:n,name:o,tenantId:r.tenantId}),r.token,[r.token]);if(typeof d?.productId!="string"||typeof d?.blueprintId!="string"||typeof d?.productBuildId!="string")throw new u("product.blueprint.compose returned an invalid Product");await z(t,{...r,selectedProduct:d.productId});let p=typeof d?.shown_once=="string"&&d.shown_once.length>0?d.shown_once:void 0,m={blueprintId:d.blueprintId,nextSteps:[`hyperscale product show ${d.productId}`,...p?[]:['hyperscale key create --name "Founder CLI"']],productBuildId:d.productBuildId,productId:d.productId,selectedProduct:d.productId,...typeof d.startKeyId=="string"?{startKeyId:d.startKeyId}:{},...p?{shown_once:p}:{}};if(e["--json"]){w(m);return}a(`Product: ${m.productId}`),a(`Blueprint: ${m.blueprintId}`),a(`Build: ${m.productBuildId}`),a(`Selected: ${m.selectedProduct}`),m.shown_once&&a(`Shown once Product API key: ${m.shown_once}`),a("Next:");for(let l of m.nextSteps)a(` ${l}`)}function He(e){return new URLSearchParams({tenantId:e}).toString()}async function Bt(e,t){let n=await $(e,t),o=await C(n,"/v1/products",{tenantId:n.tenantId},"product.list",n.token,[n.token]),r=E(o,"product.list");if(e["--json"]){w(o);return}if(r.length===0){a('No Products yet. Run "hyperscale blueprint list", then "hyperscale product create --blueprint <id> --name <name>".');return}a("ID Name Status");for(let i of r){let s=i.productId??i.id??"unknown",c=i.displayName??i.name??"unnamed";a(`${s} ${c}${i.status?` ${i.status}`:""}`)}}async function qt(e,t,n){let o=await $(e,t),r=n??o.selectedProduct;if(!r)throw new u("product show needs an id because no Product is selected. Create a Product first.");let i=await P(o,`/v1/products/${encodeURIComponent(r)}?${He(o.tenantId)}`,{},o.token,[o.token]);if(e["--json"]){w(i);return}Yt(i,r)}function Yt(e,t){let n=e?.displayName??e?.name??"unnamed",o=e?.status??"unknown",r=e?.blueprint,i=r?.id?`${r.name??r.id}${r.name?` (${r.id})`:""}`:"custom composition",s=e?.cost?.currency??"SAR",c=e?.pricing?.current?.monthlySar??e?.cost?.platformMonthlySar,d=e?.pricing?.current?.setupSar??e?.cost?.platformSetupSar,p=[...Array.isArray(e?.readiness?.outstandingLiveRequirements)?e.readiness.outstandingLiveRequirements:[],...Array.isArray(e?.readiness?.liveUnavailableCapabilities)?e.readiness.liveUnavailableCapabilities.map(m=>`unavailable:${m}`):[],...Array.isArray(e?.cost?.blockers)?e.cost.blockers.map(m=>m?.code??"pricing"):[]];a(`Name: ${n}`),a(`Product: ${e?.productId??t}`),a(`Status: ${o}`),a(`Blueprint: ${i}`),e?.pricing?.scheduled?(a(`Current billing price: ${s} ${e.pricing.current.monthlySar}/mo`),a(`Accepted price from ${e.pricing.scheduled.effectiveAt}: ${s} ${e.pricing.scheduled.monthlySar}/mo`)):a(`Monthly: ${c==null?"not returned":`${s} ${c}`}`),a(`Setup: ${d==null?"not returned":`${s} ${d}`}`),a(`Live: ${e?.readiness?.live===!0?"active":"not active"}`),a(`Live blockers: ${p.length>0?p.join(", "):"none"}`);for(let[m,l]of[["openapi","OpenAPI"],["mcp","MCP"],["sdk","SDK"],["graphql","GraphQL"]]){let f=e?.surfaces?.[m];f?.url&&a(`${l}: ${f.url}`)}a("Next:"),a(` hyperscale key create --name "Founder CLI" --product ${e?.productId??t}`)}async function Ft(e,t,n){if(!n)throw new u("product select needs a Product id");let o=await $(e,t),r=await P(o,`/v1/products/${encodeURIComponent(n)}?${He(o.tenantId)}`,{},o.token,[o.token]);if(r?.productId!==n)throw new u("product.retrieve returned the wrong Product");await z(t,{...o,selectedProduct:n});let i={productId:n,selected:!0};e["--json"]?w(i):a(`Selected Product: ${r.displayName??n} (${n})`)}function Mt(e){return e.map(t=>`${t.path}: error [composer] ${t.code}: ${t.message}`)}async function Vt(e){if(!e)throw new u("compose needs a .hsx file");if(!e.endsWith(".hsx"))throw new u(`compose reads a .hsx file, got ${e}`);let t;try{t=await D(e,"utf8")}catch(n){throw new u(`Could not read ${e}: ${n.message}`)}return{file:e,source:t}}function Wt(e){if(!e||typeof e!="object"||typeof e.ok!="boolean"||!Array.isArray(e.issues))throw new u("composer.check returned an invalid result");return{issues:e.issues.map(n=>{if(!n||typeof n!="object"||typeof n.code!="string"||typeof n.message!="string"||typeof n.path!="string")throw new u("composer.check returned an invalid issue");return{code:n.code,message:n.message,path:n.path}}),ok:e.ok}}async function Ie(e,t,n,o="none"){let r=await Vt(n),i=await $(e,t),s=o==="required"?J(i,e):o==="optional"?Ke(i,e):void 0,c=await X(i,"/v1/composer/check",T({tenantId:i.tenantId,document:r.source,...e["--catalog-revision"]?{catalogRevisionId:e["--catalog-revision"]}:{}}),i.token),d=we(c.response,[i.token]),p=Wt(ge(c.response,c.text,[i.token]));if(!p.ok)throw new K(["composer.check refused the program.",...Mt(p.issues)].join(`
|
|
118
|
+
`),{file:n,issues:p.issues,...d});return{check:p,receipt:d,context:i,productId:s,program:r,catalogRevisionId:e["--catalog-revision"]}}async function zt(e,t,n){let o=await Ie(e,t,n,"none");if(e["--json"]){w({command:"composer.check",file:n,issues:o.check.issues,ok:!0,...o.receipt});return}a(`Check passed: ${n}`)}async function Je(e,t){let n=await X(e.context,"/v1/composer/plan",T({document:e.program.source,tenantId:e.context.tenantId,...e.productId?{productId:e.productId}:{},...e.catalogRevisionId?{catalogRevisionId:e.catalogRevisionId}:{}}),e.context.token),o=ge(n.response,n.text,[e.context.token]),r=we(n.response,[e.context.token]);if(!o||typeof o!="object"||typeof o.summary!="string"||!Array.isArray(o.actions)||!o.pricing||typeof o.pricing!="object")throw new u("composer.plan returned an invalid result");let i=o.actions.filter(s=>!s||typeof s!="object"||s.kind!=="configure_product");if(i.length>0)throw new K([o.summary,...i.map(s=>s&&typeof s=="object"?`${s.kind??"unknown"} ${s.target??"unknown"} ${s.detail??"Composer refused this action."}`:"unknown unknown Composer returned an invalid refusal action.")].join(`
|
|
119
|
+
`),{actions:i,file:t,...r,...e.productId?{productId:e.productId}:{}});return{...o,...r}}async function Gt(e,t,n){let o=await Ie(e,t,n,"optional"),r=await Je(o,n);if(e["--json"]){w({command:"composer.plan",file:n,check:{...o.check,...o.receipt},plan:r,...o.productId?{productId:o.productId}:{}});return}a(r.summary);for(let i of r.actions)a(`${i.kind} ${i.target} ${i.detail}`);r.pricing?.scheduled?(a(`Current billing price: SAR ${r.pricing.current.monthlySar}/mo`),a(`Candidate price from ${r.pricing.scheduled.effectiveAt}: SAR ${r.pricing.scheduled.monthlySar}/mo`),a(`Pricing identity: ${r.pricing.scheduled.pricingIdentity}`)):(a(`Monthly: SAR ${r.pricing.monthlySar}`),a(`Activation: SAR ${r.pricing.activationSar}`))}async function Xt(e,t,n){if(!e["--confirm"]&&!e["--yes"])throw new u("compose apply changes the selected Product. Pass --confirm, or --yes for an agent.");let o=e["--pricing-identity"];if(!o&&e["--plan-file"]){let c=e["--plan-file"];try{let d=await D(c,"utf8"),p=JSON.parse(d);o=p.plan?.pricing?.scheduled?.pricingIdentity??p.pricing?.scheduled?.pricingIdentity??p.pricingIdentity}catch(d){throw new u(`Failed to read saved plan file ${c}: ${d.message}`)}}let r=await Ie(e,t,n,"required"),i=await Je(r,n);if(i.pricing?.scheduled&&!o){if(!e["--yes"])throw new u(`compose apply --confirm requires --pricing-identity (or --plan-file). Run "hyperscale compose plan ${n}" to review candidate pricing and copy the pricing identity, or pass --yes to accept the current candidate.`);o=i.pricing.scheduled.pricingIdentity}let s=await P(r.context,"/v1/products/recompose",T({program:{source:r.program.source},...r.catalogRevisionId?{catalogRevisionId:r.catalogRevisionId}:{},...o?{pricingIdentity:o}:{},tenantId:r.context.tenantId,productId:r.productId},e["--idempotency-key"]),r.context.token,[r.context.token]);if(!s||typeof s.productBuildId!="string")throw new u("product.recompose returned no new build identity");if(e["--json"]){w({command:"product.recompose",file:n,output:s});return}a(`Product: ${s.productId??r.productId}`),a(`Build: ${s.productBuildId}`),s.buildDigest&&a(`Digest: ${s.buildDigest}`),s.pricing?.scheduled&&(a(`Current billing price: SAR ${s.pricing.current.monthlySar}/mo`),a(`Accepted price from ${s.pricing.scheduled.effectiveAt}: SAR ${s.pricing.scheduled.monthlySar}/mo`))}function Ke(e,t){let n=t["--product"]??e.selectedProduct;return typeof n=="string"&&n.length>0?n:void 0}function J(e,t){let n=Ke(e,t);if(!n)throw new u("No Product selected. Pass --product <id> or create a Product first.");return n}async function Y(e,t){let n=await W(t),o=J(n??{},e),r=L(e,t,n??{});if(n&&(r.baseUrl!==n.baseUrl||r.environment!==n.environment))throw new u(`The selected Product belongs to ${n.baseUrl} (${n.environment}). Select a Product at the configured API origin first.`);let i=e["--api-key"]??t.HYPERSCALE_API_KEY;if(!i)throw ve(o);return{...r,apiKey:i,productId:o}}async function Be(e,t){let n=`/v1/products/${encodeURIComponent(e.productId)}/operation-set`,{response:o,text:r}=await Q(e,n,{},t);if(!o.ok)throw Ye(o,r,[e.apiKey],{productId:e.productId});return en(r,o.status)}async function Qt(e,t,n){let o=await Y(e,t),r=await Be(o);if(n){Zt(r,n,e);return}if(e["--json"]){w(r);return}if(r.publicActions.length===0)a("No public actions");else{a("Operation ID Input Kind");for(let i of r.publicActions){let s=i.idempotencyPolicy?.mode==="not_required"?"read-only":"mutation";a(`${i.instrument}.${i.name} ${on(i.inputSchema)} ${s}`)}}if(r.setupOperations.length>0){a("Setup operations (run with hyperscale call)");for(let i of r.setupOperations)a(i.operationName)}if(r.readOperationIds.length>0){a("Reads (run with hyperscale call)");for(let i of r.readOperationIds)a(nn(i))}a(`Digest: ${r.tenantOperationSetDigest}`),a(`Setup digest: ${r.tenantSetupOperationSetDigest}`),a(`Read digest: ${r.tenantReadOperationSetDigest}`),a(`Build: ${r.productBuildId}`),a(`Surface version: ${r.tenantSurfaceVersion}`)}function Zt(e,t,n){let o=e.publicActions.find(c=>c&&`${c.instrument}.${c.name}`===t),r=tn(t),i=e.setupOperations.find(c=>c&&(c.operationId===t||c.operationId===r||c.operationName===t));if(i){let{inputSchema:c,operationId:d,operationName:p}=i,m={status:e.status,productBuildId:e.productBuildId,tenantSurfaceVersion:e.tenantSurfaceVersion,tenantSetupOperationSetDigest:e.tenantSetupOperationSetDigest,setupOperationId:d,operationName:p,command:`hyperscale call ${p}`,inputSchema:c};if(n["--json"]){w(m);return}a(`Operation ID: ${d}`),a(`Operation name: ${p}`),a(`Run: hyperscale call ${p}`),a(`Input schema: ${JSON.stringify(c,null,2)}`),(!Array.isArray(c.required)||c.required.length===0)&&a("Input: omit --input or pass {}."),a(`Setup digest: ${e.tenantSetupOperationSetDigest}`),a(`Build: ${e.productBuildId}`),a(`Surface version: ${e.tenantSurfaceVersion}`);return}if(!o)throw new u(`Unknown frozen public action: ${t}. Run "hyperscale product actions" to list exact names.`);let s={status:e.status,productBuildId:e.productBuildId,tenantSurfaceVersion:e.tenantSurfaceVersion,tenantOperationSetDigest:e.tenantOperationSetDigest,publicAction:o};if(n["--json"]){w(s);return}a(`Operation ID: ${o.instrument}.${o.name}`),a(`Instrument: ${o.instrument}`),a(`Input schema: ${JSON.stringify(o.inputSchema,null,2)}`),a(`Output schema: ${JSON.stringify(o.outputSchema,null,2)}`),a(`Actor policy: ${JSON.stringify(o.actorPolicy,null,2)}`),a(`Port policy: ${JSON.stringify(o.portPolicy,null,2)}`),a(`Idempotency policy: ${JSON.stringify(o.idempotencyPolicy,null,2)}`),a(`Receipt policy: ${JSON.stringify(o.receiptPolicy,null,2)}`),a(`Receipt evidence: ${JSON.stringify(o.receiptEvidence,null,2)}`),a(`Digest: ${e.tenantOperationSetDigest}`),a(`Build: ${e.productBuildId}`),a(`Surface version: ${e.tenantSurfaceVersion}`)}function en(e,t){let n;try{n=JSON.parse(e)}catch{throw new u(`HTTP ${t} returned invalid JSON`)}if(!n||typeof n!="object"||n.status!=="frozen"||typeof n.productBuildId!="string"||typeof n.tenantSurfaceVersion!="number"||typeof n.tenantOperationSetDigest!="string"||typeof n.tenantReadOperationSetDigest!="string"||typeof n.tenantSetupOperationSetDigest!="string"||!Array.isArray(n.publicActions)||!Array.isArray(n.readOperationIds)||!Array.isArray(n.setupOperationIds)||!Array.isArray(n.setupOperations))throw new u("The Product operation set is not in the expected format. Upgrade the CLI.");return n}function tn(e){return e.replaceAll(".","_")}function nn(e){for(let t of["create","list","retrieve"]){let n=`_${t}`;if(e.endsWith(n))return`${e.slice(0,-n.length)}.${t}`}return e}function on(e){if(!e||typeof e!="object")return"input schema unavailable";let t=e.properties&&typeof e.properties=="object"&&!Array.isArray(e.properties)?e.properties:{},n=new Set(Array.isArray(e.required)?e.required.filter(r=>typeof r=="string"):[]),o=Object.entries(t).map(([r,i])=>`${r}${n.has(r)?"":"?"}: ${qe(i)}`);return o.length===0?"no input":o.join(", ")}function qe(e){return!e||typeof e!="object"?"value":Array.isArray(e.enum)&&e.enum.length>0?e.enum.map(t=>String(t)).join(" | "):e.type==="array"?`${qe(e.items)}[]`:typeof e.type=="string"?typeof e.format=="string"?`${e.type} (${e.format})`:e.type:"value"}async function rn(e,t,n){if(!n)throw new u("product run needs a public action");let o=await Y(e,t),r=await Be(o,n);an(r,n);let i=await Fe(e),s=e["--idempotency-key"]??globalThis.crypto.randomUUID(),{response:c,text:d}=await Q(o,`/v1/operations/${encodeURIComponent(n)}`,{body:JSON.stringify(i),headers:{"content-type":"application/json","idempotency-key":s},method:"POST"},n);if(!c.ok)throw Ye(c,d,[o.apiKey],{action:n,productId:o.productId});let p=c.headers.get("hyperscale-operation-id"),m=c.headers.get("hyperscale-receipt-id"),l=c.headers.get("x-request-id"),f=p?y(p,[o.apiKey]):null,k=m?y(m,[o.apiKey]):null,g=l?y(l,[o.apiKey]):null;if(e["--json"]){w({idempotencyKey:s,...g?{requestId:g}:{},operationId:f,receiptId:k,output:sn(d)});return}f&&a(`Operation: ${f}`),k&&a(`Receipt: ${k}`),a(`Idempotency key: ${s}`);let h=Me(d);h&&a(h)}function an(e,t){let n=e.publicActions.find(r=>r&&`${r.instrument}.${r.name}`===t);if(n)return n;let o=e.publicActions.map(r=>`${r.instrument}.${r.name}`).map(r=>({candidate:r,distance:de(t,r)})).sort((r,i)=>r.distance-i.distance||r.candidate.localeCompare(i.candidate)).slice(0,3).map(({candidate:r})=>r);throw new u(`Unknown frozen public action: ${t}. Closest valid names: ${o.join(", ")}. Run "hyperscale product actions" to list exact names.`)}function sn(e){if(e.trim()==="")return null;try{return JSON.parse(e)}catch{return e}}function Ye(e,t,n=[],o={}){let r=y(t.trim(),n),i;try{i=JSON.parse(t)}catch{return new u(`HTTP ${e.status}${r?` \xB7 ${r}`:""}`)}if(!i?.error||typeof i.error.message!="string")return new u(`HTTP ${e.status}`);let s=typeof i.error.code=="string"?i.error.code:"user_error",c=s==="user_error"?"":`${s}: `,d=i.error.message;if(typeof d=="string"&&d.includes("does not match API key Product")){let x=o.productId??d.match(/^Selected Product (\S+) does not match/)?.[1];x&&(d=`${d} Or set HYPERSCALE_API_KEY to a key for ${x}, or pass that key with --api-key.`)}let p=y(`HTTP ${e.status} \xB7 ${c}${d}`,n),m=cn(i.error.details,n),l;s==="idempotency_conflict"?l="Reuse the same key only with the same operation and input. Use a new unique key for a different request.":e.status===409&&typeof i.error.message=="string"&&i.error.message.includes("capability-derived")?l='This Product has no frozen public actions. List its operations with "hyperscale ops list" and run them with "hyperscale call".':[i.error.message,...m].some(x=>typeof x=="string"&&x.includes("[Truncated]"))&&o.action&&(l=`Run "hyperscale product actions ${o.action}" to read the full input schema and allowed values.`);let f=e.headers.get("x-request-id")??(i&&typeof i=="object"&&typeof i.requestId=="string"?i.requestId:void 0),k=e.headers.get("hyperscale-operation-id")??void 0,g=e.headers.get("hyperscale-receipt-id")??void 0,h=f?y(f,n):void 0,I=k?y(k,n):void 0,S=g?y(g,n):void 0,A=new u([p,...m].join(`
|
|
120
|
+
`),{code:s,...i.error.details?{details:F(i.error.details,n)}:{},...l?{fix:l}:{}});return h&&(A.requestId=h),I&&(A.operationId=I),S&&(A.receiptId=S),A}function F(e,t){return typeof e=="string"?y(e,t):Array.isArray(e)?e.map(n=>F(n,t)):e&&typeof e=="object"?Object.fromEntries(Object.entries(e).map(([n,o])=>[y(n,t),F(o,t)])):e}function cn(e,t){if(!e||typeof e!="object")return[];if(Array.isArray(e.issues))return e.issues.flatMap(o=>{if(!o||typeof o!="object")return[];let i=(Array.isArray(o.path)?o.path.join("."):"input")||"input";return typeof o.message=="string"?[`${i}: ${y(o.message,t)}`]:[]});let n=[];return ue(e,"",n,t),n}function ue(e,t,n,o){if(Array.isArray(e)){if(e.every(r=>r===null||typeof r!="object")){n.push(`${Te(t)}: ${y(e.join(", "),o)}`);return}e.forEach((r,i)=>ue(r,`${t}[${i}]`,n,o));return}if(e&&typeof e=="object"){for(let[r,i]of Object.entries(e))ue(i,t?`${t}.${r}`:r,n,o);return}t&&n.push(`${Te(t)}: ${y(String(e),o)}`)}function Te(e){let t=e.replace(/([a-z0-9])([A-Z])/g,"$1 $2").replaceAll("."," ");return t.charAt(0).toUpperCase()+t.slice(1)}async function un(e,t){let n=await $(e,t),o=J(n,e),r=await P(n,"/v1/sandbox-api-keys",T({name:e["--name"]??"Founder CLI",tenantId:n.tenantId,productId:o}),n.token,[n.token]);if(e["--json"]){w(r);return}a(`Key: ${r.apiKeyId??"unknown"}`),a(`Product: ${r.productId??o}`),a(`Status: ${r.status??"unknown"}`),r.secret?(a(`Secret: ${r.secret}`),a("Store it now. Hyperscale will not return it again."),a("Next:"),a(` export HYPERSCALE_API_KEY=${dn(r.secret)}`),a(` hyperscale product actions --product ${o}`)):a("The key already existed, so the one-time secret is unavailable.")}function dn(e){return`'${String(e).replaceAll("'",`'"'"'`)}'`}async function pn(e,t){let n=await $(e,t),o=J(n,e),r=await C(n,"/v1/api-keys",{productId:o,tenantId:n.tenantId},"api_key.list",n.token,[n.token]),i=E(r,"api_key.list");if(e["--json"]){w(r);return}for(let s of i)a(`${s.apiKeyId} ${s.name??"unnamed"} ${s.status??"unknown"}`)}async function ln(e,t,n){if(!n)throw new u("key revoke needs an API key id");let o=await $(e,t),r=J(o,e),i=await P(o,`/v1/api-keys/${encodeURIComponent(n)}/revoke`,T({tenantId:o.tenantId,productId:r}),o.token,[o.token]);e["--json"]?w(i):a(`Key ${i.apiKeyId??n}: ${i.status??"revoked"}`)}async function mn(e,t){let n=await $(e,t),o=n.identity??await v(n,n.token),r=ye(n,o);if(e["--json"]){w(r);return}a(`User: ${o.email}`),a(`Tenant: ${o.tenantId}`),a(`Role: ${o.role}`),a(`Token: ${o.name}`),a(`Expires: ${o.expiresAt}`)}async function fn(e,t,n){let o=await Ue(e),r=n?n.toLowerCase():null,i=r?o.operations.filter(c=>c.name.toLowerCase().includes(r)||c.path.toLowerCase().includes(r)):o.operations;if(t["--json"]){a(JSON.stringify(i,null,2));return}if(i.length===0){a(n?`No operation matches ${n}`:"No operations");return}let s=Math.max(...i.map(c=>c.name.length));for(let c of i)a(`${c.name.padEnd(s)} ${c.method.padEnd(6)}${c.path}`)}async function hn(e,t){let n=await $(e,t),o=await C(n,"/v1/activity",{tenantId:n.tenantId},"activity.list",n.token,[n.token]),r=E(o,"activity.list");if(e["--json"]){w(o);return}a("Time Activity Target Status");for(let i of r){let s=i.operation??i.auditEvent??"activity",c=i.resourceKind&&i.resourceId?`${i.resourceKind}:${i.resourceId}`:i.resourceKind??i.resourceId??"-";a(`${i.occurredAt??"unknown"} ${s} ${c} ${i.status??"recorded"}`)}}function yn(e,t){let n={...t},o=[],r=e.path.replace(/\{([^}]+)\}/g,(i,s)=>{let c=n[s];return c==null?(o.push(s),""):(delete n[s],encodeURIComponent(String(c)))});if(o.length>0)throw new u(`${e.name} needs ${o.join(", ")} in --input`);return{path:r,remaining:n}}function wn(e){let t=new URLSearchParams;for(let[o,r]of Object.entries(e))r!=null&&t.set(o,typeof r=="string"?r:JSON.stringify(r));let n=t.toString();return n?`?${n}`:""}function de(e,t){let n=Array.from({length:t.length+1},(o,r)=>r);for(let o=1;o<=e.length;o+=1){let r=[o];for(let i=1;i<=t.length;i+=1)r[i]=Math.min(r[i-1]+1,n[i]+1,n[i-1]+(e[o-1]===t[i-1]?0:1));n.splice(0,n.length,...r)}return n[t.length]}function gn(e,t){let n=e.find(i=>i.name===t);if(n)return n;let o=e.filter(i=>i.operationId===t);if(o.length===1)return o[0];if(o.length>1)throw new u(`${t} matches more than one operation. Use one of: ${o.map(i=>i.name).join(", ")}.`);let r=e.map(i=>({candidate:i,distance:Math.min(de(t,i.name),de(t,i.operationId))})).sort((i,s)=>i.distance-s.distance||i.candidate.name.localeCompare(s.candidate.name)).slice(0,3).flatMap(({candidate:i})=>[i.name,i.operationId]);throw new u(`${t} is not an operation in the selected Product's machine document. Closest valid names: ${r.join(", ")}.`)}async function In(e,t,n){if(!n)throw new u("call needs an operation name");let o=await Ue(e),r=gn(o.operations,n),i=await Fe(t),{path:s,remaining:c}=yn(r,i),d={method:r.method},p=s;r.method==="GET"?p+=wn(c):(d.body=JSON.stringify(c),d.headers={"content-type":"application/json",...r.idempotency==="not_required"?{}:{"idempotency-key":t["--idempotency-key"]??globalThis.crypto.randomUUID()}});let{response:m,text:l}=await Q(e,p,d);if(m.ok){if(t["--json"]){let f=$t(l),k=m.headers.get("x-request-id")??(f&&typeof f=="object"&&typeof f.requestId=="string"?f.requestId:null),g=m.headers.get("hyperscale-operation-id")??null,h=m.headers.get("hyperscale-receipt-id")??null,I=De(m.headers),S=k?y(k,[e.apiKey]):null,A=g?y(g,[e.apiKey]):null,x=h?y(h,[e.apiKey]):null,Ve=I?y(I,[e.apiKey]):null;w({status:m.status,data:f,requestId:S,operationId:A,receiptId:x,traceId:Ve});return}a(Me(l));return}throw Z(m,l,[e.apiKey])}async function Fe(e){if(e["--input"]!==void 0&&e["--input-file"]!==void 0)throw new u("Use only one of --input and --input-file");if(e["--input"]!==void 0)return oe(e["--input"],"--input");if(e["--input-file"]!==void 0){let t;try{t=await D(e["--input-file"],"utf8")}catch(n){throw new u(`Could not read ${e["--input-file"]}: ${n.message}`)}return oe(t,"--input-file")}if(!process.stdin.isTTY){let t=await It();if(t.trim()!=="")return oe(t,"stdin")}return{}}function oe(e,t="--input"){if(e===void 0)return{};let n;try{n=JSON.parse(e)}catch(o){throw new u(`${t} is not valid JSON: ${o.message}`)}if(n===null||typeof n!="object"||Array.isArray(n))throw new u(`${t} must be a JSON object`);return n}function Me(e){if(e.trim()==="")return"";try{return JSON.stringify(JSON.parse(e),null,2)}catch{return e}}function a(e){process.stdout.write(`${e}
|
|
121
|
+
`)}function w(e){a(JSON.stringify(e,null,2))}function kn(e){for(let t=0;t<e.length;t+=1){let n=e[t];if(!n.startsWith("--"))return n;Ee.has(n)&&(t+=1)}}function $n(e,t){let n=kn(t)==="call",o=t.includes("--json");if(n&&o&&e instanceof O){w({status:e.status,error:e.structuredError??{code:e.code??"http_error",message:e.message},requestId:e.requestId??null,operationId:e.operationId??null,receiptId:e.receiptId??null,traceId:e.traceId??null});let c=typeof e.message=="string"?e.message:e.stack??String(e);process.stderr.write(`${c}
|
|
122
122
|
`);return}let r=e instanceof u&&typeof e.shownOnce=="string"?e.shownOnce:void 0;if(!o){let c=e instanceof u?e.message:e.stack??String(e),d=e instanceof u&&typeof e.fix=="string"?`
|
|
123
123
|
Fix: ${e.fix}`:"",p=r?`
|
|
124
124
|
Shown once Product API key: ${r}`:"";process.stderr.write(`${c}${d}${p}
|
|
125
125
|
`);return}let i=e instanceof u,s=i&&typeof e.code=="string"?e.code:i?"user_error":"internal_error";process.stderr.write(`${JSON.stringify({error:{code:s,message:i?e.message:"The command failed unexpectedly.",...i&&e.details?{details:e.details}:{},fix:i?e.fix??'Follow the message, or run "hyperscale --help" for command usage.':"Report the failure without including credentials."},...r?{shown_once:r}:{}})}
|
|
126
|
-
`)}async function Pn(){let{readFileSync:e}=await import("node:fs");return JSON.parse(e(new URL("./package.json",import.meta.url),"utf8")).version}async function bn(e,t){let{flags:n,positional:o}=mt(e);if(n["--version"])return a(await Pn()),0;if(n["--help"]&&o.length>0)return process.stdout.write(lt(o)),0;if(o.length===0&&!n["--help"]){if(n["--json"])throw new u('No command. Run "hyperscale --help" to list commands.');return process.stdin.isTTY&&process.stderr.isTTY?(await Ae(n,t),0):(a('Build your first Product with "hyperscale start".'),a('Run "hyperscale --help" for every command.'),0)}if(n["--help"])return process.stdout.write(pt),0;let[r,...i]=o;if(r==="start")return await Ae(n,t),0;if(r==="auth"){if(i[0]==="login")await
|
|
126
|
+
`)}async function Pn(){let{readFileSync:e}=await import("node:fs");return JSON.parse(e(new URL("./package.json",import.meta.url),"utf8")).version}async function bn(e,t){let{flags:n,positional:o}=mt(e);if(n["--version"])return a(await Pn()),0;if(n["--help"]&&o.length>0)return process.stdout.write(lt(o)),0;if(o.length===0&&!n["--help"]){if(n["--json"])throw new u('No command. Run "hyperscale --help" to list commands.');return process.stdin.isTTY&&process.stderr.isTTY?(await Ae(n,t),0):(a('Build your first Product with "hyperscale start".'),a('Run "hyperscale --help" for every command.'),0)}if(n["--help"])return process.stdout.write(pt),0;let[r,...i]=o;if(r==="start")return await Ae(n,t),0;if(r==="auth"){if(i[0]==="login")await xt(n,t);else if(i[0]==="status")await vt(n,t);else if(i[0]==="logout")await Et(n,t);else throw new u('Auth subcommands are "login", "status", and "logout"');return 0}if(r==="blueprint"){let s=L(n,t);if(i[0]==="list")await Ct(s,n);else if(i[0]==="show")await Rt(s,n,i[1]);else throw new u('Blueprint subcommands are "list" and "show"');return 0}if(r==="product"){if(i[0]==="create")await Kt(n,t);else if(i[0]==="list")await Bt(n,t);else if(i[0]==="show")await qt(n,t,i[1]);else if(i[0]==="select")await Ft(n,t,i[1]);else if(i[0]==="actions")await Qt(n,t,i[1]);else if(i[0]==="run")await rn(n,t,i[1]);else throw new u('Product subcommands are "create", "list", "show", "select", "actions", and "run"');return 0}if(r==="compose"){if(i[0]==="check")await zt(n,t,i[1]);else if(i[0]==="plan")await Gt(n,t,i[1]);else if(i[0]==="apply")await Xt(n,t,i[1]);else throw new u('Compose subcommands are "check", "plan", and "apply"');return 0}if(r==="key"){if(i[0]==="create")await un(n,t);else if(i[0]==="list")await pn(n,t);else if(i[0]==="revoke")await ln(n,t,i[1]);else throw new u('Key subcommands are "create", "list", and "revoke"');return 0}if(r==="whoami")return await mn(n,t),0;if(r==="activity"){if(i[0]!=="list")throw new u('The only activity subcommand is "list"');return await hn(n,t),0}if(r==="ops"){if(i[0]!=="list")throw new u('The only ops subcommand is "list"');let s=n["--product"]?await Y(n,t):$e(n,t);return await fn(s,n,i[1]),0}if(r==="call"){let s=n["--product"]?await Y(n,t):$e(n,t);return await In(s,n,i[0]),0}throw new u(`Unknown command: ${r}`)}bn(process.argv.slice(2),process.env).then(e=>{process.exitCode=e},e=>{$n(e,process.argv.slice(2)),process.exitCode=e instanceof u&&Number.isInteger(e.exitCode)?e.exitCode:1});
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@hyperscale0/cli",
|
|
3
|
-
"version": "1.0.0-beta.
|
|
3
|
+
"version": "1.0.0-beta.19",
|
|
4
4
|
"description": "Hyperscale CLI: compose Products, manage keys, and call Product operations.",
|
|
5
5
|
"license": "LicenseRef-Hyperscale-Proprietary",
|
|
6
6
|
"author": "Hyperscale LLC",
|
|
@@ -20,5 +20,5 @@
|
|
|
20
20
|
"publishConfig": {
|
|
21
21
|
"access": "public"
|
|
22
22
|
},
|
|
23
|
-
"gitHead": "
|
|
23
|
+
"gitHead": "79a5770ec7262d1502edc3f3782783f05a6fddd5"
|
|
24
24
|
}
|