@wix/origami-site 0.0.0-stage → 0.1.0

package/package.json

@@ -1,6 +1,71 @@
 {
   "name": "@wix/origami-site",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.1.0",
+  "description": "Runs an exported Wix origami site: file-based routing, Wix dynamic pages, popups and build checks. Use with @wix/origami-site-astro or @wix/origami-site-express.",
+  "type": "module",
+  "files": [
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc --noEmit",
+    "lint": "oxlint .",
+    "test": "tsc --noEmit -p tsconfig.test.json"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^6.0.3",
+    "vite": "^8"
+  },
+  "publishUnscoped": false,
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "wix": {
+    "artifact": {
+      "groupId": "com.wixpress.npm",
+      "artifactId": "origami-site",
+      "targets": {
+        "docker": false
+      }
+    },
+    "validations": {
+      "source": [
+        "lint"
+      ],
+      "postBuild": [
+        "test"
+      ]
+    }
+  },
+  "dependencies": {
+    "@wix/origami-types": "1.2.0",
+    "react": "^18.3.1",
+    "react-dom": "^18.3.1",
+    "@wix/builder-error-pages": "^1.1.6",
+    "@wix/builder-piler-components": "^1.6.7"
+  },
+  "exports": {
+    "./server": {
+      "types": "./src/server/index.d.ts",
+      "default": "./src/server/index.js"
+    },
+    "./browser": {
+      "types": "./src/browser/index.d.ts",
+      "default": "./src/browser/index.js"
+    },
+    "./popups": {
+      "types": "./src/popups/index.d.ts",
+      "default": "./src/popups/index.js"
+    },
+    "./vite-plugins": {
+      "types": "./src/vite-plugins/index.d.ts",
+      "default": "./src/vite-plugins/index.js"
+    },
+    "./types": {
+      "types": "./src/types/index.d.ts"
+    },
+    "./default-error-404": "./src/default-error-404.jsx"
+  },
+  "falconPackageHash": "88d8479096308cdba298b8fe696e53dbd9a3482bd149a332bd45b100"
 }

package/src/browser/index.d.ts

@@ -0,0 +1,10 @@
+import type { PageData } from '../server/index.js'
+// PLAN-QUESTION: mountPage options follow the example; page modules remain unknown until milestone 1.7.
+export type MountPageOptions = {
+  pages: Record<string, () => Promise<unknown>>
+  popups: Record<string, () => Promise<unknown>>
+  seoUriByPageId: Record<string, string>
+  beforeMount: () => Promise<unknown>
+}
+export function mountPage(element: Element | null, options: MountPageOptions): Promise<() => void>
+export function readPageData(): PageData

package/src/browser/index.js

@@ -0,0 +1 @@
+export {}

package/src/default-error-404.jsx

@@ -0,0 +1,9 @@
+import React from 'react'
+import { createRoot } from 'react-dom/client'
+import { DefaultError404 } from '@wix/builder-error-pages'
+import { PilerPage } from '@wix/builder-piler-components'
+import '@wix/builder-error-pages/style.css'
+
+createRoot(document.getElementById('root')).render(
+    React.createElement(React.StrictMode, null, React.createElement(PilerPage, { Page: DefaultError404 }))
+)

package/src/popups/index.d.ts

@@ -0,0 +1,3 @@
+// PLAN-QUESTION: Popup option/result types are unspecified here; leave options opaque until milestone 3.2.
+export function openPopup(seoUri: string, options?: Record<string, unknown>): void
+export function closePopup(): void

package/src/popups/index.js

@@ -0,0 +1 @@
+export {}

package/src/server/index.d.ts

