@rex0220/kintone-sql-tools 3.47.0 → 3.48.0

package/dist-engine/index.cjs

@@ -12,4 +12,4 @@ WHERE \u3092 AND \u306E\u5B89\u5168\u306A KLIKE \u6761\u4EF6\u3078\u66F8\u304D\u
 `));return typeof n.code=="string"&&n.code!==""&&(i.name=n.code),typeof n.code=="string"&&Object.assign(i,{code:n.code}),typeof n.status=="number"&&Object.assign(i,{status:n.status}),Object.assign(i,{cause:e}),i}async function pT(e){try{let t=await e.json();if(t!==null&&typeof t=="object"){let r=t;return hi({code:r.code,message:r.message,errors:r.errors,status:e.status})}let n=new Error(`kintone API error: HTTP ${e.status}`);return Object.assign(n,{status:e.status,cause:t}),hi(n)}catch(t){let n=new Error(`kintone API error: HTTP ${e.status} \u306E\u5FDC\u7B54\u3092 JSON \u3068\u3057\u3066\u89E3\u6790\u3067\u304D\u307E\u305B\u3093`);return Object.assign(n,{status:e.status,cause:t}),hi(n)}}function dT(e){let t=e;return t?.code==="GAIA_CN01"&&(t.status===404||t.status===void 0)}async function dn(e,t,n){try{return await kintone.api(Iu(e),t,n)}catch(r){throw hi(r)}}function fT(e){if(!Number.isSafeInteger(e)||e<1||e>5)throw new Error("ArgumentError: cursorMaxActive must be an integer from 1 to 5.")}function CE(e={}){let t=e.cursorMaxActive??uT;fT(t);let n=null,r=null,i=new Set;return{async getRecords(a){try{let s=cT(a),l=await fetch(s.url,s.init);if(!l.ok)throw await pT(l);let d=await l.json();return PE(l.headers.get("X-Cybozu-Warning"))?{...d,searchAborted:!0}:d}catch(s){throw hi(s)}},async openCursor(a){let s=Iu(Pa),l=new URL(s,globalThis.location?.href).host.toLowerCase();if(r!==null&&r!==l)throw new Error(`CursorRouteError: factory route changed from ${r} to ${l}.`);if(r=l,n??=new wa(l,{maxActive:t}),n.snapshot().active>=t){let R=new Error(`CursorCapacityError: host=${l} \u306E active cursor \u4E0A\u9650 ${t} \u306B\u9054\u3057\u3066\u3044\u307E\u3059\u3002`);throw R.name="CursorCapacityError",R}let d=await n.acquire(),c;try{c=await n.runCreate(()=>dn(Pa,"POST",{app:a.app,query:a.query,size:a.size,fields:a.fields&&a.fields.length>0?a.fields:void 0}))}catch(R){throw typeof R?.code=="string"?(d.release(),R):(d.quarantine(),new Do(R))}let u=c.id,p=TE(Number(c.totalCount),{get:()=>dn(Pa,"GET",{id:u}),delete:()=>dn(Pa,"DELETE",{id:u}),isAlreadyReleasedError:dT,onReleased:()=>d.release(),onReleaseUnknown:()=>d.quarantine()}),f=null,E={totalCount:p.totalCount,async nextPage(){let R=await p.nextPage();return R.next||i.delete(E),R},close(){return f||(f=p.close().finally(()=>{i.delete(E)}),f)}};return i.add(E),E},async getApps(){let s=[],l=0;for(;;){let d=await dn("/k/v1/apps.json","GET",{limit:100,offset:l});for(let c of d.apps)s.push({appId:Number(c.appId),name:c.name,description:c.description});if(d.apps.length<100)break;l+=100}return s},async getFields(a){let s=await dn("/k/v1/app/form/fields.json","GET",{app:a});return IE(s.properties)},async getNumberPrecision(a){let s=await dn("/k/v1/app/settings.json","GET",{app:a});return Tp(s)},async getProcessStatuses(a){let s=await dn("/k/v1/app/status.json","GET",{app:a,lang:"user"});return{enable:s.enable,states:bE(s.states)}}}}var OE=new Set(["postRecords","putRecords","deleteRecords"]),Ai=class extends Error{constructor(t){let n=t instanceof Error?t.message:String(t);super(n),this.name="ClientOperationError",this.cause=t,Object.setPrototypeOf(this,new.target.prototype)}};async function xt(e){try{return await e()}catch(t){throw new Ai(t)}}function ET(e){return()=>{throw $e(`${String(e)} is blocked by the readonly client`)}}function Jn(e){let t=e.getRecords.bind(e),n=e.openCursor.bind(e),r=e.getApps.bind(e),i=e.getFields.bind(e),o=e.getNumberPrecision.bind(e),a=e.getProcessStatuses.bind(e),s=Object.assign(Object.create(null),{getRecords:async l=>{let d=await xt(()=>t(l));if(d.searchAborted===!0)throw SE();return d},openCursor:async l=>{let d=await xt(()=>n(l)),c=d.nextPage.bind(d),u=d.close.bind(d);return{totalCount:d.totalCount,nextPage:()=>xt(()=>c()),close:()=>xt(()=>u())}},getApps:()=>xt(()=>r()),getFields:l=>xt(()=>i(l)),getNumberPrecision:l=>xt(()=>o(l)),getProcessStatuses:l=>xt(()=>a(l))});return new Proxy(s,{get(l,d,c){return OE.has(d)?ET(d):Reflect.get(l,d,c)},has(l,d){return OE.has(d)?!1:Reflect.has(l,d)}})}function RT(e){let t=new Set,n=null;return{client:{getRecords:e.getRecords.bind(e),async openCursor(i){let o=await e.openCursor.call(e,i),a=null,s={totalCount:o.totalCount,nextPage:o.nextPage.bind(o),close(){return a||(a=Promise.resolve().then(()=>o.close()).finally(()=>{t.delete(s)}),a)}};return t.add(s),s},getApps:e.getApps.bind(e),getFields:e.getFields.bind(e),getNumberPrecision:e.getNumberPrecision.bind(e),getProcessStatuses:e.getProcessStatuses.bind(e)},close(){return n||(n=(async()=>{let o=(await Promise.allSettled([...t].map(a=>a.close()))).find(a=>a.status==="rejected");if(o)throw new Ai(o.reason)})(),n)}}}async function Qn(e,t){let n=RT(e),r=!1;try{return await t(n.client)}catch(i){throw r=!0,i}finally{try{await n.close()}catch(i){if(!r)throw i}}}var gT="A-Za-z",yT="\\u3040-\\u30FF\\u3400-\\u9FFF\\uF900-\\uFAFF\\uFF01-\\uFF60",bu=`${gT}${yT}`,_E=`${bu}0-9_`,mT=new RegExp(`^[${bu}]$`,"u"),hT=new RegExp(`^[${_E}]$`,"u"),AT=new RegExp(`^[${bu}][${_E}]{0,63}$`,"u");function ST(e){return mT.test(e)}function TT(e){return hT.test(e)}function Pu(e){let t=e.normalize("NFC").toUpperCase();if(!AT.test(t))throw new Error(`ArgumentError: logical app name "${e}" is invalid; expected 1-64 UTF-16 units starting with an ASCII letter or supported Japanese character.`);return t}function wu(e){if(!e)return!1;let t=e.codePointAt(0);return t>=65&&t<=90||t>=97&&t<=122||t>=48&&t<=57||t===95||t===36||t>=12352&&t<=12543||t>=13312&&t<=40959||t>=63744&&t<=64255||t>=65281&&t<=65376}function IT(e){if(!e)return!1;let t=e.codePointAt(0);return t>=65&&t<=90||t>=97&&t<=122||t>=48&&t<=57||e==="_"||e==="-"||e==="."||e==="$"}function wT(e,t){let n=t>0?e[t-1]:"";if(wu(n))return null;let r,i,o,a,s,l;if(e.slice(t,t+5).toUpperCase()==="LAPP_"){if(r="logical",l=t+5,a=l,!ST(e[l]??""))return null;for(l++;l<e.length&&TT(e[l]);)l++;s=l;try{o=Pu(e.slice(a,s))}catch{return null}}else if(e.slice(t,t+3).toUpperCase()==="APP"){for(r="physical",l=t+3,a=l;l<e.length&&/[0-9]/.test(e[l]);)l++;if(s=l,s===a)return null;i=Number(e.slice(a,s))}else return null;if(e[l]==="$"){l++;let f=l;for(;l<e.length&&wu(e[l]);)l++;if(l===f)return null}let d=l,c=null;if(e[l]==="@"){l++;let f=l;for(;l<e.length&&IT(e[l]);)l++;if(l===f)return null;c=e.slice(f,l)}let u=l<e.length?e[l]:"";if(wu(u))return null;let p={profile:c,start:t,referenceValueStart:a,referenceValueEnd:s,appEnd:d,fullEnd:l};return r==="physical"?{...p,source:r,appId:i}:{...p,source:r,logicalName:o}}function Nu(e){let t=[],n=0;for(;n<e.length;){let r=e[n];if(r==="'"){for(n++;n<e.length;){if(e[n]==="'"){if(n++,n<e.length&&e[n]==="'"){n++;continue}break}n++}continue}if(r==="`"){for(n++;n<e.length&&e[n]!=="`";)n++;n<e.length&&n++;continue}if(r==="-"&&e[n+1]==="-"){for(n+=2;n<e.length&&e[n]!==`
 `;)n++;continue}if(r==="/"&&e[n+1]==="*"){for(n+=2;n<e.length;){if(e[n]==="*"&&e[n+1]==="/"){n+=2;break}n++}continue}let i=wT(e,n);if(!i){n++;continue}t.push(i),n=i.fullEnd}return t}function LE(e){let t=9e8;for(;e.has(t);)t++;return e.add(t),t}function DE(e,t="dev",n){let r=Nu(e),i=r.some(g=>g.profile!==null),o=new Map,a=g=>g??t;for(let g of r){if(g.source!=="physical")continue;let y=a(g.profile),m=o.get(g.appId);m||(m=new Set,o.set(g.appId,m)),m.add(y.toLowerCase())}let s=new Set(r.filter(g=>g.source==="physical").map(g=>g.appId)),l=new Map;for(let g of r){if(g.source!=="logical")continue;let y=a(g.profile).toLowerCase(),m=`logical:${g.logicalName}@${y}`;if(l.has(m))continue;if(!n)throw new Error(`ArgumentError: logical app LAPP_${g.logicalName}@${y} requires logicalApps configuration.`);let S=n.resolveLogicalApp(g.logicalName,y);l.set(m,S),s.add(S)}let d=new Map,c=new Map;for(let[g,y]of o.entries()){let m=[...y].sort();if(!(m.length<=1))for(let S of m){let A=LE(s);d.set(`physical:${g}@${S}`,A),c.set(A,{source:"physical",mappedAppId:A,appId:g,profile:S})}}let u=[],p=[],f=0,E=0,R=(g,y,m,S)=>{if(!g&&y===m)return;let A=f;u.push(g),f+=g.length,p.push({normalizedStart:A,normalizedEnd:f,sourceStart:y,sourceEnd:m,...S===void 0?{}:{bindingMappedAppId:S}})};for(let g of r){let y=a(g.profile).toLowerCase(),m;if(g.source==="physical")m={source:"physical",mappedAppId:d.get(`physical:${g.appId}@${y}`)??g.appId,appId:g.appId,profile:y};else{let I=`logical:${g.logicalName}@${y}`,w=d.get(I);w===void 0&&(w=LE(s),d.set(I,w)),m={source:"logical",logicalName:g.logicalName,mappedAppId:w,appId:l.get(I),profile:y}}c.set(m.mappedAppId,m),R(e.slice(E,g.start),E,g.start);let S=e.slice(g.referenceValueEnd,g.appEnd),A=g.source==="physical"?`${e.slice(g.start,g.referenceValueStart)}${m.mappedAppId}${S}`:`APP${m.mappedAppId}${S}`;R(A,g.start,g.fullEnd,m.mappedAppId),E=g.fullEnd}return R(e.slice(E),E,e.length),{normalizedSql:u.join(""),hasProfileSyntax:i,appBindingByMappedApp:c,rewriteSegments:p}}var vE=new Set(["client","logicalApps","maxRecords","fetchParallel","cursorMaxActive"]),UE=new Set([...vE,"onLimitReached"]),bT=new Set([...UE,"variables","tempTableMaxRows"]);function kE(e){if(e===null||typeof e!="object"||Array.isArray(e))throw new TypeError("options must be an object")}function Si(e,t){if(!Number.isSafeInteger(e)||e<=0)throw new RangeError(`${t} must be a positive safe integer`)}function ME(e){if(e===null||typeof e!="object")throw new TypeError("client is required");let t=e;for(let n of["getRecords","openCursor","getApps","getFields","getNumberPrecision","getProcessStatuses"])if(typeof t[n]!="function")throw new TypeError(`client.${n} must be a function`)}function PT(e){if(e===null||typeof e!="object"||Array.isArray(e))throw new TypeError("variables must be an object");for(let[t,n]of Object.entries(e))if(typeof n!="string")throw new TypeError(`variables.${t} must be a string`)}function FE(e){if(e===void 0)return;if(e===null||typeof e!="object"||Array.isArray(e))throw new TypeError("logicalApps must be an object");let t={};for(let[n,r]of Object.entries(e)){let i;try{i=Pu(n)}catch{throw new TypeError(`logicalApps key "${n}" is invalid`)}if(Object.prototype.hasOwnProperty.call(t,i))throw new TypeError(`logicalApps key "${n}" duplicates "${i}" after canonical normalization`);Si(r,`logicalApps.${n}`),t[i]=r}return t}function xE(e,t,n){for(let r of Reflect.ownKeys(e))if(typeof r!="string"||!t.has(r))throw new TypeError(`Unknown ${n} option: ${String(r)}`);if(e.maxRecords!==void 0&&Si(e.maxRecords,"maxRecords"),e.fetchParallel!==void 0&&Si(e.fetchParallel,"fetchParallel"),e.cursorMaxActive!==void 0&&(Si(e.cursorMaxActive,"cursorMaxActive"),e.cursorMaxActive>5))throw new RangeError("cursorMaxActive must be between 1 and 5");if(e.onLimitReached!==void 0&&e.onLimitReached!=="error"&&e.onLimitReached!=="truncate")throw new TypeError('onLimitReached must be "error" or "truncate"');return{...e.maxRecords!==void 0?{maxRecords:e.maxRecords}:{},...e.fetchParallel!==void 0?{fetchParallel:e.fetchParallel}:{},...e.cursorMaxActive!==void 0?{cursorMaxActive:e.cursorMaxActive}:{},...e.onLimitReached!==void 0?{onLimitReached:e.onLimitReached}:{}}}function Cu(e,t){kE(e);let n=t==="run"?UE:vE;ME(e.client);let r=xE(e,n,t==="run"?"runQuery":"explainQuery"),i=FE(e.logicalApps);return{client:e.client,...i===void 0?{}:{logicalApps:i},executeOptions:r}}function KE(e){kE(e),ME(e.client),e.variables!==void 0&&PT(e.variables),e.tempTableMaxRows!==void 0&&Si(e.tempTableMaxRows,"tempTableMaxRows");let t=xE(e,bT,"runBatch"),n=FE(e.logicalApps);return{client:e.client,...n===void 0?{}:{logicalApps:n},executeOptions:{...t,...e.variables!==void 0?{variables:e.variables}:{},...e.tempTableMaxRows!==void 0?{tempTableMaxRows:e.tempTableMaxRows}:{}}}}function Na(e,t,n={}){let r=n.logicalAppDisplay??"profile";if(typeof e=="string"){let i=e.match(/^(\s*target:\s*)APP(\d+) \((\d+)\)\s*$/);if(i&&i[2]===i[3]){let s=t.get(Number(i[2]));if(s){let l=s.source==="logical"?r==="physical"?`LAPP_${s.logicalName} -> APP${s.appId}`:`LAPP_${s.logicalName} -> APP${s.appId}@${s.profile}`:r==="physical"?`APP${s.appId}`:`APP${s.appId}@${s.profile}`;return`${i[1]}${l}`}}if(t.size===0)return e;let o=[...t.keys()].sort((s,l)=>String(l).length-String(s).length),a=new RegExp(`APP(${o.join("|")})(?!\\d)(\\s+AS\\s+[^\\s()]+)?(?:\\s+\\(\\1\\))?`,"g");return e.replace(a,(s,l,d)=>{let c=t.get(Number(l));return`${c.source==="logical"?r==="physical"?`LAPP_${c.logicalName} -> APP${c.appId}`:`LAPP_${c.logicalName}@${c.profile}`:r==="physical"?`APP${c.appId}`:`APP${c.appId}@${c.profile}`}${d??""}`})}return Array.isArray(e)?e.map(i=>Na(i,t,n)):e!==null&&typeof e=="object"?Object.fromEntries(Object.entries(e).map(([i,o])=>[i,Na(o,t,n)])):e}function NT(e,t,n){return e.slice(t,n)}function Ti(e,t,n){let r=Nu(e),i=r.find(d=>d.profile!==null);if(i!==void 0)throw new Error(`ArgumentError: browser engine library does not support @profile suffixes (${NT(e,i.start,i.fullEnd)}).`);if(!r.some(d=>d.source==="logical"))return{sql:e,client:t,logicalBindings:[]};let o=DE(e,"browser",{resolveLogicalApp(d){let c=n?.[d];if(c===void 0)throw new Error(`ArgumentError: logical app LAPP_${d} is not defined.`);return c}}),a=[...o.appBindingByMappedApp.values()].filter(d=>d.source==="logical"),s=d=>o.appBindingByMappedApp.get(d)?.appId??d,l={getRecords:d=>t.getRecords({...d,app:s(d.app)}),openCursor:d=>t.openCursor({...d,app:s(d.app)}),getApps:()=>t.getApps(),getFields:d=>t.getFields(s(d)),getNumberPrecision:d=>t.getNumberPrecision(s(d)),getProcessStatuses:d=>t.getProcessStatuses(s(d))};return{sql:o.normalizedSql,client:l,logicalBindings:a}}function Ii(e,t){if(t.length===0)return e;let n=t.map(r=>`LAPP_${r.logicalName} -> APP${r.appId}`).filter((r,i,o)=>o.indexOf(r)===i);return e.message=`${e.message} [logical apps: ${n.join(", ")}]`,e}function wi(e,t){if(t.length===0)return e;let n=new Map(t.map(r=>[r.mappedAppId,r]));return Na(e,n,{logicalAppDisplay:"physical"})}function Ca(e){return{recordGetCalls:e?.getCalls??0,fetchedRows:e?.fetchedRows??0,elapsedMs:e?.elapsedMs??0,cursorRecordsScanned:e?.cursorRecordsScanned??0,limitReached:e?.limitReached??!1,limitReachedApps:e?[...e.limitReachedApps].sort((t,n)=>t-n):[]}}function CT(e){return Object.fromEntries(Object.entries(e).map(([t,n])=>[t,String(n)]))}function OT(e,t){let n=t?.get(e),r=n?.fieldType??n?.semantics?.fieldType,i=n?.semantics?.compareMode,o=n?.sortKind??(i==="number"||i==="string"?i:void 0),a=n?.publicSourceApp;return{name:e,displayName:n?.displayName??e,valueType:"string",...r!==void 0?{fieldType:r}:{},...o!==void 0?{sortKind:o}:{},...a!==void 0?{sourceApp:a}:{}}}function Oa(e,t=e.metrics){let n=gf(e);return{type:"query",rows:e.rows.map(CT),columns:e.columns.map(r=>OT(r,n)),rowCount:e.rowCount,warnings:[...e.warnings??[]],...e.validateStats?{validateStats:e.validateStats}:{},metrics:Ca(t)}}function BE(e,t={}){let n=new Ot(e).tokenize(),r=new Lt(n,t).parse();return We(r),r}function GE(e,t={}){let n=new Ot(e).tokenize(),r=new Lt(n,t).parseStatements();return r.forEach(We),r}function Ou(e){let t=e.type==="EXPLAIN"?e.query:e;if(t.type!=="UPDATE"&&t.type!=="INSERT"&&t.type!=="UPSERT")return!1;let n=t;return["applyBlocks","onInsertApplyBlocks","onUpdateApplyBlocks"].some(r=>Array.isArray(n[r])&&n[r].length>0)}function $E(e){if(e instanceof se)return Xn(e.message,e);let t=pn(e);return t.code==="PARSE_ERROR"?t:Xn("SQL statement could not be parsed",e)}function LT(e){if(e.trim()==="")throw Xn("SQL statement is empty");try{return BE(e,{import:!0})}catch(t){let n=$E(t);throw n.message.includes("\u8907\u6587\u306F\u30D0\u30C3\u30C1\u5B9F\u884C API \u3092\u4F7F\u7528\u3057\u3066\u304F\u3060\u3055\u3044")?Xn("This API accepts one statement; use runBatch for multiple statements",t):n}}function VE(e){if(Oi(e)==="UNKNOWN")throw $e("Unclassifiable statement is not allowed");return e}function WE(e){if(e.trim()==="")throw Xn("SQL statement is empty");try{return GE(e,{import:!0})}catch(t){throw $E(t)}}function _T(e){let t=VE(e),n=t.type;if(n==="IMPORT")throw $e("IMPORT is disabled by default in engine library queries");if(!gn(t))throw $e(`${n} statements are not read-only`);if(Ou(t))throw $e("APPLY statements are not allowed in engine library queries");if(!Ku(t))throw $e(`${n} does not return rows; use runBatch for batch-scoped or non-row-returning read-only statements`)}function HE(e){let t=VE(e),n=t.type==="EXPLAIN"?t.query:t;if(n.type==="IMPORT")throw $e("IMPORT is disabled by default in engine library batches");if(!gn(n))throw $e(`${n.type} statements are not read-only`);if(Ou(n))throw $e("APPLY statements are not allowed in engine library batches");if(St(n.type))throw $e("DML VALIDATE ONLY statements are not supported by runBatch")}function YE(e){let t=LT(e);return _T(t),t}function jE(e){let t=WE(e);return t.forEach(HE),t}function zE(e){let t=e.trim(),n=WE(t);n.forEach(HE);let r=n[0],i=r.type==="EXPLAIN"?r.query:r;return n.length===1&&(i.type==="SELECT"||i.type==="WITH"||i.type==="UNION")?{statements:n,legacySql:r.type==="EXPLAIN"?t:`EXPLAIN ${t}`}:{statements:n}}function DT(e){let t=e.error,n=t?.cause!==void 0?pn(t.cause):new he("EXECUTION_ERROR",t?.message??`Statement ${e.index} failed`);return Tu(n,e.index,e.type)}async function qE(e,t){let n=[],r=[];try{let i=KE(t),o=Ti(e,i.client,i.logicalApps);r=o.logicalBindings,n=jE(o.sql);let a=await Qn(o.client,c=>wf(o.sql,Jn(c),{...i.executeOptions,captureColumnMeta:!0})),s=a.statements.find(c=>c.status==="error");if(s!==void 0)throw DT(s);let l=[],d=a.statements.map(c=>{let u={index:c.index,type:c.type,status:c.status};if(c.tempTable!==void 0&&(u.tempTable=c.tempTable),c.rowCount!==void 0&&(u.rowCount=c.rowCount),c.error!==void 0&&(u.error={code:c.error.code,message:c.error.message}),c.skippedReason!==void 0&&(u.skippedReason=c.skippedReason),c.status==="success"&&c.result?.type==="SELECT"){u.resultIndex=l.length;let p=Oa(c.result,a.metrics);l.push(n[c.index]?.type==="EXPLAIN"?wi(p,r):p)}return u});return{type:"batch",batch:!0,statementCount:a.statementCount,statements:d,results:l,warnings:[]}}catch(i){throw Ii(Ta(i,n),r)}}function XE(e){if(e===null||typeof e!="object"||e.type!=="SELECT")throw new Error("Engine returned a non-SELECT result")}async function JE(e,t){let n=[];try{let r=Cu(t,"run"),i=Ti(e,r.client,r.logicalApps);n=i.logicalBindings;let a=YE(i.sql).type==="VALIDATE"?{...r.executeOptions,onLimitReached:"error"}:r.executeOptions,s=await Qn(i.client,l=>Wl(i.sql,Jn(l),{...a,captureColumnMeta:!0}));return XE(s),Oa(s)}catch(r){throw Ii(pn(r),n)}}async function QE(e,t){let n=[],r=[];try{let i=Cu(t,"explain"),o=Ti(e,i.client,i.logicalApps);r=o.logicalBindings;let a=zE(o.sql);if(n=a.statements,a.legacySql!==void 0){let c=await Qn(o.client,f=>Wl(a.legacySql,Jn(f),i.executeOptions));XE(c);let u=wi(c.rows.map(f=>String(f.plan??"")),r),p=hu(c)??{statements:[{index:0,fetch:"none",sources:[]}]};return{type:"explain",lines:u,text:u.join(`
 `),plan:p,metrics:Ca(c.metrics)}}let s=await Qn(o.client,c=>gE(o.sql,Jn(c),void 0,"batch-explain",i.executeOptions.maxRecords,i.executeOptions.cursorMaxActive)),l=wi(s.statements.flatMap(c=>[...s.statementCount>1?[`[${c.index+1}] ${c.type}`]:[],...c.plan]),r),d=hu(s)??{statements:s.statements.map(c=>({index:c.index,fetch:"none",sources:[]}))};return{type:"explain",lines:l,text:l.join(`
