@cympotek/3d-transfer-sdk 1.0.0

package/README.md

@@ -0,0 +1,345 @@
+# @cympotek/3d-transfer-sdk
+
+TypeScript SDK for Mobius 3D Transfer API - Convert images to 3D models using AI-powered style transfer.
+
+## Features
+
+- Full TypeScript support with auto-generated types
+- Support for multiple frameworks (Vite, Next.js, Expo, Node.js)
+- Environment variable based configuration
+- Axios-based HTTP client
+
+## Installation
+
+```bash
+npm install @cympotek/3d-transfer-sdk
+# or
+yarn add @cympotek/3d-transfer-sdk
+# or
+pnpm add @cympotek/3d-transfer-sdk
+```
+
+## Environment Variables
+
+Configure the SDK using environment variables based on your framework:
+
+| Variable | Framework | Description |
+|----------|-----------|-------------|
+| `VITE_TRANSFER_3D_API_URL` | Vite | API base URL |
+| `VITE_TRANSFER_3D_API_TOKEN` | Vite | API authentication token |
+| `NEXT_PUBLIC_TRANSFER_3D_API_URL` | Next.js | API base URL |
+| `NEXT_PUBLIC_TRANSFER_3D_API_TOKEN` | Next.js | API authentication token |
+| `EXPO_PUBLIC_TRANSFER_3D_API_URL` | Expo | API base URL |
+| `EXPO_PUBLIC_TRANSFER_3D_API_TOKEN` | Expo | API authentication token |
+| `TRANSFER_3D_API_URL` | Node.js | API base URL |
+| `TRANSFER_3D_API_TOKEN` | Node.js | API authentication token |
+
+### Example .env file
+
+```bash
+# For Vite projects
+VITE_TRANSFER_3D_API_URL=https://api.example.com/api
+VITE_TRANSFER_3D_API_TOKEN=your-api-token-here
+
+# For Next.js projects
+NEXT_PUBLIC_TRANSFER_3D_API_URL=https://api.example.com/api
+NEXT_PUBLIC_TRANSFER_3D_API_TOKEN=your-api-token-here
+
+# For Node.js/backend projects
+TRANSFER_3D_API_URL=https://api.example.com/api
+TRANSFER_3D_API_TOKEN=your-api-token-here
+```
+
+## Quick Start
+
+### Basic Usage
+
+```typescript
+import {
+  createTransfer3DClient,
+  getTransfer3dStyles,
+  initiateTransfer3dConversion,
+  getTransfer3dStatus,
+} from '@cympotek/3d-transfer-sdk';
+
+// Initialize client (uses environment variables by default)
+const client = createTransfer3DClient();
+
+// Or with explicit configuration
+const client = createTransfer3DClient({
+  baseURL: 'https://api.example.com/api',
+  token: 'your-api-token',
+});
+```
+
+### Complete Workflow Example
+
+```typescript
+import {
+  createTransfer3DClient,
+  getTransfer3dStyles,
+  initiateTransfer3dConversion,
+  getTransfer3dStatus,
+} from '@cympotek/3d-transfer-sdk';
+
+async function convertImageTo3D(imageFile: File) {
+  // 1. Initialize client
+  const client = createTransfer3DClient({
+    token: 'your-api-token',
+  });
+
+  // 2. Get available styles
+  const stylesResponse = await getTransfer3dStyles({ client });
+  console.log('Available styles:', stylesResponse.data);
+  // Output: [{ mode_key: 'smart', mode_name: 'Q版公仔', ... }]
+
+  // 3. Upload image and start conversion
+  const conversionResponse = await initiateTransfer3dConversion({
+    client,
+    body: {
+      image: imageFile,
+      style: 'smart', // Use a style from step 2
+    },
+  });
+
+  const requestId = conversionResponse.data.data.request_id;
+  console.log('Conversion started:', requestId);
+
+  // 4. Poll for status until completed
+  let status = 'PENDING';
+  let result = null;
+
+  while (status !== 'COMPLETED' && status !== 'FAILED') {
+    await new Promise((resolve) => setTimeout(resolve, 2000)); // Wait 2 seconds
+
+    const statusResponse = await getTransfer3dStatus({
+      client,
+      path: { requestId },
+    });
+
+    status = statusResponse.data.data.status;
+    console.log('Status:', status);
+
+    if (status === 'COMPLETED') {
+      result = statusResponse.data.data.result;
+    }
+  }
+
+  if (result) {
+    console.log('3D Model URL:', result.model_3d_url);
+    console.log('GLB File URL:', result.glb_url);
+    console.log('2D Preview URL:', result.preview_2d_url);
+  }
+
+  return result;
+}
+```
+
+### React/Next.js Example
+
+```tsx
+import { useState } from 'react';
+import {
+  createTransfer3DClient,
+  getTransfer3dStyles,
+  initiateTransfer3dConversion,
+  getTransfer3dStatus,
+} from '@cympotek/3d-transfer-sdk';
+
+export function ImageTo3DConverter() {
+  const [status, setStatus] = useState<string>('idle');
+  const [modelUrl, setModelUrl] = useState<string | null>(null);
+
+  const handleConvert = async (file: File, style: string) => {
+    const client = createTransfer3DClient();
+
+    setStatus('uploading');
+    const { data } = await initiateTransfer3dConversion({
+      client,
+      body: { image: file, style },
+    });
+
+    const requestId = data.data.request_id;
+    setStatus('processing');
+
+    // Poll for completion
+    const pollStatus = async () => {
+      const { data: statusData } = await getTransfer3dStatus({
+        client,
+        path: { requestId },
+      });
+
+      if (statusData.data.status === 'COMPLETED') {
+        setModelUrl(statusData.data.result.model_3d_url);
+        setStatus('completed');
+      } else if (statusData.data.status === 'FAILED') {
+        setStatus('failed');
+      } else {
+        setTimeout(pollStatus, 2000);
+      }
+    };
+
+    pollStatus();
+  };
+
+  return (
+    <div>
+      <p>Status: {status}</p>
+      {modelUrl && <a href={modelUrl}>Download 3D Model</a>}
+    </div>
+  );
+}
+```
+
+## API Reference
+
+### `createTransfer3DClient(config?)`
+
+Create a configured API client instance.
+
+**Parameters:**
+- `config.baseURL` (optional): API base URL
+- `config.token` (optional): Bearer authentication token
+- `config.timeout` (optional): Request timeout in ms (default: 30000)
+
+**Returns:** Configured axios client
+
+---
+
+### `getTransfer3dStyles(options)`
+
+Get available 3D transfer styles.
+
+**Returns:**
+```typescript
+{
+  success: true,
+  data: Array<{
+    mode_key: string;      // Style identifier (e.g., 'smart')
+    mode_name: string;     // Display name (e.g., 'Q版公仔')
+    mode_description: string;
+    preview_image_url: string | null;
+  }>
+}
+```
+
+---
+
+### `initiateTransfer3dConversion(options)`
+
+Upload an image and start the 3D conversion process.
+
+**Parameters:**
+- `body.image`: File - Image to convert (max 10MB, supported: jpg, png, webp)
+- `body.style`: string - Style key from `getTransfer3dStyles()`
+
+**Returns:**
+```typescript
+{
+  success: true,
+  data: {
+    request_id: string;  // UUID for status polling
+    status: 'PENDING';
+    message: string;
+  }
+}
+```
+
+---
+
+### `getTransfer3dStatus(options)`
+
+Get the status of a conversion request.
+
+**Parameters:**
+- `path.requestId`: string - Request ID from conversion response
+
+**Returns:**
+```typescript
+{
+  success: true,
+  data: {
+    request_id: string;
+    status: 'PENDING' | 'IN_PROGRESS' | 'COMPLETED' | 'FAILED';
+    phase: '2d_style_transfer' | '3d_generation';
+    progress: number;  // 0-100
+    result?: {
+      preview_2d_url: string;
+      model_3d_url: string;
+      glb_url: string;
+    };
+    error?: string;  // Present if status is FAILED
+  }
+}
+```
+
+## Status Values
+
+| Status | Description |
+|--------|-------------|
+| `PENDING` | Conversion request queued |
+| `IN_PROGRESS` | Currently processing |
+| `COMPLETED` | Conversion finished successfully |
+| `FAILED` | An error occurred |
+
+## TypeScript Types
+
+```typescript
+import type {
+  // Request/Response types (auto-generated)
+  GetTransfer3dStylesResponse,
+  InitiateTransfer3dConversionData,
+  InitiateTransfer3dConversionResponse,
+  GetTransfer3dStatusData,
+  GetTransfer3dStatusResponse,
+} from '@cympotek/3d-transfer-sdk';
+```
+
+## Error Handling
+
+```typescript
+import { AxiosError } from 'axios';
+
+try {
+  const response = await initiateTransfer3dConversion({
+    client,
+    body: { image: file, style: 'smart' },
+  });
+} catch (error) {
+  if (error instanceof AxiosError) {
+    if (error.response?.status === 401) {
+      console.error('Authentication failed. Check your API token.');
+    } else if (error.response?.status === 422) {
+      console.error('Validation error:', error.response.data.errors);
+    } else if (error.response?.status === 429) {
+      console.error('Rate limit exceeded. Please try again later.');
+    }
+  }
+  throw error;
+}
+```
+
+## Regenerating the SDK
+
+This SDK is auto-generated from the OpenAPI specification. To regenerate:
+
+```bash
+# In the mobius-frontier project root
+make sdk-3d-transfer
+```
+
+## OpenAPI Specification
+
+The OpenAPI spec is included in this package at `openapi.json`. You can use it to:
+- Generate clients for other languages
+- Import into API testing tools (Postman, Insomnia)
+- Generate documentation
+
+## Support
+
+- [API Documentation](https://api.localhost/docs/api)
+- [GitHub Issues](https://github.com/cympotek/mobius-frontier/issues)
+
+---
+
+*This SDK is auto-generated from the Mobius Frontier OpenAPI specification using [@hey-api/openapi-ts](https://heyapi.vercel.app/)*

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export * from './sdk.gen';
+export * from './types.gen';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+// This file is auto-generated by @hey-api/openapi-ts
+export * from './sdk.gen';
+export * from './types.gen';
+//# 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,qDAAqD;AACrD,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC"}

package/dist/sdk.gen.d.ts

@@ -0,0 +1,26 @@
+import { type OptionsLegacyParser } from '@hey-api/client-axios';
+import type { GetTransfer3dStylesError, InitiateTransfer3dConversionData, InitiateTransfer3dConversionError, GetTransfer3dStatusData, GetTransfer3dStatusError, ProxyTransfer3dModelData, ProxyTransfer3dModelError } from './types.gen';
+export declare const client: import("@hey-api/client-axios").Client;
+/**
+ * Get available 3D transfer styles
+ * Returns a list of available 3D transfer styles with their configurations.
+ */
+export declare const getTransfer3dStyles: <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<unknown, ThrowOnError>) => import("@hey-api/client-axios").RequestResult<200, GetTransfer3dStylesError, ThrowOnError>;
+/**
+ * Upload image and initiate 3D conversion
+ * Upload an image and start the 3D conversion process. The image will first
+ * be processed through 2D style transfer, then converted to a 3D model.
+ */
+export declare const initiateTransfer3dConversion: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<InitiateTransfer3dConversionData, ThrowOnError>) => import("@hey-api/client-axios").RequestResult<200, InitiateTransfer3dConversionError, ThrowOnError>;
+/**
+ * Get conversion status
+ * Query the status of a conversion request. Returns the current phase,
+ * progress, and result URLs when available.
+ */
+export declare const getTransfer3dStatus: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<GetTransfer3dStatusData, ThrowOnError>) => import("@hey-api/client-axios").RequestResult<200, GetTransfer3dStatusError, ThrowOnError>;
+/**
+ * Proxy GLB model file
+ * Proxies the GLB model file to avoid CORS issues when loading from external domains.
+ */
+export declare const proxyTransfer3dModel: <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ProxyTransfer3dModelData, ThrowOnError>) => import("@hey-api/client-axios").RequestResult<200, ProxyTransfer3dModelError, ThrowOnError>;
+//# sourceMappingURL=sdk.gen.d.ts.map

