@umituz/react-native-google-stitch-sdk 1.0.0

package/LICENSE

@@ -0,0 +1,20 @@
+MIT License
+
+Copyright (c) 2026 
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,88 @@
+# @umituz/react-native-google-stitch-sdk
+
+React Native wrapper for Google Labs Stitch SDK with TypeScript support.
+
+## Installation
+
+```sh
+npm install @umituz/react-native-google-stitch-sdk
+```
+
+## Quick Start
+
+```typescript
+// Initialize the SDK
+import { initializeStitchSDK } from '@umituz/react-native-google-stitch-sdk/init';
+
+initializeStitchSDK({
+  apiKey: 'your-api-key',
+  baseUrl: 'https://api.example.com',
+});
+
+// Use the hook in your component
+import { useStitch } from '@umituz/react-native-google-stitch-sdk/core';
+
+function MyComponent() {
+  const { readProject, writeProject, isLoading, error } = useStitch();
+
+  const handleRead = async () => {
+    const project = await readProject('project-id');
+    console.log(project);
+  };
+
+  return (
+    // Your JSX
+  );
+}
+```
+
+## Available Subpaths
+
+### `/core`
+Core SDK functionality - services, hooks, and types.
+
+```typescript
+import { useStitch, stitchService } from '@umituz/react-native-google-stitch-sdk/core';
+import type { StitchProject } from '@umituz/react-native-google-stitch-sdk/core';
+```
+
+### `/init`
+Initialization utilities.
+
+```typescript
+import { initializeStitchSDK, isStitchSDKInitialized } from '@umituz/react-native-google-stitch-sdk/init';
+```
+
+## API Reference
+
+### `useStitch` Hook
+
+```typescript
+const {
+  isLoading,
+  error,
+  readProject,
+  writeProject,
+  updateProject,
+  deleteProject,
+  listProjects,
+} = useStitch({ apiKey: 'your-key', autoInitialize: true });
+```
+
+### Direct Service Usage
+
+```typescript
+import { stitchService } from '@umituz/react-native-google-stitch-sdk/core';
+
+stitchService.initialize({ apiKey: 'your-key' });
+const project = await stitchService.readProject('project-id');
+```
+
+## License
+
+MIT
+
+---
+
+**@umituz** - React Native packages
+

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@umituz/react-native-google-stitch-sdk",
+  "version": "1.0.0",
+  "description": "React Native wrapper for Google Labs Stitch SDK with TypeScript support",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "sideEffects": false,
+  "exports": {
+    ".": "./src/index.ts",
+    "./core": "./src/domains/core/index.ts",
+    "./init": "./src/init/index.ts",
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint \"src/**/*.{ts,tsx}\"",
+    "version:patch": "npm version patch -m 'chore: release v%s'",
+    "version:minor": "npm version minor -m 'chore: release v%s'",
+    "version:major": "npm version major -m 'chore: release v%s'"
+  },
+  "keywords": [
+    "react-native",
+    "google",
+    "stitch",
+    "sdk",
+    "typescript"
+  ],
+  "author": "umituz",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/umituz/react-native-google-stitch-sdk.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": ">=18.2.0",
+    "react-native": ">=0.74.0"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@types/react": "^19.1.12",
+    "@typescript-eslint/eslint-plugin": "^8.57.1",
+    "@typescript-eslint/parser": "^8.57.1",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "prettier": "^3.0.0",
+    "react": "19.2.0",
+    "react-native": "0.83.2",
+    "typescript": "^5.9.2"
+  },
+  "files": [
+    "src",
+    "README.md",
+    "LICENSE"
+  ]
+}

package/src/domain/entities/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Domain Entities
+ * @description Core entity definitions for Stitch SDK
+ */
+
+export type { StitchProject, StitchProjectCreateInput, StitchProjectUpdateInput } from './stitch.entity';

package/src/domain/entities/stitch.entity.ts

