@happyvertical/smrt-template-sveltekit 0.56.2 → 0.57.0

package/AGENTS.md

@@ -82,6 +82,14 @@ It is the ground-up alternative to `smrt-saas-starter`.
 - `src/hooks.server.ts` re-exports the runtime's `handle`/`init`: URL tenant
   selection stays a separate candidate and only the verified session
   establishes tenant context. Never turn an untrusted header into authority.
+- Commerce is optional and never a template dependency.
+  `src/lib/server/commerce.ts` (`bootstrapCommerceTenant`) calls
+  `ensureCommerceTenant()` only when the app has installed
+  `@happyvertical/smrt-commerce` (resolved from its own `node_modules`, with a
+  variable import specifier), passing `smrt.cookbook.json` when present. The
+  `/setup` page runs it from `onOwnerClaimed`, after the owner claim created the
+  tenant, and logs a failure because the runtime ignores hook errors. Any other
+  tenant-creation path an app adds should call it too (#4009).
 - App code uses `runtime.getCollection()`/`runtime.classOptions()`, which are
   request-scoped (RLS transaction) and must never be retained.
 - `Note` is the single example object (the canonical Notes starter, matching

package/mcp-apps-template/package.dependencies.json

@@ -1,4 +1,4 @@
 {
-  "@happyvertical/smrt-app-mcp": "^0.56.2",
-  "@happyvertical/smrt-mcp-openai": "^0.56.2"
+  "@happyvertical/smrt-app-mcp": "^0.57.0",
+  "@happyvertical/smrt-mcp-openai": "^0.57.0"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@happyvertical/smrt-template-sveltekit",
-  "version": "0.56.2",
+  "version": "0.57.0",
   "description": "Minimal SvelteKit project template with s-m-r-t framework integration",
   "type": "module",
   "main": "index.js",
@@ -32,26 +32,26 @@
     "directory": "packages/template-sveltekit"
   },
   "peerDependencies": {
-    "@happyvertical/smrt-core": "0.56.2"
+    "@happyvertical/smrt-core": "0.57.0"
   },
   "devDependencies": {
-    "@happyvertical/smrt-app-cli": "0.56.2",
-    "@happyvertical/smrt-app-mcp": "0.56.2",
-    "@happyvertical/smrt-app-runtime": "0.56.2",
-    "@happyvertical/smrt-assets": "0.56.2",
-    "@happyvertical/smrt-chat": "0.56.2",
-    "@happyvertical/smrt-cli": "0.56.2",
-    "@happyvertical/smrt-config": "0.56.2",
-    "@happyvertical/smrt-jobs": "0.56.2",
-    "@happyvertical/smrt-mcp-openai": "0.56.2",
-    "@happyvertical/smrt-playbooks": "0.56.2",
-    "@happyvertical/smrt-profiles": "0.56.2",
-    "@happyvertical/smrt-scanner": "0.56.2",
-    "@happyvertical/smrt-svelte": "0.56.2",
-    "@happyvertical/smrt-tenancy": "0.56.2",
-    "@happyvertical/smrt-ui": "0.56.2",
-    "@happyvertical/smrt-users": "0.56.2",
-    "@happyvertical/smrt-web": "0.56.2",
+    "@happyvertical/smrt-app-cli": "0.57.0",
+    "@happyvertical/smrt-app-mcp": "0.57.0",
+    "@happyvertical/smrt-app-runtime": "0.57.0",
+    "@happyvertical/smrt-assets": "0.57.0",
+    "@happyvertical/smrt-chat": "0.57.0",
+    "@happyvertical/smrt-cli": "0.57.0",
+    "@happyvertical/smrt-config": "0.57.0",
+    "@happyvertical/smrt-jobs": "0.57.0",
+    "@happyvertical/smrt-mcp-openai": "0.57.0",
+    "@happyvertical/smrt-playbooks": "0.57.0",
+    "@happyvertical/smrt-profiles": "0.57.0",
+    "@happyvertical/smrt-scanner": "0.57.0",
+    "@happyvertical/smrt-svelte": "0.57.0",
+    "@happyvertical/smrt-tenancy": "0.57.0",
+    "@happyvertical/smrt-ui": "0.57.0",
+    "@happyvertical/smrt-users": "0.57.0",
+    "@happyvertical/smrt-web": "0.57.0",
     "@happyvertical/sql": "^0.89.12",
     "@modelcontextprotocol/client": "2.0.0",
     "@modelcontextprotocol/server": "^2.0.0",
@@ -65,7 +65,7 @@
     "typescript": "6.0.3",
     "vite": "8.1.4",
     "vitest": "4.1.10",
-    "@happyvertical/smrt-reports": "0.56.2"
+    "@happyvertical/smrt-reports": "0.57.0"
   },
   "publishConfig": {
     "registry": "https://registry.npmjs.org",

package/template/package.json

@@ -39,21 +39,21 @@
     "svelte-check": "^4.7.6",
     "typescript": "6.0.3",
     "vite": "8.3.0",
-    "@happyvertical/smrt-cli": "^0.56.2"
+    "@happyvertical/smrt-cli": "^0.57.0"
   },
   "dependencies": {
-    "@happyvertical/smrt-app-runtime": "^0.56.2",
-    "@happyvertical/smrt-config": "^0.56.2",
-    "@happyvertical/smrt-core": "^0.56.2",
-    "@happyvertical/smrt-jobs": "^0.56.2",
-    "@happyvertical/smrt-profiles": "^0.56.2",
-    "@happyvertical/smrt-svelte": "^0.56.2",
-    "@happyvertical/smrt-tenancy": "^0.56.2",
-    "@happyvertical/smrt-ui": "^0.56.2",
-    "@happyvertical/smrt-users": "^0.56.2",
-    "@happyvertical/smrt-web": "^0.56.2",
+    "@happyvertical/smrt-app-runtime": "^0.57.0",
+    "@happyvertical/smrt-config": "^0.57.0",
+    "@happyvertical/smrt-core": "^0.57.0",
+    "@happyvertical/smrt-jobs": "^0.57.0",
+    "@happyvertical/smrt-profiles": "^0.57.0",
+    "@happyvertical/smrt-svelte": "^0.57.0",
+    "@happyvertical/smrt-tenancy": "^0.57.0",
+    "@happyvertical/smrt-ui": "^0.57.0",
+    "@happyvertical/smrt-users": "^0.57.0",
+    "@happyvertical/smrt-web": "^0.57.0",
     "@happyvertical/sql": "^0.89.12",
     "@modelcontextprotocol/server": "^2.0.0",
-    "@happyvertical/smrt-reports": "^0.56.2"
+    "@happyvertical/smrt-reports": "^0.57.0"
   }
 }

package/template/src/lib/server/commerce.ts

@@ -0,0 +1,78 @@
+/**
+ * Optional commerce tenant bootstrap.
+ *
+ * The template does not depend on `@happyvertical/smrt-commerce`. An app that
+ * installs it (for example through a cookbook commerce recipe) gets one
+ * `ensureCommerceTenant()` call for each tenant it creates: the standard tax
+ * codes, its tax settings and the cookbook's tax defaults (`smrt.cookbook.json`).
+ * Without commerce this does nothing.
+ *
+ * `src/routes/setup/+page.server.ts` calls it once the owner claim has
+ * created the tenant. Call it from any other place that creates tenants.
+ */
+
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import type { DatabaseInterface } from '@happyvertical/sql';
+
+const COMMERCE_PACKAGE = '@happyvertical/smrt-commerce';
+
+/** The slice of the commerce package entry this module calls. */
+export interface CommerceTenantModule {
+  ensureCommerceTenant(
+    db: DatabaseInterface,
+    tenantId: string,
+    options?: { cookbook?: { policies: readonly unknown[] } },
+  ): Promise<{ tenantId: string }>;
+}
+
+export interface CommerceTenantBootstrapOptions {
+  /** Project root holding `node_modules` and `smrt.cookbook.json`. */
+  readonly root?: string;
+  /** Load the commerce entry, or `null` when it is not installed. */
+  readonly loadCommerce?: (
+    root: string,
+  ) => Promise<CommerceTenantModule | null>;
+  /** Load the app cookbook's policy rows, or `undefined` without one. */
+  readonly loadCookbook?: (
+    root: string,
+  ) => Promise<{ policies: readonly unknown[] } | undefined>;
+}
+
+async function installedCommerce(
+  root: string,
+): Promise<CommerceTenantModule | null> {
+  // Installed means a direct dependency of this app. The specifier stays a
+  // variable so the build never requires a package the app did not add.
+  if (!existsSync(join(root, 'node_modules', COMMERCE_PACKAGE, 'package.json')))
+    return null;
+  const specifier: string = COMMERCE_PACKAGE;
+  return (await import(/* @vite-ignore */ specifier)) as CommerceTenantModule;
+}
+
+async function appCookbook(
+  root: string,
+): Promise<{ policies: readonly unknown[] } | undefined> {
+  const { hasCookbook, loadCookbookApp } = await import(
+    '@happyvertical/smrt-svelte/cookbook/server'
+  );
+  if (!(await hasCookbook(root))) return undefined;
+  return (await loadCookbookApp({ root })).cookbook;
+}
+
+/**
+ * Initialize commerce for a tenant this app just created. Returns `null` when
+ * commerce is not installed. Errors propagate; the call is idempotent, so a
+ * caller may retry it.
+ */
+export async function bootstrapCommerceTenant(
+  db: DatabaseInterface,
+  tenantId: string,
+  options: CommerceTenantBootstrapOptions = {},
+): Promise<{ tenantId: string } | null> {
+  const root = options.root ?? process.cwd();
+  const commerce = await (options.loadCommerce ?? installedCommerce)(root);
+  if (!commerce) return null;
+  const cookbook = await (options.loadCookbook ?? appCookbook)(root);
+  return commerce.ensureCommerceTenant(db, tenantId, cookbook ? { cookbook } : {});
+}

package/template/src/routes/setup/+page.server.ts

@@ -1,9 +1,24 @@
 import { createOwnerSetupPage } from '@happyvertical/smrt-app-runtime/sveltekit';
 
+import { bootstrapCommerceTenant } from '$lib/server/commerce';
 import { runtime } from '$lib/server/smrt';
 
 /**
  * Local-profile, loopback-only, single-use owner bootstrap. The runtime
  * removes the `pnpm app:setup` onboarding hand-off files once the claim commits.
+ * When the app installs commerce, the claimed tenant is initialized for it.
  */
-export const { load, actions } = createOwnerSetupPage(runtime);
+export const { load, actions } = createOwnerSetupPage(runtime, {
+  onOwnerClaimed: async ({ tenantId }) => {
+    // The runtime ignores hook errors because the claim has committed, so
+    // report a failure here; rerunning the bootstrap is safe.
+    try {
+      await bootstrapCommerceTenant(
+        (await runtime.localRuntime()).db,
+        tenantId,
+      );
+    } catch (error) {
+      console.error(`Commerce bootstrap failed for tenant ${tenantId}`, error);
+    }
+  },
+});

package/template.config.js

@@ -19,23 +19,23 @@ export default {
 
   // Dependencies to add to generated project
   dependencies: {
-    '@happyvertical/smrt-app-runtime': '^0.56.2',
-    '@happyvertical/smrt-config': '^0.56.2',
-    '@happyvertical/smrt-core': '^0.56.2',
-    '@happyvertical/smrt-jobs': '^0.56.2',
-    '@happyvertical/smrt-profiles': '^0.56.2',
-    '@happyvertical/smrt-reports': '^0.56.2',
-    '@happyvertical/smrt-svelte': '^0.56.2',
-    '@happyvertical/smrt-tenancy': '^0.56.2',
-    '@happyvertical/smrt-ui': '^0.56.2',
-    '@happyvertical/smrt-users': '^0.56.2',
-    '@happyvertical/smrt-web': '^0.56.2',
+    '@happyvertical/smrt-app-runtime': '^0.57.0',
+    '@happyvertical/smrt-config': '^0.57.0',
+    '@happyvertical/smrt-core': '^0.57.0',
+    '@happyvertical/smrt-jobs': '^0.57.0',
+    '@happyvertical/smrt-profiles': '^0.57.0',
+    '@happyvertical/smrt-reports': '^0.57.0',
+    '@happyvertical/smrt-svelte': '^0.57.0',
+    '@happyvertical/smrt-tenancy': '^0.57.0',
+    '@happyvertical/smrt-ui': '^0.57.0',
+    '@happyvertical/smrt-users': '^0.57.0',
+    '@happyvertical/smrt-web': '^0.57.0',
     '@happyvertical/sql': '^0.89.12',
     '@modelcontextprotocol/server': '^2.0.0',
   },
 
   devDependencies: {
-    '@happyvertical/smrt-cli': '^0.56.2',
+    '@happyvertical/smrt-cli': '^0.57.0',
     '@sveltejs/adapter-node': '^5.5.7',
     '@sveltejs/kit': '2.70.3',
     '@sveltejs/vite-plugin-svelte': '^7.3.0',