juxscript 1.1.393 → 1.1.395

package/dist/services/email.d.ts

@@ -0,0 +1,50 @@
+/**
+ * email.ts — Jux email service client
+ *
+ * JuxEmail establishes connectivity to the `email` downstream service via the
+ * ApiGateway backend. It provides a domain-specific API for email operations;
+ * every method ultimately delegates to `this.call(path, options)`, which routes
+ * through the Jux Gateway transport layer.
+ *
+ * Usage in a .jux file:
+ *   const api   = await jux.gateway(username, password);
+ *   const email = api.connect('email');
+ *
+ *   // Inspect service settings (configured sender, templates, limits, etc.)
+ *   const cfg = await email.settings();
+ *
+ *   // Send a plain-text email
+ *   await email.send('recipient@example.com', 'Hello', 'Plain-text body');
+ *
+ *   // Send an HTML email
+ *   await email.send('recipient@example.com', 'Hello', 'Plain text', '<b>HTML body</b>');
+ */
+import { ApiGateway, JuxService, ApiResult, ApiCallOptions } from '../components/gateway.js';
+export declare class JuxEmail extends JuxService {
+    constructor(gateway: ApiGateway);
+    /**
+     * Retrieve the email service settings (configured sender address, available
+     * templates, sending limits, etc.).
+     *
+     * @returns ApiResult where `data` contains the service configuration object.
+     *
+     * @example
+     * const cfg = await email.settings();
+     * if (cfg.ok) { console.log(cfg.data); }
+     */
+    settings(): Promise<ApiResult>;
+    /**
+     * Send an email through the email downstream service.
+     *
+     * @param to       Recipient email address
+     * @param subject  Email subject line
+     * @param text     Plain-text body
+     * @param html     Optional HTML body (falls back to `text` when omitted)
+     *
+     * @example
+     * await email.send('user@example.com', 'Welcome!', 'Thanks for joining.');
+     */
+    send(to: string, subject: string, text: string, html?: string): Promise<ApiResult>;
+}
+export { ApiCallOptions, ApiResult };
+//# sourceMappingURL=email.d.ts.map

package/dist/services/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../lib/services/email.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAA2B,MAAM,0BAA0B,CAAC;AAEtH,qBAAa,QAAS,SAAQ,UAAU;gBACxB,OAAO,EAAE,UAAU;IAI/B;;;;;;;;;OASG;IACG,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC;IAIpC;;;;;;;;;;OAUG;IACG,IAAI,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CAM3F;AAKD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC"}

package/dist/services/email.js

@@ -0,0 +1,60 @@
+/**
+ * email.ts — Jux email service client
+ *
+ * JuxEmail establishes connectivity to the `email` downstream service via the
+ * ApiGateway backend. It provides a domain-specific API for email operations;
+ * every method ultimately delegates to `this.call(path, options)`, which routes
+ * through the Jux Gateway transport layer.
+ *
+ * Usage in a .jux file:
+ *   const api   = await jux.gateway(username, password);
+ *   const email = api.connect('email');
+ *
+ *   // Inspect service settings (configured sender, templates, limits, etc.)
+ *   const cfg = await email.settings();
+ *
+ *   // Send a plain-text email
+ *   await email.send('recipient@example.com', 'Hello', 'Plain-text body');
+ *
+ *   // Send an HTML email
+ *   await email.send('recipient@example.com', 'Hello', 'Plain text', '<b>HTML body</b>');
+ */
+import { JuxService, _registerServiceFactory } from '../components/gateway.js';
+export class JuxEmail extends JuxService {
+    constructor(gateway) {
+        super(gateway, 'email');
+    }
+    /**
+     * Retrieve the email service settings (configured sender address, available
+     * templates, sending limits, etc.).
+     *
+     * @returns ApiResult where `data` contains the service configuration object.
+     *
+     * @example
+     * const cfg = await email.settings();
+     * if (cfg.ok) { console.log(cfg.data); }
+     */
+    async settings() {
+        return this.call('settings');
+    }
+    /**
+     * Send an email through the email downstream service.
+     *
+     * @param to       Recipient email address
+     * @param subject  Email subject line
+     * @param text     Plain-text body
+     * @param html     Optional HTML body (falls back to `text` when omitted)
+     *
+     * @example
+     * await email.send('user@example.com', 'Welcome!', 'Thanks for joining.');
+     */
+    async send(to, subject, text, html) {
+        return this.call('send', {
+            method: 'POST',
+            body: { to, subject, text, html },
+        });
+    }
+}
+// Register this service so ApiGateway.connect('email') returns a JuxEmail instance.
+_registerServiceFactory('email', (gw) => new JuxEmail(gw));
+//# sourceMappingURL=email.js.map

