@ai-appforge/core 1.0.0

package/README.md

@@ -0,0 +1,17 @@
+# @ai-appforge/core
+
+Core types and shared utilities for the AI App Forge SDK.
+
+This package is generally used internally by `@ai-appforge/nodejs` and `@ai-appforge/react-native`, but can be used directly if you need access to the raw types or workflow logic.
+
+## Installation
+
+```bash
+npm install @ai-appforge/core
+```
+
+## Exports
+
+- **`WorkflowsModule`**: Handles workflow execution and status checks.
+- **`APIError`**: Custom error class for API responses.
+- **Types**: Various TypeScript definitions for workflow payloads and responses.

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './workflows';

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+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("./types"), exports);
+__exportStar(require("./workflows"), exports);

package/dist/index.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.test.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+describe('Core SDK', () => {
+    it('should export types', () => {
+        expect(true).toBe(true);
+        // Basic smoke test to ensure types are resolvable
+        const workflow = {
+            id: 'test-id',
+            name: 'Test Workflow'
+        };
+        expect(workflow.id).toBe('test-id');
+    });
+});

package/dist/types.d.ts

@@ -0,0 +1,114 @@
+import { Headers as FetchHeaders } from 'node-fetch';
+export interface Workflow {
+    id: string;
+    name: string;
+    description?: string;
+    userId: string;
+    isReusable?: boolean;
+    icon?: any;
+    workflow_data?: {
+        nodes: any[];
+        edges: any[];
+        viewport?: any;
+        isReusable?: boolean;
+        icon?: any;
+        description?: string;
+    };
+    created_at?: string;
+    updated_at?: string;
+}
+export interface ListWorkflowsResponse {
+    success: boolean;
+    data: Workflow[];
+}
+export interface RunWorkflowInput {
+    workflow?: {
+        nodes: any[];
+        edges: any[];
+        [key: string]: any;
+    };
+    workflowId?: string;
+    userId?: string;
+    input?: any;
+    [key: string]: any;
+}
+export interface RunWorkflowResponse {
+    success: boolean;
+    context?: any;
+    logs?: any[];
+    job?: any;
+    scheduled?: boolean;
+    error?: string;
+}
+export interface StopWorkflowResponse {
+    success: boolean;
+    message: string;
+    error?: string;
+}
+export interface SaveWorkflowInput {
+    nodes: any[];
+    edges: any[];
+    name?: string;
+    userId: string;
+    workflowId?: string;
+    viewport?: any;
+    isReusable?: boolean;
+    icon?: any;
+    description?: string;
+}
+export interface SaveWorkflowResponse {
+    success: boolean;
+    data?: any;
+    message?: string;
+    error?: string;
+}
+export interface ListReusableWorkflowsResponse {
+    success: boolean;
+    data: any[];
+    error?: string;
+}
+export interface ListSchedulesResponse {
+    success: boolean;
+    data: any[];
+    error?: string;
+}
+export interface CancelScheduleResponse {
+    success: boolean;
+    message?: string;
+    error?: string;
+}
+export interface WaitingInput {
+    id: string;
+    workflow_id: string;
+    node_id: string;
+    user_id: string;
+    status: 'waiting' | 'responded';
+    context: any;
+    created_at: string;
+    [key: string]: any;
+}
+export interface GetWaitingInputsResponse {
+    success: boolean;
+    data: WaitingInput[];
+    error?: string;
+}
+export interface RespondToInputData {
+    inputId: string;
+    responseData: any;
+}
+export interface RespondToInputResponse {
+    success: boolean;
+    message?: string;
+    error?: string;
+}
+export interface DeleteWorkflowResponse {
+    success: boolean;
+    message?: string;
+    error?: string;
+}
+export declare class APIError extends Error {
+    status: number;
+    body: any;
+    headers: FetchHeaders;
+    constructor(status: number, body: any, headers: FetchHeaders);
+}

package/dist/types.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APIError = void 0;
+class APIError extends Error {
+    constructor(status, body, headers) {
+        super(body?.error || `API request failed with status ${status}`);
+        this.status = status;
+        this.body = body;
+        this.headers = headers;
+    }
+}
+exports.APIError = APIError;

package/dist/workflows.d.ts

