@warlok-net/sdk 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,89 @@
+import { AssetType, GenerationEntityType, GenerationV2, GenerationStage } from '@warlok-net/core';
+export { AssetType, GenerationEntityType, GenerationStage, GenerationV2 } from '@warlok-net/core';
+
+/**
+ * Warlok SDK - Node.js client for the Warlok generation API.
+ */
+
+type LegacyGenerationType = AssetType | GenerationEntityType;
+type Generation = GenerationV2;
+type Asset = Generation;
+interface GenerateParams {
+    name?: string;
+    entityType?: GenerationEntityType;
+    type?: LegacyGenerationType;
+    prompt?: string;
+    imageUrl?: string;
+    imageBase64?: string;
+    options?: {
+        rigForMixamo?: boolean;
+        includeTpose?: boolean;
+        optimize?: boolean;
+        autoRig?: boolean;
+    };
+}
+interface ListGenerationsOptions {
+    limit?: number;
+    status?: GenerationStage;
+    entityType?: GenerationEntityType;
+    type?: LegacyGenerationType;
+}
+interface WarlokClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+}
+/**
+ * Warlok API client for generation workflows.
+ */
+declare class WarlokClient {
+    private apiKey;
+    private baseUrl;
+    constructor(options: WarlokClientOptions);
+    private request;
+    /**
+     * Create a generation job.
+     */
+    generate(params: GenerateParams): Promise<Generation>;
+    /**
+     * Get a generation by ID.
+     */
+    getGeneration(id: string): Promise<Generation>;
+    /**
+     * List generations for the current account.
+     */
+    listGenerations(options?: ListGenerationsOptions): Promise<Generation[]>;
+    /**
+     * Download a generated model file.
+     */
+    downloadGeneration(id: string, format?: "model" | "rigged"): Promise<Blob>;
+    /**
+     * Wait for terminal generation status.
+     */
+    waitForCompletion(id: string, options?: {
+        pollingInterval?: number;
+        timeout?: number;
+        onProgress?: (generation: Generation) => void;
+    }): Promise<Generation>;
+    /**
+     * Delete a generation.
+     */
+    deleteGeneration(id: string): Promise<void>;
+    getAsset(id: string): Promise<Asset>;
+    listAssets(options?: {
+        limit?: number;
+        offset?: number;
+        status?: GenerationStage;
+        type?: LegacyGenerationType;
+    }): Promise<Asset[]>;
+    downloadAsset(id: string, format?: "model" | "rigged"): Promise<Blob>;
+    deleteAsset(id: string): Promise<void>;
+}
+/**
+ * Custom error class for Warlok API errors.
+ */
+declare class WarlokError extends Error {
+    code: string;
+    constructor(message: string, code: string);
+}
+
+export { type Asset, type GenerateParams, type Generation, type LegacyGenerationType, type ListGenerationsOptions, WarlokClient, type WarlokClientOptions, WarlokError };

package/dist/index.d.ts

@@ -0,0 +1,89 @@
+import { AssetType, GenerationEntityType, GenerationV2, GenerationStage } from '@warlok-net/core';
+export { AssetType, GenerationEntityType, GenerationStage, GenerationV2 } from '@warlok-net/core';
+
+/**
+ * Warlok SDK - Node.js client for the Warlok generation API.
+ */
+
+type LegacyGenerationType = AssetType | GenerationEntityType;
+type Generation = GenerationV2;
+type Asset = Generation;
+interface GenerateParams {
+    name?: string;
+    entityType?: GenerationEntityType;
+    type?: LegacyGenerationType;
+    prompt?: string;
+    imageUrl?: string;
+    imageBase64?: string;
+    options?: {
+        rigForMixamo?: boolean;
+        includeTpose?: boolean;
+        optimize?: boolean;
+        autoRig?: boolean;
+    };
+}
+interface ListGenerationsOptions {
+    limit?: number;
+    status?: GenerationStage;
+    entityType?: GenerationEntityType;
+    type?: LegacyGenerationType;
+}
+interface WarlokClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+}
+/**
+ * Warlok API client for generation workflows.
+ */
+declare class WarlokClient {
+    private apiKey;
+    private baseUrl;
+    constructor(options: WarlokClientOptions);
+    private request;
+    /**
+     * Create a generation job.
+     */
+    generate(params: GenerateParams): Promise<Generation>;
+    /**
+     * Get a generation by ID.
+     */
+    getGeneration(id: string): Promise<Generation>;
+    /**
+     * List generations for the current account.
+     */
+    listGenerations(options?: ListGenerationsOptions): Promise<Generation[]>;
+    /**
+     * Download a generated model file.
+     */
+    downloadGeneration(id: string, format?: "model" | "rigged"): Promise<Blob>;
+    /**
+     * Wait for terminal generation status.
+     */
+    waitForCompletion(id: string, options?: {
+        pollingInterval?: number;
+        timeout?: number;
+        onProgress?: (generation: Generation) => void;
+    }): Promise<Generation>;
+    /**
+     * Delete a generation.
+     */
+    deleteGeneration(id: string): Promise<void>;
+    getAsset(id: string): Promise<Asset>;
+    listAssets(options?: {
+        limit?: number;
+        offset?: number;
+        status?: GenerationStage;
+        type?: LegacyGenerationType;
+    }): Promise<Asset[]>;
+    downloadAsset(id: string, format?: "model" | "rigged"): Promise<Blob>;
+    deleteAsset(id: string): Promise<void>;
+}
+/**
+ * Custom error class for Warlok API errors.
+ */
+declare class WarlokError extends Error {
+    code: string;
+    constructor(message: string, code: string);
+}
+
+export { type Asset, type GenerateParams, type Generation, type LegacyGenerationType, type ListGenerationsOptions, WarlokClient, type WarlokClientOptions, WarlokError };