-`),plan:d,metrics:Ca()}}catch(i){throw Ii(Ta(i,n),r)}}var vT="3.47.0";0&&(module.exports={KsqlEngineError,createReadonlyKintoneClient,explainQuery,runBatch,runQuery,version});
+`),plan:d,metrics:Ca()}}catch(i){throw Ii(Ta(i,n),r)}}var vT="3.48.0";0&&(module.exports={KsqlEngineError,createReadonlyKintoneClient,explainQuery,runBatch,runQuery,version});

package/dist-engine/index.mjs

@@ -12,4 +12,4 @@ WHERE \u3092 AND \u306E\u5B89\u5168\u306A KLIKE \u6761\u4EF6\u3078\u66F8\u304D\u
 `));return typeof n.code=="string"&&n.code!==""&&(i.name=n.code),typeof n.code=="string"&&Object.assign(i,{code:n.code}),typeof n.status=="number"&&Object.assign(i,{status:n.status}),Object.assign(i,{cause:e}),i}async function eT(e){try{let t=await e.json();if(t!==null&&typeof t=="object"){let r=t;return hi({code:r.code,message:r.message,errors:r.errors,status:e.status})}let n=new Error(`kintone API error: HTTP ${e.status}`);return Object.assign(n,{status:e.status,cause:t}),hi(n)}catch(t){let n=new Error(`kintone API error: HTTP ${e.status} \u306E\u5FDC\u7B54\u3092 JSON \u3068\u3057\u3066\u89E3\u6790\u3067\u304D\u307E\u305B\u3093`);return Object.assign(n,{status:e.status,cause:t}),hi(n)}}function tT(e){let t=e;return t?.code==="GAIA_CN01"&&(t.status===404||t.status===void 0)}async function dn(e,t,n){try{return await kintone.api(Tu(e),t,n)}catch(r){throw hi(r)}}function nT(e){if(!Number.isSafeInteger(e)||e<1||e>5)throw new Error("ArgumentError: cursorMaxActive must be an integer from 1 to 5.")}function rT(e={}){let t=e.cursorMaxActive??QS;nT(t);let n=null,r=null,i=new Set;return{async getRecords(a){try{let s=ZS(a),l=await fetch(s.url,s.init);if(!l.ok)throw await eT(l);let d=await l.json();return bE(l.headers.get("X-Cybozu-Warning"))?{...d,searchAborted:!0}:d}catch(s){throw hi(s)}},async openCursor(a){let s=Tu(Pa),l=new URL(s,globalThis.location?.href).host.toLowerCase();if(r!==null&&r!==l)throw new Error(`CursorRouteError: factory route changed from ${r} to ${l}.`);if(r=l,n??(n=new wa(l,{maxActive:t})),n.snapshot().active>=t){let R=new Error(`CursorCapacityError: host=${l} \u306E active cursor \u4E0A\u9650 ${t} \u306B\u9054\u3057\u3066\u3044\u307E\u3059\u3002`);throw R.name="CursorCapacityError",R}let d=await n.acquire(),c;try{c=await n.runCreate(()=>dn(Pa,"POST",{app:a.app,query:a.query,size:a.size,fields:a.fields&&a.fields.length>0?a.fields:void 0}))}catch(R){throw typeof R?.code=="string"?(d.release(),R):(d.quarantine(),new Do(R))}let u=c.id,p=SE(Number(c.totalCount),{get:()=>dn(Pa,"GET",{id:u}),delete:()=>dn(Pa,"DELETE",{id:u}),isAlreadyReleasedError:tT,onReleased:()=>d.release(),onReleaseUnknown:()=>d.quarantine()}),f=null,E={totalCount:p.totalCount,async nextPage(){let R=await p.nextPage();return R.next||i.delete(E),R},close(){return f||(f=p.close().finally(()=>{i.delete(E)}),f)}};return i.add(E),E},async getApps(){let s=[],l=0;for(;;){let d=await dn("/k/v1/apps.json","GET",{limit:100,offset:l});for(let c of d.apps)s.push({appId:Number(c.appId),name:c.name,description:c.description});if(d.apps.length<100)break;l+=100}return s},async getFields(a){let s=await dn("/k/v1/app/form/fields.json","GET",{app:a});return TE(s.properties)},async getNumberPrecision(a){let s=await dn("/k/v1/app/settings.json","GET",{app:a});return Sp(s)},async getProcessStatuses(a){let s=await dn("/k/v1/app/status.json","GET",{app:a,lang:"user"});return{enable:s.enable,states:wE(s.states)}}}}var NE=new Set(["postRecords","putRecords","deleteRecords"]),Ai=class extends Error{constructor(t){let n=t instanceof Error?t.message:String(t);super(n),this.name="ClientOperationError",this.cause=t,Object.setPrototypeOf(this,new.target.prototype)}};async function xt(e){try{return await e()}catch(t){throw new Ai(t)}}function iT(e){return()=>{throw $e(`${String(e)} is blocked by the readonly client`)}}function Jn(e){let t=e.getRecords.bind(e),n=e.openCursor.bind(e),r=e.getApps.bind(e),i=e.getFields.bind(e),o=e.getNumberPrecision.bind(e),a=e.getProcessStatuses.bind(e),s=Object.assign(Object.create(null),{getRecords:async l=>{let d=await xt(()=>t(l));if(d.searchAborted===!0)throw AE();return d},openCursor:async l=>{let d=await xt(()=>n(l)),c=d.nextPage.bind(d),u=d.close.bind(d);return{totalCount:d.totalCount,nextPage:()=>xt(()=>c()),close:()=>xt(()=>u())}},getApps:()=>xt(()=>r()),getFields:l=>xt(()=>i(l)),getNumberPrecision:l=>xt(()=>o(l)),getProcessStatuses:l=>xt(()=>a(l))});return new Proxy(s,{get(l,d,c){return NE.has(d)?iT(d):Reflect.get(l,d,c)},has(l,d){return NE.has(d)?!1:Reflect.has(l,d)}})}function oT(e){let t=new Set,n=null;return{client:{getRecords:e.getRecords.bind(e),async openCursor(i){let o=await e.openCursor.call(e,i),a=null,s={totalCount:o.totalCount,nextPage:o.nextPage.bind(o),close(){return a||(a=Promise.resolve().then(()=>o.close()).finally(()=>{t.delete(s)}),a)}};return t.add(s),s},getApps:e.getApps.bind(e),getFields:e.getFields.bind(e),getNumberPrecision:e.getNumberPrecision.bind(e),getProcessStatuses:e.getProcessStatuses.bind(e)},close(){return n||(n=(async()=>{let o=(await Promise.allSettled([...t].map(a=>a.close()))).find(a=>a.status==="rejected");if(o)throw new Ai(o.reason)})(),n)}}}async function Qn(e,t){let n=oT(e),r=!1;try{return await t(n.client)}catch(i){throw r=!0,i}finally{try{await n.close()}catch(i){if(!r)throw i}}}var aT="A-Za-z",sT="\\u3040-\\u30FF\\u3400-\\u9FFF\\uF900-\\uFAFF\\uFF01-\\uFF60",wu=`${aT}${sT}`,OE=`${wu}0-9_`,lT=new RegExp(`^[${wu}]$`,"u"),uT=new RegExp(`^[${OE}]$`,"u"),cT=new RegExp(`^[${wu}][${OE}]{0,63}$`,"u");function pT(e){return lT.test(e)}function dT(e){return uT.test(e)}function bu(e){let t=e.normalize("NFC").toUpperCase();if(!cT.test(t))throw new Error(`ArgumentError: logical app name "${e}" is invalid; expected 1-64 UTF-16 units starting with an ASCII letter or supported Japanese character.`);return t}function Iu(e){if(!e)return!1;let t=e.codePointAt(0);return t>=65&&t<=90||t>=97&&t<=122||t>=48&&t<=57||t===95||t===36||t>=12352&&t<=12543||t>=13312&&t<=40959||t>=63744&&t<=64255||t>=65281&&t<=65376}function fT(e){if(!e)return!1;let t=e.codePointAt(0);return t>=65&&t<=90||t>=97&&t<=122||t>=48&&t<=57||e==="_"||e==="-"||e==="."||e==="$"}function ET(e,t){let n=t>0?e[t-1]:"";if(Iu(n))return null;let r,i,o,a,s,l;if(e.slice(t,t+5).toUpperCase()==="LAPP_"){if(r="logical",l=t+5,a=l,!pT(e[l]??""))return null;for(l++;l<e.length&&dT(e[l]);)l++;s=l;try{o=bu(e.slice(a,s))}catch{return null}}else if(e.slice(t,t+3).toUpperCase()==="APP"){for(r="physical",l=t+3,a=l;l<e.length&&/[0-9]/.test(e[l]);)l++;if(s=l,s===a)return null;i=Number(e.slice(a,s))}else return null;if(e[l]==="$"){l++;let f=l;for(;l<e.length&&Iu(e[l]);)l++;if(l===f)return null}let d=l,c=null;if(e[l]==="@"){l++;let f=l;for(;l<e.length&&fT(e[l]);)l++;if(l===f)return null;c=e.slice(f,l)}let u=l<e.length?e[l]:"";if(Iu(u))return null;let p={profile:c,start:t,referenceValueStart:a,referenceValueEnd:s,appEnd:d,fullEnd:l};return r==="physical"?{...p,source:r,appId:i}:{...p,source:r,logicalName:o}}function Pu(e){let t=[],n=0;for(;n<e.length;){let r=e[n];if(r==="'"){for(n++;n<e.length;){if(e[n]==="'"){if(n++,n<e.length&&e[n]==="'"){n++;continue}break}n++}continue}if(r==="`"){for(n++;n<e.length&&e[n]!=="`";)n++;n<e.length&&n++;continue}if(r==="-"&&e[n+1]==="-"){for(n+=2;n<e.length&&e[n]!==`
 `;)n++;continue}if(r==="/"&&e[n+1]==="*"){for(n+=2;n<e.length;){if(e[n]==="*"&&e[n+1]==="/"){n+=2;break}n++}continue}let i=ET(e,n);if(!i){n++;continue}t.push(i),n=i.fullEnd}return t}function CE(e){let t=9e8;for(;e.has(t);)t++;return e.add(t),t}function LE(e,t="dev",n){let r=Pu(e),i=r.some(g=>g.profile!==null),o=new Map,a=g=>g??t;for(let g of r){if(g.source!=="physical")continue;let m=a(g.profile),y=o.get(g.appId);y||(y=new Set,o.set(g.appId,y)),y.add(m.toLowerCase())}let s=new Set(r.filter(g=>g.source==="physical").map(g=>g.appId)),l=new Map;for(let g of r){if(g.source!=="logical")continue;let m=a(g.profile).toLowerCase(),y=`logical:${g.logicalName}@${m}`;if(l.has(y))continue;if(!n)throw new Error(`ArgumentError: logical app LAPP_${g.logicalName}@${m} requires logicalApps configuration.`);let S=n.resolveLogicalApp(g.logicalName,m);l.set(y,S),s.add(S)}let d=new Map,c=new Map;for(let[g,m]of o.entries()){let y=[...m].sort();if(!(y.length<=1))for(let S of y){let A=CE(s);d.set(`physical:${g}@${S}`,A),c.set(A,{source:"physical",mappedAppId:A,appId:g,profile:S})}}let u=[],p=[],f=0,E=0,R=(g,m,y,S)=>{if(!g&&m===y)return;let A=f;u.push(g),f+=g.length,p.push({normalizedStart:A,normalizedEnd:f,sourceStart:m,sourceEnd:y,...S===void 0?{}:{bindingMappedAppId:S}})};for(let g of r){let m=a(g.profile).toLowerCase(),y;if(g.source==="physical")y={source:"physical",mappedAppId:d.get(`physical:${g.appId}@${m}`)??g.appId,appId:g.appId,profile:m};else{let I=`logical:${g.logicalName}@${m}`,w=d.get(I);w===void 0&&(w=CE(s),d.set(I,w)),y={source:"logical",logicalName:g.logicalName,mappedAppId:w,appId:l.get(I),profile:m}}c.set(y.mappedAppId,y),R(e.slice(E,g.start),E,g.start);let S=e.slice(g.referenceValueEnd,g.appEnd),A=g.source==="physical"?`${e.slice(g.start,g.referenceValueStart)}${y.mappedAppId}${S}`:`APP${y.mappedAppId}${S}`;R(A,g.start,g.fullEnd,y.mappedAppId),E=g.fullEnd}return R(e.slice(E),E,e.length),{normalizedSql:u.join(""),hasProfileSyntax:i,appBindingByMappedApp:c,rewriteSegments:p}}var _E=new Set(["client","logicalApps","maxRecords","fetchParallel","cursorMaxActive"]),DE=new Set([..._E,"onLimitReached"]),RT=new Set([...DE,"variables","tempTableMaxRows"]);function vE(e){if(e===null||typeof e!="object"||Array.isArray(e))throw new TypeError("options must be an object")}function Si(e,t){if(!Number.isSafeInteger(e)||e<=0)throw new RangeError(`${t} must be a positive safe integer`)}function UE(e){if(e===null||typeof e!="object")throw new TypeError("client is required");let t=e;for(let n of["getRecords","openCursor","getApps","getFields","getNumberPrecision","getProcessStatuses"])if(typeof t[n]!="function")throw new TypeError(`client.${n} must be a function`)}function gT(e){if(e===null||typeof e!="object"||Array.isArray(e))throw new TypeError("variables must be an object");for(let[t,n]of Object.entries(e))if(typeof n!="string")throw new TypeError(`variables.${t} must be a string`)}function kE(e){if(e===void 0)return;if(e===null||typeof e!="object"||Array.isArray(e))throw new TypeError("logicalApps must be an object");let t={};for(let[n,r]of Object.entries(e)){let i;try{i=bu(n)}catch{throw new TypeError(`logicalApps key "${n}" is invalid`)}if(Object.prototype.hasOwnProperty.call(t,i))throw new TypeError(`logicalApps key "${n}" duplicates "${i}" after canonical normalization`);Si(r,`logicalApps.${n}`),t[i]=r}return t}function ME(e,t,n){for(let r of Reflect.ownKeys(e))if(typeof r!="string"||!t.has(r))throw new TypeError(`Unknown ${n} option: ${String(r)}`);if(e.maxRecords!==void 0&&Si(e.maxRecords,"maxRecords"),e.fetchParallel!==void 0&&Si(e.fetchParallel,"fetchParallel"),e.cursorMaxActive!==void 0&&(Si(e.cursorMaxActive,"cursorMaxActive"),e.cursorMaxActive>5))throw new RangeError("cursorMaxActive must be between 1 and 5");if(e.onLimitReached!==void 0&&e.onLimitReached!=="error"&&e.onLimitReached!=="truncate")throw new TypeError('onLimitReached must be "error" or "truncate"');return{...e.maxRecords!==void 0?{maxRecords:e.maxRecords}:{},...e.fetchParallel!==void 0?{fetchParallel:e.fetchParallel}:{},...e.cursorMaxActive!==void 0?{cursorMaxActive:e.cursorMaxActive}:{},...e.onLimitReached!==void 0?{onLimitReached:e.onLimitReached}:{}}}function Nu(e,t){vE(e);let n=t==="run"?DE:_E;UE(e.client);let r=ME(e,n,t==="run"?"runQuery":"explainQuery"),i=kE(e.logicalApps);return{client:e.client,...i===void 0?{}:{logicalApps:i},executeOptions:r}}function FE(e){vE(e),UE(e.client),e.variables!==void 0&&gT(e.variables),e.tempTableMaxRows!==void 0&&Si(e.tempTableMaxRows,"tempTableMaxRows");let t=ME(e,RT,"runBatch"),n=kE(e.logicalApps);return{client:e.client,...n===void 0?{}:{logicalApps:n},executeOptions:{...t,...e.variables!==void 0?{variables:e.variables}:{},...e.tempTableMaxRows!==void 0?{tempTableMaxRows:e.tempTableMaxRows}:{}}}}function Na(e,t,n={}){let r=n.logicalAppDisplay??"profile";if(typeof e=="string"){let i=e.match(/^(\s*target:\s*)APP(\d+) \((\d+)\)\s*$/);if(i&&i[2]===i[3]){let s=t.get(Number(i[2]));if(s){let l=s.source==="logical"?r==="physical"?`LAPP_${s.logicalName} -> APP${s.appId}`:`LAPP_${s.logicalName} -> APP${s.appId}@${s.profile}`:r==="physical"?`APP${s.appId}`:`APP${s.appId}@${s.profile}`;return`${i[1]}${l}`}}if(t.size===0)return e;let o=[...t.keys()].sort((s,l)=>String(l).length-String(s).length),a=new RegExp(`APP(${o.join("|")})(?!\\d)(\\s+AS\\s+[^\\s()]+)?(?:\\s+\\(\\1\\))?`,"g");return e.replace(a,(s,l,d)=>{let c=t.get(Number(l));return`${c.source==="logical"?r==="physical"?`LAPP_${c.logicalName} -> APP${c.appId}`:`LAPP_${c.logicalName}@${c.profile}`:r==="physical"?`APP${c.appId}`:`APP${c.appId}@${c.profile}`}${d??""}`})}return Array.isArray(e)?e.map(i=>Na(i,t,n)):e!==null&&typeof e=="object"?Object.fromEntries(Object.entries(e).map(([i,o])=>[i,Na(o,t,n)])):e}function yT(e,t,n){return e.slice(t,n)}function Ti(e,t,n){let r=Pu(e),i=r.find(d=>d.profile!==null);if(i!==void 0)throw new Error(`ArgumentError: browser engine library does not support @profile suffixes (${yT(e,i.start,i.fullEnd)}).`);if(!r.some(d=>d.source==="logical"))return{sql:e,client:t,logicalBindings:[]};let o=LE(e,"browser",{resolveLogicalApp(d){let c=n?.[d];if(c===void 0)throw new Error(`ArgumentError: logical app LAPP_${d} is not defined.`);return c}}),a=[...o.appBindingByMappedApp.values()].filter(d=>d.source==="logical"),s=d=>o.appBindingByMappedApp.get(d)?.appId??d,l={getRecords:d=>t.getRecords({...d,app:s(d.app)}),openCursor:d=>t.openCursor({...d,app:s(d.app)}),getApps:()=>t.getApps(),getFields:d=>t.getFields(s(d)),getNumberPrecision:d=>t.getNumberPrecision(s(d)),getProcessStatuses:d=>t.getProcessStatuses(s(d))};return{sql:o.normalizedSql,client:l,logicalBindings:a}}function Ii(e,t){if(t.length===0)return e;let n=t.map(r=>`LAPP_${r.logicalName} -> APP${r.appId}`).filter((r,i,o)=>o.indexOf(r)===i);return e.message=`${e.message} [logical apps: ${n.join(", ")}]`,e}function wi(e,t){if(t.length===0)return e;let n=new Map(t.map(r=>[r.mappedAppId,r]));return Na(e,n,{logicalAppDisplay:"physical"})}function Ca(e){return{recordGetCalls:e?.getCalls??0,fetchedRows:e?.fetchedRows??0,elapsedMs:e?.elapsedMs??0,cursorRecordsScanned:e?.cursorRecordsScanned??0,limitReached:e?.limitReached??!1,limitReachedApps:e?[...e.limitReachedApps].sort((t,n)=>t-n):[]}}function mT(e){return Object.fromEntries(Object.entries(e).map(([t,n])=>[t,String(n)]))}function hT(e,t){let n=t?.get(e),r=n?.fieldType??n?.semantics?.fieldType,i=n?.semantics?.compareMode,o=n?.sortKind??(i==="number"||i==="string"?i:void 0),a=n?.publicSourceApp;return{name:e,displayName:n?.displayName??e,valueType:"string",...r!==void 0?{fieldType:r}:{},...o!==void 0?{sortKind:o}:{},...a!==void 0?{sourceApp:a}:{}}}function Oa(e,t=e.metrics){let n=Rf(e);return{type:"query",rows:e.rows.map(mT),columns:e.columns.map(r=>hT(r,n)),rowCount:e.rowCount,warnings:[...e.warnings??[]],...e.validateStats?{validateStats:e.validateStats}:{},metrics:Ca(t)}}function xE(e,t={}){let n=new Ot(e).tokenize(),r=new Lt(n,t).parse();return We(r),r}function KE(e,t={}){let n=new Ot(e).tokenize(),r=new Lt(n,t).parseStatements();return r.forEach(We),r}function Cu(e){let t=e.type==="EXPLAIN"?e.query:e;if(t.type!=="UPDATE"&&t.type!=="INSERT"&&t.type!=="UPSERT")return!1;let n=t;return["applyBlocks","onInsertApplyBlocks","onUpdateApplyBlocks"].some(r=>Array.isArray(n[r])&&n[r].length>0)}function BE(e){if(e instanceof se)return Xn(e.message,e);let t=pn(e);return t.code==="PARSE_ERROR"?t:Xn("SQL statement could not be parsed",e)}function AT(e){if(e.trim()==="")throw Xn("SQL statement is empty");try{return xE(e,{import:!0})}catch(t){let n=BE(t);throw n.message.includes("\u8907\u6587\u306F\u30D0\u30C3\u30C1\u5B9F\u884C API \u3092\u4F7F\u7528\u3057\u3066\u304F\u3060\u3055\u3044")?Xn("This API accepts one statement; use runBatch for multiple statements",t):n}}function GE(e){if(Oi(e)==="UNKNOWN")throw $e("Unclassifiable statement is not allowed");return e}function $E(e){if(e.trim()==="")throw Xn("SQL statement is empty");try{return KE(e,{import:!0})}catch(t){throw BE(t)}}function ST(e){let t=GE(e),n=t.type;if(n==="IMPORT")throw $e("IMPORT is disabled by default in engine library queries");if(!gn(t))throw $e(`${n} statements are not read-only`);if(Cu(t))throw $e("APPLY statements are not allowed in engine library queries");if(!xu(t))throw $e(`${n} does not return rows; use runBatch for batch-scoped or non-row-returning read-only statements`)}function VE(e){let t=GE(e),n=t.type==="EXPLAIN"?t.query:t;if(n.type==="IMPORT")throw $e("IMPORT is disabled by default in engine library batches");if(!gn(n))throw $e(`${n.type} statements are not read-only`);if(Cu(n))throw $e("APPLY statements are not allowed in engine library batches");if(St(n.type))throw $e("DML VALIDATE ONLY statements are not supported by runBatch")}function WE(e){let t=AT(e);return ST(t),t}function HE(e){let t=$E(e);return t.forEach(VE),t}function YE(e){let t=e.trim(),n=$E(t);n.forEach(VE);let r=n[0],i=r.type==="EXPLAIN"?r.query:r;return n.length===1&&(i.type==="SELECT"||i.type==="WITH"||i.type==="UNION")?{statements:n,legacySql:r.type==="EXPLAIN"?t:`EXPLAIN ${t}`}:{statements:n}}function TT(e){let t=e.error,n=t?.cause!==void 0?pn(t.cause):new we("EXECUTION_ERROR",t?.message??`Statement ${e.index} failed`);return Su(n,e.index,e.type)}async function IT(e,t){let n=[],r=[];try{let i=FE(t),o=Ti(e,i.client,i.logicalApps);r=o.logicalBindings,n=HE(o.sql);let a=await Qn(o.client,c=>If(o.sql,Jn(c),{...i.executeOptions,captureColumnMeta:!0})),s=a.statements.find(c=>c.status==="error");if(s!==void 0)throw TT(s);let l=[],d=a.statements.map(c=>{let u={index:c.index,type:c.type,status:c.status};if(c.tempTable!==void 0&&(u.tempTable=c.tempTable),c.rowCount!==void 0&&(u.rowCount=c.rowCount),c.error!==void 0&&(u.error={code:c.error.code,message:c.error.message}),c.skippedReason!==void 0&&(u.skippedReason=c.skippedReason),c.status==="success"&&c.result?.type==="SELECT"){u.resultIndex=l.length;let p=Oa(c.result,a.metrics);l.push(n[c.index]?.type==="EXPLAIN"?wi(p,r):p)}return u});return{type:"batch",batch:!0,statementCount:a.statementCount,statements:d,results:l,warnings:[]}}catch(i){throw Ii(Ta(i,n),r)}}function jE(e){if(e===null||typeof e!="object"||e.type!=="SELECT")throw new Error("Engine returned a non-SELECT result")}async function wT(e,t){let n=[];try{let r=Nu(t,"run"),i=Ti(e,r.client,r.logicalApps);n=i.logicalBindings;let a=WE(i.sql).type==="VALIDATE"?{...r.executeOptions,onLimitReached:"error"}:r.executeOptions,s=await Qn(i.client,l=>Vl(i.sql,Jn(l),{...a,captureColumnMeta:!0}));return jE(s),Oa(s)}catch(r){throw Ii(pn(r),n)}}async function bT(e,t){let n=[],r=[];try{let i=Nu(t,"explain"),o=Ti(e,i.client,i.logicalApps);r=o.logicalBindings;let a=YE(o.sql);if(n=a.statements,a.legacySql!==void 0){let c=await Qn(o.client,f=>Vl(a.legacySql,Jn(f),i.executeOptions));jE(c);let u=wi(c.rows.map(f=>String(f.plan??"")),r),p=mu(c)??{statements:[{index:0,fetch:"none",sources:[]}]};return{type:"explain",lines:u,text:u.join(`
 `),plan:p,metrics:Ca(c.metrics)}}let s=await Qn(o.client,c=>RE(o.sql,Jn(c),void 0,"batch-explain",i.executeOptions.maxRecords,i.executeOptions.cursorMaxActive)),l=wi(s.statements.flatMap(c=>[...s.statementCount>1?[`[${c.index+1}] ${c.type}`]:[],...c.plan]),r),d=mu(s)??{statements:s.statements.map(c=>({index:c.index,fetch:"none",sources:[]}))};return{type:"explain",lines:l,text:l.join(`
