@nogataka/imgen 0.1.0 → 0.2.0

package/dist/sdk.d.ts

@@ -0,0 +1,154 @@
+type SupportedLanguage = "ja" | "en" | "zh" | "ko" | "es" | "fr" | "de" | "it" | "ru" | "vi";
+declare const LANGUAGE_DESCRIPTIONS: Record<SupportedLanguage, string>;
+
+type ImageSizeConfig = "1024x1024" | "1536x1024" | "1024x1536";
+type ImageQualityConfig = "low" | "medium" | "high";
+type ImageFormatConfig = "png" | "jpg" | "webp";
+type LogLevelConfig = "debug" | "info" | "warn" | "error";
+interface Config {
+    azureEndpoint?: string;
+    azureApiKey?: string;
+    azureDeploymentName?: string;
+    azureImageDeploymentName?: string;
+    azureApiVersion?: string;
+    azureImageApiVersion?: string;
+    defaultOutputDir?: string;
+    defaultLanguage?: SupportedLanguage;
+    defaultImageSize?: ImageSizeConfig;
+    defaultImageQuality?: ImageQualityConfig;
+    defaultImageFormat?: ImageFormatConfig;
+    logLevel?: LogLevelConfig;
+}
+declare const DEFAULT_CONFIG: {
+    defaultLanguage: SupportedLanguage;
+    defaultImageSize: ImageSizeConfig;
+    defaultImageQuality: ImageQualityConfig;
+    defaultImageFormat: ImageFormatConfig;
+    logLevel: LogLevelConfig;
+};
+interface AzureConfig {
+    endpoint: string;
+    apiKey: string;
+    deploymentName: string;
+    imageDeploymentName: string;
+    apiVersion: string;
+    imageApiVersion: string;
+}
+/**
+ * Loads the configuration from disk. Returns null if no config file exists.
+ */
+declare function loadConfig(): Promise<Config | null>;
+/**
+ * Saves the configuration to disk, creating the config directory if needed.
+ */
+declare function saveConfig(config: Config): Promise<void>;
+/**
+ * Resolves the full Azure OpenAI configuration from environment variables and
+ * the config file. Environment variables take precedence over file-based config.
+ * Throws if required fields (endpoint, apiKey, deploymentName, imageDeploymentName)
+ * are missing.
+ */
+declare function getAzureConfig(): Promise<AzureConfig>;
+
+type ImageSize = "1024x1024" | "1536x1024" | "1024x1536";
+type ImageQuality = "low" | "medium" | "high";
+interface GenerateImageOptions {
+    size?: ImageSize;
+    quality?: ImageQuality;
+}
+interface EditImageOptions {
+    size?: ImageSize;
+}
+/**
+ * Client for Azure OpenAI Image generation and editing.
+ * Uses the SDK (`AzureOpenAI`) for `generateImage` and the REST API directly
+ * for `editImage`, because the Azure SDK's img2img support is unreliable.
+ */
+declare class AzureImageClient {
+    private client;
+    private config;
+    private logger;
+    constructor(config: AzureConfig);
+    /**
+     * Generates an image from a text prompt using the Azure OpenAI SDK.
+     * Returns raw image bytes as a Uint8Array.
+     */
+    generateImage(prompt: string, options: GenerateImageOptions): Promise<Uint8Array>;
+    /**
+     * Edits an existing image using the Azure OpenAI REST API.
+     * Uses fetch + FormData because the SDK's image editing support is unreliable.
+     * Returns raw image bytes as a Uint8Array.
+     */
+    editImage(imageBuffer: Buffer, prompt: string, options?: EditImageOptions): Promise<Uint8Array>;
+}
+
+interface ImageData {
+    data: string;
+    mimeType: string;
+}
+declare function readImageFile(filePath: string): Promise<ImageData>;
+declare function getMimeType(filePath: string): string;
+
+/**
+ * Client for Azure OpenAI Chat Completions API.
+ * Provides methods to generate image prompts, file names, and image explanations
+ * using a chat model (e.g. gpt-5.1).
+ */
+declare class AzureChatClient {
+    private client;
+    private deploymentName;
+    private logger;
+    constructor(config: AzureConfig);
+    /**
+     * Generates a detailed image-generation prompt from a short theme description.
+     * Optionally accepts additional context to guide prompt generation.
+     */
+    generatePrompt(theme: string, context?: string): Promise<string>;
+    /**
+     * Generates a sanitized file name (lowercase alphanumeric + hyphens only) from a theme.
+     */
+    generateFileName(theme: string, maxLength?: number): Promise<string>;
+    /**
+     * Generates a detailed explanation of an image using multimodal (vision) input.
+     * The explanation language is controlled by the `lang` parameter.
+     */
+    generateExplanation(imageData: ImageData, lang?: string, context?: string): Promise<string>;
+}
+
+/**
+ * Represents a preset configuration for image generation.
+ */
+interface ImagePreset {
+    size?: ImageSizeConfig;
+    quality?: ImageQualityConfig;
+    format?: ImageFormatConfig;
+}
+/**
+ * A dictionary of named presets.
+ */
+interface Presets {
+    [name: string]: ImagePreset;
+}
+/**
+ * Built-in presets that ship with imgen.
+ */
+declare const BUILTIN_PRESETS: Presets;
+/**
+ * Retrieves a preset by name. Checks builtin presets first, then user-defined
+ * presets. Returns null if no preset with the given name is found.
+ */
+declare function getPreset(name: string): Promise<ImagePreset | null>;
+/**
+ * Lists all presets (builtin and user-defined), returning each with its name,
+ * preset configuration, and a flag indicating whether it is builtin.
+ */
+declare function listAllPresets(): Promise<{
+    name: string;
+    preset: ImagePreset;
+    builtin: boolean;
+}[]>;
+
+declare function saveFileWithUniqueNameIfExists(outputPath: string, data: Uint8Array, maxRetries?: number): Promise<string>;
+declare function fileExists(filePath: string): Promise<boolean>;
+
+export { AzureChatClient, type AzureConfig, AzureImageClient, BUILTIN_PRESETS, type Config, DEFAULT_CONFIG, type EditImageOptions, type GenerateImageOptions, type ImageData, type ImageFormatConfig, type ImagePreset, type ImageQuality, type ImageQualityConfig, type ImageSize, type ImageSizeConfig, LANGUAGE_DESCRIPTIONS, type LogLevelConfig, type Presets, type SupportedLanguage, fileExists, getAzureConfig, getMimeType, getPreset, listAllPresets, loadConfig, readImageFile, saveConfig, saveFileWithUniqueNameIfExists };