package/dist/index.js

@@ -0,0 +1,248 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  WarlokClient: () => WarlokClient,
+  WarlokError: () => WarlokError
+});
+module.exports = __toCommonJS(index_exports);
+function mapToEntityType(type) {
+  const normalized = String(type).toLowerCase();
+  if (normalized === "person" || normalized === "character" || normalized === "creature") {
+    return "person";
+  }
+  if (normalized === "place" || normalized === "environment") {
+    return "place";
+  }
+  if (normalized === "noun") {
+    return "noun";
+  }
+  return "thing";
+}
+function resolveEntityType(params) {
+  if (params.entityType) {
+    return params.entityType;
+  }
+  if (params.type) {
+    return mapToEntityType(params.type);
+  }
+  return "thing";
+}
+var WarlokClient = class {
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl || "https://api.warlok.net";
+  }
+  async request(method, path, body) {
+    const headers = {
+      Authorization: `Bearer ${this.apiKey}`
+    };
+    const init = {
+      method,
+      headers
+    };
+    if (body !== void 0) {
+      headers["Content-Type"] = "application/json";
+      init.body = JSON.stringify(body);
+    }
+    const response = await fetch(`${this.baseUrl}${path}`, init);
+    const contentType = response.headers.get("content-type") || "";
+    const payload = contentType.includes("application/json") ? await response.json().catch(() => void 0) : void 0;
+    if (!response.ok) {
+      const errorPayload = payload || {};
+      throw new WarlokError(
+        errorPayload.error?.message || `Request failed: ${response.status}`,
+        errorPayload.error?.code || "REQUEST_FAILED"
+      );
+    }
+    return payload;
+  }
+  /**
+   * Create a generation job.
+   */
+  async generate(params) {
+    const entityType = resolveEntityType(params);
+    const isPerson = entityType === "person";
+    const rigForMixamo = isPerson ? params.options?.rigForMixamo ?? params.options?.autoRig ?? true : false;
+    const includeTpose = isPerson ? params.options?.includeTpose ?? true : false;
+    const optimize = params.options?.optimize ?? true;
+    const response = await this.request(
+      "POST",
+      "/api/v1/generations",
+      {
+        name: params.name,
+        entityType,
+        input: {
+          prompt: params.prompt,
+          imageUrl: params.imageUrl,
+          imageBase64: params.imageBase64
+        },
+        options: {
+          rigForMixamo,
+          includeTpose,
+          optimize
+        }
+      }
+    );
+    if (!response.success || !response.data) {
+      throw new WarlokError(
+        response.error?.message || "Generation failed",
+        response.error?.code || "GENERATION_FAILED"
+      );
+    }
+    return response.data;
+  }
+  /**
+   * Get a generation by ID.
+   */
+  async getGeneration(id) {
+    const response = await this.request(
+      "GET",
+      `/api/v1/generations/${id}`
+    );
+    if (!response.success || !response.data) {
+      throw new WarlokError(
+        response.error?.message || "Generation not found",
+        response.error?.code || "NOT_FOUND"
+      );
+    }
+    return response.data;
+  }
+  /**
+   * List generations for the current account.
+   */
+  async listGenerations(options) {
+    const response = await this.request(
+      "GET",
+      "/api/v1/generations"
+    );
+    let items = response.data || [];
+    if (options?.status) {
+      items = items.filter((item) => item.status === options.status);
+    }
+    const filteredEntityType = options?.entityType || (options?.type ? mapToEntityType(options.type) : void 0);
+    if (filteredEntityType) {
+      items = items.filter((item) => item.entityType === filteredEntityType);
+    }
+    if (options?.limit && options.limit > 0) {
+      items = items.slice(0, options.limit);
+    }
+    return items;
+  }
+  /**
+   * Download a generated model file.
+   */
+  async downloadGeneration(id, format) {
+    const generation = await this.getGeneration(id);
+    let url;
+    if (format === "rigged") {
+      url = generation.outputs.riggedModelUrl;
+    } else if (format === "model") {
+      url = generation.outputs.modelUrl;
+    } else {
+      url = generation.outputs.riggedModelUrl || generation.outputs.modelUrl;
+    }
+    if (!url) {
+      throw new WarlokError("No model URL available", "NO_MODEL");
+    }
+    const response = await fetch(url, {
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`
+      }
+    });
+    if (!response.ok) {
+      throw new WarlokError("Download failed", "DOWNLOAD_FAILED");
+    }
+    return response.blob();
+  }
+  /**
+   * Wait for terminal generation status.
+   */
+  async waitForCompletion(id, options) {
+    const interval = options?.pollingInterval || 2e3;
+    const timeout = options?.timeout || 3e5;
+    const startTime = Date.now();
+    while (true) {
+      const generation = await this.getGeneration(id);
+      if (options?.onProgress) {
+        options.onProgress(generation);
+      }
+      if (generation.status === "complete") {
+        return generation;
+      }
+      if (generation.status === "failed") {
+        throw new WarlokError(
+          generation.error || "Generation failed",
+          "GENERATION_FAILED"
+        );
+      }
+      if (Date.now() - startTime > timeout) {
+        throw new WarlokError("Timeout waiting for completion", "TIMEOUT");
+      }
+      await sleep(interval);
+    }
+  }
+  /**
+   * Delete a generation.
+   */
+  async deleteGeneration(id) {
+    await this.request(
+      "DELETE",
+      `/api/v1/generations/${id}`
+    );
+  }
+  // Compatibility aliases for previous SDK method names.
+  async getAsset(id) {
+    return this.getGeneration(id);
+  }
+  async listAssets(options) {
+    const items = await this.listGenerations({
+      limit: options?.limit,
+      status: options?.status,
+      type: options?.type
+    });
+    if (!options?.offset || options.offset <= 0) {
+      return items;
+    }
+    return items.slice(options.offset);
+  }
+  async downloadAsset(id, format) {
+    return this.downloadGeneration(id, format);
+  }
+  async deleteAsset(id) {
+    return this.deleteGeneration(id);
+  }
+};
+var WarlokError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.name = "WarlokError";
+    this.code = code;
+  }
+};
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  WarlokClient,
+  WarlokError
+});

package/dist/index.mjs

@@ -0,0 +1,222 @@
+// src/index.ts
+function mapToEntityType(type) {
+  const normalized = String(type).toLowerCase();
+  if (normalized === "person" || normalized === "character" || normalized === "creature") {
+    return "person";
+  }
+  if (normalized === "place" || normalized === "environment") {
+    return "place";
+  }
+  if (normalized === "noun") {
+    return "noun";
+  }
+  return "thing";
+}
+function resolveEntityType(params) {
+  if (params.entityType) {
+    return params.entityType;
+  }
+  if (params.type) {
+    return mapToEntityType(params.type);
+  }
+  return "thing";
+}
+var WarlokClient = class {
+  constructor(options) {
+    this.apiKey = options.apiKey;
+    this.baseUrl = options.baseUrl || "https://api.warlok.net";
+  }
+  async request(method, path, body) {
+    const headers = {
+      Authorization: `Bearer ${this.apiKey}`
+    };
+    const init = {
+      method,
+      headers
+    };
+    if (body !== void 0) {
+      headers["Content-Type"] = "application/json";
+      init.body = JSON.stringify(body);
+    }
+    const response = await fetch(`${this.baseUrl}${path}`, init);
+    const contentType = response.headers.get("content-type") || "";
+    const payload = contentType.includes("application/json") ? await response.json().catch(() => void 0) : void 0;
+    if (!response.ok) {
+      const errorPayload = payload || {};
+      throw new WarlokError(
+        errorPayload.error?.message || `Request failed: ${response.status}`,
+        errorPayload.error?.code || "REQUEST_FAILED"
+      );
+    }
+    return payload;
+  }
+  /**
+   * Create a generation job.
+   */
+  async generate(params) {
+    const entityType = resolveEntityType(params);
+    const isPerson = entityType === "person";
+    const rigForMixamo = isPerson ? params.options?.rigForMixamo ?? params.options?.autoRig ?? true : false;
+    const includeTpose = isPerson ? params.options?.includeTpose ?? true : false;
+    const optimize = params.options?.optimize ?? true;
+    const response = await this.request(
+      "POST",
+      "/api/v1/generations",
+      {
+        name: params.name,
+        entityType,
+        input: {
+          prompt: params.prompt,
+          imageUrl: params.imageUrl,
+          imageBase64: params.imageBase64
+        },
+        options: {
+          rigForMixamo,
+          includeTpose,
+          optimize
+        }
+      }
+    );
+    if (!response.success || !response.data) {
+      throw new WarlokError(
+        response.error?.message || "Generation failed",
+        response.error?.code || "GENERATION_FAILED"
+      );
+    }
+    return response.data;
+  }
+  /**
+   * Get a generation by ID.
+   */
+  async getGeneration(id) {
+    const response = await this.request(
+      "GET",
+      `/api/v1/generations/${id}`
+    );
+    if (!response.success || !response.data) {
+      throw new WarlokError(
+        response.error?.message || "Generation not found",
+        response.error?.code || "NOT_FOUND"
+      );
+    }
+    return response.data;
+  }
+  /**
+   * List generations for the current account.
+   */
+  async listGenerations(options) {
+    const response = await this.request(
+      "GET",
+      "/api/v1/generations"
+    );
+    let items = response.data || [];
+    if (options?.status) {
+      items = items.filter((item) => item.status === options.status);
+    }
+    const filteredEntityType = options?.entityType || (options?.type ? mapToEntityType(options.type) : void 0);
+    if (filteredEntityType) {
+      items = items.filter((item) => item.entityType === filteredEntityType);
+    }
+    if (options?.limit && options.limit > 0) {
+      items = items.slice(0, options.limit);
+    }
+    return items;
+  }
+  /**
+   * Download a generated model file.
+   */
+  async downloadGeneration(id, format) {
+    const generation = await this.getGeneration(id);
+    let url;
+    if (format === "rigged") {
+      url = generation.outputs.riggedModelUrl;
+    } else if (format === "model") {
+      url = generation.outputs.modelUrl;
+    } else {
+      url = generation.outputs.riggedModelUrl || generation.outputs.modelUrl;
+    }
+    if (!url) {
+      throw new WarlokError("No model URL available", "NO_MODEL");
+    }
+    const response = await fetch(url, {
+      headers: {
+        Authorization: `Bearer ${this.apiKey}`
+      }
+    });
+    if (!response.ok) {
+      throw new WarlokError("Download failed", "DOWNLOAD_FAILED");
+    }
+    return response.blob();
+  }
+  /**
+   * Wait for terminal generation status.
+   */
+  async waitForCompletion(id, options) {
+    const interval = options?.pollingInterval || 2e3;
+    const timeout = options?.timeout || 3e5;
+    const startTime = Date.now();
+    while (true) {
+      const generation = await this.getGeneration(id);
+      if (options?.onProgress) {
+        options.onProgress(generation);
+      }
+      if (generation.status === "complete") {
+        return generation;
+      }
+      if (generation.status === "failed") {
+        throw new WarlokError(
+          generation.error || "Generation failed",
+          "GENERATION_FAILED"
+        );
+      }
+      if (Date.now() - startTime > timeout) {
+        throw new WarlokError("Timeout waiting for completion", "TIMEOUT");
+      }
+      await sleep(interval);
+    }
+  }
+  /**
+   * Delete a generation.
+   */
+  async deleteGeneration(id) {
+    await this.request(
+      "DELETE",
+      `/api/v1/generations/${id}`
+    );
+  }
+  // Compatibility aliases for previous SDK method names.
+  async getAsset(id) {
+    return this.getGeneration(id);
+  }
+  async listAssets(options) {
+    const items = await this.listGenerations({
+      limit: options?.limit,
+      status: options?.status,
+      type: options?.type
+    });
+    if (!options?.offset || options.offset <= 0) {
+      return items;
+    }
+    return items.slice(options.offset);
+  }
+  async downloadAsset(id, format) {
+    return this.downloadGeneration(id, format);
+  }
+  async deleteAsset(id) {
+    return this.deleteGeneration(id);
+  }
+};
+var WarlokError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.name = "WarlokError";
+    this.code = code;
+  }
+};
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export {
+  WarlokClient,
+  WarlokError
+};

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@warlok-net/sdk",
+  "version": "0.1.0",
+  "description": "Node.js SDK for the Warlok 3D asset generation API",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@warlok-net/core": "0.1.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/crispcode-io/Warlok.git",
+    "directory": "packages/warlok-sdk"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  },
+  "peerDependenciesMeta": {
+    "typescript": {
+      "optional": true
+    }
+  },
+  "keywords": [
+    "warlok",
+    "3d",
+    "game-assets",
+    "ai",
+    "sdk"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "lint": "tsc --noEmit",
+    "type-check": "tsc --noEmit"
+  }
+}