@@ -0,0 +1,63 @@
+import { Workflow, ListWorkflowsResponse, RunWorkflowInput, RunWorkflowResponse, StopWorkflowResponse, SaveWorkflowInput, SaveWorkflowResponse, ListReusableWorkflowsResponse, ListSchedulesResponse, CancelScheduleResponse, GetWaitingInputsResponse, RespondToInputData, RespondToInputResponse, DeleteWorkflowResponse } from './types';
+export declare class WorkflowsModule {
+    private request;
+    constructor(request: <T>(endpoint: string, options?: any) => Promise<T>);
+    /**
+     * List all workflows for a user.
+     * @param userId The ID of the user.
+     */
+    list(userId: string): Promise<ListWorkflowsResponse>;
+    /**
+     * Get a specific workflow by ID.
+     * @param id The workflow ID.
+     */
+    get(id: string): Promise<Workflow>;
+    /**
+     * Run a workflow.
+     * @param data The input data for running the workflow.
+     */
+    run(data: RunWorkflowInput): Promise<RunWorkflowResponse>;
+    /**
+     * Stop a running workflow.
+     * @param workflowId The ID of the workflow to stop.
+     */
+    stop(workflowId: string): Promise<StopWorkflowResponse>;
+    /**
+     * Save (create or update) a workflow.
+     * @param data The workflow data to save.
+     */
+    save(data: SaveWorkflowInput): Promise<SaveWorkflowResponse>;
+    /**
+     * Delete a workflow by ID.
+     * @param id The ID of the workflow to delete.
+     */
+    delete(id: string): Promise<DeleteWorkflowResponse>;
+    /**
+     * List reusable workflows for a user.
+     * @param userId The ID of the user.
+     */
+    listReusable(userId: string): Promise<ListReusableWorkflowsResponse>;
+    /**
+     * List scheduled jobs/workflows.
+     * @param userId The ID of the user.
+     * @param workflowId Optional workflow ID filter.
+     * @param status Optional status filter.
+     */
+    listSchedules(userId: string, workflowId?: string, status?: string): Promise<ListSchedulesResponse>;
+    /**
+     * Cancel a scheduled job.
+     * @param jobId The ID of the job/schedule to cancel.
+     */
+    cancelSchedule(jobId: string): Promise<CancelScheduleResponse>;
+    /**
+     * Get inputs waiting for user response.
+     * @param userId The ID of the user.
+     * @param status Optional status filter.
+     */
+    getWaitingInputs(userId: string, status?: string): Promise<GetWaitingInputsResponse>;
+    /**
+     * Respond to a waiting input.
+     * @param data The response data including inputId.
+     */
+    respondToInput(data: RespondToInputData): Promise<RespondToInputResponse>;
+}

package/dist/workflows.js