package/dist/services/email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.js","sourceRoot":"","sources":["../../lib/services/email.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAc,UAAU,EAA6B,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEtH,MAAM,OAAO,QAAS,SAAQ,UAAU;IACpC,YAAY,OAAmB;QAC3B,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAC5B,CAAC;IAED;;;;;;;;;OASG;IACH,KAAK,CAAC,QAAQ;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACjC,CAAC;IAED;;;;;;;;;;OAUG;IACH,KAAK,CAAC,IAAI,CAAC,EAAU,EAAE,OAAe,EAAE,IAAY,EAAE,IAAa;QAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE;YACrB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE;SACpC,CAAC,CAAC;IACP,CAAC;CACJ;AAED,oFAAoF;AACpF,uBAAuB,CAAC,OAAO,EAAE,CAAC,EAAc,EAAE,EAAE,CAAC,IAAI,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/dist/services/s3.d.ts

@@ -0,0 +1,61 @@
+/**
+ * s3.ts — Jux object-storage service client
+ *
+ * JuxS3 establishes connectivity to the `storage` downstream service via the
+ * ApiGateway backend. It provides a domain-specific API for S3-compatible
+ * object storage; every method ultimately delegates to `this.call(path, options)`,
+ * which routes through the Jux Gateway transport layer.
+ *
+ * Usage in a .jux file:
+ *   const api   = await jux.gateway(username, password);
+ *   const store = api.connect('storage');
+ *
+ *   // Check connectivity
+ *   await store.health();
+ *
+ *   // Upload an object
+ *   await store.upload('avatars/user-1.png', imageBytes, 'image/png');
+ *
+ *   // Download an object
+ *   const file = await store.download('avatars/user-1.png');
+ *
+ *   // List objects under a prefix
+ *   const list = await store.list('avatars/');
+ *
+ *   // Remove an object
+ *   await store.remove('avatars/user-1.png');
+ */
+import { ApiGateway, JuxService, ApiResult, ApiCallOptions } from '../components/gateway.js';
+export declare class JuxS3 extends JuxService {
+    constructor(gateway: ApiGateway);
+    /** Verify connectivity to the storage downstream service. */
+    health(): Promise<ApiResult>;
+    /**
+     * Upload an object to storage.
+     *
+     * @param key          Object key (path within the bucket)
+     * @param data         Content to upload (string, object, or binary data)
+     * @param contentType  MIME type (default: 'application/octet-stream')
+     */
+    upload(key: string, data: any, contentType?: string): Promise<ApiResult>;
+    /**
+     * Download an object from storage.
+     *
+     * @param key  Object key to retrieve
+     */
+    download(key: string): Promise<ApiResult>;
+    /**
+     * Remove an object from storage.
+     *
+     * @param key  Object key to delete
+     */
+    remove(key: string): Promise<ApiResult>;
+    /**
+     * List objects in storage, optionally filtered by prefix.
+     *
+     * @param prefix  Optional key prefix to filter results
+     */
+    list(prefix?: string): Promise<ApiResult>;
+}
+export { ApiCallOptions, ApiResult };
+//# sourceMappingURL=s3.d.ts.map

package/dist/services/s3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.d.ts","sourceRoot":"","sources":["../../lib/services/s3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,cAAc,EAA2B,MAAM,0BAA0B,CAAC;AAEtH,qBAAa,KAAM,SAAQ,UAAU;gBACrB,OAAO,EAAE,UAAU;IAI/B,6DAA6D;IACvD,MAAM,IAAI,OAAO,CAAC,SAAS,CAAC;IAIlC;;;;;;OAMG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,WAAW,GAAE,MAAmC,GAAG,OAAO,CAAC,SAAS,CAAC;IAQ1G;;;;OAIG;IACG,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAI/C;;;;OAIG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAI7C;;;;OAIG;IACG,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;CAIlD;AAKD,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC"}

package/dist/services/s3.js

