@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.
@@ -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
- console.error(`❌ Script error: ${result.message}`);
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
+ }
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@ptkl/toolkit",
3
- "version": "0.9.1",
3
+ "version": "0.9.3",
4
4
  "description": "A command-line toolkit for managing Protokol platform applications, profiles, functions, and components",
5
5
  "keywords": [
6
6
  "protokol",