package/dist/sdk.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.gen.d.ts","sourceRoot":"","sources":["../src/sdk.gen.ts"],"names":[],"mappings":"AAEA,OAAO,EAA8B,KAAK,mBAAmB,EAA0B,MAAM,uBAAuB,CAAC;AACrH,OAAO,KAAK,EAAE,wBAAwB,EAA+B,gCAAgC,EAAE,iCAAiC,EAAwC,uBAAuB,EAAE,wBAAwB,EAA+B,wBAAwB,EAAE,yBAAyB,EAAgC,MAAM,aAAa,CAAC;AAEvW,eAAO,MAAM,MAAM,wCAA+B,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAAI,YAAY,SAAS,OAAO,GAAG,KAAK,EAAE,UAAU,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,+FAK7H,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,4BAA4B,GAAI,YAAY,SAAS,OAAO,GAAG,KAAK,EAAE,SAAS,mBAAmB,CAAC,gCAAgC,EAAE,YAAY,CAAC,wGAU9J,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAAI,YAAY,SAAS,OAAO,GAAG,KAAK,EAAE,SAAS,mBAAmB,CAAC,uBAAuB,EAAE,YAAY,CAAC,+FAK5I,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAI,YAAY,SAAS,OAAO,GAAG,KAAK,EAAE,SAAS,mBAAmB,CAAC,wBAAwB,EAAE,YAAY,CAAC,gGAK9I,CAAC"}