@@ -0,0 +1,15 @@
+/**
+ * Stitch Project Entity
+ * @description Represents a Google Labs Stitch SDK project
+ */
+
+export interface StitchProject {
+  readonly id: string;
+  readonly name: string;
+  readonly description?: string;
+  readonly createdAt: Date;
+  readonly updatedAt: Date;
+}
+
+export type StitchProjectCreateInput = Omit<StitchProject, 'id' | 'createdAt' | 'updatedAt'>;
+export type StitchProjectUpdateInput = Partial<StitchProjectCreateInput>;

package/src/domain/interfaces/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Domain Interfaces
+ * @description Core interface definitions
+ */
+
+export type { IStitchService } from './stitch-service.interface';

package/src/domain/interfaces/stitch-service.interface.ts

@@ -0,0 +1,33 @@
+/**
+ * Stitch Service Interface
+ * @description Contract for Stitch SDK service implementations
+ */
+
+import type { StitchProject, StitchProjectCreateInput, StitchProjectUpdateInput } from '../entities';
+
+export interface IStitchService {
+  /**
+   * Read a project by ID
+   */
+  readProject(_projectId: string): Promise<StitchProject>;
+
+  /**
+   * Write/create a new project
+   */
+  writeProject(_input: StitchProjectCreateInput): Promise<StitchProject>;
+
+  /**
+   * Update an existing project
+   */
+  updateProject(_projectId: string, _input: StitchProjectUpdateInput): Promise<StitchProject>;
+
+  /**
+   * Delete a project
+   */
+  deleteProject(_projectId: string): Promise<void>;
+
+  /**
+   * List all projects
+   */
+  listProjects(): Promise<StitchProject[]>;
+}

package/src/domains/core/index.ts

@@ -0,0 +1,23 @@
+/**
+ * Core Domain
+ * @description Core Stitch SDK functionality
+ * Subpath: @umituz/react-native-google-stitch-sdk/core
+ */
+
+// Domain entities
+export type {
+  StitchProject,
+  StitchProjectCreateInput,
+  StitchProjectUpdateInput,
+} from '../../domain/entities';
+
+// Infrastructure services
+export { stitchService } from '../../infrastructure/services';
+export type { StitchServiceConfig } from '../../infrastructure/services';
+
+// Presentation hooks
+export { useStitch } from '../../presentation/hooks';
+export type { UseStitchConfig, UseStitchReturn } from '../../presentation/hooks';
+
+// Constants
+export { STITCH_DEFAULT_CONFIG, STITCH_ERROR_MESSAGES } from '../../infrastructure/constants';

package/src/index.ts

@@ -0,0 +1,18 @@
+/**
+ * @umituz/react-native-google-stitch-sdk
+ * React Native wrapper for Google Labs Stitch SDK with TypeScript support
+ *
+ * ⚠️ IMPORTANT: Apps should NOT use this root barrel import.
+ * Use subpath imports instead for better tree-shaking:
+ *
+ * ❌ DON'T: import { useStitch } from '@umituz/react-native-google-stitch-sdk'
+ * ✅ DO:    import { useStitch } from '@umituz/react-native-google-stitch-sdk/core'
+ *
+ * Available subpaths:
+ * - /core: Core SDK functionality (services, hooks, types)
+ * - /init: Initialization utilities
+ */
+
+// Re-export everything for backward compatibility
+export * from './domains/core';
+export * from './init';

package/src/infrastructure/constants/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Infrastructure Constants
+ * @description Configuration constants
+ */
+
+export { STITCH_DEFAULT_CONFIG, STITCH_ERROR_MESSAGES } from './stitch.constants';

package/src/infrastructure/constants/stitch.constants.ts

@@ -0,0 +1,15 @@
+/**
+ * Stitch Constants
+ * @description Configuration constants for Stitch SDK
+ */
+
+export const STITCH_DEFAULT_CONFIG = {
+  API_TIMEOUT: 30000,
+  MAX_RETRIES: 3,
+} as const;
+
+export const STITCH_ERROR_MESSAGES = {
+  NOT_INITIALIZED: 'StitchService not initialized. Call initialize() first.',
+  INVALID_PROJECT_ID: 'Invalid project ID provided.',
+  NETWORK_ERROR: 'Network error occurred while communicating with Stitch SDK.',
+} as const;