@@ -0,0 +1,80 @@
+import type { SiteRouteTable, PageRoute, RouterRoute, AccessRule } from '@wix/origami-types'
+export type { AccessRule } from '@wix/origami-types'
+// PLAN-QUESTION: Logger is unnamed structurally in the plan; only warn/error are used.
+export type Logger = Pick<Console, 'warn' | 'error'>
+export type RequestContext = { request: Request; url: URL; tokens: TokenProvider; locals: Map<string, unknown> }
+
+export type SiteOptions = {
+  root: string                       // the site package folder
+  mode: 'dev' | 'prod'
+  table?: SiteRouteTable                 // prod: the table from the build. dev: omitted, the core scans.
+  wix: { clientId: string; siteId: string }   // from VITE_WIX_CLIENT_ID / VITE_WIX_SITE_ID
+  tokens?: TokenProvider             // default: builderAuthTokenProvider (3.3)
+  access?: AccessSource              // default: noAccessRules (4)
+  accessHandlers?: AccessHandler[]   // default: []
+  fetch?: typeof fetch               // tests inject a fake
+  wixApiBaseUrl?: string             // default 'https://www.wixapis.com'; the conformance suite points it at the fake
+  routerTimeoutMs?: number           // default 5000
+  logger?: Logger                    // default: console with an [origami] prefix
+}
+
+export interface OrigamiSite {
+  /** Current route table (dev: rescans if dirty). */
+  table(): Promise<SiteRouteTable>
+  /** Reference URL matcher. Pure, no network. */
+  match(url: URL): Promise<RouteMatch>
+  /** Answer one request. Never throws: errors become a Resolution. */
+  handle(request: Request): Promise<Resolution>
+  /** Dev: tell the core a file changed (adapters forward Vite watcher events). */
+  fileChanged(path: string): void
+  /** Dev: subscribe to table changes, e.g. to invalidate the virtual:origami-site module. */
+  onTableChange(listener: (table: SiteRouteTable) => void): () => void
+  close(): Promise<void>
+}
+
+export type RouteMatch =
+  | { kind: 'page'; route: PageRoute }
+  | { kind: 'router'; route: RouterRoute; suffix: string }     // '/a/b/c'; '/' for bare '/team'
+  | { kind: 'reserved'; path: string }                        // /_origami/*
+  | { kind: 'notFound' }
+
+export type Resolution =
+  | { kind: 'page'; status: 200 | 404; page: PageRef; data: PageData; headers: Headers }
+  | { kind: 'response'; response: Response }   // redirects, reserved endpoints, 405, 503
+
+export type PageRef = { key: string; itemPath?: string; title: string }
+
+export type PageData = {
+  page: string                                   // PageRef.key; the browser loads this page
+  route: { kind: 'page' | 'router' | 'notFound'; url: string; role?: string }
+  services: Record<string, unknown>              // runtime configs merged into the page's services
+}
+
+export interface TokenProvider {
+  /** The access token to use for this request. Called at most once per request (memoised in the context). */
+  getAccessToken(request: Request): Promise<string>
+}
+
+// AccessRule is shared with route types.   // e.g. { type: 'members' }, { type: 'password' }
+
+/** Where rules come from: a file next to the page, a central file, … — not decided. One swappable loader. */
+export interface AccessSource {
+  load(table: SiteRouteTable, root: string): Promise<Map<string /* route key */, AccessRule[]>>
+}
+export const noAccessRules: AccessSource
+
+/** One handler per rule type. Returns null to allow, or a Response (redirect, 401, a form). */
+export interface AccessHandler {
+  type: string
+  check(rule: AccessRule, request: Request, ctx: RequestContext): Promise<Response | null>
+}
+
+
+export type { SiteTreeError, RouterServiceError } from './requests/errors.js'
+export function createSite(options: SiteOptions): Promise<OrigamiSite>
+export function readSiteTree(root: string): Promise<SiteRouteTable>
+export function runInRequestContext<T>(ctx: RequestContext, fn: () => Promise<T>): Promise<T>
+export function getRequestContext(): RequestContext
+export function getAccessToken(): Promise<string>
+export function serializePageData(data: PageData): string
+export function builderAuthTokenProvider(options: { clientId: string; siteId: string }): TokenProvider

package/src/server/index.js

@@ -0,0 +1 @@
+export {}

package/src/server/requests/errors.d.ts