package/dist/sdk.gen.js

@@ -0,0 +1,51 @@
+// This file is auto-generated by @hey-api/openapi-ts
+import { createClient, createConfig, formDataBodySerializer } from '@hey-api/client-axios';
+export const client = createClient(createConfig());
+/**
+ * Get available 3D transfer styles
+ * Returns a list of available 3D transfer styles with their configurations.
+ */
+export const getTransfer3dStyles = (options) => {
+    return (options?.client ?? client).get({
+        ...options,
+        url: '/3d-transfer/styles'
+    });
+};
+/**
+ * Upload image and initiate 3D conversion
+ * Upload an image and start the 3D conversion process. The image will first
+ * be processed through 2D style transfer, then converted to a 3D model.
+ */
+export const initiateTransfer3dConversion = (options) => {
+    return (options?.client ?? client).post({
+        ...options,
+        ...formDataBodySerializer,
+        headers: {
+            'Content-Type': null,
+            ...options?.headers
+        },
+        url: '/3d-transfer/convert'
+    });
+};
+/**
+ * Get conversion status
+ * Query the status of a conversion request. Returns the current phase,
+ * progress, and result URLs when available.
+ */
+export const getTransfer3dStatus = (options) => {
+    return (options?.client ?? client).get({
+        ...options,
+        url: '/3d-transfer/{requestId}/status'
+    });
+};
+/**
+ * Proxy GLB model file
+ * Proxies the GLB model file to avoid CORS issues when loading from external domains.
+ */
+export const proxyTransfer3dModel = (options) => {
+    return (options?.client ?? client).get({
+        ...options,
+        url: '/3d-transfer/{requestId}/model.glb'
+    });
+};
+//# sourceMappingURL=sdk.gen.js.map