package/dist/sdk.js

@@ -0,0 +1,32 @@
+import {
+  AzureChatClient,
+  AzureImageClient,
+  BUILTIN_PRESETS,
+  DEFAULT_CONFIG,
+  LANGUAGE_DESCRIPTIONS,
+  fileExists,
+  getAzureConfig,
+  getMimeType,
+  getPreset,
+  listAllPresets,
+  loadConfig,
+  readImageFile,
+  saveConfig,
+  saveFileWithUniqueNameIfExists
+} from "./chunk-HQT7ZTCY.js";
+export {
+  AzureChatClient,
+  AzureImageClient,
+  BUILTIN_PRESETS,
+  DEFAULT_CONFIG,
+  LANGUAGE_DESCRIPTIONS,
+  fileExists,
+  getAzureConfig,
+  getMimeType,
+  getPreset,
+  listAllPresets,
+  loadConfig,
+  readImageFile,
+  saveConfig,
+  saveFileWithUniqueNameIfExists
+};

package/package.json

@@ -1,17 +1,20 @@
 {
   "name": "@nogataka/imgen",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Azure OpenAI画像生成・編集・説明CLIツール - gpt-image-1.5 / gpt-5.1",
   "type": "module",
   "bin": { "imgen": "dist/index.js" },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "exports": { ".": { "import": "./dist/index.js", "types": "./dist/index.d.ts" } },
+  "exports": {
+    ".": { "import": "./dist/index.js", "types": "./dist/index.d.ts" },
+    "./sdk": { "import": "./dist/sdk.js", "types": "./dist/sdk.d.ts" }
+  },
   "files": ["dist"],
   "publishConfig": { "access": "public" },
   "scripts": {
     "dev": "node --env-file=.env --import tsx src/index.ts",
-    "build": "tsup src/index.ts --format esm --dts --clean",
+    "build": "tsup src/index.ts src/sdk.ts --format esm --dts --clean",
     "test": "vitest run",
     "test:watch": "vitest",
     "check": "tsc --noEmit",