@@ -0,0 +1,129 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowsModule = void 0;
+class WorkflowsModule {
+    constructor(request) {
+        this.request = request;
+    }
+    /**
+     * List all workflows for a user.
+     * @param userId The ID of the user.
+     */
+    async list(userId) {
+        if (!userId)
+            throw new Error('userId is required');
+        return this.request(`/api/workflows?userId=${encodeURIComponent(userId)}`, { method: 'GET' });
+    }
+    /**
+     * Get a specific workflow by ID.
+     * @param id The workflow ID.
+     */
+    async get(id) {
+        if (!id)
+            throw new Error('id is required');
+        const res = await this.request(`/api/workflows/${id}`, { method: 'GET' });
+        return res.data;
+    }
+    /**
+     * Run a workflow.
+     * @param data The input data for running the workflow.
+     */
+    async run(data) {
+        return this.request('/api/workflows/run', {
+            method: 'POST',
+            body: JSON.stringify(data)
+        });
+    }
+    /**
+     * Stop a running workflow.
+     * @param workflowId The ID of the workflow to stop.
+     */
+    async stop(workflowId) {
+        if (!workflowId)
+            throw new Error('workflowId is required');
+        return this.request('/api/workflows/stop', {
+            method: 'POST',
+            body: JSON.stringify({ workflowId })
+        });
+    }
+    /**
+     * Save (create or update) a workflow.
+     * @param data The workflow data to save.
+     */
+    async save(data) {
+        return this.request('/api/workflows/save', {
+            method: 'POST',
+            body: JSON.stringify(data)
+        });
+    }
+    /**
+     * Delete a workflow by ID.
+     * @param id The ID of the workflow to delete.
+     */
+    async delete(id) {
+        if (!id)
+            throw new Error('id is required');
+        return this.request(`/api/workflows/${id}`, { method: 'DELETE' });
+    }
+    /**
+     * List reusable workflows for a user.
+     * @param userId The ID of the user.
+     */
+    async listReusable(userId) {
+        if (!userId)
+            throw new Error('userId is required');
+        return this.request(`/api/workflows/reusable?userId=${encodeURIComponent(userId)}`, { method: 'GET' });
+    }
+    /**
+     * List scheduled jobs/workflows.
+     * @param userId The ID of the user.
+     * @param workflowId Optional workflow ID filter.
+     * @param status Optional status filter.
+     */
+    async listSchedules(userId, workflowId, status) {
+        if (!userId)
+            throw new Error('userId is required');
+        let query = `?userId=${encodeURIComponent(userId)}`;
+        if (workflowId)
+            query += `&workflowId=${encodeURIComponent(workflowId)}`;
+        if (status)
+            query += `&status=${encodeURIComponent(status)}`;
+        return this.request(`/api/schedules${query}`, { method: 'GET' });
+    }
+    /**
+     * Cancel a scheduled job.
+     * @param jobId The ID of the job/schedule to cancel.
+     */
+    async cancelSchedule(jobId) {
+        if (!jobId)
+            throw new Error('jobId is required');
+        return this.request('/api/schedules/cancel', {
+            method: 'POST',
+            body: JSON.stringify({ jobId })
+        });
+    }
+    /**
+     * Get inputs waiting for user response.
+     * @param userId The ID of the user.
+     * @param status Optional status filter.
+     */
+    async getWaitingInputs(userId, status) {
+        if (!userId)
+            throw new Error('userId is required');
+        let query = `?userId=${encodeURIComponent(userId)}`;
+        if (status)
+            query += `&status=${encodeURIComponent(status)}`;
+        return this.request(`/api/workflows/inputs${query}`, { method: 'GET' });
+    }
+    /**
+     * Respond to a waiting input.
+     * @param data The response data including inputId.
+     */
+    async respondToInput(data) {
+        return this.request('/api/workflows/inputs/respond', {
+            method: 'POST',
+            body: JSON.stringify(data)
+        });
+    }
+}
+exports.WorkflowsModule = WorkflowsModule;

package/jest.config.js

@@ -0,0 +1,6 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+module.exports = {
+    preset: 'ts-jest',
+    testEnvironment: 'node',
+    verbose: true,
+};

package/package.json

@@ -0,0 +1,23 @@
+{
+    "name": "@ai-appforge/core",
+    "version": "1.0.0",
+    "description": "Core types and utilities for AI App Forge SDK",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "scripts": {
+        "build": "npx tsc",
+        "test": "jest"
+    },
+    "keywords": [],
+    "author": "",
+    "license": "ISC",
+    "devDependencies": {
+        "@types/jest": "^30.0.0",
+        "@types/node": "^25.0.10",
+        "@types/node-fetch": "^2.6.13",
+        "jest": "^30.2.0",
+        "node-fetch": "^3.3.2",
+        "ts-jest": "^29.4.6",
+        "typescript": "^5.0.0"
+    }
+}

package/src/index.test.ts

@@ -0,0 +1,13 @@
+import { Workflow } from './index';
+
+describe('Core SDK', () => {
+    it('should export types', () => {
+        expect(true).toBe(true);
+        // Basic smoke test to ensure types are resolvable
+        const workflow: Partial<Workflow> = {
+            id: 'test-id',
+            name: 'Test Workflow'
+        };
+        expect(workflow.id).toBe('test-id');
+    });
+});

package/src/index.ts

@@ -0,0 +1,2 @@
+export * from './types';
+export * from './workflows';

package/src/types.ts

