@umituz/web-cloudflare 1.4.8 → 1.4.10

package/README.md

@@ -1,6 +1,6 @@
 # @umituz/web-cloudflare
 
-Comprehensive Cloudflare Workers integration with config-based patterns, middleware, router, workflows, and AI.
+Comprehensive Cloudflare Workers & Pages integration with config-based patterns, middleware, router, workflows, and AI.
 
 ## 🚀 Features
 
@@ -177,6 +177,39 @@ const versions = await wrangler.versionsList();
 await wrangler.versionsRollback(versions[0].id);
 ```
 
+### Using Cloudflare Pages
+
+```typescript
+import { PagesService } from '@umituz/web-cloudflare/pages';
+
+const pages = new PagesService();
+
+// Create a new Pages project
+await pages.createProject('my-app', {
+  productionBranch: 'main',
+});
+
+// Deploy to Pages
+const deployment = await pages.deploy({
+  projectName: 'my-app',
+  directory: 'dist', // Build output directory
+  branch: 'main',
+  environment: 'production',
+  vars: {
+    API_URL: 'https://api.example.com',
+  },
+});
+
+// List all projects
+const projects = await pages.listProjects();
+
+// List deployments for a project
+const deployments = await pages.listDeployments('my-app');
+
+// Delete a deployment
+await pages.deleteDeployment('my-app', deployment.id);
+```
+
 **Note:** All services now follow Domain-Driven Design (DDD) architecture with their own domain structures:
 - Wrangler CLI: `src/domains/wrangler/`
 - Workers: `src/domains/workers/`
@@ -187,6 +220,7 @@ await wrangler.versionsRollback(versions[0].id);
 - Images: `src/domains/images/`
 - Analytics: `src/domains/analytics/`
 - Workflows: `src/domains/workflows/`
+- Pages: `src/domains/pages/`
 
 ## 📚 Subpath Exports
 
@@ -216,6 +250,9 @@ import { WorkflowService } from '@umituz/web-cloudflare/workflows';
 
 // Wrangler CLI
 import { WranglerService } from '@umituz/web-cloudflare/wrangler';
+
+// Pages deployment
+import { PagesService, pagesService } from '@umituz/web-cloudflare/pages';
 ```
 
 ### Workflows & AI
@@ -680,7 +717,8 @@ Contributions are welcome!
 │   │   ├── kv/              # KV storage domain
 │   │   ├── images/          # Images optimization domain
 │   │   ├── analytics/       # Analytics domain
-│   │   └── workflows/       # Workflows domain
+│   │   ├── workflows/       # Workflows domain
+│   │   ├── pages/           # Pages deployment domain
 │   ├── infrastructure/
 │   │   ├── router/          # Express-like router
 │   │   ├── middleware/      # Middleware collection

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@umituz/web-cloudflare",
-  "version": "1.4.8",
-  "description": "Comprehensive Cloudflare Workers integration with config-based patterns, middleware, router, workflows, and AI (Patch-only versioning: only z in x.y.z increments)",
+  "version": "1.4.10",
+  "description": "Comprehensive Cloudflare Workers & Pages integration with config-based patterns, middleware, router, workflows, and AI (Patch-only versioning: only z in x.y.z increments)",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
   "sideEffects": false,
@@ -17,6 +17,7 @@
     "./ai-gateway": "./src/domains/ai-gateway/index.ts",
     "./workers-ai": "./src/domains/ai-gateway/index.ts",
     "./wrangler": "./src/domains/wrangler/index.ts",
+    "./pages": "./src/domains/pages/index.ts",
     "./middleware": "./src/domains/middleware/index.ts",
     "./router": "./src/infrastructure/router/index.ts",
     "./utils": "./src/infrastructure/utils/helpers.ts",
@@ -47,6 +48,10 @@
     "workflows",
     "ai-gateway",
     "workers-ai",
+    "pages",
+    "cloudflare-pages",
+    "static-site",
+    "deployment",
     "router",
     "middleware",
     "config-patterns",

package/src/domains/pages/entities/index.ts

