@ptkl/toolkit 0.9.1 → 0.9.3
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/dist/commands/forge.js +23 -9
- package/dist/lib/forgeDevKernelPlugin.js +213 -0
- package/package.json +1 -1
package/dist/commands/forge.js
CHANGED
|
@@ -6,6 +6,7 @@ import { writeFileSync, readFileSync, rmSync, existsSync } from "fs";
|
|
|
6
6
|
import axios from 'axios';
|
|
7
7
|
import Util from "../lib/util.js";
|
|
8
8
|
import { join } from 'path';
|
|
9
|
+
import { forgeDevKernelPlugin } from '../lib/forgeDevKernelPlugin.js';
|
|
9
10
|
function formatBuildError(reason) {
|
|
10
11
|
const lines = [];
|
|
11
12
|
if (reason.id || reason.loc) {
|
|
@@ -47,6 +48,7 @@ class ForgeCommand {
|
|
|
47
48
|
.addCommand(new Command("dev")
|
|
48
49
|
.description("Run dev app")
|
|
49
50
|
.requiredOption("-p, --path <path>", "Path is directory where app is located.")
|
|
51
|
+
.option("--platform-url <url>", "Platform UI URL (e.g. http://localhost:8081) — required for window.requestForgePermissions in dev mode")
|
|
50
52
|
.action(this.runDev))
|
|
51
53
|
.addCommand(new Command("list")
|
|
52
54
|
.description("List all available apps")
|
|
@@ -252,7 +254,7 @@ class ForgeCommand {
|
|
|
252
254
|
return `const ${alias || orig}=axiosAdapter${orig === 'default' || !alias ? '' : `.${orig}`};\n`;
|
|
253
255
|
}).join(''));
|
|
254
256
|
// Wrap in async function so sandbox (isolate-vm / new Function) gets a callable back
|
|
255
|
-
chunk.code = `return async()=>{try{${code}}catch(err){const errorObj={_error_:true,message:err.message,name:err.name||'Error',stack:err.stack};Object.keys(err).forEach(key=>{errorObj[key]=err[key]});if(err.data)errorObj.data=err.data;if(err.statusCode)errorObj.statusCode=err.statusCode;if(err.response)errorObj.response=err.response;if(err.code)errorObj.code=err.code;return errorObj}}`;
|
|
257
|
+
chunk.code = `return async()=>{try{${code}}catch(err){const errorObj={_error_:true,message:err.message,name:err.name||'Error',stack:err.stack};Object.keys(err).forEach(key=>{errorObj[key]=err[key]});if(err.data)errorObj.data=err.data;if(err.statusCode)errorObj.statusCode=err.statusCode;if(err.response)errorObj.response=err.response;if(err.code)errorObj.code=err.code;if(err.errors)errorObj.errors=err.errors.map(e=>({message:e.message,code:e.code}));return errorObj}}`;
|
|
256
258
|
}
|
|
257
259
|
}
|
|
258
260
|
}
|
|
@@ -335,7 +337,7 @@ class ForgeCommand {
|
|
|
335
337
|
}
|
|
336
338
|
}
|
|
337
339
|
async runDev(options) {
|
|
338
|
-
const { path } = options;
|
|
340
|
+
const { path, platformUrl } = options;
|
|
339
341
|
const host = Util.getCurrentProfile().host;
|
|
340
342
|
// Load ptkl.config.js to discover views and app name
|
|
341
343
|
let appName;
|
|
@@ -358,6 +360,8 @@ class ForgeCommand {
|
|
|
358
360
|
: `🔌 Reusing existing dev hub on http://localhost:${DEV_HUB_PORT}`);
|
|
359
361
|
// Start Vite dev server for the app, injecting window.__PTKL_DEV_HUB__ so AppView
|
|
360
362
|
// inside this app automatically knows where to fetch local view bundles from.
|
|
363
|
+
// The forgeDevKernelPlugin polyfills window.requestForgePermissions and other forge
|
|
364
|
+
// kernel globals that normally come from the platform-forge runtime.
|
|
361
365
|
const server = await createServer({
|
|
362
366
|
root: path,
|
|
363
367
|
define: {
|
|
@@ -368,7 +372,7 @@ class ForgeCommand {
|
|
|
368
372
|
}),
|
|
369
373
|
DEV_HUB_PORT
|
|
370
374
|
},
|
|
371
|
-
plugins: [],
|
|
375
|
+
plugins: [forgeDevKernelPlugin(appName, platformUrl)],
|
|
372
376
|
});
|
|
373
377
|
await server.listen();
|
|
374
378
|
console.log('Current profile:', Util.getCurrentProfile().name);
|
|
@@ -384,11 +388,6 @@ class ForgeCommand {
|
|
|
384
388
|
const tmpDir = join(os.default.tmpdir(), `ptkl-dev-${appName}`);
|
|
385
389
|
mkdirSync(tmpDir, { recursive: true });
|
|
386
390
|
console.log(`👁️ Watching views for "${appName}": [${Object.keys(views).join(', ')}]`);
|
|
387
|
-
// createServer() sets process.env.NODE_ENV='development'.
|
|
388
|
-
// Vite 7 uses process.env.NODE_ENV (not config.mode) to determine isProduction,
|
|
389
|
-
// which controls jsxDev in esbuild. Force production here so the watch build
|
|
390
|
-
// compiles JSX without dev helpers (_store, _source, etc.).
|
|
391
|
-
process.env.NODE_ENV = 'production';
|
|
392
391
|
for (const viewName of Object.keys(views)) {
|
|
393
392
|
// Use a per-view output dir so each view's assets don't collide
|
|
394
393
|
// (two views could otherwise both emit a file named from their input, e.g. `index.css`)
|
|
@@ -399,6 +398,12 @@ class ForgeCommand {
|
|
|
399
398
|
mode: 'production',
|
|
400
399
|
logLevel: 'silent',
|
|
401
400
|
plugins: [],
|
|
401
|
+
// Explicitly define NODE_ENV for this build so esbuild strips dev-only
|
|
402
|
+
// code paths (e.g. React dev warnings) in the view bundle, regardless
|
|
403
|
+
// of what process.env.NODE_ENV is set to in the surrounding process.
|
|
404
|
+
define: {
|
|
405
|
+
'process.env.NODE_ENV': '"production"',
|
|
406
|
+
},
|
|
402
407
|
resolve: {
|
|
403
408
|
// Force all react/* imports to resolve from the app's own node_modules,
|
|
404
409
|
// preventing a second React instance from symlinked deps (e.g. @ptkl/components)
|
|
@@ -515,7 +520,16 @@ class ForgeCommand {
|
|
|
515
520
|
delete global.window;
|
|
516
521
|
delete global.axiosAdapter;
|
|
517
522
|
if (result && result._error_) {
|
|
518
|
-
|
|
523
|
+
const displayMessage = result.message ||
|
|
524
|
+
(result.errors && result.errors.length > 0
|
|
525
|
+
? result.errors.map((e) => e.message || e.code).filter(Boolean).join(', ')
|
|
526
|
+
: result.name) ||
|
|
527
|
+
'Unknown error';
|
|
528
|
+
console.error(`❌ Script error: ${displayMessage}`);
|
|
529
|
+
if (result.errors && result.errors.length > 0) {
|
|
530
|
+
console.error(' Caused by:');
|
|
531
|
+
result.errors.forEach((e) => console.error(` - ${e.message || e.code}`));
|
|
532
|
+
}
|
|
519
533
|
if (result.stack)
|
|
520
534
|
console.error(result.stack);
|
|
521
535
|
process.exit(1);
|
|
@@ -0,0 +1,213 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Vite plugin that injects the forge kernel window globals into the dev server HTML.
|
|
3
|
+
* In production these come from the platform-forge runtime loaded by the platform UI,
|
|
4
|
+
* but in `ptkl forge dev` the app runs standalone so we polyfill them here.
|
|
5
|
+
*
|
|
6
|
+
* The injected requestForgePermissions implementation mirrors the production version
|
|
7
|
+
* in platform-forge/src/lib/dynamicImport.ts — uses a DOM overlay with an iframe
|
|
8
|
+
* instead of a popup window to avoid popup blockers.
|
|
9
|
+
*/
|
|
10
|
+
export function forgeDevKernelPlugin(appName, platformUrl) {
|
|
11
|
+
const appRef = appName ?? '';
|
|
12
|
+
const platUrl = platformUrl ? platformUrl.replace(/\/$/, '') : null;
|
|
13
|
+
const scriptContent = platUrl
|
|
14
|
+
? `(function(){
|
|
15
|
+
var _appRef=${JSON.stringify(appRef)};
|
|
16
|
+
var _platformUrl=${JSON.stringify(platUrl)};
|
|
17
|
+
window.forge=window.forge||{};
|
|
18
|
+
window.forge.requestPermissions=function(permissions,reason){
|
|
19
|
+
var appName=_appRef||sessionStorage.getItem('forge_app_name')||'';
|
|
20
|
+
var params=new URLSearchParams();
|
|
21
|
+
params.set('app_ref',appName);
|
|
22
|
+
if(reason)params.set('reason',reason);
|
|
23
|
+
permissions.forEach(function(p){params.append('permissions[]',p);});
|
|
24
|
+
var consentUrl=_platformUrl+'/forge/consent?'+params.toString();
|
|
25
|
+
return new Promise(function(resolve,reject){
|
|
26
|
+
// Overlay backdrop
|
|
27
|
+
var overlay=document.createElement('div');
|
|
28
|
+
overlay.style.cssText='position:fixed;inset:0;z-index:99999;background:rgba(0,0,0,0.72);display:flex;align-items:center;justify-content:center;';
|
|
29
|
+
// Dialog shell
|
|
30
|
+
var dialog=document.createElement('div');
|
|
31
|
+
dialog.style.cssText='position:relative;width:520px;max-width:calc(100vw - 2rem);height:640px;max-height:calc(100vh - 4rem);border-radius:16px;overflow:hidden;box-shadow:0 32px 80px rgba(0,0,0,0.8);';
|
|
32
|
+
// Close button
|
|
33
|
+
var closeBtn=document.createElement('button');
|
|
34
|
+
closeBtn.textContent='\u00D7';
|
|
35
|
+
closeBtn.style.cssText='position:absolute;top:10px;right:12px;z-index:3;background:rgba(255,255,255,0.12);border:1px solid rgba(255,255,255,0.15);color:#fff;font-size:1.25rem;line-height:1;width:30px;height:30px;border-radius:50%;cursor:pointer;display:flex;align-items:center;justify-content:center;';
|
|
36
|
+
// Loader
|
|
37
|
+
var loader=document.createElement('div');
|
|
38
|
+
loader.style.cssText='position:absolute;inset:0;display:flex;align-items:center;justify-content:center;background:#0f0f10;z-index:2;pointer-events:none;';
|
|
39
|
+
var spinner=document.createElement('div');
|
|
40
|
+
spinner.style.cssText='width:36px;height:36px;border:3px solid rgba(255,255,255,0.12);border-top-color:#fff;border-radius:50%;animation:forge-spin 0.7s linear infinite;';
|
|
41
|
+
var style=document.createElement('style');
|
|
42
|
+
style.textContent='@keyframes forge-spin{to{transform:rotate(360deg)}}';
|
|
43
|
+
loader.appendChild(style);
|
|
44
|
+
loader.appendChild(spinner);
|
|
45
|
+
// iframe
|
|
46
|
+
var iframe=document.createElement('iframe');
|
|
47
|
+
iframe.style.cssText='width:100%;height:100%;border:none;display:block;';
|
|
48
|
+
iframe.addEventListener('load',function(){loader.style.display='none';});
|
|
49
|
+
dialog.appendChild(closeBtn);
|
|
50
|
+
dialog.appendChild(loader);
|
|
51
|
+
dialog.appendChild(iframe);
|
|
52
|
+
overlay.appendChild(dialog);
|
|
53
|
+
document.body.appendChild(overlay);
|
|
54
|
+
// Set src after DOM attach to prevent premature about:blank load event
|
|
55
|
+
setTimeout(function(){iframe.src=consentUrl;},0);
|
|
56
|
+
function cleanup(){
|
|
57
|
+
window.removeEventListener('message',onMessage);
|
|
58
|
+
overlay.remove();
|
|
59
|
+
}
|
|
60
|
+
function onMessage(e){
|
|
61
|
+
if(e.origin!==_platformUrl)return;
|
|
62
|
+
if(!e.data)return;
|
|
63
|
+
if(e.data.type==='forge_consent_token'){
|
|
64
|
+
cleanup();
|
|
65
|
+
sessionStorage.setItem('forge_actor_token',e.data.token);
|
|
66
|
+
resolve(e.data.permissions||[]);
|
|
67
|
+
return;
|
|
68
|
+
}
|
|
69
|
+
if(e.data.type==='forge_consent_denied'){
|
|
70
|
+
cleanup();
|
|
71
|
+
reject(new Error('[ptkl forge dev] Consent denied.'));
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
window.addEventListener('message',onMessage);
|
|
75
|
+
closeBtn.addEventListener('click',function(){
|
|
76
|
+
cleanup();
|
|
77
|
+
reject(new Error('[ptkl forge dev] Consent dialog closed without approving.'));
|
|
78
|
+
});
|
|
79
|
+
overlay.addEventListener('click',function(e){
|
|
80
|
+
if(e.target===overlay){
|
|
81
|
+
cleanup();
|
|
82
|
+
reject(new Error('[ptkl forge dev] Consent dialog closed without approving.'));
|
|
83
|
+
}
|
|
84
|
+
});
|
|
85
|
+
});
|
|
86
|
+
};
|
|
87
|
+
console.log('[ptkl forge dev] window.forge ready (platform: '+_platformUrl+')'); window.forge.dynamicImport=function(url){return import(url).then(function(){});}; window.forge.dynamicImportCSS=function(url){return new Promise(function(resolve,reject){var link=document.createElement('link');link.rel='stylesheet';link.href=url;link.onload=function(){resolve();};link.onerror=function(){reject(new Error('Failed to load CSS: '+url));};document.head.appendChild(link);});};
|
|
88
|
+
window.forge.requestMarketplaceInstall=function(itemId,itemType,options){
|
|
89
|
+
var appName=(options&&options.initiator)||sessionStorage.getItem('forge_app_name')||'';
|
|
90
|
+
var params=new URLSearchParams();
|
|
91
|
+
params.set('id',itemId);
|
|
92
|
+
params.set('type',itemType);
|
|
93
|
+
if(appName)params.set('initiator',appName);
|
|
94
|
+
var installUrl=_platformUrl+'/marketplace/install?'+params.toString();
|
|
95
|
+
return new Promise(function(resolve,reject){
|
|
96
|
+
var overlay=document.createElement('div');
|
|
97
|
+
overlay.style.cssText='position:fixed;inset:0;z-index:99999;background:rgba(0,0,0,0.72);display:flex;align-items:center;justify-content:center;';
|
|
98
|
+
var dialog=document.createElement('div');
|
|
99
|
+
dialog.style.cssText='position:relative;width:520px;max-width:calc(100vw - 2rem);height:640px;max-height:calc(100vh - 4rem);border-radius:16px;overflow:hidden;box-shadow:0 32px 80px rgba(0,0,0,0.8);';
|
|
100
|
+
var closeBtn=document.createElement('button');
|
|
101
|
+
closeBtn.textContent='\u00D7';
|
|
102
|
+
closeBtn.style.cssText='position:absolute;top:10px;right:12px;z-index:3;background:rgba(255,255,255,0.12);border:1px solid rgba(255,255,255,0.15);color:#fff;font-size:1.25rem;line-height:1;width:30px;height:30px;border-radius:50%;cursor:pointer;display:flex;align-items:center;justify-content:center;';
|
|
103
|
+
var loader=document.createElement('div');
|
|
104
|
+
loader.style.cssText='position:absolute;inset:0;display:flex;align-items:center;justify-content:center;background:#0f0f10;z-index:2;pointer-events:none;';
|
|
105
|
+
var spinner=document.createElement('div');
|
|
106
|
+
spinner.style.cssText='width:36px;height:36px;border:3px solid rgba(255,255,255,0.12);border-top-color:#fff;border-radius:50%;animation:forge-spin 0.7s linear infinite;';
|
|
107
|
+
var style=document.createElement('style');
|
|
108
|
+
style.textContent='@keyframes forge-spin{to{transform:rotate(360deg)}}';
|
|
109
|
+
loader.appendChild(style);
|
|
110
|
+
loader.appendChild(spinner);
|
|
111
|
+
var iframe=document.createElement('iframe');
|
|
112
|
+
iframe.style.cssText='width:100%;height:100%;border:none;display:block;';
|
|
113
|
+
iframe.addEventListener('load',function(){loader.style.display='none';});
|
|
114
|
+
dialog.appendChild(closeBtn);
|
|
115
|
+
dialog.appendChild(loader);
|
|
116
|
+
dialog.appendChild(iframe);
|
|
117
|
+
overlay.appendChild(dialog);
|
|
118
|
+
document.body.appendChild(overlay);
|
|
119
|
+
setTimeout(function(){iframe.src=installUrl;},0);
|
|
120
|
+
function cleanup(){
|
|
121
|
+
window.removeEventListener('message',onMessage);
|
|
122
|
+
overlay.remove();
|
|
123
|
+
}
|
|
124
|
+
function onMessage(e){
|
|
125
|
+
if(e.origin!==_platformUrl)return;
|
|
126
|
+
if(!e.data)return;
|
|
127
|
+
if(e.data.type==='marketplace_install_done'){
|
|
128
|
+
cleanup();
|
|
129
|
+
resolve({id:e.data.item_id,type:e.data.item_type,already_installed:e.data.already_installed||false});
|
|
130
|
+
return;
|
|
131
|
+
}
|
|
132
|
+
if(e.data.type==='marketplace_install_denied'){
|
|
133
|
+
cleanup();
|
|
134
|
+
reject(new Error('[ptkl forge dev] Installation cancelled.'));
|
|
135
|
+
}
|
|
136
|
+
}
|
|
137
|
+
window.addEventListener('message',onMessage);
|
|
138
|
+
closeBtn.addEventListener('click',function(){
|
|
139
|
+
cleanup();
|
|
140
|
+
reject(new Error('[ptkl forge dev] Marketplace install dialog closed.'));
|
|
141
|
+
});
|
|
142
|
+
overlay.addEventListener('click',function(e){
|
|
143
|
+
if(e.target===overlay){
|
|
144
|
+
cleanup();
|
|
145
|
+
reject(new Error('[ptkl forge dev] Marketplace install dialog closed.'));
|
|
146
|
+
}
|
|
147
|
+
});
|
|
148
|
+
});
|
|
149
|
+
};
|
|
150
|
+
window.forge.openDeveloperIntegrations=function(){
|
|
151
|
+
var integrationsUrl=_platformUrl+'/admin/developer/integrations';
|
|
152
|
+
return new Promise(function(resolve){
|
|
153
|
+
var overlay=document.createElement('div');
|
|
154
|
+
overlay.style.cssText='position:fixed;inset:0;z-index:99999;background:rgba(0,0,0,0.72);display:flex;align-items:center;justify-content:center;';
|
|
155
|
+
var dialog=document.createElement('div');
|
|
156
|
+
dialog.style.cssText='position:relative;width:860px;max-width:calc(100vw - 2rem);height:80vh;max-height:calc(100vh - 4rem);border-radius:16px;overflow:hidden;box-shadow:0 32px 80px rgba(0,0,0,0.8);';
|
|
157
|
+
var closeBtn=document.createElement('button');
|
|
158
|
+
closeBtn.textContent='\u00D7';
|
|
159
|
+
closeBtn.style.cssText='position:absolute;top:10px;right:12px;z-index:3;background:rgba(255,255,255,0.12);border:1px solid rgba(255,255,255,0.15);color:#fff;font-size:1.25rem;line-height:1;width:30px;height:30px;border-radius:50%;cursor:pointer;display:flex;align-items:center;justify-content:center;';
|
|
160
|
+
var loader=document.createElement('div');
|
|
161
|
+
loader.style.cssText='position:absolute;inset:0;display:flex;align-items:center;justify-content:center;background:#0f0f10;z-index:2;pointer-events:none;';
|
|
162
|
+
var spinner=document.createElement('div');
|
|
163
|
+
spinner.style.cssText='width:36px;height:36px;border:3px solid rgba(255,255,255,0.12);border-top-color:#fff;border-radius:50%;animation:forge-spin 0.7s linear infinite;';
|
|
164
|
+
var style=document.createElement('style');
|
|
165
|
+
style.textContent='@keyframes forge-spin{to{transform:rotate(360deg)}}';
|
|
166
|
+
loader.appendChild(style);
|
|
167
|
+
loader.appendChild(spinner);
|
|
168
|
+
var iframe=document.createElement('iframe');
|
|
169
|
+
iframe.style.cssText='width:100%;height:100%;border:none;display:block;';
|
|
170
|
+
iframe.addEventListener('load',function(){loader.style.display='none';});
|
|
171
|
+
dialog.appendChild(closeBtn);
|
|
172
|
+
dialog.appendChild(loader);
|
|
173
|
+
dialog.appendChild(iframe);
|
|
174
|
+
overlay.appendChild(dialog);
|
|
175
|
+
document.body.appendChild(overlay);
|
|
176
|
+
setTimeout(function(){iframe.src=integrationsUrl;},0);
|
|
177
|
+
function cleanup(){overlay.remove();resolve();}
|
|
178
|
+
closeBtn.addEventListener('click',cleanup);
|
|
179
|
+
overlay.addEventListener('click',function(e){if(e.target===overlay)cleanup();});
|
|
180
|
+
});
|
|
181
|
+
};
|
|
182
|
+
})();`
|
|
183
|
+
: `(function(){
|
|
184
|
+
window.forge=window.forge||{};
|
|
185
|
+
window.forge.requestPermissions=function(){
|
|
186
|
+
console.warn('[ptkl forge dev] window.forge.requestPermissions unavailable — pass --platform-url <url> to enable.');
|
|
187
|
+
return Promise.reject(new Error('requestPermissions requires --platform-url in ptkl forge dev'));
|
|
188
|
+
};
|
|
189
|
+
window.forge.requestMarketplaceInstall=function(){
|
|
190
|
+
console.warn('[ptkl forge dev] window.forge.requestMarketplaceInstall unavailable — pass --platform-url <url> to enable.');
|
|
191
|
+
return Promise.reject(new Error('requestMarketplaceInstall requires --platform-url in ptkl forge dev'));
|
|
192
|
+
};
|
|
193
|
+
window.forge.openDeveloperIntegrations=function(){
|
|
194
|
+
console.warn('[ptkl forge dev] window.forge.openDeveloperIntegrations unavailable — pass --platform-url <url> to enable.');
|
|
195
|
+
return Promise.resolve();
|
|
196
|
+
};
|
|
197
|
+
window.forge.dynamicImport=function(url){return import(url).then(function(){});};
|
|
198
|
+
window.forge.dynamicImportCSS=function(url){return new Promise(function(resolve,reject){var link=document.createElement('link');link.rel='stylesheet';link.href=url;link.onload=function(){resolve();};link.onerror=function(){reject(new Error('Failed to load CSS: '+url));};document.head.appendChild(link);});};}
|
|
199
|
+
})();`;
|
|
200
|
+
return {
|
|
201
|
+
name: 'ptkl-forge-dev-kernel',
|
|
202
|
+
transformIndexHtml() {
|
|
203
|
+
return [
|
|
204
|
+
{
|
|
205
|
+
tag: 'script',
|
|
206
|
+
attrs: { type: 'text/javascript' },
|
|
207
|
+
children: scriptContent,
|
|
208
|
+
injectTo: 'head-prepend',
|
|
209
|
+
},
|
|
210
|
+
];
|
|
211
|
+
},
|
|
212
|
+
};
|
|
213
|
+
}
|