@@ -0,0 +1,136 @@
+import { Headers as FetchHeaders } from 'node-fetch';
+
+export interface Workflow {
+    id: string;
+    name: string;
+    description?: string;
+    userId: string;
+    isReusable?: boolean;
+    icon?: any;
+    workflow_data?: {
+        nodes: any[];
+        edges: any[];
+        viewport?: any;
+        isReusable?: boolean;
+        icon?: any;
+        description?: string;
+    };
+    created_at?: string;
+    updated_at?: string;
+}
+
+export interface ListWorkflowsResponse {
+    success: boolean;
+    data: Workflow[];
+}
+
+export interface RunWorkflowInput {
+    workflow?: {
+        nodes: any[];
+        edges: any[];
+        [key: string]: any;
+    };
+    workflowId?: string;
+    userId?: string;
+    input?: any;
+    [key: string]: any; // Allow other properties if needed
+}
+
+export interface RunWorkflowResponse {
+    success: boolean;
+    context?: any;
+    logs?: any[];
+    job?: any;
+    scheduled?: boolean;
+    error?: string;
+}
+
+export interface StopWorkflowResponse {
+    success: boolean;
+    message: string;
+    error?: string;
+}
+
+export interface SaveWorkflowInput {
+    nodes: any[];
+    edges: any[];
+    name?: string;
+    userId: string;
+    workflowId?: string;
+    viewport?: any;
+    isReusable?: boolean;
+    icon?: any;
+    description?: string;
+}
+
+export interface SaveWorkflowResponse {
+    success: boolean;
+    data?: any;
+    message?: string;
+    error?: string;
+}
+
+export interface ListReusableWorkflowsResponse {
+    success: boolean;
+    data: any[];
+    error?: string;
+}
+
+export interface ListSchedulesResponse {
+    success: boolean;
+    data: any[];
+    error?: string;
+}
+
+export interface CancelScheduleResponse {
+    success: boolean;
+    message?: string;
+    error?: string;
+}
+
+export interface WaitingInput {
+    id: string;
+    workflow_id: string;
+    node_id: string;
+    user_id: string;
+    status: 'waiting' | 'responded';
+    context: any;
+    created_at: string;
+    [key: string]: any;
+}
+
+export interface GetWaitingInputsResponse {
+    success: boolean;
+    data: WaitingInput[];
+    error?: string;
+}
+
+export interface RespondToInputData {
+    inputId: string;
+    responseData: any;
+}
+
+export interface RespondToInputResponse {
+    success: boolean;
+    message?: string;
+    error?: string;
+}
+
+export interface DeleteWorkflowResponse {
+    success: boolean;
+    message?: string;
+    error?: string;
+}
+
+export class APIError extends Error {
+    public status: number;
+    public body: any;
+    public headers: FetchHeaders;
+
+    constructor(status: number, body: any, headers: FetchHeaders) {
+        super(body?.error || `API request failed with status ${status}`);
+        this.status = status;
+        this.body = body;
+        this.headers = headers;
+    }
+}

package/src/workflows.ts