package/dist/sdk.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdk.gen.js","sourceRoot":"","sources":["../src/sdk.gen.ts"],"names":[],"mappings":"AAAA,qDAAqD;AAErD,OAAO,EAAE,YAAY,EAAE,YAAY,EAA4B,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAGrH,MAAM,CAAC,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,EAAE,CAAC,CAAC;AAEnD;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAuC,OAAoD,EAAE,EAAE;IAC9H,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,MAAM,CAAC,CAAC,GAAG,CAAsE;QACxG,GAAG,OAAO;QACV,GAAG,EAAE,qBAAqB;KAC7B,CAAC,CAAC;AACP,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAuC,OAA4E,EAAE,EAAE;IAC/J,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,MAAM,CAAC,CAAC,IAAI,CAAwF;QAC3H,GAAG,OAAO;QACV,GAAG,sBAAsB;QACzB,OAAO,EAAE;YACL,cAAc,EAAE,IAAI;YACpB,GAAG,OAAO,EAAE,OAAO;SACtB;QACD,GAAG,EAAE,sBAAsB;KAC9B,CAAC,CAAC;AACP,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAuC,OAAmE,EAAE,EAAE;IAC7I,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,MAAM,CAAC,CAAC,GAAG,CAAsE;QACxG,GAAG,OAAO;QACV,GAAG,EAAE,iCAAiC;KACzC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAuC,OAAoE,EAAE,EAAE;IAC/I,OAAO,CAAC,OAAO,EAAE,MAAM,IAAI,MAAM,CAAC,CAAC,GAAG,CAAwE;QAC1G,GAAG,OAAO;QACV,GAAG,EAAE,oCAAoC;KAC5C,CAAC,CAAC;AACP,CAAC,CAAC"}

