@ebowwa/codespaces-types 1.1.0 → 1.2.0

package/runtime/database.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * Zod schemas for database operations validation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PluginsUpdateSchema = exports.ActivityUpdateSchema = exports.EnvironmentMetadataSchema = exports.ActivePortSchema = void 0;
+var zod_1 = require("zod");
+/**
+ * Active port schema
+ */
+exports.ActivePortSchema = zod_1.z.object({
+    port: zod_1.z.number().int().min(1).max(65535),
+    protocol: zod_1.z.enum(["tcp", "udp"]),
+    service: zod_1.z.string().optional(),
+    state: zod_1.z.enum(["open", "closed", "filtered"]),
+});
+/**
+ * Environment metadata schema for database operations
+ */
+exports.EnvironmentMetadataSchema = zod_1.z.object({
+    id: zod_1.z.string(),
+    description: zod_1.z.string().optional(),
+    project: zod_1.z.string().optional(),
+    owner: zod_1.z.string().optional(),
+    purpose: zod_1.z.string().optional(),
+    environmentType: zod_1.z
+        .enum(["development", "staging", "production", "testing"])
+        .optional(),
+    hoursActive: zod_1.z.number().min(0).optional(),
+    lastActive: zod_1.z.string().datetime().optional(),
+    activePorts: zod_1.z.array(exports.ActivePortSchema).optional(),
+    sshKeyPath: zod_1.z.string().optional(), // Path to SSH private key for terminal connections
+    bootstrapStatus: zod_1.z.enum(["bootstrapping", "ready", "failed"]).optional(), // Cloud-init bootstrap status
+    permissions: zod_1.z
+        .object({
+        seedConfig: zod_1.z
+            .object({
+            sourceEnvironmentId: zod_1.z.string().optional(),
+            dependencySnapshot: zod_1.z.string().optional(),
+            setupScript: zod_1.z.string().optional(),
+        })
+            .optional(),
+        logins: zod_1.z
+            .object({
+            github: zod_1.z
+                .object({
+                enabled: zod_1.z.boolean(),
+                username: zod_1.z.string().optional(),
+                tokenScopes: zod_1.z.array(zod_1.z.string()).optional(),
+            })
+                .optional(),
+            doppler: zod_1.z
+                .object({
+                enabled: zod_1.z.boolean(),
+                project: zod_1.z.string().optional(),
+                config: zod_1.z.string().optional(),
+            })
+                .optional(),
+            tailscale: zod_1.z
+                .object({
+                enabled: zod_1.z.boolean(),
+                authKey: zod_1.z.string().optional(),
+                hostname: zod_1.z.string().optional(),
+            })
+                .optional(),
+        })
+            .optional(),
+        vpns: zod_1.z
+            .array(zod_1.z.object({
+            name: zod_1.z.string(),
+            type: zod_1.z.enum(["wireguard", "openvpn", "tailscale"]),
+            config: zod_1.z.string(),
+            connected: zod_1.z.boolean(),
+        }))
+            .optional(),
+        plugins: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
+    })
+        .optional(),
+    updatedAt: zod_1.z.string().datetime().optional(),
+});
+/**
+ * Activity update schema
+ */
+exports.ActivityUpdateSchema = zod_1.z.object({
+    hoursActive: zod_1.z.number().min(0).optional(),
+    lastActive: zod_1.z.string().datetime().optional(),
+    activePorts: zod_1.z.array(exports.ActivePortSchema).optional(),
+});
+/**
+ * Plugins update schema
+ */
+exports.PluginsUpdateSchema = zod_1.z.object({
+    plugins: zod_1.z.record(zod_1.z.string(), zod_1.z.any()).optional(),
+});

package/runtime/database.ts

