oc-template-svelte-compiler 2.1.0 → 2.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oc-template-svelte-compiler",
-  "version": "2.1.0",
+  "version": "2.1.1",
   "description": "Compiler for the Svelte OC template",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -30,7 +30,7 @@
   "dependencies": {
     "@sveltejs/vite-plugin-svelte": "^5.0.3",
     "oc-template-svelte": "^0.0.2",
-    "oc-vite-compiler": "^5.1.0",
+    "oc-vite-compiler": "^5.1.1",
     "svelte": "^5.23.0"
   },
   "files": [

package/scaffold/src/package.json

@@ -27,8 +27,8 @@
     "@tsconfig/svelte": "^5.0.4",
     "@types/testing-library__jest-dom": "^5.14.5",
     "jsdom": "^21.1.1",
-    "oc-server": "^3.0.0",
-    "oc-template-svelte-compiler": "^2.1.0",
+    "oc-server": "^3.1.0",
+    "oc-template-svelte-compiler": "^2.1.1",
     "svelte": "^5.23.0",
     "svelte-check": "^4.0.0",
     "typescript": "5.0.2",

package/scaffold/src/src/server.ts

@@ -12,19 +12,24 @@ const yearsFunFactDatabase: Record<number, string> = {
 };
 
 async function getUser(userId: number) {
+  if (userId < 0 || userId >= userDatabase.length) {
+    throw new Error(`User with ID ${userId} not found`);
+  }
   return userDatabase[userId];
 }
 
 async function getFunFact(year: number) {
-  return yearsFunFactDatabase[year];
+  return yearsFunFactDatabase[year] || `No fun fact available for year ${year}`;
 }
 
+// Export the server instance - this is required for OC
 export const server = new Server({
   development: {
-    // Echo console logs from the browser to the server
+    // Enable console logs from browser to server for debugging
     console: true,
   },
 })
+  //Define URL parameters that can be passed to your component
   .withParameters({
     userId: {
       default: 1,
@@ -34,15 +39,23 @@ export const server = new Server({
       type: 'number',
     },
   })
-  .handler(async (params) => {
+  // Main handler - returns initial data for component rendering
+  // This runs when the component is first loaded
+  .handler(async (params, ctx) => {
     const { userId } = params;
     const user = await getUser(userId);
     const [firstName, lastName] = user.name.split(/\s+/);
 
     if (firstName === 'Invalid') {
+      // Return undefined to prevent rendering
       return;
     }
 
+    // Set cache headers when same params produce same result
+    // This improves performance by reducing server load
+    ctx.setHeader('Cache-Control', 'max-age=300'); // Cache for 5 minutes
+
+    // Return data that will be passed as props to React component
     return {
       firstName,
       lastName,
@@ -50,15 +63,17 @@ export const server = new Server({
       hobbies: user.hobbies,
     };
   })
+  // Actions are server endpoints that the client can call
+  // Use these for user interactions, form submissions, etc.
   .action('funFact', async (params: { year: number }) => {
     const { year } = params;
     const funFact = await getFunFact(year);
-
     return {
       funFact,
     };
   });
 
+// This enables automatic type inference between server and client
 declare module 'oc-server' {
   interface Register {
     server: typeof server;

package/dist/lib/vueOCProviderTemplate.d.ts

@@ -1,4 +0,0 @@
-export default function vueOCProviderTemplate({ viewPath, providerFunctions }: {
-    viewPath: string;
-    providerFunctions: string;
-}): string;

package/dist/lib/vueOCProviderTemplate.js

@@ -1,22 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-function vueOCProviderTemplate({ viewPath, providerFunctions }) {
-    return `
-  import { createApp } from 'vue'
-  import View from '${viewPath}';
-
-  function renderer(props, element, ssr) {
-    const { _staticPath, _baseUrl, _componentName, _componentVersion, ...rest } = props;
-    ${providerFunctions}
-
-    rest.getData = getData;
-    rest.getSetting = getSetting;
-    createApp(View, rest).mount(element, ssr);
-  }
-
-  renderer.component = View;
-
-  export default renderer;
-`;
-}
-exports.default = vueOCProviderTemplate;