@@ -0,0 +1,79 @@
+/**
+ * Pages Domain Entities
+ * Defines entities for Cloudflare Pages operations
+ */
+
+/**
+ * Pages project info
+ */
+export interface PagesProject {
+  name: string;
+  production_branch?: string;
+  created_on?: string;
+  deployment_configs?: {
+    preview?: {
+      branch?: string;
+      env_vars?: Record<string, string>;
+    };
+    production?: {
+      branch?: string;
+      env_vars?: Record<string, string>;
+    };
+  };
+}
+
+/**
+ * Pages deployment info
+ */
+export interface PagesDeployment {
+  id: string;
+  project: string;
+  url: string;
+  latest_stage?: string;
+  created_on?: string;
+  deployment_trigger?: {
+    metadata?: {
+      branch?: string;
+      commit_hash?: string;
+    };
+  };
+  stages?: {
+    environment: string;
+    function?: string;
+    url?: string;
+  }[];
+}
+
+/**
+ * Pages deploy options
+ */
+export interface PagesDeployOptions {
+  projectName: string;
+  directory?: string; // Build output directory (default: dist)
+  branch?: string;
+  preview?: boolean;
+  environment?: 'preview' | 'production';
+  compatibilityDate?: string;
+  compatibilityFlags?: string[];
+  vars?: Record<string, string>;
+  functions?: boolean; // Deploy with functions
+}
+
+/**
+ * Pages function info
+ */
+export interface PagesFunction {
+  name: string;
+  scriptPath?: string;
+  compatibilityDate?: string;
+  compatibilityFlags?: string[];
+}
+
+/**
+ * Pages deployment result
+ */
+export interface PagesDeploymentResult {
+  deployment: PagesDeployment;
+  url?: string;
+  alias?: string;
+}

package/src/domains/pages/index.ts

@@ -0,0 +1,13 @@
+/**
+ * Pages Domain
+ * Cloudflare Pages deployment and management
+ */
+
+// Entities
+export * from './entities';
+
+// Types
+export * from './types';
+
+// Services
+export * from './services';

package/src/domains/pages/services/index.ts

@@ -0,0 +1,5 @@
+/**
+ * Pages Domain Services
+ */
+
+export { PagesService, pagesService } from './pages.service';

package/src/domains/pages/services/pages.service.ts