-`),plan:d,metrics:Ca()}}catch(i){throw Ii(Ta(i,n),r)}}var FO="3.47.0";export{we as KsqlEngineError,rT as createReadonlyKintoneClient,bT as explainQuery,IT as runBatch,wT as runQuery,FO as version};
+`),plan:d,metrics:Ca()}}catch(i){throw Ii(Ta(i,n),r)}}var FO="3.48.0";export{we as KsqlEngineError,rT as createReadonlyKintoneClient,bT as explainQuery,IT as runBatch,wT as runQuery,FO as version};

package/dist-engine/ksql-engine.umd.js

@@ -12,4 +12,4 @@ WHERE \u3092 AND \u306E\u5B89\u5168\u306A KLIKE \u6761\u4EF6\u3078\u66F8\u304D\u
 `));return typeof n.code=="string"&&n.code!==""&&(i.name=n.code),typeof n.code=="string"&&Object.assign(i,{code:n.code}),typeof n.status=="number"&&Object.assign(i,{status:n.status}),Object.assign(i,{cause:e}),i}async function sT(e){try{let t=await e.json();if(t!==null&&typeof t=="object"){let r=t;return hi({code:r.code,message:r.message,errors:r.errors,status:e.status})}let n=new Error(`kintone API error: HTTP ${e.status}`);return Object.assign(n,{status:e.status,cause:t}),hi(n)}catch(t){let n=new Error(`kintone API error: HTTP ${e.status} \u306E\u5FDC\u7B54\u3092 JSON \u3068\u3057\u3066\u89E3\u6790\u3067\u304D\u307E\u305B\u3093`);return Object.assign(n,{status:e.status,cause:t}),hi(n)}}function lT(e){let t=e;return t?.code==="GAIA_CN01"&&(t.status===404||t.status===void 0)}async function dn(e,t,n){try{return await kintone.api(Tu(e),t,n)}catch(r){throw hi(r)}}function uT(e){if(!Number.isSafeInteger(e)||e<1||e>5)throw new Error("ArgumentError: cursorMaxActive must be an integer from 1 to 5.")}function Iu(e={}){let t=e.cursorMaxActive??oT;uT(t);let n=null,r=null,i=new Set;return{async getRecords(a){try{let s=aT(a),l=await fetch(s.url,s.init);if(!l.ok)throw await sT(l);let d=await l.json();return LE(l.headers.get("X-Cybozu-Warning"))?{...d,searchAborted:!0}:d}catch(s){throw hi(s)}},async openCursor(a){let s=Tu(Pa),l=new URL(s,globalThis.location?.href).host.toLowerCase();if(r!==null&&r!==l)throw new Error(`CursorRouteError: factory route changed from ${r} to ${l}.`);if(r=l,n??(n=new wa(l,{maxActive:t})),n.snapshot().active>=t){let R=new Error(`CursorCapacityError: host=${l} \u306E active cursor \u4E0A\u9650 ${t} \u306B\u9054\u3057\u3066\u3044\u307E\u3059\u3002`);throw R.name="CursorCapacityError",R}let d=await n.acquire(),c;try{c=await n.runCreate(()=>dn(Pa,"POST",{app:a.app,query:a.query,size:a.size,fields:a.fields&&a.fields.length>0?a.fields:void 0}))}catch(R){throw typeof R?.code=="string"?(d.release(),R):(d.quarantine(),new Do(R))}let u=c.id,p=PE(Number(c.totalCount),{get:()=>dn(Pa,"GET",{id:u}),delete:()=>dn(Pa,"DELETE",{id:u}),isAlreadyReleasedError:lT,onReleased:()=>d.release(),onReleaseUnknown:()=>d.quarantine()}),f=null,E={totalCount:p.totalCount,async nextPage(){let R=await p.nextPage();return R.next||i.delete(E),R},close(){return f||(f=p.close().finally(()=>{i.delete(E)}),f)}};return i.add(E),E},async getApps(){let s=[],l=0;for(;;){let d=await dn("/k/v1/apps.json","GET",{limit:100,offset:l});for(let c of d.apps)s.push({appId:Number(c.appId),name:c.name,description:c.description});if(d.apps.length<100)break;l+=100}return s},async getFields(a){let s=await dn("/k/v1/app/form/fields.json","GET",{app:a});return NE(s.properties)},async getNumberPrecision(a){let s=await dn("/k/v1/app/settings.json","GET",{app:a});return Pp(s)},async getProcessStatuses(a){let s=await dn("/k/v1/app/status.json","GET",{app:a,lang:"user"});return{enable:s.enable,states:OE(s.states)}}}}var DE=new Set(["postRecords","putRecords","deleteRecords"]),Ai=class extends Error{constructor(t){let n=t instanceof Error?t.message:String(t);super(n),this.name="ClientOperationError",this.cause=t,Object.setPrototypeOf(this,new.target.prototype)}};async function xt(e){try{return await e()}catch(t){throw new Ai(t)}}function cT(e){return()=>{throw $e(`${String(e)} is blocked by the readonly client`)}}function Jn(e){let t=e.getRecords.bind(e),n=e.openCursor.bind(e),r=e.getApps.bind(e),i=e.getFields.bind(e),o=e.getNumberPrecision.bind(e),a=e.getProcessStatuses.bind(e),s=Object.assign(Object.create(null),{getRecords:async l=>{let d=await xt(()=>t(l));if(d.searchAborted===!0)throw bE();return d},openCursor:async l=>{let d=await xt(()=>n(l)),c=d.nextPage.bind(d),u=d.close.bind(d);return{totalCount:d.totalCount,nextPage:()=>xt(()=>c()),close:()=>xt(()=>u())}},getApps:()=>xt(()=>r()),getFields:l=>xt(()=>i(l)),getNumberPrecision:l=>xt(()=>o(l)),getProcessStatuses:l=>xt(()=>a(l))});return new Proxy(s,{get(l,d,c){return DE.has(d)?cT(d):Reflect.get(l,d,c)},has(l,d){return DE.has(d)?!1:Reflect.has(l,d)}})}function pT(e){let t=new Set,n=null;return{client:{getRecords:e.getRecords.bind(e),async openCursor(i){let o=await e.openCursor.call(e,i),a=null,s={totalCount:o.totalCount,nextPage:o.nextPage.bind(o),close(){return a||(a=Promise.resolve().then(()=>o.close()).finally(()=>{t.delete(s)}),a)}};return t.add(s),s},getApps:e.getApps.bind(e),getFields:e.getFields.bind(e),getNumberPrecision:e.getNumberPrecision.bind(e),getProcessStatuses:e.getProcessStatuses.bind(e)},close(){return n||(n=(async()=>{let o=(await Promise.allSettled([...t].map(a=>a.close()))).find(a=>a.status==="rejected");if(o)throw new Ai(o.reason)})(),n)}}}async function Qn(e,t){let n=pT(e),r=!1;try{return await t(n.client)}catch(i){throw r=!0,i}finally{try{await n.close()}catch(i){if(!r)throw i}}}var dT="A-Za-z",fT="\\u3040-\\u30FF\\u3400-\\u9FFF\\uF900-\\uFAFF\\uFF01-\\uFF60",bu=`${dT}${fT}`,UE=`${bu}0-9_`,ET=new RegExp(`^[${bu}]$`,"u"),RT=new RegExp(`^[${UE}]$`,"u"),gT=new RegExp(`^[${bu}][${UE}]{0,63}$`,"u");function yT(e){return ET.test(e)}function mT(e){return RT.test(e)}function Pu(e){let t=e.normalize("NFC").toUpperCase();if(!gT.test(t))throw new Error(`ArgumentError: logical app name "${e}" is invalid; expected 1-64 UTF-16 units starting with an ASCII letter or supported Japanese character.`);return t}function wu(e){if(!e)return!1;let t=e.codePointAt(0);return t>=65&&t<=90||t>=97&&t<=122||t>=48&&t<=57||t===95||t===36||t>=12352&&t<=12543||t>=13312&&t<=40959||t>=63744&&t<=64255||t>=65281&&t<=65376}function hT(e){if(!e)return!1;let t=e.codePointAt(0);return t>=65&&t<=90||t>=97&&t<=122||t>=48&&t<=57||e==="_"||e==="-"||e==="."||e==="$"}function AT(e,t){let n=t>0?e[t-1]:"";if(wu(n))return null;let r,i,o,a,s,l;if(e.slice(t,t+5).toUpperCase()==="LAPP_"){if(r="logical",l=t+5,a=l,!yT(e[l]??""))return null;for(l++;l<e.length&&mT(e[l]);)l++;s=l;try{o=Pu(e.slice(a,s))}catch{return null}}else if(e.slice(t,t+3).toUpperCase()==="APP"){for(r="physical",l=t+3,a=l;l<e.length&&/[0-9]/.test(e[l]);)l++;if(s=l,s===a)return null;i=Number(e.slice(a,s))}else return null;if(e[l]==="$"){l++;let f=l;for(;l<e.length&&wu(e[l]);)l++;if(l===f)return null}let d=l,c=null;if(e[l]==="@"){l++;let f=l;for(;l<e.length&&hT(e[l]);)l++;if(l===f)return null;c=e.slice(f,l)}let u=l<e.length?e[l]:"";if(wu(u))return null;let p={profile:c,start:t,referenceValueStart:a,referenceValueEnd:s,appEnd:d,fullEnd:l};return r==="physical"?{...p,source:r,appId:i}:{...p,source:r,logicalName:o}}function Nu(e){let t=[],n=0;for(;n<e.length;){let r=e[n];if(r==="'"){for(n++;n<e.length;){if(e[n]==="'"){if(n++,n<e.length&&e[n]==="'"){n++;continue}break}n++}continue}if(r==="`"){for(n++;n<e.length&&e[n]!=="`";)n++;n<e.length&&n++;continue}if(r==="-"&&e[n+1]==="-"){for(n+=2;n<e.length&&e[n]!==`
 `;)n++;continue}if(r==="/"&&e[n+1]==="*"){for(n+=2;n<e.length;){if(e[n]==="*"&&e[n+1]==="/"){n+=2;break}n++}continue}let i=AT(e,n);if(!i){n++;continue}t.push(i),n=i.fullEnd}return t}function vE(e){let t=9e8;for(;e.has(t);)t++;return e.add(t),t}function kE(e,t="dev",n){let r=Nu(e),i=r.some(g=>g.profile!==null),o=new Map,a=g=>g??t;for(let g of r){if(g.source!=="physical")continue;let m=a(g.profile),y=o.get(g.appId);y||(y=new Set,o.set(g.appId,y)),y.add(m.toLowerCase())}let s=new Set(r.filter(g=>g.source==="physical").map(g=>g.appId)),l=new Map;for(let g of r){if(g.source!=="logical")continue;let m=a(g.profile).toLowerCase(),y=`logical:${g.logicalName}@${m}`;if(l.has(y))continue;if(!n)throw new Error(`ArgumentError: logical app LAPP_${g.logicalName}@${m} requires logicalApps configuration.`);let S=n.resolveLogicalApp(g.logicalName,m);l.set(y,S),s.add(S)}let d=new Map,c=new Map;for(let[g,m]of o.entries()){let y=[...m].sort();if(!(y.length<=1))for(let S of y){let A=vE(s);d.set(`physical:${g}@${S}`,A),c.set(A,{source:"physical",mappedAppId:A,appId:g,profile:S})}}let u=[],p=[],f=0,E=0,R=(g,m,y,S)=>{if(!g&&m===y)return;let A=f;u.push(g),f+=g.length,p.push({normalizedStart:A,normalizedEnd:f,sourceStart:m,sourceEnd:y,...S===void 0?{}:{bindingMappedAppId:S}})};for(let g of r){let m=a(g.profile).toLowerCase(),y;if(g.source==="physical")y={source:"physical",mappedAppId:d.get(`physical:${g.appId}@${m}`)??g.appId,appId:g.appId,profile:m};else{let I=`logical:${g.logicalName}@${m}`,w=d.get(I);w===void 0&&(w=vE(s),d.set(I,w)),y={source:"logical",logicalName:g.logicalName,mappedAppId:w,appId:l.get(I),profile:m}}c.set(y.mappedAppId,y),R(e.slice(E,g.start),E,g.start);let S=e.slice(g.referenceValueEnd,g.appEnd),A=g.source==="physical"?`${e.slice(g.start,g.referenceValueStart)}${y.mappedAppId}${S}`:`APP${y.mappedAppId}${S}`;R(A,g.start,g.fullEnd,y.mappedAppId),E=g.fullEnd}return R(e.slice(E),E,e.length),{normalizedSql:u.join(""),hasProfileSyntax:i,appBindingByMappedApp:c,rewriteSegments:p}}var ME=new Set(["client","logicalApps","maxRecords","fetchParallel","cursorMaxActive"]),FE=new Set([...ME,"onLimitReached"]),ST=new Set([...FE,"variables","tempTableMaxRows"]);function xE(e){if(e===null||typeof e!="object"||Array.isArray(e))throw new TypeError("options must be an object")}function Si(e,t){if(!Number.isSafeInteger(e)||e<=0)throw new RangeError(`${t} must be a positive safe integer`)}function KE(e){if(e===null||typeof e!="object")throw new TypeError("client is required");let t=e;for(let n of["getRecords","openCursor","getApps","getFields","getNumberPrecision","getProcessStatuses"])if(typeof t[n]!="function")throw new TypeError(`client.${n} must be a function`)}function TT(e){if(e===null||typeof e!="object"||Array.isArray(e))throw new TypeError("variables must be an object");for(let[t,n]of Object.entries(e))if(typeof n!="string")throw new TypeError(`variables.${t} must be a string`)}function BE(e){if(e===void 0)return;if(e===null||typeof e!="object"||Array.isArray(e))throw new TypeError("logicalApps must be an object");let t={};for(let[n,r]of Object.entries(e)){let i;try{i=Pu(n)}catch{throw new TypeError(`logicalApps key "${n}" is invalid`)}if(Object.prototype.hasOwnProperty.call(t,i))throw new TypeError(`logicalApps key "${n}" duplicates "${i}" after canonical normalization`);Si(r,`logicalApps.${n}`),t[i]=r}return t}function GE(e,t,n){for(let r of Reflect.ownKeys(e))if(typeof r!="string"||!t.has(r))throw new TypeError(`Unknown ${n} option: ${String(r)}`);if(e.maxRecords!==void 0&&Si(e.maxRecords,"maxRecords"),e.fetchParallel!==void 0&&Si(e.fetchParallel,"fetchParallel"),e.cursorMaxActive!==void 0&&(Si(e.cursorMaxActive,"cursorMaxActive"),e.cursorMaxActive>5))throw new RangeError("cursorMaxActive must be between 1 and 5");if(e.onLimitReached!==void 0&&e.onLimitReached!=="error"&&e.onLimitReached!=="truncate")throw new TypeError('onLimitReached must be "error" or "truncate"');return{...e.maxRecords!==void 0?{maxRecords:e.maxRecords}:{},...e.fetchParallel!==void 0?{fetchParallel:e.fetchParallel}:{},...e.cursorMaxActive!==void 0?{cursorMaxActive:e.cursorMaxActive}:{},...e.onLimitReached!==void 0?{onLimitReached:e.onLimitReached}:{}}}function Cu(e,t){xE(e);let n=t==="run"?FE:ME;KE(e.client);let r=GE(e,n,t==="run"?"runQuery":"explainQuery"),i=BE(e.logicalApps);return{client:e.client,...i===void 0?{}:{logicalApps:i},executeOptions:r}}function $E(e){xE(e),KE(e.client),e.variables!==void 0&&TT(e.variables),e.tempTableMaxRows!==void 0&&Si(e.tempTableMaxRows,"tempTableMaxRows");let t=GE(e,ST,"runBatch"),n=BE(e.logicalApps);return{client:e.client,...n===void 0?{}:{logicalApps:n},executeOptions:{...t,...e.variables!==void 0?{variables:e.variables}:{},...e.tempTableMaxRows!==void 0?{tempTableMaxRows:e.tempTableMaxRows}:{}}}}function Na(e,t,n={}){let r=n.logicalAppDisplay??"profile";if(typeof e=="string"){let i=e.match(/^(\s*target:\s*)APP(\d+) \((\d+)\)\s*$/);if(i&&i[2]===i[3]){let s=t.get(Number(i[2]));if(s){let l=s.source==="logical"?r==="physical"?`LAPP_${s.logicalName} -> APP${s.appId}`:`LAPP_${s.logicalName} -> APP${s.appId}@${s.profile}`:r==="physical"?`APP${s.appId}`:`APP${s.appId}@${s.profile}`;return`${i[1]}${l}`}}if(t.size===0)return e;let o=[...t.keys()].sort((s,l)=>String(l).length-String(s).length),a=new RegExp(`APP(${o.join("|")})(?!\\d)(\\s+AS\\s+[^\\s()]+)?(?:\\s+\\(\\1\\))?`,"g");return e.replace(a,(s,l,d)=>{let c=t.get(Number(l));return`${c.source==="logical"?r==="physical"?`LAPP_${c.logicalName} -> APP${c.appId}`:`LAPP_${c.logicalName}@${c.profile}`:r==="physical"?`APP${c.appId}`:`APP${c.appId}@${c.profile}`}${d??""}`})}return Array.isArray(e)?e.map(i=>Na(i,t,n)):e!==null&&typeof e=="object"?Object.fromEntries(Object.entries(e).map(([i,o])=>[i,Na(o,t,n)])):e}function IT(e,t,n){return e.slice(t,n)}function Ti(e,t,n){let r=Nu(e),i=r.find(d=>d.profile!==null);if(i!==void 0)throw new Error(`ArgumentError: browser engine library does not support @profile suffixes (${IT(e,i.start,i.fullEnd)}).`);if(!r.some(d=>d.source==="logical"))return{sql:e,client:t,logicalBindings:[]};let o=kE(e,"browser",{resolveLogicalApp(d){let c=n?.[d];if(c===void 0)throw new Error(`ArgumentError: logical app LAPP_${d} is not defined.`);return c}}),a=[...o.appBindingByMappedApp.values()].filter(d=>d.source==="logical"),s=d=>o.appBindingByMappedApp.get(d)?.appId??d,l={getRecords:d=>t.getRecords({...d,app:s(d.app)}),openCursor:d=>t.openCursor({...d,app:s(d.app)}),getApps:()=>t.getApps(),getFields:d=>t.getFields(s(d)),getNumberPrecision:d=>t.getNumberPrecision(s(d)),getProcessStatuses:d=>t.getProcessStatuses(s(d))};return{sql:o.normalizedSql,client:l,logicalBindings:a}}function Ii(e,t){if(t.length===0)return e;let n=t.map(r=>`LAPP_${r.logicalName} -> APP${r.appId}`).filter((r,i,o)=>o.indexOf(r)===i);return e.message=`${e.message} [logical apps: ${n.join(", ")}]`,e}function wi(e,t){if(t.length===0)return e;let n=new Map(t.map(r=>[r.mappedAppId,r]));return Na(e,n,{logicalAppDisplay:"physical"})}function Ca(e){return{recordGetCalls:e?.getCalls??0,fetchedRows:e?.fetchedRows??0,elapsedMs:e?.elapsedMs??0,cursorRecordsScanned:e?.cursorRecordsScanned??0,limitReached:e?.limitReached??!1,limitReachedApps:e?[...e.limitReachedApps].sort((t,n)=>t-n):[]}}function wT(e){return Object.fromEntries(Object.entries(e).map(([t,n])=>[t,String(n)]))}function bT(e,t){let n=t?.get(e),r=n?.fieldType??n?.semantics?.fieldType,i=n?.semantics?.compareMode,o=n?.sortKind??(i==="number"||i==="string"?i:void 0),a=n?.publicSourceApp;return{name:e,displayName:n?.displayName??e,valueType:"string",...r!==void 0?{fieldType:r}:{},...o!==void 0?{sortKind:o}:{},...a!==void 0?{sourceApp:a}:{}}}function Oa(e,t=e.metrics){let n=Af(e);return{type:"query",rows:e.rows.map(wT),columns:e.columns.map(r=>bT(r,n)),rowCount:e.rowCount,warnings:[...e.warnings??[]],...e.validateStats?{validateStats:e.validateStats}:{},metrics:Ca(t)}}function VE(e,t={}){let n=new Ot(e).tokenize(),r=new Lt(n,t).parse();return We(r),r}function WE(e,t={}){let n=new Ot(e).tokenize(),r=new Lt(n,t).parseStatements();return r.forEach(We),r}function Ou(e){let t=e.type==="EXPLAIN"?e.query:e;if(t.type!=="UPDATE"&&t.type!=="INSERT"&&t.type!=="UPSERT")return!1;let n=t;return["applyBlocks","onInsertApplyBlocks","onUpdateApplyBlocks"].some(r=>Array.isArray(n[r])&&n[r].length>0)}function HE(e){if(e instanceof se)return Xn(e.message,e);let t=pn(e);return t.code==="PARSE_ERROR"?t:Xn("SQL statement could not be parsed",e)}function PT(e){if(e.trim()==="")throw Xn("SQL statement is empty");try{return VE(e,{import:!0})}catch(t){let n=HE(t);throw n.message.includes("\u8907\u6587\u306F\u30D0\u30C3\u30C1\u5B9F\u884C API \u3092\u4F7F\u7528\u3057\u3066\u304F\u3060\u3055\u3044")?Xn("This API accepts one statement; use runBatch for multiple statements",t):n}}function YE(e){if(Oi(e)==="UNKNOWN")throw $e("Unclassifiable statement is not allowed");return e}function jE(e){if(e.trim()==="")throw Xn("SQL statement is empty");try{return WE(e,{import:!0})}catch(t){throw HE(t)}}function NT(e){let t=YE(e),n=t.type;if(n==="IMPORT")throw $e("IMPORT is disabled by default in engine library queries");if(!gn(t))throw $e(`${n} statements are not read-only`);if(Ou(t))throw $e("APPLY statements are not allowed in engine library queries");if(!Vu(t))throw $e(`${n} does not return rows; use runBatch for batch-scoped or non-row-returning read-only statements`)}function zE(e){let t=YE(e),n=t.type==="EXPLAIN"?t.query:t;if(n.type==="IMPORT")throw $e("IMPORT is disabled by default in engine library batches");if(!gn(n))throw $e(`${n.type} statements are not read-only`);if(Ou(n))throw $e("APPLY statements are not allowed in engine library batches");if(St(n.type))throw $e("DML VALIDATE ONLY statements are not supported by runBatch")}function qE(e){let t=PT(e);return NT(t),t}function XE(e){let t=jE(e);return t.forEach(zE),t}function JE(e){let t=e.trim(),n=jE(t);n.forEach(zE);let r=n[0],i=r.type==="EXPLAIN"?r.query:r;return n.length===1&&(i.type==="SELECT"||i.type==="WITH"||i.type==="UNION")?{statements:n,legacySql:r.type==="EXPLAIN"?t:`EXPLAIN ${t}`}:{statements:n}}function CT(e){let t=e.error,n=t?.cause!==void 0?pn(t.cause):new fe("EXECUTION_ERROR",t?.message??`Statement ${e.index} failed`);return Su(n,e.index,e.type)}async function Lu(e,t){let n=[],r=[];try{let i=$E(t),o=Ti(e,i.client,i.logicalApps);r=o.logicalBindings,n=XE(o.sql);let a=await Qn(o.client,c=>Cf(o.sql,Jn(c),{...i.executeOptions,captureColumnMeta:!0})),s=a.statements.find(c=>c.status==="error");if(s!==void 0)throw CT(s);let l=[],d=a.statements.map(c=>{let u={index:c.index,type:c.type,status:c.status};if(c.tempTable!==void 0&&(u.tempTable=c.tempTable),c.rowCount!==void 0&&(u.rowCount=c.rowCount),c.error!==void 0&&(u.error={code:c.error.code,message:c.error.message}),c.skippedReason!==void 0&&(u.skippedReason=c.skippedReason),c.status==="success"&&c.result?.type==="SELECT"){u.resultIndex=l.length;let p=Oa(c.result,a.metrics);l.push(n[c.index]?.type==="EXPLAIN"?wi(p,r):p)}return u});return{type:"batch",batch:!0,statementCount:a.statementCount,statements:d,results:l,warnings:[]}}catch(i){throw Ii(Ta(i,n),r)}}function QE(e){if(e===null||typeof e!="object"||e.type!=="SELECT")throw new Error("Engine returned a non-SELECT result")}async function _u(e,t){let n=[];try{let r=Cu(t,"run"),i=Ti(e,r.client,r.logicalApps);n=i.logicalBindings;let a=qE(i.sql).type==="VALIDATE"?{...r.executeOptions,onLimitReached:"error"}:r.executeOptions,s=await Qn(i.client,l=>Vl(i.sql,Jn(l),{...a,captureColumnMeta:!0}));return QE(s),Oa(s)}catch(r){throw Ii(pn(r),n)}}async function Du(e,t){let n=[],r=[];try{let i=Cu(t,"explain"),o=Ti(e,i.client,i.logicalApps);r=o.logicalBindings;let a=JE(o.sql);if(n=a.statements,a.legacySql!==void 0){let c=await Qn(o.client,f=>Vl(a.legacySql,Jn(f),i.executeOptions));QE(c);let u=wi(c.rows.map(f=>String(f.plan??"")),r),p=mu(c)??{statements:[{index:0,fetch:"none",sources:[]}]};return{type:"explain",lines:u,text:u.join(`
 `),plan:p,metrics:Ca(c.metrics)}}let s=await Qn(o.client,c=>AE(o.sql,Jn(c),void 0,"batch-explain",i.executeOptions.maxRecords,i.executeOptions.cursorMaxActive)),l=wi(s.statements.flatMap(c=>[...s.statementCount>1?[`[${c.index+1}] ${c.type}`]:[],...c.plan]),r),d=mu(s)??{statements:s.statements.map(c=>({index:c.index,fetch:"none",sources:[]}))};return{type:"explain",lines:l,text:l.join(`
