vite-plugin-tanstack-start-zephyr 0.0.0 → 0.1.0

package/.eslintrc.json

@@ -0,0 +1,18 @@
+{
+  "extends": ["../../.eslintrc.json"],
+  "ignorePatterns": ["!**/*"],
+  "overrides": [
+    {
+      "files": ["*.ts", "*.tsx", "*.js", "*.jsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.ts", "*.tsx"],
+      "rules": {}
+    },
+    {
+      "files": ["*.js", "*.jsx"],
+      "rules": {}
+    }
+  ]
+}

package/LICENSE

@@ -0,0 +1,201 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+1. Definitions.
+
+   "License" shall mean the terms and conditions for use, reproduction,
+   and distribution as defined by Sections 1 through 9 of this document.
+
+   "Licensor" shall mean the copyright owner or entity authorized by
+   the copyright owner that is granting the License.
+
+   "Legal Entity" shall mean the union of the acting entity and all
+   other entities that control, are controlled by, or are under common
+   control with that entity. For the purposes of this definition,
+   "control" means (i) the power, direct or indirect, to cause the
+   direction or management of such entity, whether by contract or
+   otherwise, or (ii) ownership of fifty percent (50%) or more of the
+   outstanding shares, or (iii) beneficial ownership of such entity.
+
+   "You" (or "Your") shall mean an individual or Legal Entity
+   exercising permissions granted by this License.
+
+   "Source" form shall mean the preferred form for making modifications,
+   including but not limited to software source code, documentation
+   source, and configuration files.
+
+   "Object" form shall mean any form resulting from mechanical
+   transformation or translation of a Source form, including but
+   not limited to compiled object code, generated documentation,
+   and conversions to other media types.
+
+   "Work" shall mean the work of authorship, whether in Source or
+   Object form, made available under the License, as indicated by a
+   copyright notice that is included in or attached to the work
+   (an example is provided in the Appendix below).
+
+   "Derivative Works" shall mean any work, whether in Source or Object
+   form, that is based on (or derived from) the Work and for which the
+   editorial revisions, annotations, elaborations, or other modifications
+   represent, as a whole, an original work of authorship. For the purposes
+   of this License, Derivative Works shall not include works that remain
+   separable from, or merely link (or bind by name) to the interfaces of,
+   the Work and Derivative Works thereof.
+
+   "Contribution" shall mean any work of authorship, including
+   the original version of the Work and any modifications or additions
+   to that Work or Derivative Works thereof, that is intentionally
+   submitted to Licensor for inclusion in the Work by the copyright owner
+   or by an individual or Legal Entity authorized to submit on behalf of
+   the copyright owner. For the purposes of this definition, "submitted"
+   means any form of electronic, verbal, or written communication sent
+   to the Licensor or its representatives, including but not limited to
+   communication on electronic mailing lists, source code control systems,
+   and issue tracking systems that are managed by, or on behalf of, the
+   Licensor for the purpose of discussing and improving the Work, but
+   excluding communication that is conspicuously marked or otherwise
+   designated in writing by the copyright owner as "Not a Contribution."
+
+   "Contributor" shall mean Licensor and any individual or Legal Entity
+   on behalf of whom a Contribution has been received by Licensor and
+   subsequently incorporated within the Work.
+
+2. Grant of Copyright License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   copyright license to reproduce, prepare Derivative Works of,
+   publicly display, publicly perform, sublicense, and distribute the
+   Work and such Derivative Works in Source or Object form.
+
+3. Grant of Patent License. Subject to the terms and conditions of
+   this License, each Contributor hereby grants to You a perpetual,
+   worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+   (except as stated in this section) patent license to make, have made,
+   use, offer to sell, sell, import, and otherwise transfer the Work,
+   where such license applies only to those patent claims licensable
+   by such Contributor that are necessarily infringed by their
+   Contribution(s) alone or by combination of their Contribution(s)
+   with the Work to which such Contribution(s) was submitted. If You
+   institute patent litigation against any entity (including a
+   cross-claim or counterclaim in a lawsuit) alleging that the Work
+   or a Contribution incorporated within the Work constitutes direct
+   or contributory patent infringement, then any patent licenses
+   granted to You under this License for that Work shall terminate
+   as of the date such litigation is filed.
+
+4. Redistribution. You may reproduce and distribute copies of the
+   Work or Derivative Works thereof in any medium, with or without
+   modifications, and in Source or Object form, provided that You
+   meet the following conditions:
+
+   (a) You must give any other recipients of the Work or
+       Derivative Works a copy of this License; and
+
+   (b) You must cause any modified files to carry prominent notices
+       stating that You changed the files; and
+
+   (c) You must retain, in the Source form of any Derivative Works
+       that You distribute, all copyright, patent, trademark, and
+       attribution notices from the Source form of the Work,
+       excluding those notices that do not pertain to any part of
+       the Derivative Works; and
+
+   (d) If the Work includes a "NOTICE" text file as part of its
+       distribution, then any Derivative Works that You distribute must
+       include a readable copy of the attribution notices contained
+       within such NOTICE file, excluding those notices that do not
+       pertain to any part of the Derivative Works, in at least one
+       of the following places: within a NOTICE text file distributed
+       as part of the Derivative Works; within the Source form or
+       documentation, if provided along with the Derivative Works; or,
+       within a display generated by the Derivative Works, if and
+       wherever such third-party notices normally appear. The contents
+       of the NOTICE file are for informational purposes only and
+       do not modify the License. You may add Your own attribution
+       notices within Derivative Works that You distribute, alongside
+       or as an addendum to the NOTICE text from the Work, provided
+       that such additional attribution notices cannot be construed
+       as modifying the License.
+
+   You may add Your own copyright statement to Your modifications and
+   may provide additional or different license terms and conditions
+   for use, reproduction, or distribution of Your modifications, or
+   for any such Derivative Works as a whole, provided Your use,
+   reproduction, and distribution of the Work otherwise complies with
+   the conditions stated in this License.
+
+5. Submission of Contributions. Unless You explicitly state otherwise,
+   any Contribution intentionally submitted for inclusion in the Work
+   by You to the Licensor shall be under the terms and conditions of
+   this License, without any additional terms or conditions.
+   Notwithstanding the above, nothing herein shall supersede or modify
+   the terms of any separate license agreement you may have executed
+   with Licensor regarding such Contributions.
+
+6. Trademarks. This License does not grant permission to use the trade
+   names, trademarks, service marks, or product names of the Licensor,
+   except as required for reasonable and customary use in describing the
+   origin of the Work and reproducing the content of the NOTICE file.
+
+7. Disclaimer of Warranty. Unless required by applicable law or
+   agreed to in writing, Licensor provides the Work (and each
+   Contributor provides its Contributions) on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+   implied, including, without limitation, any warranties or conditions
+   of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+   PARTICULAR PURPOSE. You are solely responsible for determining the
+   appropriateness of using or redistributing the Work and assume any
+   risks associated with Your exercise of permissions under this License.
+
+8. Limitation of Liability. In no event and under no legal theory,
+   whether in tort (including negligence), contract, or otherwise,
+   unless required by applicable law (such as deliberate and grossly
+   negligent acts) or agreed to in writing, shall any Contributor be
+   liable to You for damages, including any direct, indirect, special,
+   incidental, or consequential damages of any character arising as a
+   result of this License or out of the use or inability to use the
+   Work (including but not limited to damages for loss of goodwill,
+   work stoppage, computer failure or malfunction, or any and all
+   other commercial damages or losses), even if such Contributor
+   has been advised of the possibility of such damages.
+
+9. Accepting Warranty or Additional Liability. While redistributing
+   the Work or Derivative Works thereof, You may choose to offer,
+   and charge a fee for, acceptance of support, warranty, indemnity,
+   or other liability obligations and/or rights consistent with this
+   License. However, in accepting such obligations, You may act only
+   on Your own behalf and on Your sole responsibility, not on behalf
+   of any other Contributor, and only if You agree to indemnify,
+   defend, and hold each Contributor harmless for any liability
+   incurred by, or claims asserted against, such Contributor by reason
+   of your accepting any such warranty or additional liability.
+
+END OF TERMS AND CONDITIONS
+
+APPENDIX: How to apply the Apache License to your work.
+
+   To apply the Apache License to your work, attach the following
+   boilerplate notice, with the fields enclosed by brackets "[]"
+   replaced with your own identifying information. (Don't include
+   the brackets!)  The text should be enclosed in the appropriate
+   comment syntax for the file format. We also recommend that a
+   file or class name and description of purpose be included on the
+   same "printed page" as the copyright notice for easier
+   identification within third-party archives.
+
+Copyright [Zephyr Cloud Inc] [Dmitriy Shekhovtsov, Zackary Chapple, Zack Jackson]
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,132 @@
+# vite-plugin-tanstack-start-zephyr
+
+Vite plugin for deploying TanStack Start applications to Zephyr with SSR support.
+
+## Overview
+
+This plugin automatically bundles and uploads your TanStack Start application to Zephyr's edge network during the build process. It supports server-side rendering (SSR) and enables multiple versions of your application to run simultaneously.
+
+## Installation
+
+```bash
+pnpm add vite-plugin-tanstack-start-zephyr
+```
+
+## Usage
+
+Add the plugin to your `vite.config.ts`:
+
+```typescript
+import { defineConfig } from 'vite';
+import { TanStackStartVite } from '@tanstack/start/vite';
+import { withZephyrTanstackStart } from 'vite-plugin-tanstack-start-zephyr';
+
+export default defineConfig({
+  plugins: [
+    TanStackStartVite(),
+    withZephyrTanstackStart({
+      appUid: 'my-app-uid',
+      environment: 'production',
+      apiEndpoint: 'https://api.zephyrcloud.app',
+      apiKey: process.env.ZEPHYR_API_KEY,
+    }),
+  ],
+});
+```
+
+## Configuration
+
+### Options
+
+| Option        | Type     | Required | Description                                    |
+| ------------- | -------- | -------- | ---------------------------------------------- |
+| `appUid`      | `string` | Yes      | Your application's unique identifier           |
+| `environment` | `string` | No       | Deployment environment (default: 'production') |
+| `apiEndpoint` | `string` | No       | Zephyr API endpoint                            |
+| `apiKey`      | `string` | No       | API key for authentication                     |
+
+### Environment Variables
+
+You can also configure the plugin using environment variables:
+
+- `ZE_APP_UID` - Application UID
+- `ZE_API_ENDPOINT` - API endpoint
+- `ZE_API_KEY` - API key
+- `ZE_ENVIRONMENT` - Deployment environment
+
+## How It Works
+
+1. **Build**: TanStack Start builds your app to `.output/` directory
+2. **Extract**: Plugin collects server modules and client assets
+3. **Bundle**: Server code is bundled with all dependencies
+4. **Upload**: Both server and client files are uploaded to Zephyr
+5. **Deploy**: Files are stored in content-addressable KV storage
+6. **Run**: Orchestration worker loads and runs your app on the edge
+
+## Build Output
+
+The plugin processes TanStack Start's build output:
+
+```
+.output/
+├── server/           # Server-side code
+│   ├── index.js     # Main entry point
+│   └── assets/      # Server bundles
+└── client/          # Client-side assets
+    └── assets/      # Client bundles
+```
+
+## Deployment Architecture
+
+Your app runs in Cloudflare's orchestration worker using dynamic worker loaders:
+
+```
+Request → Orchestration Worker → Load Your App (Isolate) → Response
+```
+
+Features:
+
+- ✅ Multiple versions live simultaneously
+- ✅ Content-addressable storage (efficient caching)
+- ✅ SSR and API routes support
+- ✅ Hot swapping without redeployment
+- ✅ Per-version isolation
+
+## Development
+
+### Build Plugin
+
+```bash
+cd libs/vite-plugin-tanstack-start-zephyr
+pnpm build
+```
+
+### Run Tests
+
+```bash
+pnpm test
+```
+
+### Link Locally
+
+```bash
+pnpm link --global
+# In your project
+pnpm link --global vite-plugin-tanstack-start-zephyr
+```
+
+## Requirements
+
+- Node.js 18+
+- TanStack Start 1.0+
+- Vite 5+
+
+## License
+
+MIT
+
+## Related
+
+- [@tanstack/start](https://tanstack.com/start) - TanStack Start framework
+- [zephyr-agent](../zephyr-agent) - Core Zephyr upload library
+- [vite-plugin-zephyr](../vite-plugin-zephyr) - Static site Vite plugin

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Vite-plugin-tanstack-start-zephyr
+ *
+ * Vite plugin for deploying TanStack Start applications to Zephyr with SSR support
+ *
+ * Configuration is automatically detected from:
+ *
+ * - Package.json (app name, version)
+ * - Git info (org, project, branch)
+ * - Zephyr auth (via `ze login`)
+ */
+export { withZephyrTanstackStart, type TanStackStartZephyrOptions, } from './lib/vite-plugin-tanstack-start-zephyr';

package/dist/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Vite-plugin-tanstack-start-zephyr
+ *
+ * Vite plugin for deploying TanStack Start applications to Zephyr with SSR support
+ *
+ * Configuration is automatically detected from:
+ *
+ * - Package.json (app name, version)
+ * - Git info (org, project, branch)
+ * - Zephyr auth (via `ze login`)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withZephyrTanstackStart = void 0;
+var vite_plugin_tanstack_start_zephyr_1 = require("./lib/vite-plugin-tanstack-start-zephyr");
+Object.defineProperty(exports, "withZephyrTanstackStart", { enumerable: true, get: function () { return vite_plugin_tanstack_start_zephyr_1.withZephyrTanstackStart; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;AAEH,6FAGiD;AAF/C,4IAAA,uBAAuB,OAAA"}

package/dist/lib/internal/extract/load-tanstack-output.d.ts

@@ -0,0 +1,16 @@
+/** Loads TanStack Start build output from .output directory */
+import type { OutputBundle } from 'rollup';
+/** Load files from directory into Rollup OutputBundle format */
+export declare function loadFilesFromDirectory(dir: string): Promise<OutputBundle>;
+/**
+ * Load TanStack Start build output preserving full directory structure This loads ALL
+ * files from the output directory root, maintaining their natural paths (e.g.,
+ * server/index.js, client/assets/main.js, favicon.ico)
+ */
+export declare function loadTanStackOutput(outputDir: string): Promise<OutputBundle>;
+/** @deprecated Use loadTanStackOutput instead - this preserves the full structure */
+export declare function loadServerOutput(outputDir: string): Promise<OutputBundle>;
+/** @deprecated Use loadTanStackOutput instead - this preserves the full structure */
+export declare function loadClientOutput(outputDir: string): Promise<OutputBundle>;
+/** Check if TanStack Start output directory exists and is valid */
+export declare function validateTanStackOutput(outputDir: string): Promise<boolean>;

package/dist/lib/internal/extract/load-tanstack-output.js

@@ -0,0 +1,126 @@
+"use strict";
+/** Loads TanStack Start build output from .output directory */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadFilesFromDirectory = loadFilesFromDirectory;
+exports.loadTanStackOutput = loadTanStackOutput;
+exports.loadServerOutput = loadServerOutput;
+exports.loadClientOutput = loadClientOutput;
+exports.validateTanStackOutput = validateTanStackOutput;
+const tslib_1 = require("tslib");
+const fs = tslib_1.__importStar(require("fs/promises"));
+const path = tslib_1.__importStar(require("path"));
+/** Recursively get all files in a directory using Node.js native recursive option */
+async function getAllFiles(dir) {
+    const entries = await fs.readdir(dir, { recursive: true, withFileTypes: true });
+    return entries
+        .filter((entry) => entry.isFile())
+        .map((entry) => { var _a; return path.join((_a = entry.parentPath) !== null && _a !== void 0 ? _a : entry.path, entry.name); });
+}
+/** Load files from directory into Rollup OutputBundle format */
+async function loadFilesFromDirectory(dir) {
+    const bundle = {};
+    try {
+        const files = await getAllFiles(dir);
+        for (const filePath of files) {
+            const relativePath = path.relative(dir, filePath);
+            const content = await fs.readFile(filePath);
+            const ext = path.extname(filePath);
+            // Determine if this is a code chunk or asset
+            const isCode = ext === '.js' || ext === '.mjs' || ext === '.cjs';
+            if (isCode) {
+                // Create OutputChunk for code files
+                const chunk = {
+                    type: 'chunk',
+                    fileName: relativePath,
+                    name: path.basename(relativePath, ext),
+                    code: content.toString('utf-8'),
+                    isEntry: relativePath === 'index.js' || relativePath.includes('index'),
+                    isDynamicEntry: false,
+                    facadeModuleId: null,
+                    moduleIds: [],
+                    exports: [],
+                    imports: [],
+                    dynamicImports: [],
+                    implicitlyLoadedBefore: [],
+                    importedBindings: {},
+                    referencedFiles: [],
+                    modules: {},
+                    map: null,
+                    sourcemapFileName: null,
+                    preliminaryFileName: relativePath,
+                    isImplicitEntry: false,
+                };
+                bundle[relativePath] = chunk;
+            }
+            else {
+                // Create OutputAsset for non-code files
+                const asset = {
+                    type: 'asset',
+                    fileName: relativePath,
+                    name: relativePath,
+                    needsCodeReference: false,
+                    source: content,
+                    names: [],
+                    originalFileName: null,
+                    originalFileNames: [],
+                };
+                bundle[relativePath] = asset;
+            }
+        }
+        return bundle;
+    }
+    catch (error) {
+        console.error(`Error loading files from ${dir}:`, error);
+        throw error;
+    }
+}
+/**
+ * Load TanStack Start build output preserving full directory structure This loads ALL
+ * files from the output directory root, maintaining their natural paths (e.g.,
+ * server/index.js, client/assets/main.js, favicon.ico)
+ */
+async function loadTanStackOutput(outputDir) {
+    // Load from the root output directory to preserve natural structure
+    return loadFilesFromDirectory(outputDir);
+}
+/** @deprecated Use loadTanStackOutput instead - this preserves the full structure */
+async function loadServerOutput(outputDir) {
+    const serverDir = path.join(outputDir, 'server');
+    return loadFilesFromDirectory(serverDir);
+}
+/** @deprecated Use loadTanStackOutput instead - this preserves the full structure */
+async function loadClientOutput(outputDir) {
+    const clientDir = path.join(outputDir, 'client');
+    return loadFilesFromDirectory(clientDir);
+}
+/** Check if TanStack Start output directory exists and is valid */
+async function validateTanStackOutput(outputDir) {
+    try {
+        const serverDir = path.join(outputDir, 'server');
+        const clientDir = path.join(outputDir, 'client');
+        const [serverExists, clientExists] = await Promise.all([
+            fs
+                .access(serverDir)
+                .then(() => true)
+                .catch(() => false),
+            fs
+                .access(clientDir)
+                .then(() => true)
+                .catch(() => false),
+        ]);
+        if (!serverExists) {
+            console.error(`Server output directory not found: ${serverDir}`);
+            return false;
+        }
+        if (!clientExists) {
+            console.warn(`Client output directory not found: ${clientDir}`);
+            // Client is optional, might be API-only
+        }
+        return true;
+    }
+    catch (error) {
+        console.error('Error validating TanStack output:', error);
+        return false;
+    }
+}
+//# sourceMappingURL=load-tanstack-output.js.map

package/dist/lib/internal/extract/load-tanstack-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-tanstack-output.js","sourceRoot":"","sources":["../../../../src/lib/internal/extract/load-tanstack-output.ts"],"names":[],"mappings":"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"}

package/dist/lib/vite-plugin-tanstack-start-zephyr.d.ts

@@ -0,0 +1,32 @@
+/** Vite plugin for deploying TanStack Start applications to Zephyr */
+import type { Plugin } from 'vite';
+/**
+ * Plugin options for TanStack Start Zephyr deployment All configuration is handled
+ * automatically by ZephyrEngine via package.json and git info
+ */
+export interface TanStackStartZephyrOptions {
+    /**
+     * Optional output directory override Defaults to 'dist' relative to project root
+     * (TanStack Start default)
+     */
+    outputDir?: string;
+    /**
+     * Server entry file path for SSR.
+     *
+     * This should be a path **relative to the TanStack Start output directory** (usually
+     * `dist/`). For example: `server/index.js`.
+     *
+     * Defaults to `server/index.js`.
+     */
+    entrypoint?: string;
+}
+/**
+ * Main Vite plugin for TanStack Start Zephyr deployment
+ *
+ * Configuration is automatically detected from:
+ *
+ * - Package.json (app name, version)
+ * - Git info (org, project, branch)
+ * - Zephyr auth (via ze login)
+ */
+export declare function withZephyrTanstackStart(options?: TanStackStartZephyrOptions): Plugin;

package/dist/lib/vite-plugin-tanstack-start-zephyr.js

@@ -0,0 +1,156 @@
+"use strict";
+/** Vite plugin for deploying TanStack Start applications to Zephyr */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withZephyrTanstackStart = withZephyrTanstackStart;
+const tslib_1 = require("tslib");
+const path = tslib_1.__importStar(require("path"));
+const zephyr_agent_1 = require("zephyr-agent");
+const load_tanstack_output_1 = require("./internal/extract/load-tanstack-output");
+/** Extract buffer from Rollup output */
+function extractBuffer(item) {
+    if (item.type === 'chunk') {
+        return Buffer.from(item.code, 'utf-8');
+    }
+    else if (item.type === 'asset') {
+        if (typeof item.source === 'string') {
+            return Buffer.from(item.source, 'utf-8');
+        }
+        else if (Buffer.isBuffer(item.source)) {
+            return item.source;
+        }
+        else {
+            return Buffer.from(item.source);
+        }
+    }
+    return Buffer.from('');
+}
+/** Get asset type from Rollup output item */
+function getAssetType(item) {
+    const fileName = item.fileName || item.name || '';
+    const ext = path.extname(fileName).toLowerCase();
+    // Note: .cjs is intentionally excluded as workers don't support CommonJS
+    const typeMap = {
+        '.js': 'application/javascript',
+        '.mjs': 'application/javascript',
+        '.css': 'text/css',
+        '.html': 'text/html',
+        '.json': 'application/json',
+    };
+    return typeMap[ext] || 'application/octet-stream';
+}
+function normalizeEntrypoint(entrypoint) {
+    let normalized = entrypoint.trim();
+    // Normalize separators to match snapshot asset keys (posix-style).
+    normalized = normalized.split('\\').join('/');
+    // Remove common leading prefixes users may provide.
+    while (normalized.startsWith('./')) {
+        normalized = normalized.slice(2);
+    }
+    while (normalized.startsWith('/')) {
+        normalized = normalized.slice(1);
+    }
+    if (normalized.startsWith('dist/')) {
+        normalized = normalized.slice('dist/'.length);
+    }
+    return normalized;
+}
+/**
+ * Main Vite plugin for TanStack Start Zephyr deployment
+ *
+ * Configuration is automatically detected from:
+ *
+ * - Package.json (app name, version)
+ * - Git info (org, project, branch)
+ * - Zephyr auth (via ze login)
+ */
+function withZephyrTanstackStart(options = {}) {
+    const { zephyr_engine_defer, zephyr_defer_create } = zephyr_agent_1.ZephyrEngine.defer_create();
+    let config;
+    let outputDir;
+    let entrypoint;
+    let uploadCompleted = false; // Guard to ensure we only upload once
+    return {
+        name: 'vite-plugin-tanstack-start-zephyr',
+        enforce: 'post', // Run after TanStack Start plugin
+        configResolved(resolvedConfig) {
+            config = resolvedConfig;
+            // For TanStack Start, always use the root dist directory (contains server/ and client/)
+            // Don't use config.build.outDir as it points to dist/server/ during SSR build
+            outputDir = options.outputDir || path.join(config.root, 'dist');
+            entrypoint = normalizeEntrypoint(options.entrypoint || 'server/index.js');
+        },
+        async buildApp(builder) {
+            // Guard: Only process upload once, even if buildApp is called multiple times
+            if (uploadCompleted) {
+                return;
+            }
+            // Initialize ZephyrEngine in buildApp (runs once) instead of configResolved (runs per environment)
+            // This ensures the engine is only created once, and start_new_build() is only called once
+            // NOTE: ZephyrEngine.create() automatically calls start_new_build()
+            const engineOptions = {
+                builder: 'vite',
+                context: config.root,
+            };
+            zephyr_defer_create(engineOptions);
+            const zephyr_engine = await zephyr_engine_defer;
+            // Log all environments and their build status for debugging
+            const environments = Object.entries(builder.environments);
+            zephyr_agent_1.ze_log.init(`buildApp hook called with ${environments.length} environment(s): ${environments.map(([name, env]) => `${name}(isBuilt=${env.isBuilt})`).join(', ')}`);
+            // Wait for all environments to be built (not just specific ones)
+            // This ensures we have all build outputs before uploading
+            const notBuilt = Object.entries(builder.environments)
+                .filter(([, env]) => !env.isBuilt)
+                .map(([name]) => name);
+            if (notBuilt.length > 0) {
+                zephyr_agent_1.ze_log.init(`Building environments that aren't built yet: ${notBuilt.join(', ')}`);
+                for (const envName of notBuilt) {
+                    const env = builder.environments[envName];
+                    if (env) {
+                        await builder.build(env);
+                    }
+                }
+            }
+            // Verify all environments are now built
+            const allBuilt = Object.values(builder.environments).every((env) => env.isBuilt);
+            if (!allBuilt) {
+                const stillNotBuilt = Object.entries(builder.environments)
+                    .filter(([, env]) => !env.isBuilt)
+                    .map(([name]) => name);
+                throw new zephyr_agent_1.ZephyrError(zephyr_agent_1.ZeErrors.ERR_DEPLOY_LOCAL_BUILD, {
+                    message: `Some environments are still not built: ${stillNotBuilt.join(', ')}`,
+                });
+            }
+            zephyr_agent_1.ze_log.upload('All environments built, processing output...');
+            try {
+                // Engine is already initialized above, and ZephyrEngine.create() automatically calls start_new_build()
+                // So we don't need to call start_new_build() again here
+                // Load ALL build output preserving directory structure
+                // This includes server/, client/, and any root files (favicon.ico, etc.)
+                // Note: We read from disk here (via loadTanStackOutput) rather than using Vite's
+                // generateBundle hook because TanStack Start uses multiple Vite environments
+                // (client, server, etc.) that build separately. The buildApp hook runs after
+                // all environments are complete, making disk reading the simplest approach
+                // that's consistent with vite-plugin-zephyr's loadStaticAssets pattern.
+                const bundle = await (0, load_tanstack_output_1.loadTanStackOutput)(outputDir);
+                const assetsMap = (0, zephyr_agent_1.buildAssetsMap)(bundle, extractBuffer, getAssetType);
+                zephyr_agent_1.ze_log.upload(`Uploading ${Object.keys(assetsMap).length} assets...`);
+                // Upload assets with SSR snapshot type
+                await zephyr_engine.upload_assets({
+                    assetsMap,
+                    buildStats: await (0, zephyr_agent_1.zeBuildDashData)(zephyr_engine),
+                    snapshotType: 'ssr',
+                    entrypoint,
+                });
+                // Finish build
+                await zephyr_engine.build_finished();
+                // Mark upload as completed to prevent multiple calls
+                uploadCompleted = true;
+                zephyr_agent_1.ze_log.upload('Deployment successful!');
+            }
+            catch (error) {
+                (0, zephyr_agent_1.handleGlobalError)(error);
+            }
+        },
+    };
+}
+//# sourceMappingURL=vite-plugin-tanstack-start-zephyr.js.map

package/dist/lib/vite-plugin-tanstack-start-zephyr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vite-plugin-tanstack-start-zephyr.js","sourceRoot":"","sources":["../../src/lib/vite-plugin-tanstack-start-zephyr.ts"],"names":[],"mappings":"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"}

package/dist/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "vite-plugin-tanstack-start-zephyr",
+  "version": "0.1.0",
+  "description": "Vite plugin for Zephyr with TanStack Start support",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ZephyrCloudIO/zephyr-packages.git",
+    "directory": "libs/vite-plugin-tanstack-start-zephyr"
+  },
+  "license": "Apache-2.0",
+  "author": {
+    "name": "ZephyrCloudIO",
+    "url": "https://github.com/ZephyrCloudIO"
+  },
+  "type": "commonjs",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "nx run vite-plugin-tanstack-start-zephyr:build",
+    "patch-version": "pnpm version"
+  },
+  "dependencies": {
+    "rollup": "catalog:rollup4",
+    "vite": "catalog:vite7",
+    "zephyr-agent": "workspace:*"
+  },
+  "peerDependencies": {
+    "@tanstack/react-start": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "catalog:typescript"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}

package/dist/tsconfig.tsbuildinfo

@@ -0,0 +1 @@
+{"version":"5.9.3"}

package/jest.config.ts

@@ -0,0 +1,10 @@
+export default {
+  displayName: 'vite-plugin-tanstack-start-zephyr',
+  preset: '../../jest.preset.js',
+  testEnvironment: 'node',
+  transform: {
+    '^.+\\.[tj]s$': ['ts-jest', { tsconfig: '<rootDir>/tsconfig.spec.json' }],
+  },
+  moduleFileExtensions: ['ts', 'js', 'html'],
+  coverageDirectory: '../../coverage/libs/vite-plugin-tanstack-start-zephyr',
+};

package/package.json

@@ -1,23 +1,37 @@
 {
   "name": "vite-plugin-tanstack-start-zephyr",
-  "version": "0.0.0",
-  "description": "Zephyr Plugin for Tanstack Start on Vite",
-  "homepage": "https://github.com/ZephyrCloudIO/zephyr-packages#readme",
-  "bugs": {
-    "url": "https://github.com/ZephyrCloudIO/zephyr-packages/issues"
-  },
+  "version": "0.1.0",
+  "description": "Vite plugin for Zephyr with TanStack Start support",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/ZephyrCloudIO/zephyr-packages.git"
+    "url": "git+https://github.com/ZephyrCloudIO/zephyr-packages.git",
+    "directory": "libs/vite-plugin-tanstack-start-zephyr"
   },
   "license": "Apache-2.0",
-  "author": "ZephyrCloudIO",
+  "author": {
+    "name": "ZephyrCloudIO",
+    "url": "https://github.com/ZephyrCloudIO"
+  },
   "type": "commonjs",
-  "main": "index.js",
-  "directories": {
-    "test": "test"
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "dependencies": {
+    "rollup": "^4.36.0",
+    "vite": "^7.1.11",
+    "zephyr-agent": "0.1.3"
+  },
+  "peerDependencies": {
+    "@tanstack/react-start": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.11"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
   },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "nx run vite-plugin-tanstack-start-zephyr:build",
+    "patch-version": "pnpm version"
   }
 }

package/project.json

@@ -0,0 +1,35 @@
+{
+  "name": "vite-plugin-tanstack-start-zephyr",
+  "$schema": "../../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "libs/vite-plugin-tanstack-start-zephyr/src",
+  "projectType": "library",
+  "tags": [],
+  "implicitDependencies": ["zephyr-agent"],
+  "targets": {
+    "build": {
+      "executor": "@nx/js:tsc",
+      "outputs": ["{options.outputPath}"],
+      "options": {
+        "rootDir": "libs/vite-plugin-tanstack-start-zephyr/src",
+        "outputPath": "libs/vite-plugin-tanstack-start-zephyr/dist",
+        "tsConfig": "libs/vite-plugin-tanstack-start-zephyr/tsconfig.lib.json",
+        "main": "libs/vite-plugin-tanstack-start-zephyr/src/index.ts"
+      }
+    },
+    "nx-release-publish": {
+      "options": {
+        "packageRoot": "dist\\{projectRoot}"
+      }
+    },
+    "lint": {
+      "executor": "@nx/eslint:lint"
+    },
+    "test": {
+      "executor": "@nx/jest:jest",
+      "outputs": ["{workspaceRoot}/coverage/{projectRoot}"],
+      "options": {
+        "jestConfig": "libs/vite-plugin-tanstack-start-zephyr/jest.config.ts"
+      }
+    }
+  }
+}

package/src/index.ts

@@ -0,0 +1,16 @@
+/**
+ * Vite-plugin-tanstack-start-zephyr
+ *
+ * Vite plugin for deploying TanStack Start applications to Zephyr with SSR support
+ *
+ * Configuration is automatically detected from:
+ *
+ * - Package.json (app name, version)
+ * - Git info (org, project, branch)
+ * - Zephyr auth (via `ze login`)
+ */
+
+export {
+  withZephyrTanstackStart,
+  type TanStackStartZephyrOptions,
+} from './lib/vite-plugin-tanstack-start-zephyr';

package/src/lib/internal/extract/load-tanstack-output.ts

@@ -0,0 +1,131 @@
+/** Loads TanStack Start build output from .output directory */
+
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import type { OutputBundle, OutputAsset, OutputChunk } from 'rollup';
+
+/** Recursively get all files in a directory using Node.js native recursive option */
+async function getAllFiles(dir: string): Promise<string[]> {
+  const entries = await fs.readdir(dir, { recursive: true, withFileTypes: true });
+  return entries
+    .filter((entry) => entry.isFile())
+    .map((entry) => path.join(entry.parentPath ?? entry.path, entry.name));
+}
+
+/** Load files from directory into Rollup OutputBundle format */
+export async function loadFilesFromDirectory(dir: string): Promise<OutputBundle> {
+  const bundle: OutputBundle = {};
+
+  try {
+    const files = await getAllFiles(dir);
+
+    for (const filePath of files) {
+      const relativePath = path.relative(dir, filePath);
+      const content = await fs.readFile(filePath);
+      const ext = path.extname(filePath);
+
+      // Determine if this is a code chunk or asset
+      const isCode = ext === '.js' || ext === '.mjs' || ext === '.cjs';
+
+      if (isCode) {
+        // Create OutputChunk for code files
+        const chunk: OutputChunk = {
+          type: 'chunk',
+          fileName: relativePath,
+          name: path.basename(relativePath, ext),
+          code: content.toString('utf-8'),
+          isEntry: relativePath === 'index.js' || relativePath.includes('index'),
+          isDynamicEntry: false,
+          facadeModuleId: null,
+          moduleIds: [],
+          exports: [],
+          imports: [],
+          dynamicImports: [],
+          implicitlyLoadedBefore: [],
+          importedBindings: {},
+          referencedFiles: [],
+          modules: {},
+          map: null,
+          sourcemapFileName: null,
+          preliminaryFileName: relativePath,
+          isImplicitEntry: false,
+        };
+        bundle[relativePath] = chunk;
+      } else {
+        // Create OutputAsset for non-code files
+        const asset: OutputAsset = {
+          type: 'asset',
+          fileName: relativePath,
+          name: relativePath,
+          needsCodeReference: false,
+          source: content,
+          names: [],
+          originalFileName: null,
+          originalFileNames: [],
+        };
+        bundle[relativePath] = asset;
+      }
+    }
+
+    return bundle;
+  } catch (error) {
+    console.error(`Error loading files from ${dir}:`, error);
+    throw error;
+  }
+}
+
+/**
+ * Load TanStack Start build output preserving full directory structure This loads ALL
+ * files from the output directory root, maintaining their natural paths (e.g.,
+ * server/index.js, client/assets/main.js, favicon.ico)
+ */
+export async function loadTanStackOutput(outputDir: string): Promise<OutputBundle> {
+  // Load from the root output directory to preserve natural structure
+  return loadFilesFromDirectory(outputDir);
+}
+
+/** @deprecated Use loadTanStackOutput instead - this preserves the full structure */
+export async function loadServerOutput(outputDir: string): Promise<OutputBundle> {
+  const serverDir = path.join(outputDir, 'server');
+  return loadFilesFromDirectory(serverDir);
+}
+
+/** @deprecated Use loadTanStackOutput instead - this preserves the full structure */
+export async function loadClientOutput(outputDir: string): Promise<OutputBundle> {
+  const clientDir = path.join(outputDir, 'client');
+  return loadFilesFromDirectory(clientDir);
+}
+
+/** Check if TanStack Start output directory exists and is valid */
+export async function validateTanStackOutput(outputDir: string): Promise<boolean> {
+  try {
+    const serverDir = path.join(outputDir, 'server');
+    const clientDir = path.join(outputDir, 'client');
+
+    const [serverExists, clientExists] = await Promise.all([
+      fs
+        .access(serverDir)
+        .then(() => true)
+        .catch(() => false),
+      fs
+        .access(clientDir)
+        .then(() => true)
+        .catch(() => false),
+    ]);
+
+    if (!serverExists) {
+      console.error(`Server output directory not found: ${serverDir}`);
+      return false;
+    }
+
+    if (!clientExists) {
+      console.warn(`Client output directory not found: ${clientDir}`);
+      // Client is optional, might be API-only
+    }
+
+    return true;
+  } catch (error) {
+    console.error('Error validating TanStack output:', error);
+    return false;
+  }
+}

package/src/lib/vite-plugin-tanstack-start-zephyr.ts

@@ -0,0 +1,208 @@
+/** Vite plugin for deploying TanStack Start applications to Zephyr */
+
+import type { Plugin, ResolvedConfig } from 'vite';
+import * as path from 'path';
+import {
+  ZephyrEngine,
+  type ZephyrEngineOptions,
+  zeBuildDashData,
+  buildAssetsMap,
+  ZeErrors,
+  ZephyrError,
+  ze_log,
+  handleGlobalError,
+} from 'zephyr-agent';
+import { loadTanStackOutput } from './internal/extract/load-tanstack-output';
+
+/** Extract buffer from Rollup output */
+function extractBuffer(item: any): Buffer {
+  if (item.type === 'chunk') {
+    return Buffer.from(item.code, 'utf-8');
+  } else if (item.type === 'asset') {
+    if (typeof item.source === 'string') {
+      return Buffer.from(item.source, 'utf-8');
+    } else if (Buffer.isBuffer(item.source)) {
+      return item.source;
+    } else {
+      return Buffer.from(item.source);
+    }
+  }
+  return Buffer.from('');
+}
+
+/** Get asset type from Rollup output item */
+function getAssetType(item: { fileName?: string; name?: string }): string {
+  const fileName = item.fileName || item.name || '';
+  const ext = path.extname(fileName).toLowerCase();
+  // Note: .cjs is intentionally excluded as workers don't support CommonJS
+  const typeMap: Record<string, string> = {
+    '.js': 'application/javascript',
+    '.mjs': 'application/javascript',
+    '.css': 'text/css',
+    '.html': 'text/html',
+    '.json': 'application/json',
+  };
+  return typeMap[ext] || 'application/octet-stream';
+}
+
+/**
+ * Plugin options for TanStack Start Zephyr deployment All configuration is handled
+ * automatically by ZephyrEngine via package.json and git info
+ */
+export interface TanStackStartZephyrOptions {
+  /**
+   * Optional output directory override Defaults to 'dist' relative to project root
+   * (TanStack Start default)
+   */
+  outputDir?: string;
+  /**
+   * Server entry file path for SSR.
+   *
+   * This should be a path **relative to the TanStack Start output directory** (usually
+   * `dist/`). For example: `server/index.js`.
+   *
+   * Defaults to `server/index.js`.
+   */
+  entrypoint?: string;
+}
+
+function normalizeEntrypoint(entrypoint: string): string {
+  let normalized = entrypoint.trim();
+  // Normalize separators to match snapshot asset keys (posix-style).
+  normalized = normalized.split('\\').join('/');
+
+  // Remove common leading prefixes users may provide.
+  while (normalized.startsWith('./')) {
+    normalized = normalized.slice(2);
+  }
+  while (normalized.startsWith('/')) {
+    normalized = normalized.slice(1);
+  }
+  if (normalized.startsWith('dist/')) {
+    normalized = normalized.slice('dist/'.length);
+  }
+
+  return normalized;
+}
+
+/**
+ * Main Vite plugin for TanStack Start Zephyr deployment
+ *
+ * Configuration is automatically detected from:
+ *
+ * - Package.json (app name, version)
+ * - Git info (org, project, branch)
+ * - Zephyr auth (via ze login)
+ */
+export function withZephyrTanstackStart(
+  options: TanStackStartZephyrOptions = {}
+): Plugin {
+  const { zephyr_engine_defer, zephyr_defer_create } = ZephyrEngine.defer_create();
+  let config: ResolvedConfig;
+  let outputDir: string;
+  let entrypoint: string;
+  let uploadCompleted = false; // Guard to ensure we only upload once
+
+  return {
+    name: 'vite-plugin-tanstack-start-zephyr',
+    enforce: 'post', // Run after TanStack Start plugin
+
+    configResolved(resolvedConfig) {
+      config = resolvedConfig;
+
+      // For TanStack Start, always use the root dist directory (contains server/ and client/)
+      // Don't use config.build.outDir as it points to dist/server/ during SSR build
+      outputDir = options.outputDir || path.join(config.root, 'dist');
+      entrypoint = normalizeEntrypoint(options.entrypoint || 'server/index.js');
+    },
+
+    async buildApp(builder) {
+      // Guard: Only process upload once, even if buildApp is called multiple times
+      if (uploadCompleted) {
+        return;
+      }
+
+      // Initialize ZephyrEngine in buildApp (runs once) instead of configResolved (runs per environment)
+      // This ensures the engine is only created once, and start_new_build() is only called once
+      // NOTE: ZephyrEngine.create() automatically calls start_new_build()
+      const engineOptions: ZephyrEngineOptions = {
+        builder: 'vite',
+        context: config.root,
+      };
+      zephyr_defer_create(engineOptions);
+      const zephyr_engine = await zephyr_engine_defer;
+      // Log all environments and their build status for debugging
+      const environments = Object.entries(builder.environments);
+      ze_log.init(
+        `buildApp hook called with ${environments.length} environment(s): ${environments.map(([name, env]) => `${name}(isBuilt=${env.isBuilt})`).join(', ')}`
+      );
+
+      // Wait for all environments to be built (not just specific ones)
+      // This ensures we have all build outputs before uploading
+      const notBuilt = Object.entries(builder.environments)
+        .filter(([, env]) => !env.isBuilt)
+        .map(([name]) => name);
+
+      if (notBuilt.length > 0) {
+        ze_log.init(
+          `Building environments that aren't built yet: ${notBuilt.join(', ')}`
+        );
+        for (const envName of notBuilt) {
+          const env = builder.environments[envName];
+          if (env) {
+            await builder.build(env);
+          }
+        }
+      }
+
+      // Verify all environments are now built
+      const allBuilt = Object.values(builder.environments).every((env) => env.isBuilt);
+      if (!allBuilt) {
+        const stillNotBuilt = Object.entries(builder.environments)
+          .filter(([, env]) => !env.isBuilt)
+          .map(([name]) => name);
+        throw new ZephyrError(ZeErrors.ERR_DEPLOY_LOCAL_BUILD, {
+          message: `Some environments are still not built: ${stillNotBuilt.join(', ')}`,
+        });
+      }
+
+      ze_log.upload('All environments built, processing output...');
+
+      try {
+        // Engine is already initialized above, and ZephyrEngine.create() automatically calls start_new_build()
+        // So we don't need to call start_new_build() again here
+
+        // Load ALL build output preserving directory structure
+        // This includes server/, client/, and any root files (favicon.ico, etc.)
+        // Note: We read from disk here (via loadTanStackOutput) rather than using Vite's
+        // generateBundle hook because TanStack Start uses multiple Vite environments
+        // (client, server, etc.) that build separately. The buildApp hook runs after
+        // all environments are complete, making disk reading the simplest approach
+        // that's consistent with vite-plugin-zephyr's loadStaticAssets pattern.
+        const bundle = await loadTanStackOutput(outputDir);
+
+        const assetsMap = buildAssetsMap(bundle, extractBuffer, getAssetType);
+
+        ze_log.upload(`Uploading ${Object.keys(assetsMap).length} assets...`);
+
+        // Upload assets with SSR snapshot type
+        await zephyr_engine.upload_assets({
+          assetsMap,
+          buildStats: await zeBuildDashData(zephyr_engine),
+          snapshotType: 'ssr',
+          entrypoint,
+        });
+
+        // Finish build
+        await zephyr_engine.build_finished();
+
+        // Mark upload as completed to prevent multiple calls
+        uploadCompleted = true;
+
+        ze_log.upload('Deployment successful!');
+      } catch (error) {
+        handleGlobalError(error);
+      }
+    },
+  };
+}

package/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "module": "commonjs",
+    "forceConsistentCasingInFileNames": true,
+    "strict": true,
+    "noImplicitOverride": true,
+    "noPropertyAccessFromIndexSignature": true,
+    "noImplicitReturns": true,
+    "noFallthroughCasesInSwitch": true
+  },
+  "files": [],
+  "include": [],
+  "references": [
+    {
+      "path": "./tsconfig.lib.json"
+    },
+    {
+      "path": "./tsconfig.spec.json"
+    }
+  ]
+}

package/tsconfig.lib.json

@@ -0,0 +1,11 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "module": "commonjs",
+    "outDir": "../../dist/out-tsc",
+    "declaration": true,
+    "types": ["node"]
+  },
+  "exclude": ["jest.config.ts", "src/**/*.spec.ts", "src/**/*.test.ts"],
+  "include": ["src/**/*.ts"]
+}

package/tsconfig.spec.json

@@ -0,0 +1,14 @@
+{
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "outDir": "../../dist/out-tsc",
+    "module": "commonjs",
+    "types": ["jest", "node"]
+  },
+  "include": [
+    "jest.config.ts",
+    "src/**/*.test.ts",
+    "src/**/*.spec.ts",
+    "src/**/*.d.ts"
+  ]
+}