zitejs 0.9.137 → 0.10.0-start.0

package/dist/esm/start/vite.js

@@ -0,0 +1,114 @@
+import path from "node:path";
+import { tanstackStart } from "@tanstack/react-start/plugin/vite";
+import viteReact from "@vitejs/plugin-react";
+import { ziteId } from "../vite/index.js";
+import { hasAppStart, renderStartInstance, renderStartServerEntry, START_INSTANCE_ENTRY, START_SERVER_ENTRY, writeIfChanged, } from "./entries.js";
+// Must match the literal in ./server.ts, which the build rewrites.
+const FN_IDS_TOKEN = "__ZITE_FN_IDS__";
+// Platform-pinned Worker settings. The deploy uses its own fixed template, so
+// these only have to match it; apps don't carry a wrangler config.
+const WORKER_COMPATIBILITY_DATE = "2026-09-25";
+const WORKER_COMPATIBILITY_FLAGS = ["nodejs_compat"];
+// Resolved from the app at build time; zitejs doesn't depend on it.
+const loadCloudflare = async (main) => {
+    const { cloudflare } = (await import("@cloudflare/vite-plugin"));
+    return cloudflare({
+        viteEnvironment: { name: "ssr" },
+        config: {
+            name: "zite-app",
+            main,
+            compatibility_date: WORKER_COMPATIBILITY_DATE,
+            compatibility_flags: WORKER_COMPATIBILITY_FLAGS,
+        },
+    });
+};
+/** The one plugin a Zite app's `vite.config.ts` uses. */
+export function zite(options = {}) {
+    const serverEntry = options.serverEntry ?? START_SERVER_ENTRY;
+    // Platform-owned, so they're rewritten whenever they differ. Sandboxes run the
+    // image's zitejs for `generate`, which may predate Start; the plugin can't.
+    const appDir = process.cwd();
+    if (!options.serverEntry)
+        writeIfChanged(appDir, START_SERVER_ENTRY, renderStartServerEntry());
+    writeIfChanged(appDir, START_INSTANCE_ENTRY, renderStartInstance(hasAppStart(appDir)));
+    // Every server function TanStack's compiler found, from its own hook, by id.
+    const ids = new Map();
+    const compileZitejs = {
+        name: "zite:compile-zitejs",
+        // The factories must go through TanStack's compiler in both environments.
+        // The peer dependency gets zitejs crawled already; this keeps it true if an
+        // install drops that. A Node build bundles everything, so externalized
+        // libraries can't load the root's React 18 renderer.
+        config: (config) => {
+            const root = path.resolve(config.root ?? ".");
+            const src = `${path.join(root, "src")}/`;
+            return {
+                ssr: { noExternal: options.cloudflare === false ? true : ["zitejs"] },
+                optimizeDeps: { exclude: ["zitejs"] },
+                resolve: {
+                    // `@/` as in classic apps and shadcn, `~/` as in TanStack's templates.
+                    alias: [
+                        { find: /^@\//, replacement: src },
+                        { find: /^~\//, replacement: src },
+                        // The workspace SDKs `zitejs generate` writes, as classic apps map them.
+                        { find: /^zitejs\/db$/, replacement: path.join(root, "../../.zite/db.ts") },
+                        { find: /^zitejs\/integrations$/, replacement: path.join(root, ".zite/integrations/index.ts") },
+                        { find: /^zitejs\/email$/, replacement: path.join(root, ".zite/integrations/email.ts") },
+                        { find: /^zitejs\/meta$/, replacement: path.join(root, ".zite/meta.ts") },
+                    ],
+                    // Shared workspace libraries resolve from the root, where classic apps
+                    // keep React 18; recharts 2 needs the app's react-is 19 or drops series.
+                    dedupe: ["react-is"],
+                },
+            };
+        },
+    };
+    const functionIds = {
+        name: "zite:function-ids",
+        apply: "build",
+        generateBundle(_, bundle) {
+            for (const chunk of Object.values(bundle)) {
+                if (chunk.type === "chunk" && chunk.code.includes(FN_IDS_TOKEN)) {
+                    chunk.code = chunk.code.replace(FN_IDS_TOKEN, [...ids.keys()].join(","));
+                }
+            }
+        },
+    };
+    return [
+        tanstackStart({
+            // TanStack resolves these from `src/`.
+            server: { entry: `../${serverEntry.replace(/\.ts$/, "")}` },
+            start: { entry: `../${START_INSTANCE_ENTRY.replace(/\.ts$/, "")}` },
+            serverFns: {
+                generateFunctionId: ({ filename, functionName }) => {
+                    const id = functionName.replace(/_createServerFn_handler$/, "");
+                    if (/(^|\/)node_modules\//.test(filename)) {
+                        throw new Error(`[zite] ${filename} defines server function ${id}; dependencies can't ship server functions`);
+                    }
+                    const existing = ids.get(id);
+                    if (existing && existing !== filename) {
+                        throw new Error(`[zite] server function name ${id} is used in both ${existing} and ${filename}`);
+                    }
+                    ids.set(id, filename);
+                    return id;
+                },
+            },
+            importProtection: {
+                behavior: "error",
+                client: {
+                    // Appended to TanStack's own.
+                    specifiers: ["zitejs/start/server", "zitejs/start/describe", "zitejs/runtime"],
+                    // Replaces TanStack's list, so its `**/*.server.*` is restated. File
+                    // patterns also catch `zitejs/db` and `zitejs/integrations`, which the
+                    // aliases above rewrite before specifiers are matched.
+                    files: ["**/*.server.*", "**/.zite/db.ts", "**/.zite/integrations/**"],
+                },
+            },
+        }),
+        options.cloudflare !== false ? loadCloudflare(serverEntry) : null,
+        viteReact(),
+        ziteId(),
+        compileZitejs,
+        functionIds,
+    ];
+}

package/dist/esm/sync/lib.js

@@ -1217,10 +1217,10 @@ export function generateBackendWrapperTs(envVarNames = []) {
         "// Auto-generated type-narrowing wrapper. Do not edit manually.",
         "// Re-exports createEndpoint with context.user typed to the app User.",
         "",
-        "import type { ZiteRequestContext as _ZiteRequestContext, ZiteScheduledContext, ZiteErrorCode, ZiteSchedule, ZiteStreamInterface, ZiteTrigger, ZiteTriggerContext, ZiteWebhook } from 'zitejs/backend/base';",
+        "import type { ZiteRequestContext as _ZiteRequestContext, ZiteScheduledContext, ZiteErrorCode, ZiteSchedule, ZiteStep, ZiteStreamInterface, ZiteTrigger, ZiteTriggerContext, ZiteWebhook } from 'zitejs/backend/base';",
         "import type { User } from 'zitejs/auth';",
         "",
-        "export type { ZiteErrorCode, ZiteSchedule, ZiteScheduledContext, ZiteStreamInterface, ZiteTrigger, ZiteWebhook };",
+        "export type { ZiteErrorCode, ZiteSchedule, ZiteScheduledContext, ZiteStep, ZiteStreamInterface, ZiteTrigger, ZiteWebhook };",
         // A trigger's registration exports are typed against these, and they
         // only reach app code through this file.
         "export type { ZiteTriggerContext, ZiteTriggerDeliveryInfo, ZiteTriggerDeliveryRun, ZiteTriggerRun, ZiteTriggerSubscribe, ZiteTriggerSubscribeInput, ZiteTriggerSubscribeResult, ZiteTriggerUnsubscribe, ZiteTriggerUnsubscribeInput } from 'zitejs/backend/base';",
@@ -1316,6 +1316,8 @@ export function generateBackendWrapperTs(envVarNames = []) {
         "  execute: (",
         "    params: {",
         "      input: TInput;",
+        "      /** Durable steps: step.run(name, fn) runs fn once per logical run — its result is saved before anything after it executes, and a resumed run replays completed steps from their saved results. Provided by the platform; never define a local stand-in. */",
+        "      step: ZiteStep;",
         "      context: TSchedule extends ZiteSchedule ? ZiteRequestContext | ZiteScheduledContext : TWebhook extends ZiteWebhook ? ZiteRequestContext | ZiteScheduledContext : TTrigger extends ZiteTrigger ? ZiteRequestContext | ZiteScheduledContext : ZiteRequestContext;",
         // Mirrors the base module: a trigger's run gets `trigger`.
         "    } & (TStream extends true ? { stream: ZiteStreamInterface } : {}) & (TTrigger extends ZiteTrigger ? { trigger?: ZiteTriggerContext<TTrigger> } : {}),",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zitejs",
-  "version": "0.9.137",
+  "version": "0.10.0-start.0",
   "description": "The Zite framework — build apps on Zite Database",
   "type": "module",
   "sideEffects": false,
@@ -90,11 +90,37 @@
       "import": "./dist/esm/vite/index.js",
       "require": "./dist/cjs/vite/index.js",
       "default": "./dist/esm/vite/index.js"
+    },
+    "./start": {
+      "types": "./dist/esm/start/index.d.ts",
+      "import": "./dist/esm/start/index.js",
+      "default": "./dist/esm/start/index.js"
+    },
+    "./start/server": {
+      "types": "./dist/esm/start/server.d.ts",
+      "import": "./dist/esm/start/server.js",
+      "default": "./dist/esm/start/server.js"
+    },
+    "./start/instance": {
+      "types": "./dist/esm/start/instance.d.ts",
+      "import": "./dist/esm/start/instance.js",
+      "default": "./dist/esm/start/instance.js"
+    },
+    "./start/describe": {
+      "types": "./dist/esm/start/describe.d.ts",
+      "import": "./dist/esm/start/describe.js",
+      "default": "./dist/esm/start/describe.js"
+    },
+    "./vite": {
+      "types": "./dist/esm/start/vite.d.ts",
+      "import": "./dist/esm/start/vite.js",
+      "default": "./dist/esm/start/vite.js"
     }
   },
   "scripts": {
     "build": "tsc && tsc -p tsconfig.cjs.json && echo '{\"type\":\"commonjs\"}' > dist/cjs/package.json",
     "test": "vitest run",
+    "test:start": "node tests/start/run-contract.mjs",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "npm run build"
@@ -148,7 +174,12 @@
   "peerDependencies": {
     "@tanstack/react-query": ">=5",
     "react": ">=18",
-    "vite": ">=5"
+    "vite": ">=5",
+    "@tanstack/react-start": "1.168.60",
+    "@tanstack/start-storage-context": "1.167.36",
+    "@vitejs/plugin-react": ">=5",
+    "@cloudflare/vite-plugin": ">=1",
+    "@tanstack/react-router": "1.170.41"
   },
   "peerDependenciesMeta": {
     "react": {
@@ -159,14 +190,34 @@
     },
     "vite": {
       "optional": true
+    },
+    "@tanstack/react-start": {
+      "optional": true
+    },
+    "@tanstack/start-storage-context": {
+      "optional": true
+    },
+    "@vitejs/plugin-react": {
+      "optional": true
+    },
+    "@cloudflare/vite-plugin": {
+      "optional": true
+    },
+    "@tanstack/react-router": {
+      "optional": true
     }
   },
   "devDependencies": {
     "@tanstack/react-query": "^5.100.14",
+    "@tanstack/react-router": "1.170.41",
+    "@tanstack/react-start": "1.168.60",
+    "@tanstack/start-storage-context": "1.167.36",
     "@types/node": "^25.9.1",
     "@types/react": "^19.0.0",
+    "@vitejs/plugin-react": "^5.2.0",
     "react": "^19.0.0",
     "typescript": "^5.4.0",
+    "vite": "^7.3.7",
     "vitest": "^3.0.0"
   },
   "keywords": [

package/dist/cjs/meta/index.d.ts

@@ -1,14 +0,0 @@
-export type ZiteProjectUser = {
-    uuid: string;
-    firstName: string | null;
-    lastName: string | null;
-    email: string;
-    profilePictureUrl: string | null;
-};
-export type MetaListUsersResult = {
-    users: ZiteProjectUser[];
-};
-export declare class ZiteMeta {
-    static listUsers(): Promise<MetaListUsersResult>;
-}
-export declare const Meta: typeof ZiteMeta;

package/dist/cjs/meta/index.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Meta = exports.ZiteMeta = void 0;
-const sdkCall_js_1 = require("../internal/sdkCall.js");
-const META_SDK_INTEGRATION_ID = '__meta__';
-class ZiteMeta {
-    static listUsers() {
-        return (0, sdkCall_js_1.getSdkCall)()(META_SDK_INTEGRATION_ID, 'ZiteMeta', 'listUsers', {});
-    }
-}
-exports.ZiteMeta = ZiteMeta;
-exports.Meta = ZiteMeta;

package/dist/cjs/notifications/index.d.ts

@@ -1,25 +0,0 @@
-export interface NotificationLink {
-    path?: string;
-    params?: Record<string, string>;
-}
-export type NotificationsCreateParams = {
-    recipients: string[];
-    title: string;
-    body?: string;
-    link?: NotificationLink;
-    path?: string;
-    params?: Record<string, string>;
-    payload?: Record<string, unknown>;
-    idempotencyKey?: string;
-};
-export type NotificationsCreateResult = {
-    created: number;
-} | {
-    created: 0;
-    preview: true;
-    wouldCreate: number;
-};
-export declare class ZiteNotifications {
-    static create(params: NotificationsCreateParams): Promise<NotificationsCreateResult>;
-}
-export declare const Notifications: typeof ZiteNotifications;

package/dist/cjs/notifications/index.js

@@ -1,12 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Notifications = exports.ZiteNotifications = void 0;
-const sdkCall_js_1 = require("../internal/sdkCall.js");
-const NOTIFICATIONS_SDK_INTEGRATION_ID = '__notifications__';
-class ZiteNotifications {
-    static create(params) {
-        return (0, sdkCall_js_1.getSdkCall)()(NOTIFICATIONS_SDK_INTEGRATION_ID, 'ZiteNotifications', 'create', params);
-    }
-}
-exports.ZiteNotifications = ZiteNotifications;
-exports.Notifications = ZiteNotifications;

package/dist/esm/meta/index.d.ts

@@ -1,14 +0,0 @@
-export type ZiteProjectUser = {
-    uuid: string;
-    firstName: string | null;
-    lastName: string | null;
-    email: string;
-    profilePictureUrl: string | null;
-};
-export type MetaListUsersResult = {
-    users: ZiteProjectUser[];
-};
-export declare class ZiteMeta {
-    static listUsers(): Promise<MetaListUsersResult>;
-}
-export declare const Meta: typeof ZiteMeta;

package/dist/esm/meta/index.js

@@ -1,8 +0,0 @@
-import { getSdkCall } from '../internal/sdkCall.js';
-const META_SDK_INTEGRATION_ID = '__meta__';
-export class ZiteMeta {
-    static listUsers() {
-        return getSdkCall()(META_SDK_INTEGRATION_ID, 'ZiteMeta', 'listUsers', {});
-    }
-}
-export const Meta = ZiteMeta;

package/dist/esm/notifications/index.d.ts

@@ -1,25 +0,0 @@
-export interface NotificationLink {
-    path?: string;
-    params?: Record<string, string>;
-}
-export type NotificationsCreateParams = {
-    recipients: string[];
-    title: string;
-    body?: string;
-    link?: NotificationLink;
-    path?: string;
-    params?: Record<string, string>;
-    payload?: Record<string, unknown>;
-    idempotencyKey?: string;
-};
-export type NotificationsCreateResult = {
-    created: number;
-} | {
-    created: 0;
-    preview: true;
-    wouldCreate: number;
-};
-export declare class ZiteNotifications {
-    static create(params: NotificationsCreateParams): Promise<NotificationsCreateResult>;
-}
-export declare const Notifications: typeof ZiteNotifications;

package/dist/esm/notifications/index.js

@@ -1,8 +0,0 @@
-import { getSdkCall } from '../internal/sdkCall.js';
-const NOTIFICATIONS_SDK_INTEGRATION_ID = '__notifications__';
-export class ZiteNotifications {
-    static create(params) {
-        return getSdkCall()(NOTIFICATIONS_SDK_INTEGRATION_ID, 'ZiteNotifications', 'create', params);
-    }
-}
-export const Notifications = ZiteNotifications;