@@ -0,0 +1,79 @@
+/**
+ * s3.ts — Jux object-storage service client
+ *
+ * JuxS3 establishes connectivity to the `storage` downstream service via the
+ * ApiGateway backend. It provides a domain-specific API for S3-compatible
+ * object storage; every method ultimately delegates to `this.call(path, options)`,
+ * which routes through the Jux Gateway transport layer.
+ *
+ * Usage in a .jux file:
+ *   const api   = await jux.gateway(username, password);
+ *   const store = api.connect('storage');
+ *
+ *   // Check connectivity
+ *   await store.health();
+ *
+ *   // Upload an object
+ *   await store.upload('avatars/user-1.png', imageBytes, 'image/png');
+ *
+ *   // Download an object
+ *   const file = await store.download('avatars/user-1.png');
+ *
+ *   // List objects under a prefix
+ *   const list = await store.list('avatars/');
+ *
+ *   // Remove an object
+ *   await store.remove('avatars/user-1.png');
+ */
+import { JuxService, _registerServiceFactory } from '../components/gateway.js';
+export class JuxS3 extends JuxService {
+    constructor(gateway) {
+        super(gateway, 'storage');
+    }
+    /** Verify connectivity to the storage downstream service. */
+    async health() {
+        return this.call('health');
+    }
+    /**
+     * Upload an object to storage.
+     *
+     * @param key          Object key (path within the bucket)
+     * @param data         Content to upload (string, object, or binary data)
+     * @param contentType  MIME type (default: 'application/octet-stream')
+     */
+    async upload(key, data, contentType = 'application/octet-stream') {
+        return this.call(`upload/${encodeURIComponent(key)}`, {
+            method: 'POST',
+            body: data,
+            headers: { 'Content-Type': contentType },
+        });
+    }
+    /**
+     * Download an object from storage.
+     *
+     * @param key  Object key to retrieve
+     */
+    async download(key) {
+        return this.call(`download/${encodeURIComponent(key)}`);
+    }
+    /**
+     * Remove an object from storage.
+     *
+     * @param key  Object key to delete
+     */
+    async remove(key) {
+        return this.call(`delete/${encodeURIComponent(key)}`, { method: 'DELETE' });
+    }
+    /**
+     * List objects in storage, optionally filtered by prefix.
+     *
+     * @param prefix  Optional key prefix to filter results
+     */
+    async list(prefix) {
+        const path = prefix ? `list/${encodeURIComponent(prefix)}` : 'list';
+        return this.call(path);
+    }
+}
+// Register this service so ApiGateway.connect('storage') returns a JuxS3 instance.
+_registerServiceFactory('storage', (gw) => new JuxS3(gw));
+//# sourceMappingURL=s3.js.map

package/dist/services/s3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"s3.js","sourceRoot":"","sources":["../../lib/services/s3.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,EAAc,UAAU,EAA6B,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AAEtH,MAAM,OAAO,KAAM,SAAQ,UAAU;IACjC,YAAY,OAAmB;QAC3B,KAAK,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC9B,CAAC;IAED,6DAA6D;IAC7D,KAAK,CAAC,MAAM;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC/B,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,MAAM,CAAC,GAAW,EAAE,IAAS,EAAE,cAAsB,0BAA0B;QACjF,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE;YAClD,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE;SAC3C,CAAC,CAAC;IACP,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CAAC,GAAW;QACtB,OAAO,IAAI,CAAC,IAAI,CAAC,YAAY,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM,CAAC,GAAW;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,kBAAkB,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IAChF,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,MAAe;QACtB,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;QACpE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;CACJ;AAED,mFAAmF;AACnF,uBAAuB,CAAC,SAAS,EAAE,CAAC,EAAc,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC"}

package/juxconfig.example.js

@@ -18,6 +18,13 @@ export const config = {
         wsPort: 3001,
     },
 
+    // Jux Proxy connection — URL is injected as __JUX_PROXY_URL__ at build time.
+    // Set this to your deployed Jux Proxy server URL.
+    // Leave empty ('') to use the same origin as the app (default).
+    proxy: {
+        url: '',
+    },
+
     // Precompile: bootstrap .jux files that run before routing.
     // These render into sibling containers of #app at boot time.
     // For CSS/JS injection, use jux.include() inside your .jux files.

package/machinery/build3.js