@@ -0,0 +1,107 @@
+/**
+ * Zod schemas for database operations validation
+ */
+
+import { z } from "zod";
+
+/**
+ * Active port schema
+ */
+export const ActivePortSchema = z.object({
+  port: z.number().int().min(1).max(65535),
+  protocol: z.enum(["tcp", "udp"]),
+  service: z.string().optional(),
+  state: z.enum(["open", "closed", "filtered"]),
+});
+
+/**
+ * Environment metadata schema for database operations
+ */
+export const EnvironmentMetadataSchema = z.object({
+  id: z.string(),
+  description: z.string().optional(),
+  project: z.string().optional(),
+  owner: z.string().optional(),
+  purpose: z.string().optional(),
+  environmentType: z
+    .enum(["development", "staging", "production", "testing"])
+    .optional(),
+  hoursActive: z.number().min(0).optional(),
+  lastActive: z.string().datetime().optional(),
+  activePorts: z.array(ActivePortSchema).optional(),
+  sshKeyPath: z.string().optional(), // Path to SSH private key for terminal connections
+  bootstrapStatus: z.enum(["bootstrapping", "ready", "failed"]).optional(), // Cloud-init bootstrap status
+  permissions: z
+    .object({
+      seedConfig: z
+        .object({
+          sourceEnvironmentId: z.string().optional(),
+          dependencySnapshot: z.string().optional(),
+          setupScript: z.string().optional(),
+        })
+        .optional(),
+      logins: z
+        .object({
+          github: z
+            .object({
+              enabled: z.boolean(),
+              username: z.string().optional(),
+              tokenScopes: z.array(z.string()).optional(),
+            })
+            .optional(),
+          doppler: z
+            .object({
+              enabled: z.boolean(),
+              project: z.string().optional(),
+              config: z.string().optional(),
+            })
+            .optional(),
+          tailscale: z
+            .object({
+              enabled: z.boolean(),
+              authKey: z.string().optional(),
+              hostname: z.string().optional(),
+            })
+            .optional(),
+        })
+        .optional(),
+      vpns: z
+        .array(
+          z.object({
+            name: z.string(),
+            type: z.enum(["wireguard", "openvpn", "tailscale"]),
+            config: z.string(),
+            connected: z.boolean(),
+          }),
+        )
+        .optional(),
+      plugins: z.record(z.string(), z.any()).optional(),
+    })
+    .optional(),
+  updatedAt: z.string().datetime().optional(),
+});
+
+/**
+ * Activity update schema
+ */
+export const ActivityUpdateSchema = z.object({
+  hoursActive: z.number().min(0).optional(),
+  lastActive: z.string().datetime().optional(),
+  activePorts: z.array(ActivePortSchema).optional(),
+});
+
+/**
+ * Plugins update schema
+ */
+export const PluginsUpdateSchema = z.object({
+  plugins: z.record(z.string(), z.any()).optional(),
+});
+
+/**
+ * Type exports for TypeScript inference
+ */
+export type EnvironmentMetadataInput = z.infer<
+  typeof EnvironmentMetadataSchema
+>;
+export type ActivityUpdateInput = z.infer<typeof ActivityUpdateSchema>;
+export type PluginsUpdateInput = z.infer<typeof PluginsUpdateSchema>;

package/runtime/env.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * Zod schemas for environment variable validation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvSchema = exports.AIEnvSchema = exports.ServerEnvSchema = void 0;
+exports.validateEnv = validateEnv;
+exports.validateServerEnv = validateServerEnv;
+exports.validateAIEnv = validateAIEnv;
+var zod_1 = require("zod");
+/**
+ * Server environment variables schema
+ */
+exports.ServerEnvSchema = zod_1.z.object({
+    TEMP_UPLOAD_DIR: zod_1.z.string().optional().default('/tmp/cheapspaces-uploads'),
+    HETZNER_API_TOKEN: zod_1.z.string().min(1).optional(),
+});
+/**
+ * AI client environment variables schema
+ * At least one API key must be provided
+ */
+exports.AIEnvSchema = zod_1.z
+    .object({
+    Z_AI_API_KEY: zod_1.z.string().min(1).optional(),
+    ZAI_API_KEY: zod_1.z.string().min(1).optional(),
+    GLM_API_KEY: zod_1.z.string().min(1).optional(),
+})
+    .refine(function (data) { return data.Z_AI_API_KEY || data.ZAI_API_KEY || data.GLM_API_KEY; }, {
+    message: 'At least one AI API key must be provided (Z_AI_API_KEY, ZAI_API_KEY, or GLM_API_KEY)',
+});
+/**
+ * Full environment variables schema
+ */
+exports.EnvSchema = zod_1.z.object({
+    TEMP_UPLOAD_DIR: zod_1.z.string().optional().default('/tmp/cheapspaces-uploads'),
+    HETZNER_API_TOKEN: zod_1.z.string().min(1).optional(),
+    Z_AI_API_KEY: zod_1.z.string().min(1).optional(),
+    ZAI_API_KEY: zod_1.z.string().min(1).optional(),
+    GLM_API_KEY: zod_1.z.string().min(1).optional(),
+}).refine(function (data) { return data.Z_AI_API_KEY || data.ZAI_API_KEY || data.GLM_API_KEY; }, {
+    message: 'At least one AI API key must be provided (Z_AI_API_KEY, ZAI_API_KEY, or GLM_API_KEY)',
+});
+/**
+ * Validate and parse environment variables
+ */
+function validateEnv(env) {
+    if (env === void 0) { env = process.env; }
+    return exports.EnvSchema.safeParse(env);
+}
+/**
+ * Validate and parse server environment variables
+ */
+function validateServerEnv(env) {
+    if (env === void 0) { env = process.env; }
+    return exports.ServerEnvSchema.safeParse(env);
+}
+/**
+ * Validate and parse AI environment variables
+ */
+function validateAIEnv(env) {
+    if (env === void 0) { env = process.env; }
+    return exports.AIEnvSchema.safeParse(env);
+}