package/dist/types.gen.d.ts

@@ -0,0 +1,56 @@
+export type GetTransfer3dStylesResponse = (200);
+export type GetTransfer3dStylesError = ({
+    /**
+     * Error overview.
+     */
+    message: string;
+});
+export type InitiateTransfer3dConversionData = {
+    body: {
+        image: (Blob | File);
+        style: '';
+    };
+};
+export type InitiateTransfer3dConversionResponse = (200);
+export type InitiateTransfer3dConversionError = ({
+    /**
+     * Error overview.
+     */
+    message: string;
+} | {
+    /**
+     * Errors overview.
+     */
+    message: string;
+    /**
+     * A detailed description of each field that failed validation.
+     */
+    errors: {
+        [key: string]: Array<(string)>;
+    };
+});
+export type GetTransfer3dStatusData = {
+    path: {
+        requestId: string;
+    };
+};
+export type GetTransfer3dStatusResponse = (200);
+export type GetTransfer3dStatusError = ({
+    /**
+     * Error overview.
+     */
+    message: string;
+});
+export type ProxyTransfer3dModelData = {
+    path: {
+        requestId: string;
+    };
+};
+export type ProxyTransfer3dModelResponse = (200);
+export type ProxyTransfer3dModelError = ({
+    /**
+     * Error overview.
+     */
+    message: string;
+});
+//# sourceMappingURL=types.gen.d.ts.map

package/dist/types.gen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.gen.d.ts","sourceRoot":"","sources":["../src/types.gen.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,2BAA2B,GAAG,CAAC,GAAG,CAAC,CAAC;AAEhD,MAAM,MAAM,wBAAwB,GAAG,CAAC;IACpC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC;AAEH,MAAM,MAAM,gCAAgC,GAAG;IAC3C,IAAI,EAAE;QACF,KAAK,EAAE,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;QACrB,KAAK,EAAE,EAAE,CAAC;KACb,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,oCAAoC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEzD,MAAM,MAAM,iCAAiC,GAAG,CAAC;IAC7C;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACnB,GAAG;IACA;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,MAAM,EAAE;QACJ,CAAC,GAAG,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;KAClC,CAAC;CACL,CAAC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG;IAClC,IAAI,EAAE;QACF,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,2BAA2B,GAAG,CAAC,GAAG,CAAC,CAAC;AAEhD,MAAM,MAAM,wBAAwB,GAAG,CAAC;IACpC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG;IACnC,IAAI,EAAE;QACF,SAAS,EAAE,MAAM,CAAC;KACrB,CAAC;CACL,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,CAAC,GAAG,CAAC,CAAC;AAEjD,MAAM,MAAM,yBAAyB,GAAG,CAAC;IACrC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACnB,CAAC,CAAC"}

