@ebowwa/codespaces-types 0.1.0

package/dist/validation.js

@@ -0,0 +1,80 @@
+/**
+ * Validation utilities for environment names and other inputs
+ * Migrated to use Zod for runtime type safety and better error messages
+ */
+import { z } from 'zod';
+/**
+ * Zod schema for environment name validation
+ * - Must start with a letter or number
+ * - Can contain letters, numbers, hyphens, and underscores
+ * - 1-64 characters long
+ * - Cannot be a reserved word
+ */
+export const EnvironmentNameSchema = z
+    .string()
+    .min(1, 'Environment name is required')
+    .max(64, 'Environment name must be 64 characters or less')
+    .regex(/^[a-zA-Z0-9][a-zA-Z0-9_-]*$/, 'Name must start with a letter or number and contain only letters, numbers, hyphens, and underscores')
+    .refine((name) => !['ssh', 'ssh-keys', 'docker', 'registry', 'volume', 'network'].includes(name.toLowerCase()), {
+    message: 'Name is a reserved word',
+})
+    .transform((val) => val.trim());
+/**
+ * Zod schema for SSH key name validation
+ */
+export const SSHKeyNameSchema = z
+    .string()
+    .min(1, 'SSH key name is required')
+    .max(64, 'Name must be 64 characters or less')
+    .transform((val) => val.trim());
+/**
+ * Zod schema for Hetzner API token validation
+ */
+export const APITokenSchema = z
+    .string()
+    .min(1, 'API token is required')
+    .min(32, 'API token appears too short')
+    .startsWith('hetzner_', 'Hetzner API tokens typically start with "hetzner_"')
+    .transform((val) => val.trim());
+/**
+ * Validates environment name according to Hetzner naming rules
+ * @deprecated Use EnvironmentNameSchema.safeParse() instead
+ */
+export function validateEnvironmentName(name) {
+    const result = EnvironmentNameSchema.safeParse(name);
+    if (result.success) {
+        return { isValid: true };
+    }
+    return {
+        isValid: false,
+        error: result.error.issues.map((e) => e.message).join(', '),
+    };
+}
+/**
+ * Validates SSH key name
+ * @deprecated Use SSHKeyNameSchema.safeParse() instead
+ */
+export function validateSSHKeyName(name) {
+    const result = SSHKeyNameSchema.safeParse(name);
+    if (result.success) {
+        return { isValid: true };
+    }
+    return {
+        isValid: false,
+        error: result.error.issues.map((e) => e.message).join(', '),
+    };
+}
+/**
+ * Validates Hetzner API token format
+ * @deprecated Use APITokenSchema.safeParse() instead
+ */
+export function validateAPIToken(token) {
+    const result = APITokenSchema.safeParse(token);
+    if (result.success) {
+        return { isValid: true };
+    }
+    return {
+        isValid: false,
+        error: result.error.issues.map((e) => e.message).join(', '),
+    };
+}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@ebowwa/codespaces-types",
+  "version": "0.1.0",
+  "description": "Shared TypeScript type definitions for Codespaces packages",
+  "author": "Ebowwa Labs <labs@ebowwa.com>",
+  "license": "MIT",
+  "type": "module",
+  "homepage": "https://github.com/ebowwa/codespaces-types#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ebowwa/codespaces-types.git"
+  },
+  "bugs": {
+    "url": "https://github.com/ebowwa/codespaces-types/issues"
+  },
+  "keywords": [
+    "typescript",
+    "types",
+    "codespaces",
+    "shared"
+  ],
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "zod": "^3.24.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./resources": {
+      "types": "./dist/resources.d.ts",
+      "import": "./dist/resources.js"
+    },
+    "./terminal-websocket": {
+      "types": "./dist/terminal-websocket.d.ts",
+      "import": "./dist/terminal-websocket.js"
+    },
+    "./time": {
+      "types": "./dist/time.d.ts",
+      "import": "./dist/time.js"
+    },
+    "./validation": {
+      "types": "./dist/validation.d.ts",
+      "import": "./dist/validation.js"
+    },
+    "./schemas/resources": {
+      "types": "./dist/schemas/resources.d.ts",
+      "import": "./dist/schemas/resources.js"
+    }
+  }
+}