@@ -0,0 +1,23 @@
+export class SiteTreeError extends Error {
+  code:
+    | 'DUPLICATE_URL'                    // two folders give the same URL
+    | 'ROUTE_JSON_INVALID'               // not JSON, or a required field missing or of the wrong type
+    | 'ROUTE_JSON_MISSING_SERVICE_URL'   // no routerServiceUrl: origami refuses to start
+    | 'ROUTE_JSON_SIBLINGS_DIFFER'       // [a]/route.json and [b]/route.json differ
+    | 'ROLE_FOLDER_MISSING'              // pages.member = 'team-member' but no [team-member]/ folder
+    | 'ROLE_FOLDER_NOT_IN_PAGES'         // a [x]/ folder that no role in pages names
+    | 'BRACKET_OUTSIDE_PREFIX'           // [x]/ not directly under a prefix folder
+    | 'PREFIX_HAS_FILES'                 // team/ itself holds page files
+    | 'ROLE_PAGE_HAS_CHILDREN'           // a folder inside [x]/ that isn't _generated
+    | 'PREFIX_COLLIDES_WITH_PAGE'        // pages/team is both a page and a prefix
+    | 'NOT_FOUND_HAS_CHILDREN'
+    | 'DUPLICATE_POPUP'
+    | 'UNSUPPORTED_ACCESS_RULE'          // see section 4
+  paths: string[]
+}
+
+export class RouterServiceError extends Error {
+  code: 'TIMEOUT' | 'NETWORK' | 'HTTP_STATUS' | 'BAD_RESPONSE'
+  routerPrefix: string
+  status?: number
+}

package/src/server/requests/index.js

@@ -0,0 +1 @@
+export {}

package/src/server/site-tree/index.js

@@ -0,0 +1 @@
+export {}

package/src/styles.d.ts

@@ -0,0 +1,2 @@
+// The copied 404 entry imports the package's stylesheet as a bundler side effect.
+declare module '@wix/builder-error-pages/style.css'

package/src/types/index.d.ts

@@ -0,0 +1,48 @@
+/** What each adapter package exports as its default `origami` descriptor. */
+export interface OrigamiAdapter {
+  name: string                                   // '@wix/origami-site-astro'
+  version: string                                // its package version
+  framework: { name: string; range: string }     // { name: 'astro', range: '^7.3.0' }
+  /** Files and package.json fields the generator writes for this adapter (section 8). */
+  project(ctx: ProjectContext): ProjectFiles
+  /** How the conformance suite runs a site with this adapter. */
+  conformance: ConformanceDriver
+}
+
+export type ProjectContext = {
+  siteName: string
+  coreVersion: string                            // the @wix/origami-site range to depend on
+  nodeVersion: string                            // '22'
+}
+
+export type ProjectFiles = {
+  files: Record<string /* path relative to the site package */, string /* contents */>   // e.g. astro.config.mjs, Dockerfile
+  packageJson: {
+    scripts: { dev: string; build: string; start: string } & Record<string, string>
+    dependencies: Record<string, string>
+    devDependencies?: Record<string, string>
+  }
+  readme: string                                 // markdown section appended to the site README
+}
+
+export interface ConformanceDriver {
+  /** Start `yarn dev`. Resolves when the server answers. */
+  dev(root: string, env: SiteEnv): Promise<RunningSite>
+  // PLAN-QUESTION: Keep the explicit BuildResult union; rejection policy is deferred to adapters.
+  /** Run `yarn build`. */
+  build(root: string, env: SiteEnv): Promise<BuildResult>
+  /** Start `yarn start` after a build. */
+  start(root: string, env: SiteEnv): Promise<RunningSite>
+}
+
+export type SiteEnv = Record<string, string>     // VITE_WIX_CLIENT_ID, VITE_WIX_SITE_ID, ORIGAMI_WIX_API_BASE (tests), PORT
+export type RunningSite = { url: URL; logs(): string; restarts(): number; stop(): Promise<void> }
+export type BuildResult = { ok: true; output: string } | { ok: false; output: string }
+
+
+/** Core contracts only; runtime APIs belong to @wix/origami-site/server. */
+export type {
+  SiteOptions, OrigamiSite, RouteMatch, Resolution, PageRef, PageData,
+  RequestContext, TokenProvider, AccessRule, AccessSource, AccessHandler,
+  Logger, SiteTreeError, RouterServiceError,
+} from '../server/index.js'

package/src/types/index.js

@@ -0,0 +1 @@
+export {}

package/src/vite-plugins/index.d.ts

@@ -0,0 +1,2 @@
+import type { Plugin } from 'vite'
+export function origamiVitePlugins(options: { root: string }): Plugin[]

package/src/vite-plugins/index.js

@@ -0,0 +1 @@
+export {}

package/README.md

@@ -1,3 +0,0 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.