@stacksjs/sites 0.72.6 → 0.72.7

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export type { SiteProvisionInput, SiteProvisionPage, SiteProvisionResult } from './provision';
 export type { SiteSnapshotShape } from './snapshot';
 export type { HostKind, ResolvedSitesOptions, SiteContext, SiteStore } from './types';
 export {
@@ -19,5 +20,6 @@ export {
   resolveSiteByHost,
   sitesOptions,
 } from './resolver';
+export { provisionSite } from './provision';
 export { forSite, siteOwnership } from './scoping';
 export { toSiteSnapshot } from './snapshot';

package/dist/index.js

@@ -1 +1 @@
-export{currentSite,currentSiteId,requireSite,runWithSite,setCurrentSite,SiteNotResolvedError}from"./context";export{default as siteResolver}from"./middleware";export{classifyHost,clearSiteCache,databaseSiteStore,isPlatformHost,normalizeHost,requestHost,resolveSiteByHost,sitesOptions}from"./resolver";export{forSite,siteOwnership}from"./scoping";export{toSiteSnapshot}from"./snapshot";
+export{currentSite,currentSiteId,requireSite,runWithSite,setCurrentSite,SiteNotResolvedError}from"./context";export{default as siteResolver}from"./middleware";export{classifyHost,clearSiteCache,databaseSiteStore,isPlatformHost,normalizeHost,requestHost,resolveSiteByHost,sitesOptions}from"./resolver";export{provisionSite}from"./provision";export{forSite,siteOwnership}from"./scoping";export{toSiteSnapshot}from"./snapshot";

package/dist/provision.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Create or refresh a site, then seed any missing pages.
+ *
+ * Page seeding needs `@stacksjs/cms`, which is imported lazily so an app using
+ * sites WITHOUT the CMS feature does not pull it in - and a caller passing no
+ * pages never touches it at all.
+ */
+export declare function provisionSite(input: SiteProvisionInput): Promise<SiteProvisionResult>;
+/**
+ * Creating a site and giving it something to serve.
+ *
+ * Every multi-tenant app built on `@stacksjs/sites` ends up writing the same
+ * function: take a tenant, make sure it has a Site row, carry the tenant's
+ * branding onto it, and seed the pages a new site starts with. CampusHQ wrote
+ * it for schools; a storefront builder would write it for merchants.
+ *
+ * The parts that are the same every time live here. What a tenant IS, and
+ * which pages it starts with, stay with the app - this takes them as
+ * arguments rather than guessing.
+ *
+ * Idempotency is the whole point. Provisioning is a button people press twice,
+ * a seeder that re-runs, a retried request: a second pass re-themes the site,
+ * adds only the pages that are missing, and never touches one somebody has
+ * since edited.
+ */
+export declare interface SiteProvisionPage {
+  title: string
+  slug: string
+  status?: 'draft' | 'published' | 'scheduled'
+  blocks?: Array<{ type: string, props?: Record<string, unknown> }>
+  parentId?: number
+}
+export declare interface SiteProvisionInput {
+  name: string
+  subdomain: string
+  timezone?: string
+  settings?: Record<string, unknown>
+  pages?: SiteProvisionPage[]
+  siteId?: number | null
+}
+export declare interface SiteProvisionResult {
+  siteId: number
+  subdomain: string
+  created: boolean
+  pagesCreated: string[]
+  pagesKept: string[]
+}

package/dist/provision.js

@@ -0,0 +1 @@
+import{db}from"@stacksjs/database";export async function provisionSite(input){const existing=input.siteId?await db.selectFrom("sites").selectAll().where("id","=",input.siteId).executeTakeFirst():await db.selectFrom("sites").selectAll().where("subdomain","=",input.subdomain).executeTakeFirst(),settings=JSON.stringify(input.settings??{});let siteId,created=!1;if(existing){siteId=Number(existing.id);await db.updateTable("sites").set({settings,...input.timezone?{timezone:input.timezone}:{}}).where("id","=",siteId).execute()}else{const inserted=await db.insertInto("sites").values({name:input.name,subdomain:input.subdomain,status:"active",settings,...input.timezone?{timezone:input.timezone}:{}}).returning("id").executeTakeFirst();siteId=Number(inserted?.id);created=!0}const pagesCreated=[],pagesKept=[];if(input.pages?.length){const{createPageDocument,registerDefaultBlocks}=await import("@stacksjs/cms");registerDefaultBlocks();for(const page of input.pages){const path=page.slug==="/"?"/":`/${page.slug}`;if(await db.selectFrom("pages").select("id").where("site_id","=",siteId).where("path","=",path).executeTakeFirst()){pagesKept.push(path);continue}await createPageDocument(siteId,{title:page.title,slug:page.slug,status:page.status??"published",blocks:page.blocks??[],parentId:page.parentId});pagesCreated.push(path)}}return{siteId,subdomain:input.subdomain,created,pagesCreated,pagesKept}}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/sites",
   "type": "module",
-  "version": "0.72.6",
+  "version": "0.72.7",
   "description": "The Stacks multi-site (request-level tenancy) functionality.",
   "author": "Chris Breuer",
   "contributors": [
@@ -56,11 +56,11 @@
     "prepublishOnly": "bun run build"
   },
   "devDependencies": {
-    "@stacksjs/auth": "0.72.6",
-    "@stacksjs/config": "0.72.6",
-    "@stacksjs/database": "0.72.6",
-    "@stacksjs/error-handling": "0.72.6",
-    "@stacksjs/router": "0.72.6",
+    "@stacksjs/auth": "0.72.7",
+    "@stacksjs/config": "0.72.7",
+    "@stacksjs/database": "0.72.7",
+    "@stacksjs/error-handling": "0.72.7",
+    "@stacksjs/router": "0.72.7",
     "better-dx": "^0.2.23"
   },
   "sideEffects": false