-`),plan:d,metrics:Ca()}}catch(i){throw Ii(Ta(i,n),r)}}var vu="3.47.0";var ZE=(e,t)=>Object.prototype.hasOwnProperty.call(e,t);function OT(){let e=Object.create(null);return Object.freeze({versions:e,get(t){return ZE(e,t)?e[t]:void 0}})}function LT(e){if(e===null||typeof e!="object")return!1;let t=e;return t.versions!==null&&typeof t.versions=="object"&&!Array.isArray(t.versions)&&typeof t.get=="function"}function eR(e,t,n,r=console){let i;if(e.ksql===void 0){i=OT();try{e.ksql=i}catch(a){r.error(`[kSQL engine ${t}] window.ksql registry could not be initialized; loading was aborted.`,a);return}}else if(LT(e.ksql))i=e.ksql;else{r.error(`[kSQL engine ${t}] window.ksql already exists but is not a compatible { versions, get } registry; loading was aborted.`);return}if(ZE(i.versions,t))return r.warn(`[kSQL engine ${t}] this version is already registered; the first entry was kept.`),i;let o=Object.freeze(n);try{i.versions[t]=o}catch(a){r.error(`[kSQL engine ${t}] the compatible window.ksql registry rejected registration; loading was aborted.`,a);return}return i}var _T={version:vu,createReadonlyKintoneClient:Iu,explainQuery:Du,KsqlEngineError:fe,runBatch:Lu,runQuery:_u};eR(window,vu,_T);})();
+`),plan:d,metrics:Ca()}}catch(i){throw Ii(Ta(i,n),r)}}var vu="3.48.0";var ZE=(e,t)=>Object.prototype.hasOwnProperty.call(e,t);function OT(){let e=Object.create(null);return Object.freeze({versions:e,get(t){return ZE(e,t)?e[t]:void 0}})}function LT(e){if(e===null||typeof e!="object")return!1;let t=e;return t.versions!==null&&typeof t.versions=="object"&&!Array.isArray(t.versions)&&typeof t.get=="function"}function eR(e,t,n,r=console){let i;if(e.ksql===void 0){i=OT();try{e.ksql=i}catch(a){r.error(`[kSQL engine ${t}] window.ksql registry could not be initialized; loading was aborted.`,a);return}}else if(LT(e.ksql))i=e.ksql;else{r.error(`[kSQL engine ${t}] window.ksql already exists but is not a compatible { versions, get } registry; loading was aborted.`);return}if(ZE(i.versions,t))return r.warn(`[kSQL engine ${t}] this version is already registered; the first entry was kept.`),i;let o=Object.freeze(n);try{i.versions[t]=o}catch(a){r.error(`[kSQL engine ${t}] the compatible window.ksql registry rejected registration; loading was aborted.`,a);return}return i}var _T={version:vu,createReadonlyKintoneClient:Iu,explainQuery:Du,KsqlEngineError:fe,runBatch:Lu,runQuery:_u};eR(window,vu,_T);})();