package/src/infrastructure/services/index.ts

@@ -0,0 +1,7 @@
+/**
+ * Infrastructure Services
+ * @description Service implementations
+ */
+
+export { stitchService } from './stitch.service';
+export type { StitchServiceConfig } from './stitch.service';

package/src/infrastructure/services/stitch.service.ts

@@ -0,0 +1,87 @@
+/**
+ * Stitch Service
+ * @description Main service implementation for Google Labs Stitch SDK wrapper
+ * @note This is a placeholder implementation. Replace with actual SDK calls when available.
+ */
+
+import type { IStitchService } from '../../domain/interfaces';
+import type { StitchProject, StitchProjectCreateInput, StitchProjectUpdateInput } from '../../domain/entities';
+
+export interface StitchServiceConfig {
+  apiKey?: string;
+  baseUrl?: string;
+}
+
+class StitchService implements IStitchService {
+  private config: StitchServiceConfig | null = null;
+
+  initialize(config: StitchServiceConfig): void {
+    this.config = config;
+  }
+
+  isInitialized(): boolean {
+    return this.config !== null;
+  }
+
+  async readProject(projectId: string): Promise<StitchProject> {
+    this.ensureInitialized();
+
+    // TODO: Replace with actual SDK call
+    // Example: const response = await fetch(`${this.config.baseUrl}/projects/${projectId}`);
+    return {
+      id: projectId,
+      name: 'Sample Project',
+      description: 'Placeholder project',
+      createdAt: new Date(),
+      updatedAt: new Date(),
+    };
+  }
+
+  async writeProject(input: StitchProjectCreateInput): Promise<StitchProject> {
+    this.ensureInitialized();
+
+    // TODO: Replace with actual SDK call
+    const newProject: StitchProject = {
+      id: `project_${Date.now()}`,
+      ...input,
+      createdAt: new Date(),
+      updatedAt: new Date(),
+    };
+
+    return newProject;
+  }
+
+  async updateProject(projectId: string, input: StitchProjectUpdateInput): Promise<StitchProject> {
+    this.ensureInitialized();
+
+    // TODO: Replace with actual SDK call
+    const existing = await this.readProject(projectId);
+    return {
+      ...existing,
+      ...input,
+      updatedAt: new Date(),
+    };
+  }
+
+  async deleteProject(_projectId: string): Promise<void> {
+    this.ensureInitialized();
+
+    // TODO: Replace with actual SDK call
+    // Placeholder: no-op delete operation
+  }
+
+  async listProjects(): Promise<StitchProject[]> {
+    this.ensureInitialized();
+
+    // TODO: Replace with actual SDK call
+    return [];
+  }
+
+  private ensureInitialized(): void {
+    if (!this.isInitialized()) {
+      throw new Error('StitchService not initialized. Call initialize() first.');
+    }
+  }
+}
+
+export const stitchService = new StitchService();

package/src/infrastructure/utils/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Infrastructure Utils
+ * @description Utility functions
+ */
+
+// Placeholder for future utility functions

package/src/init/index.ts

@@ -0,0 +1,23 @@
+/**
+ * Initialization Module
+ * @description Initialize Stitch SDK with configuration
+ * Subpath: @umituz/react-native-google-stitch-sdk/init
+ */
+
+import { stitchService } from '../infrastructure/services';
+import type { StitchServiceConfig } from '../infrastructure/services';
+
+/**
+ * Initialize the Stitch SDK
+ * @param config - Configuration object
+ */
+export function initializeStitchSDK(config: StitchServiceConfig): void {
+  stitchService.initialize(config);
+}
+
+/**
+ * Check if SDK is initialized
+ */
+export function isStitchSDKInitialized(): boolean {
+  return stitchService.isInitialized();
+}

