@jay-framework/wix-members 0.20.0 → 0.22.0

package/dist/index.client.js

@@ -34,8 +34,9 @@ function provideWixMembersContext(initData) {
       });
     }
     function getCallbackUrl() {
-      if (initData.authCallbackUrl) return initData.authCallbackUrl;
-      return window.location.origin + "/auth/callback";
+      const url = initData.authCallbackUrl || "/auth/callback";
+      if (url.startsWith("http")) return url;
+      return window.location.origin + url;
     }
     async function redirectToLogin(callbackUrl) {
       const redirectUri = callbackUrl || getCallbackUrl();

package/dist/index.d.ts

@@ -1,13 +1,24 @@
 import { W as WixMembersService } from './index.client-lddj65uZ.js';
 export { A as AuthCallbackResult, R as ReactiveMemberIndicator, b as WIX_MEMBERS_CONTEXT, a as WIX_MEMBERS_SERVICE, c as WixMembersContext, d as WixMembersInitData, e as authCallback, i as init, l as loginIndicator, f as protectedPage, p as provideWixMembersContext } from './index.client-lddj65uZ.js';
+import { JayHtmlValidatorFn } from '@jay-framework/compiler-shared';
+import { PluginSetupContext, PluginSetupResult } from '@jay-framework/stack-server-runtime';
 import '@jay-framework/runtime';
 import '@jay-framework/reactive';
 import '@jay-framework/fullstack-component';
 import '@jay-framework/component';
 
+interface WixMembersConfig {
+    authCallbackUrl: string;
+}
+declare function loadWixMembersConfig(projectRoot?: string): WixMembersConfig;
+
 declare function provideWixMembersService(): WixMembersService;
 
 declare const AUTH_COOKIE_NAME = "wix_auth_role";
 declare function setAuthCookie(role: 'member' | 'visitor'): void;
 
-export { AUTH_COOKIE_NAME, WixMembersService, provideWixMembersService, setAuthCookie };
+declare const validateAuthCallbackPage: JayHtmlValidatorFn;
+
+declare function setupWixMembers(ctx: PluginSetupContext): Promise<PluginSetupResult>;
+
+export { AUTH_COOKIE_NAME, type WixMembersConfig, WixMembersService, loadWixMembersConfig, provideWixMembersService, setAuthCookie, setupWixMembers, validateAuthCallbackPage };

package/dist/index.js

@@ -3,6 +3,9 @@ import { createJayService, makeJayStackComponent, RenderPipeline, redirect3xx, m
 import { createJayContext, useGlobalContext } from "@jay-framework/runtime";
 import { registerReactiveGlobalContext, createSignal, useReactive, createEvent } from "@jay-framework/component";
 import { WIX_CLIENT_CONTEXT, WIX_CLIENT_SERVICE } from "@jay-framework/wix-server-client";
+import * as fs from "node:fs";
+import * as path from "node:path";
+import * as yaml from "js-yaml";
 const WIX_MEMBERS_SERVICE = createJayService("Wix Members Service");
 function provideWixMembersService() {
   const service = {};
@@ -41,8 +44,9 @@ function provideWixMembersContext(initData) {
       });
     }
     function getCallbackUrl() {
-      if (initData.authCallbackUrl) return initData.authCallbackUrl;
-      return window.location.origin + "/auth/callback";
+      const url = initData.authCallbackUrl || "/auth/callback";
+      if (url.startsWith("http")) return url;
+      return window.location.origin + url;
     }
     async function redirectToLogin(callbackUrl) {
       const redirectUri = callbackUrl || getCallbackUrl();
@@ -156,22 +160,123 @@ async function renderFastChanging(props, _membersService) {
   }));
 }
 const protectedPage = makeJayStackComponent().withProps().withServices(WIX_MEMBERS_SERVICE).withFastRender(renderFastChanging);