@@ -0,0 +1,144 @@
+/**
+ * Pages Service Implementation
+ * Cloudflare Pages deployment and management
+ *
+ * ⚠️ NODE.JS ONLY: This service requires Node.js runtime and is NOT compatible
+ * with Cloudflare Workers runtime. Use this service only in build/development
+ * scripts running in Node.js environment.
+ */
+
+import { execSync } from 'child_process';
+import type { IPagesService } from '../types/service.interface';
+import type {
+  PagesProject,
+  PagesDeployment,
+  PagesDeployOptions,
+  PagesFunction,
+  PagesDeploymentResult,
+} from '../entities';
+
+export class PagesService implements IPagesService {
+  private readonly wranglerCommand: string;
+
+  constructor(options?: { wranglerPath?: string }) {
+    this.wranglerCommand = options?.wranglerPath || 'npx wrangler';
+  }
+
+  /**
+   * Create a new Pages project
+   */
+  async createProject(
+    projectName: string,
+    options?: {
+      productionBranch?: string;
+      compatibilityDate?: string;
+    }
+  ): Promise<{ success: boolean; data?: PagesProject; error?: string }> {
+    return this.nodeNotRequired();
+  }
+
+  /**
+   * List all Pages projects
+   */
+  async listProjects(): Promise<{ success: boolean; data?: PagesProject[]; error?: string }> {
+    return this.nodeNotRequired();
+  }
+
+  /**
+   * Get project details
+   */
+  async getProject(projectName: string): Promise<{ success: boolean; data?: PagesProject; error?: string }> {
+    return this.nodeNotRequired();
+  }
+
+  /**
+   * Deploy to Pages
+   */
+  async deploy(
+    options: PagesDeployOptions
+  ): Promise<{ success: boolean; data?: PagesDeploymentResult; error?: string }> {
+    return this.nodeNotRequired();
+  }
+
+  /**
+   * Create a Pages function
+   */
+  async createFunction(
+    projectName: string,
+    functionName: string,
+    options?: {
+      compatibilityDate?: string;
+      compatibilityFlags?: string[];
+    }
+  ): Promise<{ success: boolean; data?: PagesFunction; error?: string }> {
+    return this.nodeNotRequired();
+  }
+
+  /**
+   * List deployments for a project
+   */
+  async listDeployments(
+    projectName: string
+  ): Promise<{ success: boolean; data?: PagesDeployment[]; error?: string }> {
+    return this.nodeNotRequired();
+  }
+
+  /**
+   * Get deployment details
+   */
+  async getDeployment(
+    projectName: string,
+    deploymentId: string
+  ): Promise<{ success: boolean; data?: PagesDeployment; error?: string }> {
+    return this.nodeNotRequired();
+  }
+
+  /**
+   * Delete a deployment
+   */
+  async deleteDeployment(
+    projectName: string,
+    deploymentId: string
+  ): Promise<{ success: boolean; error?: string }> {
+    return this.nodeNotRequired();
+  }
+
+  /**
+   * Execute wrangler pages command
+   */
+  private executeWranglerPages(
+    args: string[],
+    options?: { cwd?: string; env?: Record<string, string> }
+  ): { success: boolean; stdout: string; stderr: string; exitCode?: number } {
+    try {
+      const command = `${this.wranglerCommand} pages ${args.join(' ')}`;
+      const stdout = execSync(command, {
+        cwd: options?.cwd,
+        env: { ...process.env, ...options?.env },
+        encoding: 'utf-8',
+      });
+      return { success: true, stdout, stderr: '', exitCode: 0 };
+    } catch (error: unknown) {
+      if (error instanceof Error) {
+        const err = error as { stdout?: string; stderr?: string; code?: number };
+        return {
+          success: false,
+          stdout: err.stdout || '',
+          stderr: err.stderr || error.message,
+          exitCode: err.code,
+        };
+      }
+      return { success: false, stdout: '', stderr: 'Unknown error', exitCode: -1 };
+    }
+  }
+
+  private nodeNotRequired<T>(): never {
+    throw new Error(
+      'PagesService requires Node.js runtime. ' +
+      'This service only works in Node.js environment, not in Cloudflare Workers. ' +
+      'Use this service in build scripts or deployment tools only.'
+    );
+  }
+}
+
+export const pagesService = new PagesService();

package/src/domains/pages/types/index.ts

@@ -0,0 +1,5 @@
+/**
+ * Pages Domain Types
+ */
+
+export * from './service.interface';

package/src/domains/pages/types/service.interface.ts

@@ -0,0 +1,77 @@
+/**
+ * Pages Service Interface
+ * Defines the contract for Cloudflare Pages operations
+ */
+
+import type {
+  PagesProject,
+  PagesDeployment,
+  PagesDeployOptions,
+  PagesFunction,
+  PagesDeploymentResult,
+} from '../entities';
+
+export interface IPagesService {
+  /**
+   * Create a new Pages project
+   */
+  createProject(
+    projectName: string,
+    options?: {
+      productionBranch?: string;
+      compatibilityDate?: string;
+    }
+  ): Promise<{ success: boolean; data?: PagesProject; error?: string }>;
+
+  /**
+   * List all Pages projects
+   */
+  listProjects(): Promise<{ success: boolean; data?: PagesProject[]; error?: string }>;
+
+  /**
+   * Get project details
+   */
+  getProject(projectName: string): Promise<{ success: boolean; data?: PagesProject; error?: string }>;
+
+  /**
+   * Deploy to Pages
+   */
+  deploy(
+    options: PagesDeployOptions
+  ): Promise<{ success: boolean; data?: PagesDeploymentResult; error?: string }>;
+
+  /**
+   * Create a Pages function
+   */
+  createFunction(
+    projectName: string,
+    functionName: string,
+    options?: {
+      compatibilityDate?: string;
+      compatibilityFlags?: string[];
+    }
+  ): Promise<{ success: boolean; data?: PagesFunction; error?: string }>;
+
+  /**
+   * List deployments for a project
+   */
+  listDeployments(
+    projectName: string
+  ): Promise<{ success: boolean; data?: PagesDeployment[]; error?: string }>;
+
+  /**
+   * Get deployment details
+   */
+  getDeployment(
+    projectName: string,
+    deploymentId: string
+  ): Promise<{ success: boolean; data?: PagesDeployment; error?: string }>;
+
+  /**
+   * Delete a deployment
+   */
+  deleteDeployment(
+    projectName: string,
+    deploymentId: string
+  ): Promise<{ success: boolean; error?: string }>;
+}