package/runtime/env.ts

@@ -0,0 +1,68 @@
+/**
+ * Zod schemas for environment variable validation
+ */
+
+import { z } from 'zod'
+
+/**
+ * Server environment variables schema
+ */
+export const ServerEnvSchema = z.object({
+  TEMP_UPLOAD_DIR: z.string().optional().default('/tmp/cheapspaces-uploads'),
+  HETZNER_API_TOKEN: z.string().min(1).optional(),
+})
+
+/**
+ * AI client environment variables schema
+ * At least one API key must be provided
+ */
+export const AIEnvSchema = z
+  .object({
+    Z_AI_API_KEY: z.string().min(1).optional(),
+    ZAI_API_KEY: z.string().min(1).optional(),
+    GLM_API_KEY: z.string().min(1).optional(),
+  })
+  .refine((data) => data.Z_AI_API_KEY || data.ZAI_API_KEY || data.GLM_API_KEY, {
+    message: 'At least one AI API key must be provided (Z_AI_API_KEY, ZAI_API_KEY, or GLM_API_KEY)',
+  })
+
+/**
+ * Full environment variables schema
+ */
+export const EnvSchema = z.object({
+  TEMP_UPLOAD_DIR: z.string().optional().default('/tmp/cheapspaces-uploads'),
+  HETZNER_API_TOKEN: z.string().min(1).optional(),
+  Z_AI_API_KEY: z.string().min(1).optional(),
+  ZAI_API_KEY: z.string().min(1).optional(),
+  GLM_API_KEY: z.string().min(1).optional(),
+}).refine((data) => data.Z_AI_API_KEY || data.ZAI_API_KEY || data.GLM_API_KEY, {
+  message: 'At least one AI API key must be provided (Z_AI_API_KEY, ZAI_API_KEY, or GLM_API_KEY)',
+})
+
+/**
+ * Validate and parse environment variables
+ */
+export function validateEnv(env: Record<string, string | undefined> = process.env) {
+  return EnvSchema.safeParse(env)
+}
+
+/**
+ * Validate and parse server environment variables
+ */
+export function validateServerEnv(env: Record<string, string | undefined> = process.env) {
+  return ServerEnvSchema.safeParse(env)
+}
+
+/**
+ * Validate and parse AI environment variables
+ */
+export function validateAIEnv(env: Record<string, string | undefined> = process.env) {
+  return AIEnvSchema.safeParse(env)
+}
+
+/**
+ * Type exports for TypeScript inference
+ */
+export type ServerEnv = z.infer<typeof ServerEnvSchema>
+export type AIEnv = z.infer<typeof AIEnvSchema>
+export type Env = z.infer<typeof EnvSchema>

package/{dist/runtime → runtime}/glm.js

@@ -1,17 +1,20 @@
+"use strict";
 /**
  * Zod schemas for Z.AI GLM API
  *
  * Provider-specific schemas for Z.AI (GLM) models.
  * Generic AI schemas (chat messages, streaming, etc.) are in ./ai.ts
  */