@@ -0,0 +1,175 @@
+import {
+    Workflow,
+    ListWorkflowsResponse,
+    RunWorkflowInput,
+    RunWorkflowResponse,
+    StopWorkflowResponse,
+    SaveWorkflowInput,
+    SaveWorkflowResponse,
+    ListReusableWorkflowsResponse,
+    ListSchedulesResponse,
+    CancelScheduleResponse,
+    GetWaitingInputsResponse,
+    RespondToInputData,
+    RespondToInputResponse,
+    DeleteWorkflowResponse
+} from './types'; // Removed .js extension for TS resolution
+
+export class WorkflowsModule {
+    constructor(private request: <T>(endpoint: string, options?: any) => Promise<T>) { }
+
+    /**
+     * List all workflows for a user.
+     * @param userId The ID of the user.
+     */
+    async list(userId: string): Promise<ListWorkflowsResponse> {
+        if (!userId) throw new Error('userId is required');
+        return this.request<ListWorkflowsResponse>(
+            `/api/workflows?userId=${encodeURIComponent(userId)}`,
+            { method: 'GET' }
+        );
+    }
+
+    /**
+     * Get a specific workflow by ID.
+     * @param id The workflow ID.
+     */
+    async get(id: string): Promise<Workflow> {
+        if (!id) throw new Error('id is required');
+        const res = await this.request<{ success: boolean; data: Workflow }>(
+            `/api/workflows/${id}`,
+            { method: 'GET' }
+        );
+        return res.data;
+    }
+
+    /**
+     * Run a workflow.
+     * @param data The input data for running the workflow.
+     */
+    async run(data: RunWorkflowInput): Promise<RunWorkflowResponse> {
+        return this.request<RunWorkflowResponse>(
+            '/api/workflows/run',
+            {
+                method: 'POST',
+                body: JSON.stringify(data)
+            }
+        );
+    }
+
+    /**
+     * Stop a running workflow.
+     * @param workflowId The ID of the workflow to stop.
+     */
+    async stop(workflowId: string): Promise<StopWorkflowResponse> {
+        if (!workflowId) throw new Error('workflowId is required');
+        return this.request<StopWorkflowResponse>(
+            '/api/workflows/stop',
+            {
+                method: 'POST',
+                body: JSON.stringify({ workflowId })
+            }
+        );
+    }
+
+    /**
+     * Save (create or update) a workflow.
+     * @param data The workflow data to save.
+     */
+    async save(data: SaveWorkflowInput): Promise<SaveWorkflowResponse> {
+        return this.request<SaveWorkflowResponse>(
+            '/api/workflows/save',
+            {
+                method: 'POST',
+                body: JSON.stringify(data)
+            }
+        );
+    }
+
+    /**
+     * Delete a workflow by ID.
+     * @param id The ID of the workflow to delete.
+     */
+    async delete(id: string): Promise<DeleteWorkflowResponse> {
+        if (!id) throw new Error('id is required');
+        return this.request<DeleteWorkflowResponse>(
+            `/api/workflows/${id}`,
+            { method: 'DELETE' }
+        );
+    }
+
+    /**
+     * List reusable workflows for a user.
+     * @param userId The ID of the user.
+     */
+    async listReusable(userId: string): Promise<ListReusableWorkflowsResponse> {
+        if (!userId) throw new Error('userId is required');
+        return this.request<ListReusableWorkflowsResponse>(
+            `/api/workflows/reusable?userId=${encodeURIComponent(userId)}`,
+            { method: 'GET' }
+        );
+    }
+
+    /**
+     * List scheduled jobs/workflows.
+     * @param userId The ID of the user.
+     * @param workflowId Optional workflow ID filter.
+     * @param status Optional status filter.
+     */
+    async listSchedules(userId: string, workflowId?: string, status?: string): Promise<ListSchedulesResponse> {
+        if (!userId) throw new Error('userId is required');
+        let query = `?userId=${encodeURIComponent(userId)}`;
+        if (workflowId) query += `&workflowId=${encodeURIComponent(workflowId)}`;
+        if (status) query += `&status=${encodeURIComponent(status)}`;
+
+        return this.request<ListSchedulesResponse>(
+            `/api/schedules${query}`,
+            { method: 'GET' }
+        );
+    }
+
+    /**
+     * Cancel a scheduled job.
+     * @param jobId The ID of the job/schedule to cancel.
+     */
+    async cancelSchedule(jobId: string): Promise<CancelScheduleResponse> {
+        if (!jobId) throw new Error('jobId is required');
+        return this.request<CancelScheduleResponse>(
+            '/api/schedules/cancel',
+            {
+                method: 'POST',
+                body: JSON.stringify({ jobId })
+            }
+        );
+    }
+
+    /**
+     * Get inputs waiting for user response.
+     * @param userId The ID of the user.
+     * @param status Optional status filter.
+     */
+    async getWaitingInputs(userId: string, status?: string): Promise<GetWaitingInputsResponse> {
+        if (!userId) throw new Error('userId is required');
+        let query = `?userId=${encodeURIComponent(userId)}`;
+        if (status) query += `&status=${encodeURIComponent(status)}`;
+
+        return this.request<GetWaitingInputsResponse>(
+            `/api/workflows/inputs${query}`,
+            { method: 'GET' }
+        );
+    }
+
+    /**
+     * Respond to a waiting input.
+     * @param data The response data including inputId.
+     */
+    async respondToInput(data: RespondToInputData): Promise<RespondToInputResponse> {
+        return this.request<RespondToInputResponse>(
+            '/api/workflows/inputs/respond',
+            {
+                method: 'POST',
+                body: JSON.stringify(data)
+            }
+        );
+    }
+}

package/tsconfig.json

@@ -0,0 +1,14 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "CommonJS",
+    "moduleResolution": "node",
+    "declaration": true,
+    "outDir": "./dist",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src"]
+}