package/src/domains/wrangler/entities/index.ts

@@ -53,6 +53,12 @@ export enum WranglerCommand {
   // Versions
   VERSIONS_LIST = 'versions list',
   VERSIONS_ROLLBACK = 'versions rollback',
+
+  // Pages operations
+  PAGES_PROJECT_CREATE = 'pages project create',
+  PAGES_PROJECT_LIST = 'pages project list',
+  PAGES_DEPLOY = 'pages deploy',
+  PAGES_FUNCTION = 'pages function',
 }
 
 /**
@@ -140,3 +146,54 @@ export interface WranglerAnalyticsData {
   statusCodes?: Record<string, number>;
   countries?: Record<string, number>;
 }
+
+/**
+ * Pages project info
+ */
+export interface PagesProjectInfo {
+  name: string;
+  production_branch?: string;
+  creation_date?: string;
+  deployment_configs?: {
+    preview?: {
+      branch?: string;
+      env_vars?: Record<string, string>;
+    };
+    production?: {
+      branch?: string;
+      env_vars?: Record<string, string>;
+    };
+  };
+}
+
+/**
+ * Pages deployment info
+ */
+export interface PagesDeploymentInfo {
+  id: string;
+  project: string;
+  url: string;
+  latest_stage?: string;
+  created_on?: string;
+  deployment_trigger?: {
+    metadata?: {
+      branch?: string;
+      commit_hash?: string;
+    };
+  };
+}
+
+/**
+ * Pages deploy options
+ */
+export interface PagesDeployOptions {
+  projectName: string;
+  directory?: string;
+  branch?: string;
+  preview?: boolean;
+  environment?: 'preview' | 'production';
+  compatibilityDate?: string;
+  compatibilityFlags?: string[];
+  vars?: Record<string, string>;
+}
+

package/src/domains/wrangler/types/service.interface.ts

@@ -13,6 +13,9 @@ import type {
   SecretInfo,
   WorkerVersionInfo,
   WranglerAnalyticsData,
+  PagesProjectInfo,
+  PagesDeploymentInfo,
+  PagesDeployOptions,
 } from '../entities';
 
 export interface IWranglerService {
@@ -127,4 +130,21 @@ export interface IWranglerService {
     args: string[],
     options?: WranglerCommandOptions
   ): Promise<WranglerResult<string>>;
+
+  // Pages operations
+  pagesProjectCreate(
+    projectName: string,
+    options?: WranglerCommandOptions & { productionBranch?: string }
+  ): Promise<WranglerResult<PagesProjectInfo>>;
+  pagesProjectList(
+    options?: WranglerCommandOptions
+  ): Promise<WranglerResult<PagesProjectInfo[]>>;
+  pagesDeploy(
+    options: PagesDeployOptions & WranglerCommandOptions
+  ): Promise<WranglerResult<PagesDeploymentInfo>>;
+  pagesFunctionCreate(
+    projectName: string,
+    functionName: string,
+    options?: WranglerCommandOptions
+  ): Promise<WranglerResult<void>>;
 }

package/src/index.ts

@@ -35,6 +35,15 @@ export { d1Service, D1Service } from "./domains/d1";
 export { kvService, KVService } from "./domains/kv";
 export { imagesService, ImagesService } from "./domains/images";
 export { analyticsService, AnalyticsService } from "./domains/analytics";
+// Pages - Node.js-only service
+export { pagesService, PagesService } from "./domains/pages";
+export type {
+  PagesProject,
+  PagesDeployment,
+  PagesDeployOptions,
+  PagesFunction,
+  PagesDeploymentResult,
+} from "./domains/pages";
 // Workflows - selective exports to avoid conflicts
 export type {
   WorkflowStep,