-import { z } from "zod";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GLMModelSchema = void 0;
+var zod_1 = require("zod");
 // ============================================================================
 // Z.AI GLM MODELS
 // ============================================================================
 /**
  * Available GLM models from Z.AI API
  */
-export const GLMModelSchema = z.enum([
+exports.GLMModelSchema = zod_1.z.enum([
     "GLM-4.7",
     "GLM-4.6",
     "GLM-4.5",
@@ -20,6 +23,6 @@ export const GLMModelSchema = z.enum([
 // ============================================================================
 // EXPORTS
 // ============================================================================
-export default {
-    GLMModelSchema,
+exports.default = {
+    GLMModelSchema: exports.GLMModelSchema,
 };

package/runtime/glm.ts

@@ -0,0 +1,36 @@
+/**
+ * Zod schemas for Z.AI GLM API
+ *
+ * Provider-specific schemas for Z.AI (GLM) models.
+ * Generic AI schemas (chat messages, streaming, etc.) are in ./ai.ts
+ */
+
+import { z } from "zod";
+
+// ============================================================================
+// Z.AI GLM MODELS
+// ============================================================================
+
+/**
+ * Available GLM models from Z.AI API
+ */
+export const GLMModelSchema = z.enum([
+  "GLM-4.7",
+  "GLM-4.6",
+  "GLM-4.5",
+  "GLM-4.5-air",
+]);
+
+// ============================================================================
+// TYPE INFERENCE
+// ============================================================================
+
+export type GLMModel = z.infer<typeof GLMModelSchema>;
+
+// ============================================================================
+// EXPORTS
+// ============================================================================
+
+export default {
+  GLMModelSchema,
+};

package/runtime/index.js

@@ -0,0 +1,28 @@
+"use strict";
+/**
+ * Central export point for all Zod schemas
+ *
+ * Note: Hetzner schemas are in app/backend/shared/lib/hetzner/schemas.ts
+ * to keep them with the Hetzner client implementation.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./api.js"), exports);
+__exportStar(require("./ai.js"), exports);
+__exportStar(require("./database.js"), exports);
+__exportStar(require("./env.js"), exports);
+__exportStar(require("./glm.js"), exports);
+__exportStar(require("./ssh.js"), exports);

package/{dist/runtime/index.js → runtime/index.ts}

@@ -4,6 +4,7 @@
  * Note: Hetzner schemas are in app/backend/shared/lib/hetzner/schemas.ts
  * to keep them with the Hetzner client implementation.
  */
+
 export * from "./api.js";
 export * from "./ai.js";
 export * from "./database.js";

package/runtime/ssh.js

@@ -0,0 +1,47 @@
+"use strict";
+/**
+ * Zod schemas for SSH operations validation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FilePreviewOptionsSchema = exports.FilesListOptionsSchema = exports.SCPOptionsSchema = exports.SSHCommandSchema = exports.SSHOptionsSchema = void 0;
+var zod_1 = require("zod");
+/**
+ * SSH connection options schema
+ */
+exports.SSHOptionsSchema = zod_1.z.object({
+    host: zod_1.z.string().min(1, 'Host is required'),
+    user: zod_1.z.string().default('root'),
+    timeout: zod_1.z.number().int().positive().default(5),
+    port: zod_1.z.number().int().positive().max(65535).default(22),
+    keyPath: zod_1.z.string().optional(),
+    password: zod_1.z.string().optional(),
+});
+/**
+ * SSH command validation schema
+ */
+exports.SSHCommandSchema = zod_1.z.string().min(1, 'Command cannot be empty');
+/**
+ * SCP options schema (extends SSH options)
+ */
+exports.SCPOptionsSchema = exports.SSHOptionsSchema.extend({
+    source: zod_1.z.string().min(1, 'Source is required'),
+    destination: zod_1.z.string().min(1, 'Destination is required'),
+    recursive: zod_1.z.boolean().default(false),
+    preserve: zod_1.z.boolean().default(false),
+});
+/**
+ * Files list options schema
+ */
+exports.FilesListOptionsSchema = zod_1.z.object({
+    host: zod_1.z.string().min(1, 'Host is required'),
+    user: zod_1.z.string().default('root'),
+    path: zod_1.z.string().default('.'),
+});
+/**
+ * File preview options schema
+ */
+exports.FilePreviewOptionsSchema = zod_1.z.object({
+    host: zod_1.z.string().min(1, 'Host is required'),
+    user: zod_1.z.string().default('root'),
+    path: zod_1.z.string().min(1, 'Path is required'),
+});

package/runtime/ssh.ts

@@ -0,0 +1,58 @@
+/**
+ * Zod schemas for SSH operations validation
+ */
+
+import { z } from 'zod'
+
+/**
+ * SSH connection options schema
+ */
+export const SSHOptionsSchema = z.object({
+  host: z.string().min(1, 'Host is required'),
+  user: z.string().default('root'),
+  timeout: z.number().int().positive().default(5),
+  port: z.number().int().positive().max(65535).default(22),
+  keyPath: z.string().optional(),
+  password: z.string().optional(),
+})
+
+/**
+ * SSH command validation schema
+ */
+export const SSHCommandSchema = z.string().min(1, 'Command cannot be empty')
+
+/**
+ * SCP options schema (extends SSH options)
+ */
+export const SCPOptionsSchema = SSHOptionsSchema.extend({
+  source: z.string().min(1, 'Source is required'),
+  destination: z.string().min(1, 'Destination is required'),
+  recursive: z.boolean().default(false),
+  preserve: z.boolean().default(false),
+})
+
+/**
+ * Files list options schema
+ */
+export const FilesListOptionsSchema = z.object({
+  host: z.string().min(1, 'Host is required'),
+  user: z.string().default('root'),
+  path: z.string().default('.'),
+})
+
+/**
+ * File preview options schema
+ */
+export const FilePreviewOptionsSchema = z.object({
+  host: z.string().min(1, 'Host is required'),
+  user: z.string().default('root'),
+  path: z.string().min(1, 'Path is required'),
+})
+
+/**
+ * Type exports for TypeScript inference
+ */
+export type SSHOptions = z.infer<typeof SSHOptionsSchema>
+export type SCPOptions = z.infer<typeof SCPOptionsSchema>
+export type FilesListOptions = z.infer<typeof FilesListOptionsSchema>
+export type FilePreviewOptions = z.infer<typeof FilePreviewOptionsSchema>

package/README.md

@@ -1,65 +0,0 @@
-# @ebowwa/codespaces-types
-
-Shared types and runtime validation schemas for codespaces projects.
-
-## Structure
-
-- **`/runtime`** - Zod schemas for runtime validation
-- **`/compile`** - TypeScript type definitions for compile-time checking
-
-## Installation
-
-```bash
-npm install @ebowwa/codespaces-types
-```
-
-## Usage
-
-### Runtime Validation (Zod Schemas)
-
-```typescript
-import { CreateEnvironmentRequestSchema } from '@ebowwa/codespaces-types/runtime/api';
-
-// Validate data at runtime
-const result = CreateEnvironmentRequestSchema.parse(userData);
-```
-
-### Compile-Time Types
-
-```typescript
-import type { Environment, HetznerServerType } from '@ebowwa/codespaces-types/compile';
-
-// Type checking at compile time
-const env: Environment = { /* ... */ };
-```
-
-### Type Inference (Recommended)
-
-Runtime schemas automatically export inferred TypeScript types:
-
-```typescript
-import {
-  CreateEnvironmentRequestSchema,
-  type CreateEnvironmentRequest
-} from '@ebowwa/codespaces-types/runtime/api';
-
-const data: CreateEnvironmentRequest = { /* ... */ };
-const validated = CreateEnvironmentRequestSchema.parse(data);
-```
-
-## Available Exports
-
-### Runtime (`./runtime/*`)
-- `api` - API request/response validation schemas
-- `ai` - AI-related schemas
-- `database` - Database validation schemas
-- `env` - Environment variable schemas
-- `glm` - GLM-specific schemas
-- `ssh` - SSH configuration schemas
-
-### Compile-Time Types (`./compile/*`)
-- `index` - Main type exports (Environment, Hetzner types, etc.)
-
-## License
-
-MIT