@@ -76,7 +76,8 @@ const compiler = new JuxCompiler({
     publicDir: directories.public,
     defaults,
     paths,
-    precompile
+    precompile,
+    proxy: rawConfig.proxy || {},
 });
 
 compiler.build()

package/machinery/compiler4.js

@@ -434,6 +434,8 @@ export class JuxCompiler {
         this._validationIssues = [];
 
         entry += `\nwindow.__juxSources = ${JSON.stringify(sourceSnapshot)};\n`;
+        const proxyUrl = this.config.proxy?.url ?? '';
+        entry += `window.__JUX_PROXY_URL__ = ${JSON.stringify(proxyUrl)};\n`;
 
         entry += `\n// --- STARTUP ---\n`;
         entry += `window.addEventListener('DOMContentLoaded', async () => {\n`;

package/machinery/serve.js

@@ -65,6 +65,8 @@ const precompile = {
   juxfiles: rawConfig.precompile?.juxfiles || [],
 };
 
+const proxy = rawConfig.proxy || {};
+
 const app = express();
 let lastBuildResult = { success: true, errors: [] };
 
@@ -77,7 +79,8 @@ if (!fs.existsSync(DIST_DIR) || !fs.existsSync(path.join(DIST_DIR, 'index.html')
     distDir: DIST_DIR,
     publicDir: directories.public,
     paths,
-    precompile
+    precompile,
+    proxy
   });
 
   try {
@@ -145,30 +148,6 @@ app.get('/__jux_sources.json', (req, res) => {
   }
 });
 
-// ═══════════════════════════════════════════════════════════════
-// API ROUTES — must come BEFORE static middleware and catch-all
-// ═══════════════════════════════════════════════════════════════
-app.get('/api/test', (req, res) => {
-  const fruits = ['apple', 'banana', 'orange', 'mango', 'strawberry', 'grape', 'watermelon', 'pineapple', 'kiwi', 'peach'];
-  const randomFruit = fruits[Math.floor(Math.random() * fruits.length)];
-
-  res.json({
-    randomFruit,
-    growers: [
-      { id: 1, name: 'Berry Bliss Farm', region: 'Pacific Northwest', specialty: 'blueberry' },
-      { id: 2, name: 'Tropical Sun Orchard', region: 'Hawaii', specialty: 'mango' },
-      { id: 3, name: 'Bramble & Vine', region: 'Willamette Valley', specialty: 'raspberry' }
-    ],
-    harvests: [
-      { id: 1, fruit: 'blueberry', lbs: 1200, growerId: 1, season: 'summer' },
-      { id: 2, fruit: 'raspberry', lbs: 800, growerId: 3, season: 'summer' },
-      { id: 3, fruit: 'mango', lbs: 2400, growerId: 2, season: 'spring' },
-      { id: 4, fruit: 'strawberry', lbs: 1600, growerId: 1, season: 'spring' }
-    ],
-    timestamp: new Date().toISOString()
-  });
-});
-
 const hotReloadScript = `
 <script>
 (function() {
@@ -284,7 +263,8 @@ if (HOT_RELOAD) {
     distDir: DIST_DIR,
     publicDir: directories.public,
     paths,
-    precompile
+    precompile,
+    proxy
   });
 
   watcher = createWatcher(SRC_DIR, {

package/machinery/validate-jux.js

@@ -99,6 +99,10 @@ export function validateJuxFiles(juxDir, packageRoot) {
             if (['if', 'for', 'while', 'switch', 'catch', 'return', 'throw', 'new', 'delete', 'typeof', 'void'].includes(name)) continue;
             methods.add(name);
         }
+        // Also match async methods: "    async methodName("
+        for (const m of source.matchAll(/^\s{4}async\s+(\w+)\s*\(/gm)) {
+            if (m[1] !== 'constructor' && !m[1].startsWith('_')) methods.add(m[1]);
+        }
         for (const m of source.matchAll(/^\s{4}get\s+(\w+)\s*\(/gm)) {
             methods.add(m[1]);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "juxscript",
-  "version": "1.1.393",
+  "version": "1.1.395",
   "type": "module",
   "description": "A JavaScript UX authorship platform",
   "main": "./dist/index.js",
@@ -24,7 +24,7 @@
     "dom-structure-map.json",
     "bin",
     "create",
-    "presets",
+    "components",
     "machinery",
     "juxconfig.example.js",
     "README.md",