+const DEFAULTS = {
+  authCallbackUrl: "/auth/callback"
+};
+function loadWixMembersConfig(projectRoot) {
+  const root = projectRoot ?? process.cwd();
+  const configPath = path.join(root, "config", ".wix-members.yaml");
+  if (!fs.existsSync(configPath)) {
+    return DEFAULTS;
+  }
+  const raw = yaml.load(fs.readFileSync(configPath, "utf8"));
+  if (!raw) {
+    return DEFAULTS;
+  }
+  return {
+    authCallbackUrl: typeof raw.authCallbackUrl === "string" ? raw.authCallbackUrl : DEFAULTS.authCallbackUrl
+  };
+}
+const MEMBERS_CONTRACTS = /* @__PURE__ */ new Set(["login-indicator", "auth-callback", "protected-page"]);
+const checkedProjects = /* @__PURE__ */ new Set();
+const validateAuthCallbackPage = (ctx) => {
+  const findings = [];
+  const usesMembers = ctx.headlessImports.some((imp) => MEMBERS_CONTRACTS.has(imp.contractName));
+  if (!usesMembers) return findings;
+  if (checkedProjects.has(ctx.projectRoot)) return findings;
+  checkedProjects.add(ctx.projectRoot);
+  const config = loadWixMembersConfig(ctx.projectRoot);
+  const callbackUrl = config.authCallbackUrl;
+  if (!callbackUrl.startsWith("/")) return findings;
+  const routeSegments = callbackUrl.replace(/^\//, "").split("/");
+  const pagesDir = path.join(ctx.projectRoot, "src", "pages");
+  const pagePath = path.join(pagesDir, ...routeSegments, "page.jay-html");
+  if (!fs.existsSync(pagePath)) {
+    findings.push({
+      severity: "error",
+      message: `wix-members requires an auth callback page at src/pages/${routeSegments.join("/")}/page.jay-html`,
+      suggestion: "Create the page using the auth-callback contract. See agent-kit/plugin/wix-members-setup.md for a template."
+    });
+  }
+  return findings;
+};
 const init = makeJayInit().withServer(async () => {
   console.log("[wix-members] Initializing Wix Members service...");
   getService(WIX_CLIENT_SERVICE);
   provideWixMembersService();
+  const config = loadWixMembersConfig();
+  console.log(`[wix-members] Auth callback URL: ${config.authCallbackUrl}`);
   console.log("[wix-members] Server initialization complete");
-  return {};
+  return {
+    authCallbackUrl: config.authCallbackUrl
+  };
 });
+const CONFIG_FILE_NAME = ".wix-members.yaml";
+const CONFIG_TEMPLATE = `# Wix Members Configuration
+#
+# Auth callback URL — the route that handles the OAuth redirect after login/register.
+# Must match a page in your site (e.g. src/pages/auth/callback/page.jay-html).
+# Relative paths are resolved against the site origin at runtime.
+authCallbackUrl: "/auth/callback"
+`;
+async function setupWixMembers(ctx) {
+  if (ctx.initError) {
+    return {
+      status: "error",
+      message: `Service init failed (is wix-server-client configured?). ${ctx.initError.message}`
+    };
+  }
+  const configCreated = [];
+  const configPath = path.join(ctx.configDir, CONFIG_FILE_NAME);
+  if (!fs.existsSync(configPath)) {
+    if (!fs.existsSync(ctx.configDir)) {
+      fs.mkdirSync(ctx.configDir, { recursive: true });
+    }
+    fs.writeFileSync(configPath, CONFIG_TEMPLATE, "utf-8");
+    configCreated.push(`config/${CONFIG_FILE_NAME}`);
+  }
+  const config = loadWixMembersConfig(ctx.projectRoot);
+  const callbackUrl = config.authCallbackUrl;
+  if (!callbackUrl.startsWith("/")) {
+    return {
+      status: "configured",
+      configCreated,
+      message: `Wix Members configured (external callback: ${callbackUrl})`
+    };
+  }
+  const routeSegments = callbackUrl.replace(/^\//, "").split("/");
+  const pagesDir = path.join(ctx.projectRoot, "src", "pages");
+  const candidatePaths = [
+    path.join(pagesDir, ...routeSegments, "page.jay-html"),
+    path.join(pagesDir, ...routeSegments.slice(0, -1), routeSegments.at(-1) + ".jay-html")
+  ];
+  const hasCallbackPage = candidatePaths.some((p) => fs.existsSync(p));
+  if (!hasCallbackPage) {
+    const expectedPath = `src/pages/${routeSegments.join("/")}/page.jay-html`;
+    return {
+      status: "needs-config",
+      configCreated,
+      message: `Auth callback page missing: create ${expectedPath} using the auth-callback contract. See agent-kit/plugin/wix-members-setup.md for details.`
+    };
+  }
+  return {
+    status: "configured",
+    configCreated,
+    message: `Wix Members configured (callback: ${callbackUrl})`
+  };
+}
 export {
   AUTH_COOKIE_NAME,
   WIX_MEMBERS_CONTEXT,
   WIX_MEMBERS_SERVICE,
   authCallback,
   init,
+  loadWixMembersConfig,
   loginIndicator,
   protectedPage,
   provideWixMembersContext,
   provideWixMembersService,
-  setAuthCookie
+  setAuthCookie,
+  setupWixMembers,
+  validateAuthCallbackPage
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jay-framework/wix-members",
-  "version": "0.20.0",
+  "version": "0.22.0",
   "type": "module",
   "description": "Wix Members authentication package for Jay Framework",
   "license": "Apache-2.0",
@@ -37,26 +37,28 @@
     "test": ":"
   },
   "dependencies": {
-    "@jay-framework/component": "^0.20.0",
-    "@jay-framework/fullstack-component": "^0.20.0",
-    "@jay-framework/reactive": "^0.20.0",
-    "@jay-framework/runtime": "^0.20.0",
-    "@jay-framework/secure": "^0.20.0",
-    "@jay-framework/stack-client-runtime": "^0.20.0",
-    "@jay-framework/stack-server-runtime": "^0.20.0",
-    "@jay-framework/wix-server-client": "^0.20.0",
-    "@jay-framework/wix-utils": "^0.20.0",
+    "@jay-framework/component": "^0.22.0",
+    "@jay-framework/fullstack-component": "^0.22.0",
+    "@jay-framework/reactive": "^0.22.0",
+    "@jay-framework/runtime": "^0.22.0",
+    "@jay-framework/secure": "^0.22.0",
+    "@jay-framework/stack-client-runtime": "^0.22.0",
+    "@jay-framework/stack-server-runtime": "^0.22.0",
+    "@jay-framework/wix-server-client": "^0.22.0",
+    "@jay-framework/wix-utils": "^0.22.0",
     "@wix/redirects": "^1.0.88",
     "@wix/sdk": "^1.21.5",
-    "@wix/sdk-runtime": "^1.0.11"
+    "@wix/sdk-runtime": "^1.0.11",
+    "js-yaml": "^4.1.0"
   },
   "devDependencies": {
     "@babel/core": "^7.23.7",
     "@babel/preset-env": "^7.23.8",
     "@babel/preset-typescript": "^7.23.3",
-    "@jay-framework/compiler-jay-stack": "^0.20.0",
-    "@jay-framework/jay-cli": "^0.20.0",
-    "@jay-framework/vite-plugin": "^0.20.0",
+    "@jay-framework/compiler-jay-stack": "^0.22.0",
+    "@jay-framework/jay-cli": "^0.22.0",
+    "@jay-framework/jay-stack-cli": "^0.22.0",
+    "@jay-framework/vite-plugin": "^0.22.0",
     "@jay-framework/wix-dev-environment": "^0.6.12",
     "nodemon": "^3.0.3",
     "rimraf": "^5.0.5",

package/plugin.yaml

@@ -23,3 +23,10 @@ contexts:
   - name: wix-members
     marker: WIX_MEMBERS_CONTEXT
     description: Client-side member auth state, redirect login/register/logout operations
+
+validators:
+  - name: auth-callback-page
+    handler: validateAuthCallbackPage
+    description: Checks that the auth callback page exists for the OAuth redirect flow
+
+setup: setupWixMembers