package/src/presentation/components/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Presentation Components
+ * @description React components for Stitch SDK
+ */
+
+// Placeholder for future components

package/src/presentation/hooks/index.ts

@@ -0,0 +1,7 @@
+/**
+ * Presentation Hooks
+ * @description React hooks for Stitch SDK
+ */
+
+export { useStitch } from './useStitch';
+export type { UseStitchConfig, UseStitchReturn } from './useStitch';

package/src/presentation/hooks/useStitch.ts

@@ -0,0 +1,119 @@
+/**
+ * useStitch Hook
+ * @description React hook for Stitch SDK operations
+ */
+
+import { useCallback, useEffect, useState } from 'react';
+import type { StitchProject, StitchProjectCreateInput, StitchProjectUpdateInput } from '../../domain/entities';
+import { stitchService } from '../../infrastructure/services';
+
+export interface UseStitchConfig {
+  apiKey?: string;
+  baseUrl?: string;
+  autoInitialize?: boolean;
+}
+
+export interface UseStitchReturn {
+  isLoading: boolean;
+  error: Error | null;
+  readProject: (_projectId: string) => Promise<StitchProject>;
+  writeProject: (_input: StitchProjectCreateInput) => Promise<StitchProject>;
+  updateProject: (_projectId: string, _input: StitchProjectUpdateInput) => Promise<StitchProject>;
+  deleteProject: (_projectId: string) => Promise<void>;
+  listProjects: () => Promise<StitchProject[]>;
+}
+
+export function useStitch(config?: UseStitchConfig): UseStitchReturn {
+  const [isLoading, setIsLoading] = useState(false);
+  const [error, setError] = useState<Error | null>(null);
+
+  useEffect(() => {
+    if (config?.autoInitialize && config.apiKey) {
+      stitchService.initialize({ apiKey: config.apiKey, baseUrl: config.baseUrl });
+    }
+  }, [config]);
+
+  const readProject = useCallback(async (projectId: string) => {
+    setIsLoading(true);
+    setError(null);
+    try {
+      const project = await stitchService.readProject(projectId);
+      return project;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error('Failed to read project');
+      setError(error);
+      throw error;
+    } finally {
+      setIsLoading(false);
+    }
+  }, []);
+
+  const writeProject = useCallback(async (input: StitchProjectCreateInput) => {
+    setIsLoading(true);
+    setError(null);
+    try {
+      const project = await stitchService.writeProject(input);
+      return project;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error('Failed to write project');
+      setError(error);
+      throw error;
+    } finally {
+      setIsLoading(false);
+    }
+  }, []);
+
+  const updateProject = useCallback(async (projectId: string, input: StitchProjectUpdateInput) => {
+    setIsLoading(true);
+    setError(null);
+    try {
+      const project = await stitchService.updateProject(projectId, input);
+      return project;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error('Failed to update project');
+      setError(error);
+      throw error;
+    } finally {
+      setIsLoading(false);
+    }
+  }, []);
+
+  const deleteProject = useCallback(async (projectId: string) => {
+    setIsLoading(true);
+    setError(null);
+    try {
+      await stitchService.deleteProject(projectId);
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error('Failed to delete project');
+      setError(error);
+      throw error;
+    } finally {
+      setIsLoading(false);
+    }
+  }, []);
+
+  const listProjects = useCallback(async () => {
+    setIsLoading(true);
+    setError(null);
+    try {
+      const projects = await stitchService.listProjects();
+      return projects;
+    } catch (err) {
+      const error = err instanceof Error ? err : new Error('Failed to list projects');
+      setError(error);
+      throw error;
+    } finally {
+      setIsLoading(false);
+    }
+  }, []);
+
+  return {
+    isLoading,
+    error,
+    readProject,
+    writeProject,
+    updateProject,
+    deleteProject,
+    listProjects,
+  };
+}

package/src/presentation/stores/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Presentation Stores
+ * @description State management stores
+ */
+
+// Placeholder for future stores