package/dist-engine/meta/bundle-baseline.json

@@ -1,5 +1,5 @@
 {
-  "generatedAt": "2026-08-05T11:06:47.516Z",
+  "generatedAt": "2026-08-05T14:17:11.175Z",
   "baseline": "B66 Phase1 initial measured values; no arbitrary size ceiling",
   "bundles": {
     "index.cjs": {
@@ -45,7 +45,7 @@
     "ksql-engine.umd.js": {
       "inputCount": 105,
       "minifiedBytes": 578114,
-      "gzipBytes": 157692,
+      "gzipBytes": 157693,
       "forbidden": {
         "mcp-instructions": [],
         "src-mcp": [],

package/dist-mcp/ksql-mcp.js

@@ -57075,7 +57075,7 @@ var saveQueryInputSchema = external_exports.object({
   name: savedQueryName,
   title: external_exports.string().min(1).describe("Human-readable title.").optional(),
   description: external_exports.string().min(1).describe("What the query does and when to use it.").optional(),
-  sql: external_exports.string().min(1).describe("kSQL text to save (single statement only)."),
+  sql: external_exports.string().min(1).describe("kSQL text to save. Read-only saved queries may contain multiple ;-separated statements; DML saved queries must remain single-statement."),
   defaultProfile: external_exports.string().min(1).describe("Profile the saved query runs against by default."),
   readOnly: external_exports.boolean().describe("true for read-only queries; false marks the saved query as DML (requires mutate safety inputs at run time)."),
   allowProfileOverride: external_exports.boolean().describe("Allow overriding the profile at run time (default false).").optional(),
@@ -57093,7 +57093,8 @@ var runSavedQueryInputSchema = external_exports.object({
   timeout,
   allowDml: external_exports.literal(true).describe("Required for DML saved queries: must be true to acknowledge writes.").optional(),
   confirmText: external_exports.literal("yes").describe('Required for DML saved queries: must be the literal string "yes".').optional(),
-  dmlMaxRows: external_exports.number().int().positive().describe("Required for DML saved queries: per-statement cap on affected rows; for UPSERT it counts inserts + updates. It does NOT limit source reads of INSERT/UPSERT ... SELECT: those follow the runtime maxRecords resolution (KSQL_MAX_RECORDS / profile query.maxRecords, default 500). Saved queries are single-statement, so temp tables do not apply here. Note: this tool's maxRecords / onLimit inputs apply to read-only saved queries only.").optional()
+  dmlMaxRows: external_exports.number().int().positive().describe("Required for DML saved queries: per-statement cap on affected rows; for UPSERT it counts inserts + updates. It does NOT limit source reads of INSERT/UPSERT ... SELECT: those follow the runtime maxRecords resolution (KSQL_MAX_RECORDS / profile query.maxRecords, default 500). Read-only saved-query batches may use temp tables with the engine default row cap. Note: this tool's maxRecords / onLimit inputs apply to read-only saved queries only.").optional(),
+  variables: external_exports.record(external_exports.string(), external_exports.string()).describe("Batch only: string values for variables declared with DECLARE. Keys omit @ and are case-insensitive.").optional()
 });
 var validateInputShape = validateInputSchema.shape;
 var explainInputShape = explainInputSchema.shape;
@@ -57150,10 +57151,14 @@ function validateSavedQueryName(name) {
   }
 }
 function assertSavedQuerySafety(input, safety) {
-  if (input.readOnly && safety.isDml) {
-    throw new Error(`ArgumentError: readOnly saved query cannot contain ${safety.statementType}.`);
+  if (input.readOnly && !safety.canRunWithQueryTool) {
+    const detail = safety.statementCount === 1 && safety.statementType ? safety.statementType : "statements that require ksql_mutate";
+    throw new Error(`ArgumentError: readOnly saved query cannot contain ${detail}.`);
+  }
+  if (!input.readOnly && safety.statementCount > 1) {
+    throw new Error("ArgumentError: DML batches are not supported by saved queries in Phase 1.");
   }
-  if (!input.readOnly && !safety.isDml) {
+  if (!input.readOnly && !safety.requiresMutationTool) {
     throw new Error("ArgumentError: readOnly: false is only allowed for DML saved queries.");
   }
 }
@@ -57287,14 +57292,6 @@ function deleteSavedQuery(catalog, name) {
 }
 
 // src/mcp/tools.ts
-function requireSingleStatement(validation, toolName) {
-  if (validation.batch) {
-    throw new Error(
-      `ArgumentError: batch SQL (multiple statements) is not supported by ${toolName} yet.`
-    );
-  }
-  return validation;
-}
 var DEFAULT_MAX_RECORDS = 500;
 var DEFAULT_ON_LIMIT = "error";
 var MCP_IMPORT_SOURCE_REQUIRED_MESSAGE = "IMPORT \u306B\u306F importSources\uFF08inline CSV/JSON\uFF09\u3092\u6307\u5B9A\u3057\u3066\u304F\u3060\u3055\u3044\u3002";
@@ -57993,15 +57990,14 @@ function createKsqlMcpTools(serverOptions, deps = {}) {
     });
   }
   async function saveQuery(input) {
-    const validation = requireSingleStatement(
-      await validate({
-        sql: input.sql,
-        profile: input.defaultProfile
-      }),
-      "ksql_save_query"
-    );
+    const validation = await validate({
+      sql: input.sql,
+      profile: input.defaultProfile
+    });
     assertSavedQuerySafety(input, {
-      isDml: validation.isDml,
+      statementCount: validation.statementCount,
+      canRunWithQueryTool: validation.canRunWithQueryTool,
+      requiresMutationTool: validation.requiresMutationTool,
       statementType: validation.statementType
     });
     const filePath = getSavedQueryCatalogPath(serverOptions);
@@ -58043,15 +58039,14 @@ function createKsqlMcpTools(serverOptions, deps = {}) {
     const saved = getSavedQuery(catalog, input.name);
     assertProfileOverrideAllowed(saved, input.profile);
     const profile2 = input.profile ?? saved.defaultProfile;
-    const validation = requireSingleStatement(
-      await validate({
-        sql: saved.sql,
-        profile: profile2
-      }),
-      "ksql_run_saved_query"
-    );
+    const validation = await validate({
+      sql: saved.sql,
+      profile: profile2
+    });
     assertSavedQuerySafety(saved, {
-      isDml: validation.isDml,
+      statementCount: validation.statementCount,
+      canRunWithQueryTool: validation.canRunWithQueryTool,
+      requiresMutationTool: validation.requiresMutationTool,
       statementType: validation.statementType
     });
     if (saved.readOnly) {
@@ -58061,7 +58056,8 @@ function createKsqlMcpTools(serverOptions, deps = {}) {
         maxRecords: input.maxRecords,
         fetchParallel: input.fetchParallel,
         onLimit: input.onLimit,
-        timeout: input.timeout
+        timeout: input.timeout,
+        variables: input.variables
       }, validation);
       return {
         ok: true,
@@ -58077,7 +58073,8 @@ function createKsqlMcpTools(serverOptions, deps = {}) {
       confirmText: "yes",
       dmlMaxRows,
       fetchParallel: input.fetchParallel,
-      timeout: input.timeout
+      timeout: input.timeout,
+      variables: input.variables
     }, validation);
     return {
       ok: true,
@@ -58313,7 +58310,7 @@ Nested JSON/CSV subtable mutation is fail-closed on MCP: use VALIDATE ONLY/EXPLA
 JSON child IDs are rejected and replacement renumbers all rows.
 `);
 }
-var SERVER_VERSION = true ? "3.47.0" : "0.0.0-dev";
+var SERVER_VERSION = true ? "3.48.0" : "0.0.0-dev";
 var FUNCTION_CATALOG_PARAGRAPH = `Complete function catalog \u2014 Scalar: ${KSQL_FUNCTION_CATALOG.scalar.join(" ")}. Aggregate: ${KSQL_FUNCTION_CATALOG.aggregate.join(" ")}. Variance and standard-deviation aggregates use explicit POP/SAMP names; unqualified STDDEV and VARIANCE are unsupported. Window: ${KSQL_FUNCTION_CATALOG.window.join(" ")} (OVER and AS alias required). Contextual: ${KSQL_FUNCTION_CATALOG.contextual.join(" ")} (kintone predicates; WHERE server-only/fail-closed; INNER JOIN direct-APP exact pushdown supported; local LOGINUSER is empty on all surfaces). Aliases: ${KSQL_FUNCTION_CATALOG.aliases.join(" ")}. Syntax: ${KSQL_FUNCTION_CATALOG.syntax.join(" ")}. This list is complete; functions from other dialects such as IFNULL do not exist. Use ksql_docs for arguments and constraints.`;
 var KSQL_MCP_INSTRUCTIONS = `kSQL MCP server version ${SERVER_VERSION}.
 
@@ -58406,7 +58403,7 @@ function createServer(args) {
   });
   server.registerTool("ksql_save_query", {
     title: "Save kSQL query",
-    description: "Save a validated kSQL statement into the local saved query catalog.",
+    description: "Save a validated kSQL query into the local catalog. Read-only queries may be multi-statement batches; DML saved queries remain single-statement.",
     inputSchema: saveQueryInputShape
   }, tools.saveQueryTool);
   server.registerTool("ksql_list_queries", {
@@ -58421,7 +58418,7 @@ function createServer(args) {
   }, tools.getQueryTool);
   server.registerTool("ksql_run_saved_query", {
     title: "Run saved kSQL query",
-    description: "Run a saved kSQL query. Read-only queries use ksql_query safety; DML queries require ksql_mutate safety inputs.",
+    description: "Run a saved kSQL query. Read-only queries and batches use ksql_query safety and support DECLARE variable injection; DML queries require ksql_mutate safety inputs.",
     inputSchema: runSavedQueryInputShape
   }, tools.runSavedQueryTool);
   server.registerTool("ksql_delete_query", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rex0220/kintone-sql-tools",
-  "version": "3.47.0",
+  "version": "3.48.0",
   "description": "kintone SQL plugin, CLI, and MCP tools (ksql)",
   "publishConfig": {
     "access": "public"