package/dist/types.gen.js

@@ -0,0 +1,3 @@
+// This file is auto-generated by @hey-api/openapi-ts
+export {};
+//# sourceMappingURL=types.gen.js.map

package/dist/types.gen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.gen.js","sourceRoot":"","sources":["../src/types.gen.ts"],"names":[],"mappings":"AAAA,qDAAqD"}

package/openapi.json

@@ -0,0 +1,240 @@
+{
+  "openapi": "3.1.0",
+  "info": {
+    "title": "Mobius 3D Transfer API",
+    "version": "1.0.0",
+    "description": "3D Transfer API for converting images to 3D models.\n\n## Overview\n\nThis API provides endpoints for:\n- Getting available 3D transfer styles\n- Uploading images and initiating 3D conversion\n- Checking conversion status and retrieving results\n\n## Authentication\n\nAll endpoints require Bearer token authentication:\n```\nAuthorization: Bearer <your-api-token>\n```\n\n## Workflow\n\n1. Call `GET /3d-transfer/styles` to get available styles\n2. Call `POST /3d-transfer/convert` with an image and style\n3. Poll `GET /3d-transfer/{requestId}/status` until status is COMPLETED\n4. Retrieve the 3D model URL from the response"
+  },
+  "servers": [
+    {
+      "url": "http://www.localhost/api"
+    }
+  ],
+  "security": [
+    {
+      "http": []
+    }
+  ],
+  "paths": {
+    "/3d-transfer/styles": {
+      "get": {
+        "operationId": "getTransfer3DStyles",
+        "description": "Returns a list of available 3D transfer styles with their configurations.",
+        "summary": "Get available 3D transfer styles",
+        "tags": [
+          "3D Transfer",
+          "Transfer3D"
+        ],
+        "responses": {
+          "200": {
+            "description": "",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "integer",
+                  "enum": [
+                    200
+                  ]
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/AuthenticationException"
+          }
+        }
+      }
+    },
+    "/3d-transfer/convert": {
+      "post": {
+        "operationId": "initiateTransfer3DConversion",
+        "description": "Upload an image and start the 3D conversion process. The image will first\nbe processed through 2D style transfer, then converted to a 3D model.",
+        "summary": "Upload image and initiate 3D conversion",
+        "tags": [
+          "3D Transfer",
+          "Transfer3D"
+        ],
+        "requestBody": {
+          "required": true,
+          "content": {
+            "multipart/form-data": {
+              "schema": {
+                "type": "object",
+                "properties": {
+                  "image": {
+                    "type": "string",
+                    "format": "binary",
+                    "contentMediaType": "application/octet-stream",
+                    "maxLength": 10240
+                  },
+                  "style": {
+                    "type": "string",
+                    "enum": [
+                      ""
+                    ]
+                  }
+                },
+                "required": [
+                  "image",
+                  "style"
+                ]
+              }
+            }
+          }
+        },
+        "responses": {
+          "200": {
+            "description": "",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "integer",
+                  "enum": [
+                    200
+                  ]
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/AuthenticationException"
+          },
+          "422": {
+            "$ref": "#/components/responses/ValidationException"
+          }
+        }
+      }
+    },
+    "/3d-transfer/{requestId}/status": {
+      "get": {
+        "operationId": "getTransfer3DStatus",
+        "description": "Query the status of a conversion request. Returns the current phase,\nprogress, and result URLs when available.",
+        "summary": "Get conversion status",
+        "tags": [
+          "3D Transfer",
+          "Transfer3D"
+        ],
+        "parameters": [
+          {
+            "name": "requestId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "integer",
+                  "enum": [
+                    200
+                  ]
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/AuthenticationException"
+          }
+        }
+      }
+    },
+    "/3d-transfer/{requestId}/model.glb": {
+      "get": {
+        "operationId": "proxyTransfer3DModel",
+        "description": "Proxies the GLB model file to avoid CORS issues when loading from external domains.",
+        "summary": "Proxy GLB model file",
+        "tags": [
+          "3D Transfer",
+          "Transfer3D"
+        ],
+        "parameters": [
+          {
+            "name": "requestId",
+            "in": "path",
+            "required": true,
+            "schema": {
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "",
+            "content": {
+              "application/json": {
+                "schema": {
+                  "type": "integer",
+                  "enum": [
+                    200
+                  ]
+                }
+              }
+            }
+          },
+          "401": {
+            "$ref": "#/components/responses/AuthenticationException"
+          }
+        }
+      }
+    }
+  },
+  "components": {
+    "responses": {
+      "AuthenticationException": {
+        "description": "Unauthenticated",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "message": {
+                  "type": "string",
+                  "description": "Error overview."
+                }
+              },
+              "required": [
+                "message"
+              ]
+            }
+          }
+        }
+      },
+      "ValidationException": {
+        "description": "Validation error",
+        "content": {
+          "application/json": {
+            "schema": {
+              "type": "object",
+              "properties": {
+                "message": {
+                  "type": "string",
+                  "description": "Errors overview."
+                },
+                "errors": {
+                  "type": "object",
+                  "description": "A detailed description of each field that failed validation.",
+                  "additionalProperties": {
+                    "type": "array",
+                    "items": {
+                      "type": "string"
+                    }
+                  }
+                }
+              },
+              "required": [
+                "message",
+                "errors"
+              ]
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@cympotek/3d-transfer-sdk",
+  "version": "1.0.0",
+  "description": "TypeScript SDK for Mobius 3D Transfer API - Convert images to 3D models",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      },
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./react": {
+      "import": {
+        "types": "./dist/react/index.d.ts",
+        "default": "./dist/react/index.js"
+      },
+      "require": {
+        "types": "./dist/react/index.d.ts",
+        "default": "./dist/react/index.js"
+      },
+      "types": "./dist/react/index.d.ts",
+      "default": "./dist/react/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "openapi.json"
+  ],
+  "scripts": {
+    "generate": "openapi-ts --input ./openapi.json --output ./src --client @hey-api/client-axios",
+    "build": "tsc && tsc -p tsconfig.esm.json",
+    "clean": "rm -rf dist src/*.gen.ts",
+    "prepublishOnly": "npm run clean && npm run generate && npm run build"
+  },
+  "dependencies": {
+    "@hey-api/client-axios": "^0.3.4",
+    "axios": "^1.6.0"
+  },
+  "devDependencies": {
+    "@hey-api/openapi-ts": "^0.60.1",
+    "@types/react": "^18.0.0",
+    "@types/react-dom": "^18.0.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "axios": ">=1.0.0",
+    "react": ">=17.0.0",
+    "react-dom": ">=17.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "react-dom": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "3d",
+    "transfer",
+    "api",
+    "sdk",
+    "mobius",
+    "ai",
+    "image-to-3d",
+    "typescript",
+    "openapi"
+  ],
+  "author": "Cympotek",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/cympotek/mobius-frontier"
+  },
+  "homepage": "https://github.com/cympotek/mobius-frontier#readme",
+  "bugs": {
+    "url": "https://github.com/cympotek/mobius-frontier/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}