@suknna/pixelforge 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,138 @@
+export type ProviderName = "openai-images" | "fal" | "replicate" | "stability-ai";
+export type JobKind = "text-to-image" | "image-to-image";
+export type JobStatus = "queued" | "running" | "succeeded" | "failed";
+export type ErrorCategory = "network" | "timeout" | "rate-limit" | "server" | "auth" | "bad-request" | "moderation" | "configuration" | "filesystem" | "provider";
+export type ProviderError = {
+    category: ErrorCategory;
+    message: string;
+    retryable: boolean;
+    statusCode?: number;
+    provider?: ProviderName;
+};
+export type ImageResult = {
+    bytes: Uint8Array;
+    mimeType: string;
+    provider: ProviderName;
+};
+export type TextToImageRequest = {
+    prompt: string;
+    signal: AbortSignal;
+};
+export type ImageToImageRequest = {
+    baseImagePath: string;
+    prompt: string;
+    strength?: number;
+    signal: AbortSignal;
+};
+export type ImageAdapter = {
+    provider: ProviderName;
+    generateImage(request: TextToImageRequest): Promise<ImageResult>;
+    generateImageFromImage(request: ImageToImageRequest): Promise<ImageResult>;
+};
+export type SecretValue = string | {
+    env: string;
+};
+export type NotificationConfig = {
+    tui: boolean;
+    sessionMessage: boolean;
+    autoContinue: boolean;
+};
+export type BaseProfile = {
+    provider: ProviderName;
+    timeoutMs: number;
+    outputFormat?: "png" | "jpeg" | "webp";
+    defaultStrength?: number;
+};
+export type OpenAIImagesProfile = BaseProfile & {
+    provider: "openai-images";
+    apiKey: SecretValue;
+    model: string;
+    baseUrl: string;
+    size: string;
+    quality?: "low" | "medium" | "high" | "auto";
+};
+export type FalProfile = BaseProfile & {
+    provider: "fal";
+    apiKey: SecretValue;
+    endpoint: string;
+    imageToImageEndpoint: string;
+    imageSize?: string;
+};
+export type ReplicateProfile = BaseProfile & {
+    provider: "replicate";
+    apiToken: SecretValue;
+    version: string;
+    promptInputKey: string;
+    imageInputKey: string;
+    strengthInputKey?: string;
+    pollIntervalMs: number;
+};
+export type StabilityAIProfile = BaseProfile & {
+    provider: "stability-ai";
+    apiKey: SecretValue;
+    baseUrl: string;
+    textToImagePath: string;
+    imageToImagePath: string;
+    width?: number;
+    height?: number;
+};
+export type RawProfile = OpenAIImagesProfile | FalProfile | ReplicateProfile | StabilityAIProfile;
+export type RawPixelForgeConfig = {
+    defaultProfile: string;
+    fallbackProfiles?: string[];
+    notifications?: NotificationConfig;
+    profiles: Record<string, RawProfile>;
+};
+/**
+ * Resolves a raw profile into its runtime form: secret references are replaced
+ * by a single resolved `credential` string and the profile name is attached.
+ *
+ * This is written as a distributive conditional type so the discriminated
+ * union over `provider` survives. A plain `Omit<RawProfile, ...>` would collapse
+ * the union into one object type and break `Extract<ResolvedProfile, { provider }>`.
+ */
+export type ResolvedProfile = RawProfile extends infer P ? P extends RawProfile ? Omit<P, "apiKey" | "apiToken"> & {
+    profileName: string;
+    credential: string;
+} : never : never;
+export type PixelForgeConfig = {
+    defaultProfile: string;
+    fallbackProfiles: string[];
+    notifications: NotificationConfig;
+    profiles: Record<string, ResolvedProfile>;
+};
+export type JobAttempt = {
+    provider: ProviderName;
+    startedAt: string;
+    finishedAt?: string;
+    error?: ProviderError;
+};
+export type ImageJob = {
+    id: string;
+    kind: JobKind;
+    status: JobStatus;
+    prompt: string;
+    outputPath: string;
+    baseImagePath?: string;
+    provider?: ProviderName;
+    mimeType?: string;
+    byteLength?: number;
+    error?: ProviderError;
+    attempts: JobAttempt[];
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+};
+export type PublicJobStatus = {
+    jobId: string;
+    status: JobStatus;
+    outputPath: string;
+    baseImagePath?: string;
+    provider?: ProviderName;
+    mimeType?: string;
+    byteLength?: number;
+    error?: Pick<ProviderError, "category" | "message" | "retryable" | "statusCode">;
+    createdAt: string;
+    updatedAt: string;
+    completedAt?: string;
+};

package/dist/types.js

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

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@suknna/pixelforge",
+  "version": "0.1.0",
+  "description": "OpenCode plugin that provides background image generation tools.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist", "README.md", "LICENSE"],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:integration": "vitest run tests/integration",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "1.17.6"
+  },
+  "devDependencies": {
+    "@types/node": "25.9.3",
+    "typescript": "6.0.3",
+    "vitest": "4.1.8"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Suknna/pixelforge.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Suknna/pixelforge/issues"
+  },
+  "homepage": "https://github.com/Suknna/pixelforge#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": ["opencode", "plugin", "image-generation", "pixel-forge"],
+  "license": "MIT"
+}