oc-server 2.1.2 → 3.1.0

package/dist/Server.d.ts

@@ -43,6 +43,15 @@ interface ServerOptions<S extends boolean> {
      * @default false
      */
     stream?: S;
+    development?: {
+        /**
+         * If true, the server will log the browser console.
+         * Useful for AI agents to debug on the terminal.
+         *
+         * @default false
+         */
+        console?: boolean;
+    };
 }
 export declare class Server<E = {
     name: string;

package/dist/Server.js

@@ -1,6 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ServerError = exports.getSettings = exports.getInitialData = exports.Server = void 0;
+// Simple ANSI color utility function
+const styleText = (color, text) => {
+    const colors = {
+        gray: '\x1b[90m',
+        reset: '\x1b[0m',
+    };
+    return `${colors[color] || ''}${text}${colors.reset}`;
+};
 class Server {
     _options;
     _parameters = {};
@@ -38,6 +46,11 @@ class HandledServer {
         this._middleware = _middleware;
         this._parameters = _parameters;
         this._options = _options;
+        if (this._options.development?.console) {
+            this.actions['$$__oc__server___console__$$'] = (params) => {
+                console[params.level]?.(`${styleText('gray', '[browser]')} ${params.message}`);
+            };
+        }
     }
     action(name, action) {
         this.actions[name] = action;
@@ -67,7 +80,7 @@ class HandledServer {
             if (res && context.streamSymbol) {
                 res[context.streamSymbol] = stream;
             }
-            cb(null, res);
+            cb(null, res, { console: !!this._options.development?.console });
         };
     }
 }

package/dist/cli/server.js

@@ -45,7 +45,7 @@ function getDataProvider() {
         parametersSchema: backend.server?._parameters,
     };
 }
-function getBaseTemplate(appBlock) {
+function getBaseTemplate(appBlock, imports = {}) {
     const baseTemplate = `
 <!DOCTYPE html>
 <html>
@@ -60,6 +60,9 @@ function getBaseTemplate(appBlock) {
       margin: 0;
     }
     </style>
+    ${imports
+        ? `<script type="importmap">{"imports": ${JSON.stringify(imports)}}</script>`
+        : ''}
   </head>
   <body>
     <script src="/oc-client/client.js"></script>
@@ -69,7 +72,7 @@ function getBaseTemplate(appBlock) {
   `;
     return baseTemplate;
 }
-async function getHtmlTemplate(appBlock, filePath = 'index.html') {
+async function getHtmlTemplate(appBlock, imports = {}, filePath = 'index.html') {
     let template;
     try {
         template = node_fs_1.default.readFileSync(node_path_1.default.resolve(process.cwd(), filePath), 'utf-8');
@@ -90,7 +93,7 @@ async function getHtmlTemplate(appBlock, filePath = 'index.html') {
         })}</body>`);
     }
     catch (error) {
-        template = getBaseTemplate(appBlock);
+        template = getBaseTemplate(appBlock, imports);
     }
     return template;
 }
@@ -104,6 +107,11 @@ async function createServer({ template, port, }) {
         plugin.register.register(null, null, () => { });
     }
     const defaultParams = (0, oc_1.getDefaultParams)(pk.oc?.parameters ?? parametersSchema);
+    const baseConfig = await (0, vite_1.loadConfigFromFile)({
+        command: 'build',
+        mode: 'development',
+    }, undefined, process.cwd()).catch(() => null);
+    let imports = baseConfig?.config?.resolve?.alias;
     const vite = await (0, vite_1.createServer)({
         server: { middlewareMode: true },
         plugins: [(0, cssModulesPlugin_1.default)(), template.plugin?.()].filter(Boolean),
@@ -151,7 +159,9 @@ async function createServer({ template, port, }) {
         try {
             const params = defaultParams;
             const { context, responseHeaders } = (0, oc_1.getContext)(plugins, request, params);
-            let htmlTemplate = await getHtmlTemplate(template.appBlock);
+            let htmlTemplate = await getHtmlTemplate(template.appBlock, typeof imports === 'object' && !!imports
+                ? imports
+                : {});
             const data = await dataProvider(context);
             htmlTemplate = htmlTemplate.replace('__INITIAL_DATA__', JSON.stringify(data));
             htmlTemplate = await vite.transformIndexHtml(url, htmlTemplate);

package/dist/types.d.ts

@@ -2,6 +2,14 @@ export type Prettify<T> = {
     [K in keyof T]: T[K];
 } & {};
 type JsonPrimitive = string | number | boolean | null | undefined;
+type JsonObject = {
+    [key: string]: JsonPrimitive | JsonArray | JsonObject;
+};
+interface JsonArray extends Array<JsonPrimitive | JsonArray | JsonObject> {
+}
+interface JsonLike {
+    [key: string]: JsonPrimitive | JsonArray | JsonObject;
+}
 type CleanNeverProperties<T> = {
     [K in keyof T as T[K] extends never ? never : K]: T[K];
 };
@@ -28,6 +36,36 @@ export interface Template {
     version: string;
     externals: External[];
 }
+export interface CookieOptions {
+    /** Convenient option for setting the expiry time relative to the current time in **milliseconds**. */
+    maxAge?: number | undefined;
+    /** Indicates if the cookie should be signed. */
+    signed?: boolean | undefined;
+    /** Expiry date of the cookie in GMT. If not specified (undefined), creates a session cookie. */
+    expires?: Date | undefined;
+    /** Flags the cookie to be accessible only by the web server. */
+    httpOnly?: boolean | undefined;
+    /** Path for the cookie. Defaults to “/”. */
+    path?: string | undefined;
+    /** Domain name for the cookie. Defaults to the domain name of the app. */
+    domain?: string | undefined;
+    /** Marks the cookie to be used with HTTPS only. */
+    secure?: boolean | undefined;
+    /** A synchronous function used for cookie value encoding. Defaults to encodeURIComponent. */
+    encode?: ((val: string) => string) | undefined;
+    /**
+     * Value of the “SameSite” Set-Cookie attribute.
+     * @link https://tools.ietf.org/html/draft-ietf-httpbis-cookie-same-site-00#section-4.1.1.
+     */
+    sameSite?: boolean | 'lax' | 'strict' | 'none' | undefined;
+    /**
+     * Value of the “Priority” Set-Cookie attribute.
+     * @link https://datatracker.ietf.org/doc/html/draft-west-cookie-priority-00#section-4.3
+     */
+    priority?: 'low' | 'medium' | 'high';
+    /** Marks the cookie to use partioned storage. */
+    partitioned?: boolean | undefined;
+}
 export type DataContext<T = any, E = Env, P = any, S = unknown> = {
     action?: string;
     acceptLanguage: AcceptLanguage[];
@@ -39,6 +77,7 @@ export type DataContext<T = any, E = Env, P = any, S = unknown> = {
     requestIp: string;
     setEmptyResponse: () => void;
     setHeader: (header: string, value: string) => void;
+    setCookie: (name: string, value: string | JsonLike, options?: CookieOptions) => void;
     staticPath: string;
     templates: Template[];
 } & (S extends Record<string, unknown> ? {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oc-server",
-  "version": "2.1.2",
+  "version": "3.1.0",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",