@plasius/ai 1.1.9 → 1.1.11

package/CHANGELOG.md

@@ -40,6 +40,7 @@ The format is based on **[Keep a Changelog](https://keepachangelog.com/en/1.1.0/
   - Removed provider-specific identifiers from code roots to enforce public package boundaries.
 
 - **Fixed**
+  - Enforced CommonJS runtime compatibility for dual-build output by generating and validating `dist-cjs/package.json` (`type: commonjs`) during build and package verification.
   - `pack:check` now passes vendor-namespace checks for `src/**` by using generic provider naming in runtime/editor code.
 
 - **Security**

package/README.md

@@ -27,6 +27,12 @@ Provider wiring and runtime adapters are documented in [`docs/providers.md`](./d
 npm install @plasius/ai
 ```
 
+## Module formats
+
+This package publishes dual ESM and CJS artifacts.
+When CJS output is emitted under `dist-cjs/*.js` with `type: module`, `dist-cjs/package.json` is generated with `{ "type": "commonjs" }` to ensure Node `require(...)` compatibility.
+
+
 ## Usage
 
 ```ts

package/dist/components/pixelverse/pixelverseeditor.d.ts

@@ -0,0 +1,16 @@
+interface PixelverseEditorProps {
+    apiKey: string;
+    onVideoGenerated?: (videoUrl: string) => void;
+    onImageUpload?: (imageUrl: string) => void;
+    prompt?: string;
+    onPromptChange?: (prompt: string) => void;
+    negative_prompt?: string;
+    onNegativePromptChange?: (negative_prompt: string) => void;
+    template_id?: string;
+    onTemplateIdChange?: (template_id: string) => void;
+    seed?: number;
+    onSeedChange?: (seed: number) => void;
+}
+export declare function PixelverseEditor({ apiKey, onVideoGenerated, prompt, negative_prompt, template_id, seed, }: PixelverseEditorProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=pixelverseeditor.d.ts.map

package/dist/components/pixelverse/pixelverseeditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixelverseeditor.d.ts","sourceRoot":"","sources":["../../../src/components/pixelverse/pixelverseeditor.tsx"],"names":[],"mappings":"AAKA,UAAU,qBAAqB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB,CAAC,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,gBAAgB,EAChB,MAAM,EACN,eAAe,EACf,WAAW,EACX,IAAI,GACL,EAAE,qBAAqB,2CA+CvB"}

package/dist/components/pixelverse/pixelverseeditor.js

@@ -0,0 +1,21 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+import Balance from "./balance.js";
+export function PixelverseEditor({ apiKey, onVideoGenerated, prompt, negative_prompt, template_id, seed, }) {
+    const [videoUrl, setVideoUrl] = useState("");
+    const [videoId, setVideoId] = useState(null);
+    const [selectedFile, setSelectedFile] = useState(null);
+    const [loading, setLoading] = useState(false);
+    const [videoStatus, setVideoStatus] = useState(0);
+    const handleFileChange = (e) => {
+        if (e.target.files?.[0]) {
+            setSelectedFile(e.target.files[0]);
+            handleUploadProcess();
+        }
+    };
+    const handleRegenerate = () => {
+    };
+    const handleUploadProcess = async () => {
+    };
+    return (_jsxs("div", { children: [_jsx(Balance, { apiKey: apiKey }), videoStatus === 0 && !selectedFile && (_jsxs("div", { children: [_jsx("p", { children: "Drag/Drop or Click HERE to upload" }), _jsx("input", { title: "Upload Image", type: "file", accept: ".jpg,.jpeg,.png,.webp", onChange: handleFileChange })] })), loading && _jsx("div", { children: "Loading..." }), videoStatus === 0 && selectedFile && (_jsx("button", { onClick: handleUploadProcess, children: "Start Upload" })), videoStatus === 1 && (_jsxs("div", { children: [_jsx("video", { src: videoUrl, controls: true }), _jsx("button", { onClick: handleRegenerate, children: "Regenerate" })] }))] }));
+}

package/dist/platform/openai.d.ts

@@ -0,0 +1,8 @@
+import type { AIPlatform } from "./index.js";
+export interface OpenAIPlatformProps {
+    openaiAPIKey: string;
+    openaiProjectKey?: string;
+    openaiOrgID?: string;
+}
+export declare function OpenAIPlatform(userId: string, props: OpenAIPlatformProps): Promise<AIPlatform>;
+//# sourceMappingURL=openai.d.ts.map

package/dist/platform/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/platform/openai.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EAGX,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAmBD,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,UAAU,CAAC,CAsCrB"}

package/dist/platform/openai.js

@@ -0,0 +1,43 @@
+import OpenAI from "openai";
+function createCompletionData(type, model, requestor, durationMs) {
+    return {
+        partitionKey: requestor,
+        id: crypto.randomUUID(),
+        type,
+        model,
+        createdAt: new Date().toISOString(),
+        durationMs,
+        usage: {},
+    };
+}
+export async function OpenAIPlatform(userId, props) {
+    const apiKey = props.openaiAPIKey.trim();
+    if (!apiKey) {
+        throw new Error("openaiAPIKey is required.");
+    }
+    const openai = new OpenAI({
+        apiKey,
+        project: props.openaiProjectKey?.trim() || undefined,
+        organization: props.openaiOrgID?.trim() || undefined,
+        dangerouslyAllowBrowser: false,
+    });
+    void openai;
+    const notImplemented = (operation) => {
+        return Promise.reject(new Error(`OpenAIPlatform "${operation}" is not implemented yet.`));
+    };
+    const checkBalance = async (requestorId) => {
+        const base = createCompletionData("balanceCompletion", "", requestorId, 0);
+        return Promise.resolve({ ...base, balance: 0.0 });
+    };
+    const currentBalance = (await checkBalance(userId)).balance;
+    return {
+        chatWithAI: async () => notImplemented("chatWithAI"),
+        synthesizeSpeech: async () => notImplemented("synthesizeSpeech"),
+        transcribeSpeech: async () => notImplemented("transcribeSpeech"),
+        generateImage: async () => notImplemented("generateImage"),
+        produceVideo: async () => notImplemented("produceVideo"),
+        generateModel: async () => notImplemented("generateModel"),
+        checkBalance,
+        currentBalance,
+    };
+}

package/dist/platform/pixelverse.d.ts

@@ -0,0 +1,6 @@
+import type { AIPlatform } from "./index.js";
+export interface PixelVersePlatformProps {
+    pixelVerseAPIKey: string;
+}
+export declare function PixelVersePlatform(userId: string, props: PixelVersePlatformProps): Promise<AIPlatform>;
+//# sourceMappingURL=pixelverse.d.ts.map

package/dist/platform/pixelverse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixelverse.d.ts","sourceRoot":"","sources":["../../src/platform/pixelverse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EAQX,MAAM,YAAY,CAAC;AAmBpB,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,UAAU,CAAC,CA8QrB"}

package/dist/platform/pixelverse.js

@@ -0,0 +1,196 @@
+import { v4 as uuidv4 } from "uuid";
+import { performance } from "perf_hooks";
+import { useState } from "react";
+export async function PixelVersePlatform(userId, props) {
+    async function uploadImage(image, apiKey) {
+        const headers = new Headers();
+        headers.append("API-KEY", apiKey);
+        headers.append("Ai-trace-id", uuidv4());
+        headers.append("Access-Control-Allow-Origin", "*");
+        const formData = new FormData();
+        if (image instanceof File) {
+            formData.append("image", image, "");
+        }
+        else {
+            const blob = await fetch(image.toString()).then((r) => r.blob());
+            formData.append("image", blob, "image-from-url");
+        }
+        // pixelapi is proxied through the vite.config.ts file
+        // to avoid CORS issues and to allow for local development
+        const response = await fetch("/pixelapi/openapi/v2/image/upload", {
+            method: "POST",
+            headers,
+            body: formData,
+            redirect: "follow",
+        });
+        const data = (await response.json());
+        return data;
+    }
+    async function generateVideo(imgId, prompt, apiKey, seed, template_id, negative_prompt) {
+        const headers = new Headers();
+        headers.append("API-KEY", apiKey);
+        headers.append("Ai-trace-id", uuidv4());
+        headers.append("Content-Type", "application/json");
+        headers.append("Access-Control-Allow-Origin", "*");
+        headers.append("Accept", "application/json");
+        const values = {
+            duration: 5,
+            img_id: imgId,
+            model: "v3.5",
+            motion_mode: "normal",
+            prompt: prompt,
+            quality: "720p",
+            water_mark: false,
+        };
+        if (seed) {
+            values.seed = seed;
+        }
+        if (template_id) {
+            values.template_id = template_id;
+        }
+        if (negative_prompt) {
+            values.negative_prompt = negative_prompt;
+        }
+        const body = JSON.stringify(values);
+        // pixelapi is proxied through the vite.config.ts file
+        // to avoid CORS issues and to allow for local development
+        const response = await fetch("/pixelapi/openapi/v2/video/img/generate", {
+            method: "POST",
+            headers: headers,
+            referrerPolicy: "no-referrer",
+            body,
+        });
+        const data = (await response.json());
+        return data;
+    }
+    async function checkVideoStatus(id, apiKey) {
+        const headers = new Headers();
+        headers.append("API-KEY", apiKey);
+        headers.append("Ai-trace-id", uuidv4());
+        headers.append("Access-Control-Allow-Origin", "*");
+        headers.append("Accept", "application/json");
+        // pixelapi is proxied through the vite.config.ts file
+        // to avoid CORS issues and to allow for local development
+        const response = await fetch(`/pixelapi/openapi/v2/video/result/${id}`, {
+            method: "GET",
+            headers,
+            referrerPolicy: "no-referrer",
+        });
+        const data = (await response.json());
+        return data;
+    }
+    function baseCompletionData(type, model, requestor, duration) {
+        return {
+            partitionKey: requestor,
+            id: crypto.randomUUID(),
+            type,
+            model,
+            createdAt: new Date().toISOString(),
+            durationMs: duration,
+            usage: {},
+        };
+    }
+    const chatWithAI = (_userId, _input, _context, _model) => {
+        void [_userId, _input, _context, _model];
+        return Promise.reject(new Error("Not implemented"));
+    };
+    const synthesizeSpeech = (_userId, _input, _voice, _context, _model) => {
+        void [_userId, _input, _voice, _context, _model];
+        return Promise.reject(new Error("Not implemented"));
+    };
+    const transcribeSpeech = (_userId, _input, _context, _model) => {
+        void [_userId, _input, _context, _model];
+        return Promise.reject(new Error("Not implemented"));
+    };
+    const generateImage = (_userId, _input, _context, _model) => {
+        void [_userId, _input, _context, _model];
+        return Promise.reject(new Error("Not implemented"));
+    };
+    const produceVideo = (userId, input, image, context, model) => {
+        const start = performance.now();
+        return uploadImage(image, props.pixelVerseAPIKey)
+            .then((uploadResult) => {
+            const imageId = uploadResult?.Resp?.id;
+            if (!imageId)
+                throw new Error("Invalid image upload response.");
+            return generateVideo(imageId, input, props.pixelVerseAPIKey);
+        })
+            .then((generated) => {
+            const videoId = generated?.Resp?.id;
+            if (!videoId)
+                throw new Error("Video generation did not return a valid ID.");
+            return waitForVideoCompletion(videoId, props.pixelVerseAPIKey);
+        })
+            .then((videoUrl) => {
+            const duration = performance.now() - start;
+            const base = baseCompletionData("video", model, userId, duration);
+            return {
+                ...base,
+                url: new URL(videoUrl),
+            };
+        })
+            .catch((err) => {
+            // Optional: log or re-throw error for upstream handling
+            throw new Error(`produceVideo failed: ${err.message}`);
+        });
+    };
+    async function waitForVideoCompletion(videoId, apiKey, maxRetries = 20, delayMs = 3000) {
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            await new Promise((res) => setTimeout(res, delayMs));
+            try {
+                const videoCheck = await checkVideoStatus(videoId, apiKey);
+                if (videoCheck?.Resp?.status === 1) {
+                    const url = videoCheck?.Resp?.url;
+                    if (!url)
+                        throw new Error("Video marked complete but no URL returned.");
+                    return url;
+                }
+            }
+            catch (err) {
+                console.warn(`Attempt ${attempt + 1} failed: ${err.message}`);
+            }
+        }
+        throw new Error("Timed out waiting for video to complete.");
+    }
+    const checkBalance = (userId) => {
+        const start = performance.now();
+        const headers = new Headers();
+        headers.append("API-KEY", props.pixelVerseAPIKey);
+        headers.append("AI-trace-ID", uuidv4());
+        headers.append("Access-Control-Allow-Origin", "*");
+        headers.append("Accept", "application/json");
+        headers.append("Content-Type", "application/json");
+        return fetch("/pixelapi/openapi/v2/account/balance", {
+            method: "GET",
+            headers,
+            referrerPolicy: "no-referrer",
+        })
+            .then(async (res) => (await res.json()))
+            .then((data) => {
+            if (!data?.Resp) {
+                throw new Error("Invalid balance response");
+            }
+            const duration = performance.now() - start;
+            const base = baseCompletionData("balanceCompletion", "", userId, duration);
+            const monthly = data.Resp.credit_monthly ?? 0;
+            const pkg = data.Resp.credit_package ?? 0;
+            return {
+                ...base,
+                balance: monthly + pkg,
+            };
+        })
+            .catch((err) => {
+            throw new Error(`checkBalance failed: ${err.message}`);
+        });
+    };
+    const [currentBalance] = useState((await checkBalance(userId)).balance ?? 0);
+    return {
+        chatWithAI,
+        synthesizeSpeech,
+        transcribeSpeech,
+        generateImage,
+        produceVideo,
+        checkBalance,
+        currentBalance,
+    };
+}

package/dist-cjs/components/pixelverse/pixelverseeditor.d.ts

@@ -0,0 +1,16 @@
+interface PixelverseEditorProps {
+    apiKey: string;
+    onVideoGenerated?: (videoUrl: string) => void;
+    onImageUpload?: (imageUrl: string) => void;
+    prompt?: string;
+    onPromptChange?: (prompt: string) => void;
+    negative_prompt?: string;
+    onNegativePromptChange?: (negative_prompt: string) => void;
+    template_id?: string;
+    onTemplateIdChange?: (template_id: string) => void;
+    seed?: number;
+    onSeedChange?: (seed: number) => void;
+}
+export declare function PixelverseEditor({ apiKey, onVideoGenerated, prompt, negative_prompt, template_id, seed, }: PixelverseEditorProps): import("react/jsx-runtime").JSX.Element;
+export {};
+//# sourceMappingURL=pixelverseeditor.d.ts.map

package/dist-cjs/components/pixelverse/pixelverseeditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixelverseeditor.d.ts","sourceRoot":"","sources":["../../../src/components/pixelverse/pixelverseeditor.tsx"],"names":[],"mappings":"AAKA,UAAU,qBAAqB;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB,CAAC,EAAE,CAAC,eAAe,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC;AAED,wBAAgB,gBAAgB,CAAC,EAC/B,MAAM,EACN,gBAAgB,EAChB,MAAM,EACN,eAAe,EACf,WAAW,EACX,IAAI,GACL,EAAE,qBAAqB,2CA+CvB"}

package/dist-cjs/components/pixelverse/pixelverseeditor.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PixelverseEditor = PixelverseEditor;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+const balance_js_1 = __importDefault(require("./balance.js"));
+function PixelverseEditor({ apiKey, onVideoGenerated, prompt, negative_prompt, template_id, seed, }) {
+    const [videoUrl, setVideoUrl] = (0, react_1.useState)("");
+    const [videoId, setVideoId] = (0, react_1.useState)(null);
+    const [selectedFile, setSelectedFile] = (0, react_1.useState)(null);
+    const [loading, setLoading] = (0, react_1.useState)(false);
+    const [videoStatus, setVideoStatus] = (0, react_1.useState)(0);
+    const handleFileChange = (e) => {
+        if (e.target.files?.[0]) {
+            setSelectedFile(e.target.files[0]);
+            handleUploadProcess();
+        }
+    };
+    const handleRegenerate = () => {
+    };
+    const handleUploadProcess = async () => {
+    };
+    return ((0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)(balance_js_1.default, { apiKey: apiKey }), videoStatus === 0 && !selectedFile && ((0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("p", { children: "Drag/Drop or Click HERE to upload" }), (0, jsx_runtime_1.jsx)("input", { title: "Upload Image", type: "file", accept: ".jpg,.jpeg,.png,.webp", onChange: handleFileChange })] })), loading && (0, jsx_runtime_1.jsx)("div", { children: "Loading..." }), videoStatus === 0 && selectedFile && ((0, jsx_runtime_1.jsx)("button", { onClick: handleUploadProcess, children: "Start Upload" })), videoStatus === 1 && ((0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("video", { src: videoUrl, controls: true }), (0, jsx_runtime_1.jsx)("button", { onClick: handleRegenerate, children: "Regenerate" })] }))] }));
+}

package/dist-cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist-cjs/platform/openai.d.ts

@@ -0,0 +1,8 @@
+import type { AIPlatform } from "./index.js";
+export interface OpenAIPlatformProps {
+    openaiAPIKey: string;
+    openaiProjectKey?: string;
+    openaiOrgID?: string;
+}
+export declare function OpenAIPlatform(userId: string, props: OpenAIPlatformProps): Promise<AIPlatform>;
+//# sourceMappingURL=openai.d.ts.map

package/dist-cjs/platform/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/platform/openai.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,UAAU,EAGX,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAmBD,wBAAsB,cAAc,CAClC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,UAAU,CAAC,CAsCrB"}

package/dist-cjs/platform/openai.js

@@ -0,0 +1,49 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OpenAIPlatform = OpenAIPlatform;
+const openai_1 = __importDefault(require("openai"));
+function createCompletionData(type, model, requestor, durationMs) {
+    return {
+        partitionKey: requestor,
+        id: crypto.randomUUID(),
+        type,
+        model,
+        createdAt: new Date().toISOString(),
+        durationMs,
+        usage: {},
+    };
+}
+async function OpenAIPlatform(userId, props) {
+    const apiKey = props.openaiAPIKey.trim();
+    if (!apiKey) {
+        throw new Error("openaiAPIKey is required.");
+    }
+    const openai = new openai_1.default({
+        apiKey,
+        project: props.openaiProjectKey?.trim() || undefined,
+        organization: props.openaiOrgID?.trim() || undefined,
+        dangerouslyAllowBrowser: false,
+    });
+    void openai;
+    const notImplemented = (operation) => {
+        return Promise.reject(new Error(`OpenAIPlatform "${operation}" is not implemented yet.`));
+    };
+    const checkBalance = async (requestorId) => {
+        const base = createCompletionData("balanceCompletion", "", requestorId, 0);
+        return Promise.resolve({ ...base, balance: 0.0 });
+    };
+    const currentBalance = (await checkBalance(userId)).balance;
+    return {
+        chatWithAI: async () => notImplemented("chatWithAI"),
+        synthesizeSpeech: async () => notImplemented("synthesizeSpeech"),
+        transcribeSpeech: async () => notImplemented("transcribeSpeech"),
+        generateImage: async () => notImplemented("generateImage"),
+        produceVideo: async () => notImplemented("produceVideo"),
+        generateModel: async () => notImplemented("generateModel"),
+        checkBalance,
+        currentBalance,
+    };
+}

package/dist-cjs/platform/pixelverse.d.ts

@@ -0,0 +1,6 @@
+import type { AIPlatform } from "./index.js";
+export interface PixelVersePlatformProps {
+    pixelVerseAPIKey: string;
+}
+export declare function PixelVersePlatform(userId: string, props: PixelVersePlatformProps): Promise<AIPlatform>;
+//# sourceMappingURL=pixelverse.d.ts.map

package/dist-cjs/platform/pixelverse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pixelverse.d.ts","sourceRoot":"","sources":["../../src/platform/pixelverse.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,UAAU,EAQX,MAAM,YAAY,CAAC;AAmBpB,MAAM,WAAW,uBAAuB;IACtC,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,uBAAuB,GAC7B,OAAO,CAAC,UAAU,CAAC,CA8QrB"}

package/dist-cjs/platform/pixelverse.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PixelVersePlatform = PixelVersePlatform;
+const uuid_1 = require("uuid");
+const perf_hooks_1 = require("perf_hooks");
+const react_1 = require("react");
+async function PixelVersePlatform(userId, props) {
+    async function uploadImage(image, apiKey) {
+        const headers = new Headers();
+        headers.append("API-KEY", apiKey);
+        headers.append("Ai-trace-id", (0, uuid_1.v4)());
+        headers.append("Access-Control-Allow-Origin", "*");
+        const formData = new FormData();
+        if (image instanceof File) {
+            formData.append("image", image, "");
+        }
+        else {
+            const blob = await fetch(image.toString()).then((r) => r.blob());
+            formData.append("image", blob, "image-from-url");
+        }
+        // pixelapi is proxied through the vite.config.ts file
+        // to avoid CORS issues and to allow for local development
+        const response = await fetch("/pixelapi/openapi/v2/image/upload", {
+            method: "POST",
+            headers,
+            body: formData,
+            redirect: "follow",
+        });
+        const data = (await response.json());
+        return data;
+    }
+    async function generateVideo(imgId, prompt, apiKey, seed, template_id, negative_prompt) {
+        const headers = new Headers();
+        headers.append("API-KEY", apiKey);
+        headers.append("Ai-trace-id", (0, uuid_1.v4)());
+        headers.append("Content-Type", "application/json");
+        headers.append("Access-Control-Allow-Origin", "*");
+        headers.append("Accept", "application/json");
+        const values = {
+            duration: 5,
+            img_id: imgId,
+            model: "v3.5",
+            motion_mode: "normal",
+            prompt: prompt,
+            quality: "720p",
+            water_mark: false,
+        };
+        if (seed) {
+            values.seed = seed;
+        }
+        if (template_id) {
+            values.template_id = template_id;
+        }
+        if (negative_prompt) {
+            values.negative_prompt = negative_prompt;
+        }
+        const body = JSON.stringify(values);
+        // pixelapi is proxied through the vite.config.ts file
+        // to avoid CORS issues and to allow for local development
+        const response = await fetch("/pixelapi/openapi/v2/video/img/generate", {
+            method: "POST",
+            headers: headers,
+            referrerPolicy: "no-referrer",
+            body,
+        });
+        const data = (await response.json());
+        return data;
+    }
+    async function checkVideoStatus(id, apiKey) {
+        const headers = new Headers();
+        headers.append("API-KEY", apiKey);
+        headers.append("Ai-trace-id", (0, uuid_1.v4)());
+        headers.append("Access-Control-Allow-Origin", "*");
+        headers.append("Accept", "application/json");
+        // pixelapi is proxied through the vite.config.ts file
+        // to avoid CORS issues and to allow for local development
+        const response = await fetch(`/pixelapi/openapi/v2/video/result/${id}`, {
+            method: "GET",
+            headers,
+            referrerPolicy: "no-referrer",
+        });
+        const data = (await response.json());
+        return data;
+    }
+    function baseCompletionData(type, model, requestor, duration) {
+        return {
+            partitionKey: requestor,
+            id: crypto.randomUUID(),
+            type,
+            model,
+            createdAt: new Date().toISOString(),
+            durationMs: duration,
+            usage: {},
+        };
+    }
+    const chatWithAI = (_userId, _input, _context, _model) => {
+        void [_userId, _input, _context, _model];
+        return Promise.reject(new Error("Not implemented"));
+    };
+    const synthesizeSpeech = (_userId, _input, _voice, _context, _model) => {
+        void [_userId, _input, _voice, _context, _model];
+        return Promise.reject(new Error("Not implemented"));
+    };
+    const transcribeSpeech = (_userId, _input, _context, _model) => {
+        void [_userId, _input, _context, _model];
+        return Promise.reject(new Error("Not implemented"));
+    };
+    const generateImage = (_userId, _input, _context, _model) => {
+        void [_userId, _input, _context, _model];
+        return Promise.reject(new Error("Not implemented"));
+    };
+    const produceVideo = (userId, input, image, context, model) => {
+        const start = perf_hooks_1.performance.now();
+        return uploadImage(image, props.pixelVerseAPIKey)
+            .then((uploadResult) => {
+            const imageId = uploadResult?.Resp?.id;
+            if (!imageId)
+                throw new Error("Invalid image upload response.");
+            return generateVideo(imageId, input, props.pixelVerseAPIKey);
+        })
+            .then((generated) => {
+            const videoId = generated?.Resp?.id;
+            if (!videoId)
+                throw new Error("Video generation did not return a valid ID.");
+            return waitForVideoCompletion(videoId, props.pixelVerseAPIKey);
+        })
+            .then((videoUrl) => {
+            const duration = perf_hooks_1.performance.now() - start;
+            const base = baseCompletionData("video", model, userId, duration);
+            return {
+                ...base,
+                url: new URL(videoUrl),
+            };
+        })
+            .catch((err) => {
+            // Optional: log or re-throw error for upstream handling
+            throw new Error(`produceVideo failed: ${err.message}`);
+        });
+    };
+    async function waitForVideoCompletion(videoId, apiKey, maxRetries = 20, delayMs = 3000) {
+        for (let attempt = 0; attempt < maxRetries; attempt++) {
+            await new Promise((res) => setTimeout(res, delayMs));
+            try {
+                const videoCheck = await checkVideoStatus(videoId, apiKey);
+                if (videoCheck?.Resp?.status === 1) {
+                    const url = videoCheck?.Resp?.url;
+                    if (!url)
+                        throw new Error("Video marked complete but no URL returned.");
+                    return url;
+                }
+            }
+            catch (err) {
+                console.warn(`Attempt ${attempt + 1} failed: ${err.message}`);
+            }
+        }
+        throw new Error("Timed out waiting for video to complete.");
+    }
+    const checkBalance = (userId) => {
+        const start = perf_hooks_1.performance.now();
+        const headers = new Headers();
+        headers.append("API-KEY", props.pixelVerseAPIKey);
+        headers.append("AI-trace-ID", (0, uuid_1.v4)());
+        headers.append("Access-Control-Allow-Origin", "*");
+        headers.append("Accept", "application/json");
+        headers.append("Content-Type", "application/json");
+        return fetch("/pixelapi/openapi/v2/account/balance", {
+            method: "GET",
+            headers,
+            referrerPolicy: "no-referrer",
+        })
+            .then(async (res) => (await res.json()))
+            .then((data) => {
+            if (!data?.Resp) {
+                throw new Error("Invalid balance response");
+            }
+            const duration = perf_hooks_1.performance.now() - start;
+            const base = baseCompletionData("balanceCompletion", "", userId, duration);
+            const monthly = data.Resp.credit_monthly ?? 0;
+            const pkg = data.Resp.credit_package ?? 0;
+            return {
+                ...base,
+                balance: monthly + pkg,
+            };
+        })
+            .catch((err) => {
+            throw new Error(`checkBalance failed: ${err.message}`);
+        });
+    };
+    const [currentBalance] = (0, react_1.useState)((await checkBalance(userId)).balance ?? 0);
+    return {
+        chatWithAI,
+        synthesizeSpeech,
+        transcribeSpeech,
+        generateImage,
+        produceVideo,
+        checkBalance,
+        currentBalance,
+    };
+}

package/docs/adrs/adr-0004-dual-esm-cjs-runtime-compatibility.md

@@ -0,0 +1,22 @@
+# ADR-0004: Dual ESM and CJS Runtime Compatibility
+
+- Date: 2026-03-01
+- Status: Accepted
+
+## Context
+
+`@plasius/ai` publishes dual ESM and CJS entry points. This package currently emits CJS output under `dist-cjs/*.js` while the repository root uses `type: module`. Without an explicit CommonJS boundary for `dist-cjs`, Node can interpret those files as ESM and fail at runtime for `require(...)` consumers.
+
+## Decision
+
+Keep dual output and enforce a runtime-compatible CJS boundary by:
+
+- generating `dist-cjs/package.json` with `{ "type": "commonjs" }` as part of `build:cjs`;
+- validating this metadata in `pack:check`;
+- ensuring the packed artifact includes `dist-cjs/package.json`.
+
+## Consequences
+
+- Node CommonJS consumers can reliably load `@plasius/ai` via `require(...)`.
+- ESM consumers remain unchanged.
+- CD publish checks fail fast if CJS runtime compatibility metadata is missing.

package/docs/adrs/index.md

@@ -3,3 +3,4 @@
 - [ADR-0001: Standalone @plasius/ai Package Scope](./adr-0001-ai-package-scope.md)
 - [ADR-0002: Public Repository Governance Baseline](./adr-0002-public-repo-governance.md)
 - [ADR-0003: Contracts-First Documentation Baseline](./adr-0003-contracts-first-documentation.md)
+- [ADR-0004: Dual ESM and CJS Runtime Compatibility](./adr-0004-dual-esm-cjs-runtime-compatibility.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plasius/ai",
-  "version": "1.1.9",
+  "version": "1.1.11",
   "description": "Plasius AI functions providing chatbot, text-to-speech, speech-to-text, and AI-generated images and videos",
   "keywords": [
     "chatbot",
@@ -29,7 +29,7 @@
     "audit:npm": "npm audit --audit-level=high --omit=dev",
     "audit:test": "vitest run --coverage",
     "audit:all": "npm-run-all -l audit:ts audit:eslint audit:deps audit:npm audit:test",
-    "build:cjs": "tsc -p tsconfig.json --module commonjs --moduleResolution node --outDir dist-cjs --tsBuildInfoFile dist-cjs/tsconfig.tsbuildinfo",
+    "build:cjs": "tsc -p tsconfig.json --module commonjs --moduleResolution node --outDir dist-cjs --tsBuildInfoFile dist-cjs/tsconfig.tsbuildinfo && node scripts/write-cjs-package-json.cjs",
     "lint": "eslint . --max-warnings=0",
     "prepare": "npm run build",
     "demo:run": "npm run build && node demo/example.mjs",
@@ -40,8 +40,8 @@
   "license": "MIT",
   "dependencies": {
     "@plasius/entity-manager": "^1.0.6",
-    "@plasius/error": "^1.0.5",
-    "@plasius/profile": "^1.0.7",
+    "@plasius/error": "^1.0.6",
+    "@plasius/profile": "^1.0.9",
     "@plasius/schema": "^1.2.2"
   },
   "peerDependencies": {