From 8b8d220b1326f3ddfaa7cbb466b710cc73b29467 Mon Sep 17 00:00:00 2001 From: sai80082 Date: Mon, 23 Mar 2026 10:46:46 +0530 Subject: [PATCH 01/30] feat: add sqlite db --- .gitignore | 5 +++++ drizzle.app.config.ts | 12 ++++++++++++ instrumentation.ts | 7 +++++++ package.json | 6 +++++- src/db/index.ts | 20 ++++++++++++++++++++ src/db/migrations/meta/_journal.json | 5 +++++ src/db/schema/index.ts | 1 + src/db/schema/settings.schema.ts | 9 +++++++++ 8 files changed, 64 insertions(+), 1 deletion(-) create mode 100644 drizzle.app.config.ts create mode 100644 instrumentation.ts create mode 100644 src/db/index.ts create mode 100644 src/db/migrations/meta/_journal.json create mode 100644 src/db/schema/index.ts create mode 100644 src/db/schema/settings.schema.ts diff --git a/.gitignore b/.gitignore index b9f8d23..315d974 100644 --- a/.gitignore +++ b/.gitignore @@ -28,6 +28,11 @@ yarn-error.log* # local env files .env*.local +# SQLite database files +/data/*.db +/data/*.db-shm +/data/*.db-wal + # vercel .vercel diff --git a/drizzle.app.config.ts b/drizzle.app.config.ts new file mode 100644 index 0000000..3e3ede5 --- /dev/null +++ b/drizzle.app.config.ts @@ -0,0 +1,12 @@ +import { defineConfig } from "drizzle-kit"; + +export default defineConfig({ + dialect: "sqlite", + schema: "./src/db/schema/index.ts", + out: "./src/db/migrations", + dbCredentials: { + url: process.env.APP_DB_PATH + ? `file:${process.env.APP_DB_PATH}` + : "file:./data/app.db", + }, +}); diff --git a/instrumentation.ts b/instrumentation.ts new file mode 100644 index 0000000..e8982e3 --- /dev/null +++ b/instrumentation.ts @@ -0,0 +1,7 @@ +export async function register() { + // Only run on the Node.js server, not in the Edge runtime or client + if (process.env.NEXT_RUNTIME === "nodejs") { + const { runMigrations } = await import("./src/db"); + await runMigrations(); + } +} diff --git a/package.json b/package.json index 75dd287..9301dc6 100644 --- a/package.json +++ b/package.json @@ -6,7 +6,11 @@ "dev": "next dev", "build": "next build", "start": "next start -p ${PORT:=3000} -H ${HOST:=0.0.0.0}", - "lint": "next lint" + "lint": "next lint", + "db:generate": "drizzle-kit generate --config=drizzle.app.config.ts", + "db:migrate": "drizzle-kit migrate --config=drizzle.app.config.ts", + "db:studio": "drizzle-kit studio --config=drizzle.app.config.ts", + "db:push": "drizzle-kit push --config=drizzle.app.config.ts" }, "author": { "name": "Varun Raj Manoharan", diff --git a/src/db/index.ts b/src/db/index.ts new file mode 100644 index 0000000..ea91391 --- /dev/null +++ b/src/db/index.ts @@ -0,0 +1,20 @@ +import { createClient } from "@libsql/client"; +import { drizzle } from "drizzle-orm/libsql"; +import { migrate } from "drizzle-orm/libsql/migrator"; +import path from "path"; +import * as schema from "./schema"; + +const DB_PATH = + process.env.APP_DB_PATH || path.join(process.cwd(), "data", "app.db"); + +const client = createClient({ url: `file:${DB_PATH}` }); + +export const appDb = drizzle(client, { schema }); + +// Run pending migrations automatically on startup. +// migrate() is idempotent — safe to call on every boot. +export async function runMigrations() { + await migrate(appDb, { + migrationsFolder: path.join(process.cwd(), "src", "db", "migrations"), + }); +} diff --git a/src/db/migrations/meta/_journal.json b/src/db/migrations/meta/_journal.json new file mode 100644 index 0000000..7e7f287 --- /dev/null +++ b/src/db/migrations/meta/_journal.json @@ -0,0 +1,5 @@ +{ + "version": "5", + "dialect": "sqlite", + "entries": [] +} diff --git a/src/db/schema/index.ts b/src/db/schema/index.ts new file mode 100644 index 0000000..a58fe37 --- /dev/null +++ b/src/db/schema/index.ts @@ -0,0 +1 @@ +export * from "./settings.schema"; diff --git a/src/db/schema/settings.schema.ts b/src/db/schema/settings.schema.ts new file mode 100644 index 0000000..463a2ee --- /dev/null +++ b/src/db/schema/settings.schema.ts @@ -0,0 +1,9 @@ +import { sqliteTable, text, integer } from "drizzle-orm/sqlite-core"; + +export const settings = sqliteTable("settings", { + key: text("key").primaryKey(), + value: text("value").notNull(), + updatedAt: integer("updated_at", { mode: "timestamp" }).$onUpdate( + () => new Date() + ), +}); From ca95be956a066c53a016ed1e5dd9ebf26a63019c Mon Sep 17 00:00:00 2001 From: sai80082 Date: Mon, 23 Mar 2026 11:15:06 +0530 Subject: [PATCH 02/30] feat: add API key management and database setup - Add SQLite database schema and migrations - Implement API key management endpoints and schema - Add settings page for API key management - Enhance share functionality with key-based access - Update configuration and environment setup --- .env.sample | 4 +- package.json | 5 +- src/components/shared/ShareAssetsTrigger.tsx | 46 +++++- src/config/constants/sidebarNavs.tsx | 8 +- src/config/environment.ts | 3 +- src/db/migrations/0000_vengeful_kylun.sql | 17 +++ src/db/migrations/meta/0000_snapshot.json | 114 +++++++++++++++ src/db/migrations/meta/_journal.json | 12 +- src/db/schema/apiKeys.schema.ts | 14 ++ src/db/schema/index.ts | 1 + src/helpers/user.helper.ts | 5 +- .../asset/share-thumbnail/[id].ts | 26 +++- src/pages/api/settings/api-keys/[purpose].ts | 93 ++++++++++++ src/pages/api/settings/api-keys/index.ts | 28 ++++ src/pages/api/share-key/index.ts | 91 ++++++++++++ src/pages/api/share-link/[token]/download.ts | 21 ++- src/pages/api/share-link/[token]/index.ts | 5 - src/pages/api/share-link/generate.ts | 6 +- src/pages/settings/index.tsx | 133 ++++++++++++++++++ 19 files changed, 599 insertions(+), 33 deletions(-) create mode 100644 src/db/migrations/0000_vengeful_kylun.sql create mode 100644 src/db/migrations/meta/0000_snapshot.json create mode 100644 src/db/schema/apiKeys.schema.ts create mode 100644 src/pages/api/settings/api-keys/[purpose].ts create mode 100644 src/pages/api/settings/api-keys/index.ts create mode 100644 src/pages/api/share-key/index.ts create mode 100644 src/pages/settings/index.tsx diff --git a/.env.sample b/.env.sample index 071d49f..6207dbc 100644 --- a/.env.sample +++ b/.env.sample @@ -15,6 +15,8 @@ AI_BASE_URL="https://api.openai.com/v1" # Base URL for OpenAI-compatible API AI_MODEL="gpt-4o-mini" # Model used for parsing search queries in "Find" # Immich Share Link -IMMICH_SHARE_LINK_KEY="" # Share link key for Immich POWER_TOOLS_ENDPOINT_URL="" # URL of the Power Tools endpoint (Used for share links) JWT_SECRET="" # JWT Secret for authentication + +# App Database (SQLite) +APP_DB_PATH="" # Path to the SQLite database file (default: ./data/app.db) diff --git a/package.json b/package.json index 9301dc6..15ac611 100644 --- a/package.json +++ b/package.json @@ -21,6 +21,7 @@ "@ai-sdk/openai": "^3.0.29", "@ai-sdk/openai-compatible": "^2.0.30", "@ai-sdk/react": "^3.0.88", + "@libsql/client": "^0.17.2", "@radix-ui/react-accordion": "^1.2.1", "@radix-ui/react-alert-dialog": "^1.1.4", "@radix-ui/react-avatar": "^1.1.0", @@ -58,7 +59,7 @@ "cookie": "^0.6.0", "date-fns": "^3.6.0", "date-fns-tz": "^3.2.0", - "drizzle-orm": "^0.33.0", + "drizzle-orm": "^0.45.1", "jsonwebtoken": "^9.0.2", "leaflet": "^1.9.4", "leaflet-defaulticon-compatibility": "0.1.2", @@ -96,7 +97,7 @@ "@types/react-dom": "^18", "@types/react-mentions": "^4.4.1", "autoprefixer": "^10.4.20", - "drizzle-kit": "^0.24.0", + "drizzle-kit": "^0.31.10", "eslint": "^8", "eslint-config-next": "14.2.5", "postcss": "^8.4.41", diff --git a/src/components/shared/ShareAssetsTrigger.tsx b/src/components/shared/ShareAssetsTrigger.tsx index 31e05db..8b90d36 100644 --- a/src/components/shared/ShareAssetsTrigger.tsx +++ b/src/components/shared/ShareAssetsTrigger.tsx @@ -22,6 +22,30 @@ export default function ShareAssetsTrigger({ filters, buttonProps }: ShareAssets const [config, setConfig] = useState>({ expiresIn: "never" }); + const [endpointConfigured, setEndpointConfigured] = useState(null); + const [shareKeyExists, setShareKeyExists] = useState(null); + const [creatingKey, setCreatingKey] = useState(false); + const [keyError, setKeyError] = useState(null); + + const checkShareKey = async () => { + const res = await fetch('/api/share-key'); + const data = await res.json(); + setEndpointConfigured(data.endpointConfigured); + setShareKeyExists(data.exists); + }; + + const handleCreateKey = async () => { + setCreatingKey(true); + setKeyError(null); + const res = await fetch('/api/share-key', { method: 'POST' }); + if (res.ok) { + setShareKeyExists(true); + } else { + const data = await res.json(); + setKeyError(data.message ?? 'Failed to create share key'); + } + setCreatingKey(false); + }; const handleReset = () => { setConfig({ expiresIn: "never" }); @@ -52,7 +76,7 @@ export default function ShareAssetsTrigger({ filters, buttonProps }: ShareAssets return ( - + { if (open) checkShareKey(); }}> @@ -63,6 +87,24 @@ export default function ShareAssetsTrigger({ filters, buttonProps }: ShareAssets Generate a share link for the selected assets (either bunch of albums or bunch of people) and share it with your friends and family. + {endpointConfigured === false && ( +
+

+ POWER_TOOLS_ENDPOINT_URL is not set. Add it to your environment variables to enable share links. +

+
+ )} + {endpointConfigured && shareKeyExists === false && ( +
+

+ Serving thumbnails on share links requires a dedicated API key. Create one now with minimal permissions. +

+ {keyError &&

{keyError}

} + +
+ )} {errorMessage &&
{errorMessage}
} {generatedLink ?
@@ -106,7 +148,7 @@ export default function ShareAssetsTrigger({ filters, buttonProps }: ShareAssets
- + )} diff --git a/src/config/constants/sidebarNavs.tsx b/src/config/constants/sidebarNavs.tsx index 27c1834..78d8655 100644 --- a/src/config/constants/sidebarNavs.tsx +++ b/src/config/constants/sidebarNavs.tsx @@ -1,4 +1,4 @@ -import { Copy, GalleryHorizontal, GalleryVerticalEnd, Image as ImageIcon, MapPin, MapPinX, Rewind, Search, Share2, User, Video } from "lucide-react"; +import { Copy, GalleryHorizontal, GalleryVerticalEnd, Image as ImageIcon, MapPin, MapPinX, Rewind, Search, Settings, Share2, User, Video } from "lucide-react"; export const sidebarNavs = [ // { @@ -59,5 +59,9 @@ export const sidebarNavs = [ link: "/assets/bulk-duplicate-finder", icon: , }, - + { + title: "Settings", + link: "/settings", + icon: , + }, ]; diff --git a/src/config/environment.ts b/src/config/environment.ts index f3daf06..bc0c5c3 100644 --- a/src/config/environment.ts +++ b/src/config/environment.ts @@ -15,8 +15,9 @@ export const ENV = { AI_API_KEY: process.env.AI_API_KEY as string, AI_BASE_URL: (process.env.AI_BASE_URL || 'https://api.openai.com/v1') as string, AI_MODEL: process.env.AI_MODEL as string, - IMMICH_SHARE_LINK_KEY: process.env.IMMICH_SHARE_LINK_KEY as string, POWER_TOOLS_ENDPOINT_URL: process.env.POWER_TOOLS_ENDPOINT_URL as string, + // App SQLite database path (defaults to ./data/app.db) + APP_DB_PATH: process.env.APP_DB_PATH as string | undefined, // OAuth configuration OAUTH_ENABLED: process.env.OAUTH_ENABLED === 'true', OAUTH_BUTTON_TEXT: (process.env.OAUTH_BUTTON_TEXT || 'Login with OAuth') as string, diff --git a/src/db/migrations/0000_vengeful_kylun.sql b/src/db/migrations/0000_vengeful_kylun.sql new file mode 100644 index 0000000..b60b53d --- /dev/null +++ b/src/db/migrations/0000_vengeful_kylun.sql @@ -0,0 +1,17 @@ +CREATE TABLE `api_keys` ( + `id` text PRIMARY KEY NOT NULL, + `user_id` text NOT NULL, + `purpose` text NOT NULL, + `key_name` text NOT NULL, + `secret` text NOT NULL, + `immich_key_id` text NOT NULL, + `created_at` integer +); +--> statement-breakpoint +CREATE TABLE `settings` ( + `key` text PRIMARY KEY NOT NULL, + `value` text NOT NULL, + `updated_at` integer +); +--> statement-breakpoint +CREATE UNIQUE INDEX `api_keys_user_id_purpose_unique` ON `api_keys` (`user_id`,`purpose`); \ No newline at end of file diff --git a/src/db/migrations/meta/0000_snapshot.json b/src/db/migrations/meta/0000_snapshot.json new file mode 100644 index 0000000..f17cfa1 --- /dev/null +++ b/src/db/migrations/meta/0000_snapshot.json @@ -0,0 +1,114 @@ +{ + "version": "6", + "dialect": "sqlite", + "id": "8b257fc8-972b-47da-ae98-7a83316d6df6", + "prevId": "00000000-0000-0000-0000-000000000000", + "tables": { + "api_keys": { + "name": "api_keys", + "columns": { + "id": { + "name": "id", + "type": "text", + "primaryKey": true, + "notNull": true, + "autoincrement": false + }, + "user_id": { + "name": "user_id", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false + }, + "purpose": { + "name": "purpose", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false + }, + "key_name": { + "name": "key_name", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false + }, + "secret": { + "name": "secret", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false + }, + "immich_key_id": { + "name": "immich_key_id", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false + }, + "created_at": { + "name": "created_at", + "type": "integer", + "primaryKey": false, + "notNull": false, + "autoincrement": false + } + }, + "indexes": { + "api_keys_user_id_purpose_unique": { + "name": "api_keys_user_id_purpose_unique", + "columns": [ + "user_id", + "purpose" + ], + "isUnique": true + } + }, + "foreignKeys": {}, + "compositePrimaryKeys": {}, + "uniqueConstraints": {} + }, + "settings": { + "name": "settings", + "columns": { + "key": { + "name": "key", + "type": "text", + "primaryKey": true, + "notNull": true, + "autoincrement": false + }, + "value": { + "name": "value", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false + }, + "updated_at": { + "name": "updated_at", + "type": "integer", + "primaryKey": false, + "notNull": false, + "autoincrement": false + } + }, + "indexes": {}, + "foreignKeys": {}, + "compositePrimaryKeys": {}, + "uniqueConstraints": {} + } + }, + "enums": {}, + "_meta": { + "schemas": {}, + "tables": {}, + "columns": {} + }, + "internal": { + "indexes": {} + } +} \ No newline at end of file diff --git a/src/db/migrations/meta/_journal.json b/src/db/migrations/meta/_journal.json index 7e7f287..655df45 100644 --- a/src/db/migrations/meta/_journal.json +++ b/src/db/migrations/meta/_journal.json @@ -1,5 +1,13 @@ { "version": "5", "dialect": "sqlite", - "entries": [] -} + "entries": [ + { + "idx": 0, + "version": "6", + "when": 1774242821856, + "tag": "0000_vengeful_kylun", + "breakpoints": true + } + ] +} \ No newline at end of file diff --git a/src/db/schema/apiKeys.schema.ts b/src/db/schema/apiKeys.schema.ts new file mode 100644 index 0000000..e931daa --- /dev/null +++ b/src/db/schema/apiKeys.schema.ts @@ -0,0 +1,14 @@ +import { sqliteTable, text, integer, unique } from "drizzle-orm/sqlite-core"; +import { randomUUID } from "crypto"; + +export const apiKeys = sqliteTable("api_keys", { + id: text("id").primaryKey().$defaultFn(() => randomUUID()), + userId: text("user_id").notNull(), + purpose: text("purpose").notNull(), + keyName: text("key_name").notNull(), + secret: text("secret").notNull(), + immichKeyId: text("immich_key_id").notNull(), + createdAt: integer("created_at", { mode: "timestamp" }).$defaultFn(() => new Date()), +}, (t) => [ + unique().on(t.userId, t.purpose), +]); diff --git a/src/db/schema/index.ts b/src/db/schema/index.ts index a58fe37..5c0e3da 100644 --- a/src/db/schema/index.ts +++ b/src/db/schema/index.ts @@ -1 +1,2 @@ export * from "./settings.schema"; +export * from "./apiKeys.schema"; diff --git a/src/helpers/user.helper.ts b/src/helpers/user.helper.ts index 6713b45..b34e6cb 100644 --- a/src/helpers/user.helper.ts +++ b/src/helpers/user.helper.ts @@ -3,7 +3,6 @@ import { IUser } from "@/types/user" export const getUserHeaders = (user: { isUsingAPIKey?: boolean, - isUsingShareKey?: boolean, accessToken?: string }, otherHeaders?: { 'Content-Type': string @@ -15,9 +14,7 @@ export const getUserHeaders = (user: { } = { 'Content-Type': 'application/json', } - if (user.isUsingShareKey) { - headers['x-api-key'] = ENV.IMMICH_SHARE_LINK_KEY - } else if (user.isUsingAPIKey) { + if (user.isUsingAPIKey) { headers['x-api-key'] = ENV.IMMICH_API_KEY } else { headers['Authorization'] = `Bearer ${user.accessToken}` diff --git a/src/pages/api/immich-proxy/asset/share-thumbnail/[id].ts b/src/pages/api/immich-proxy/asset/share-thumbnail/[id].ts index 4fa6c77..2d3526a 100644 --- a/src/pages/api/immich-proxy/asset/share-thumbnail/[id].ts +++ b/src/pages/api/immich-proxy/asset/share-thumbnail/[id].ts @@ -1,7 +1,9 @@ // pages/api/proxy.js import { ENV } from '@/config/environment'; -import { getUserHeaders } from '@/helpers/user.helper'; +import { appDb } from '@/db'; +import { apiKeys } from '@/db/schema'; +import { and, eq } from 'drizzle-orm'; import { verify } from 'jsonwebtoken'; import { NextApiRequest, NextApiResponse } from 'next' @@ -16,18 +18,31 @@ export default async function handler(req: NextApiRequest, res: NextApiResponse) if (req.method !== 'GET') { return res.status(405).json({ message: 'Method Not Allowed' }) } - + const { id, size, token, p } = req.query; if (!token) { return res.status(401).json({ message: 'Unauthorized' }) } + let userId: string; try { - verify(token as string, ENV.JWT_SECRET); + const previewDecoded = verify(token as string, ENV.JWT_SECRET) as { token: string }; + const mainDecoded = verify(previewDecoded.token, ENV.JWT_SECRET) as { userId: string }; + userId = mainDecoded.userId; } catch (error) { return res.status(401).json({ message: 'Token is invalid' }) } + const [keyRow] = await appDb + .select({ secret: apiKeys.secret }) + .from(apiKeys) + .where(and(eq(apiKeys.userId, userId), eq(apiKeys.purpose, "share"))) + .limit(1); + + if (!keyRow) { + return res.status(403).json({ message: 'Share key not configured. Please set up sharing in Power Tools.' }); + } + const resource = p === "true" ? "people" : "assets"; const baseURL = `${ENV.IMMICH_URL}/api/${resource}/${id}`; const version = size === "original" ? "original" : "thumbnail"; @@ -37,9 +52,10 @@ export default async function handler(req: NextApiRequest, res: NextApiResponse) // Forward the request to the target API const response = await fetch(targetUrl, { method: 'GET', - headers: getUserHeaders({ isUsingShareKey: true }, { + headers: { 'Content-Type': 'application/octet-stream', - }), + 'x-api-key': keyRow.secret, + }, }) if (!response.ok) { diff --git a/src/pages/api/settings/api-keys/[purpose].ts b/src/pages/api/settings/api-keys/[purpose].ts new file mode 100644 index 0000000..aeb60a0 --- /dev/null +++ b/src/pages/api/settings/api-keys/[purpose].ts @@ -0,0 +1,93 @@ +import { ENV } from "@/config/environment"; +import { appDb } from "@/db"; +import { apiKeys } from "@/db/schema"; +import { getCurrentUser } from "@/handlers/serverUtils/user.utils"; +import { getUserHeaders } from "@/helpers/user.helper"; +import { and, eq } from "drizzle-orm"; +import { NextApiRequest, NextApiResponse } from "next"; + +const PURPOSE_CONFIG: Record = { + share: { + keyName: "Power Tools Share Key", + permissions: ["asset.view", "asset.download"], + }, +}; + +export default async function handler(req: NextApiRequest, res: NextApiResponse) { + const currentUser = await getCurrentUser(req); + if (!currentUser) { + return res.status(401).json({ message: "Unauthorized" }); + } + + const { purpose } = req.query as { purpose: string }; + + if (req.method === "DELETE") { + const [row] = await appDb + .select() + .from(apiKeys) + .where(and(eq(apiKeys.userId, currentUser.id), eq(apiKeys.purpose, purpose))) + .limit(1); + + if (!row) { + return res.status(404).json({ message: "API key not found" }); + } + + await fetch(`${ENV.IMMICH_URL}/api/api-keys/${row.immichKeyId}`, { + method: "DELETE", + headers: getUserHeaders(currentUser, { "Content-Type": "application/json" }), + }); + + await appDb + .delete(apiKeys) + .where(and(eq(apiKeys.userId, currentUser.id), eq(apiKeys.purpose, purpose))); + + return res.status(200).json({ success: true }); + } + + if (req.method === "PUT") { + const config = PURPOSE_CONFIG[purpose]; + if (!config) { + return res.status(400).json({ message: `Unknown purpose: ${purpose}` }); + } + + // Delete old key from Immich if it exists + const [existing] = await appDb + .select() + .from(apiKeys) + .where(and(eq(apiKeys.userId, currentUser.id), eq(apiKeys.purpose, purpose))) + .limit(1); + + if (existing) { + await fetch(`${ENV.IMMICH_URL}/api/api-keys/${existing.immichKeyId}`, { + method: "DELETE", + headers: getUserHeaders(currentUser, { "Content-Type": "application/json" }), + }); + } + + // Create new key in Immich + const immichRes = await fetch(`${ENV.IMMICH_URL}/api/api-keys`, { + method: "POST", + headers: getUserHeaders(currentUser, { "Content-Type": "application/json" }), + body: JSON.stringify({ name: config.keyName, permissions: config.permissions }), + }); + + if (!immichRes.ok) { + const err = await immichRes.json().catch(() => ({})); + return res.status(immichRes.status).json({ message: err.message ?? "Failed to create API key in Immich" }); + } + + const { secret, apiKey } = await immichRes.json(); + + await appDb + .insert(apiKeys) + .values({ userId: currentUser.id, purpose, keyName: config.keyName, secret, immichKeyId: apiKey.id }) + .onConflictDoUpdate({ + target: [apiKeys.userId, apiKeys.purpose], + set: { secret, immichKeyId: apiKey.id, keyName: config.keyName }, + }); + + return res.status(200).json({ success: true }); + } + + return res.status(405).json({ message: "Method not allowed" }); +} diff --git a/src/pages/api/settings/api-keys/index.ts b/src/pages/api/settings/api-keys/index.ts new file mode 100644 index 0000000..af8b783 --- /dev/null +++ b/src/pages/api/settings/api-keys/index.ts @@ -0,0 +1,28 @@ +import { appDb } from "@/db"; +import { apiKeys } from "@/db/schema"; +import { getCurrentUser } from "@/handlers/serverUtils/user.utils"; +import { eq } from "drizzle-orm"; +import { NextApiRequest, NextApiResponse } from "next"; + +export default async function handler(req: NextApiRequest, res: NextApiResponse) { + if (req.method !== "GET") { + return res.status(405).json({ message: "Method not allowed" }); + } + + const currentUser = await getCurrentUser(req); + if (!currentUser) { + return res.status(401).json({ message: "Unauthorized" }); + } + + const rows = await appDb + .select({ + id: apiKeys.id, + purpose: apiKeys.purpose, + keyName: apiKeys.keyName, + createdAt: apiKeys.createdAt, + }) + .from(apiKeys) + .where(eq(apiKeys.userId, currentUser.id)); + + return res.status(200).json(rows); +} diff --git a/src/pages/api/share-key/index.ts b/src/pages/api/share-key/index.ts new file mode 100644 index 0000000..8c55719 --- /dev/null +++ b/src/pages/api/share-key/index.ts @@ -0,0 +1,91 @@ +import { ENV } from "@/config/environment"; +import { appDb } from "@/db"; +import { apiKeys } from "@/db/schema"; +import { getCurrentUser } from "@/handlers/serverUtils/user.utils"; +import { getUserHeaders } from "@/helpers/user.helper"; +import { and, eq } from "drizzle-orm"; +import { NextApiRequest, NextApiResponse } from "next"; + +const PURPOSE = "share"; +const KEY_NAME = "Power Tools Share Key"; + +export default async function handler(req: NextApiRequest, res: NextApiResponse) { + const currentUser = await getCurrentUser(req); + if (!currentUser) { + return res.status(401).json({ message: "Unauthorized" }); + } + + if (req.method === "GET") { + const [row] = await appDb + .select({ keyName: apiKeys.keyName, createdAt: apiKeys.createdAt }) + .from(apiKeys) + .where(and(eq(apiKeys.userId, currentUser.id), eq(apiKeys.purpose, PURPOSE))) + .limit(1); + + return res.status(200).json({ + endpointConfigured: !!ENV.POWER_TOOLS_ENDPOINT_URL, + exists: !!row, + keyName: row?.keyName ?? null, + createdAt: row?.createdAt ?? null, + }); + } + + if (req.method === "POST") { + const immichRes = await fetch(`${ENV.IMMICH_URL}/api/api-keys`, { + method: "POST", + headers: getUserHeaders(currentUser, { "Content-Type": "application/json" }), + body: JSON.stringify({ + name: KEY_NAME, + permissions: ["asset.view", "asset.download"], + }), + }); + + if (!immichRes.ok) { + const err = await immichRes.json().catch(() => ({})); + return res.status(immichRes.status).json({ message: err.message ?? "Failed to create API key in Immich" }); + } + + const { secret, apiKey } = await immichRes.json(); + + await appDb + .insert(apiKeys) + .values({ + userId: currentUser.id, + purpose: PURPOSE, + keyName: KEY_NAME, + secret, + immichKeyId: apiKey.id, + }) + .onConflictDoUpdate({ + target: [apiKeys.userId, apiKeys.purpose], + set: { secret, immichKeyId: apiKey.id, keyName: KEY_NAME }, + }); + + return res.status(200).json({ success: true }); + } + + if (req.method === "DELETE") { + const [row] = await appDb + .select() + .from(apiKeys) + .where(and(eq(apiKeys.userId, currentUser.id), eq(apiKeys.purpose, PURPOSE))) + .limit(1); + + if (!row) { + return res.status(404).json({ message: "No share key found" }); + } + + await fetch(`${ENV.IMMICH_URL}/api/api-keys/${row.immichKeyId}`, { + method: "DELETE", + headers: getUserHeaders(currentUser, { "Content-Type": "application/json" }), + }); + + await appDb + .delete(apiKeys) + .where(and(eq(apiKeys.userId, currentUser.id), eq(apiKeys.purpose, PURPOSE))); + + return res.status(200).json({ success: true }); + } + + return res.status(405).json({ message: "Method not allowed" }); +} diff --git a/src/pages/api/share-link/[token]/download.ts b/src/pages/api/share-link/[token]/download.ts index 9915a03..2fb3b20 100644 --- a/src/pages/api/share-link/[token]/download.ts +++ b/src/pages/api/share-link/[token]/download.ts @@ -1,9 +1,11 @@ import { ENV } from "@/config/environment"; +import { appDb } from "@/db"; +import { apiKeys } from "@/db/schema"; +import { and, eq } from "drizzle-orm"; import { JsonWebTokenError, verify } from "jsonwebtoken"; import { NextApiResponse } from "next"; import { NextApiRequest } from "next"; -import { getUserHeaders } from "@/helpers/user.helper"; interface ShareLinkFilters { personIds: string[]; @@ -23,20 +25,31 @@ export default async function handler(req: NextApiRequest, res: NextApiResponse) return res.status(405).json({ message: "Method not allowed" }); } - const decoded = verify(token as string, ENV.JWT_SECRET); + const decoded = verify(token as string, ENV.JWT_SECRET) as { userId: string }; if (!decoded) { return res.status(401).json({ message: "Unauthorized" }); } + const [keyRow] = await appDb + .select({ secret: apiKeys.secret }) + .from(apiKeys) + .where(and(eq(apiKeys.userId, decoded.userId), eq(apiKeys.purpose, "share"))) + .limit(1); + + if (!keyRow) { + return res.status(403).json({ message: "Share key not configured. Please set up sharing in Power Tools." }); + } + const targetUrl = `${ENV.IMMICH_URL}/api/download/archive`; const response = await fetch(targetUrl, { method: 'POST', body: JSON.stringify({ assetIds }), - headers: getUserHeaders({ isUsingShareKey: true }, { + headers: { 'Content-Type': 'application/json', - }), + 'x-api-key': keyRow.secret, + }, }) if (!response.ok) { diff --git a/src/pages/api/share-link/[token]/index.ts b/src/pages/api/share-link/[token]/index.ts index d2a1d11..5c1a1ee 100644 --- a/src/pages/api/share-link/[token]/index.ts +++ b/src/pages/api/share-link/[token]/index.ts @@ -1,7 +1,6 @@ import { NextApiResponse } from "next"; import { ENV } from "@/config/environment"; -import { ShareLinkFilters } from "@/types/shareLink"; import { JsonWebTokenError, verify } from "jsonwebtoken"; import { NextApiRequest } from "next"; @@ -13,10 +12,6 @@ export default async function GET(req: NextApiRequest, res: NextApiResponse) { return res.status(404).json({ message: "Token not found" }); } - if (!ENV.IMMICH_SHARE_LINK_KEY) { - return res.status(401).json({ message: "Please check your link and try again. If you're the admin, check if you've enabled all the configurations in the Immich Power Tools in your environment variables" }); - } - const decoded = verify(token as string, ENV.JWT_SECRET); diff --git a/src/pages/api/share-link/generate.ts b/src/pages/api/share-link/generate.ts index 139f7e9..b355354 100644 --- a/src/pages/api/share-link/generate.ts +++ b/src/pages/api/share-link/generate.ts @@ -19,15 +19,11 @@ export default async function handler(req: NextApiRequest, res: NextApiResponse) return res.status(401).json({ message: "The JWT_SECRET is missing in the .env file. Please add it to the .env file for generating share links" }); } - if (!ENV.IMMICH_SHARE_LINK_KEY) { - return res.status(401).json({ message: "The IMMICH_SHARE_LINK_KEY is missing in the .env file. Please add it to the .env file for generating share links" }); - } - if (!ENV.POWER_TOOLS_ENDPOINT_URL) { return res.status(401).json({ message: "The POWER_TOOLS_ENDPOINT_URL is missing in the .env file. Please add it to the .env file for generating share links" }); } - const token = sign(filters, ENV.JWT_SECRET, expiresIn !== "never" ? { + const token = sign({ ...filters, userId: currentUser.id }, ENV.JWT_SECRET, expiresIn !== "never" ? { expiresIn: expiresIn } : {}); diff --git a/src/pages/settings/index.tsx b/src/pages/settings/index.tsx new file mode 100644 index 0000000..65ae191 --- /dev/null +++ b/src/pages/settings/index.tsx @@ -0,0 +1,133 @@ +import PageLayout from "@/components/layouts/PageLayout"; +import Header from "@/components/shared/Header"; +import { AlertDialog } from "@/components/ui/alert-dialog"; +import { Badge } from "@/components/ui/badge"; +import { Button } from "@/components/ui/button"; +import { Card, CardContent, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"; +import { RefreshCw, Trash2 } from "lucide-react"; +import { useEffect, useState } from "react"; +import toast from "react-hot-toast"; + +interface ApiKey { + id: string; + purpose: string; + keyName: string; + createdAt: string; +} + +export default function SettingsPage() { + const [keys, setKeys] = useState([]); + const [loading, setLoading] = useState(true); + const [deleting, setDeleting] = useState(null); + const [regenerating, setRegenerating] = useState(null); + + const fetchKeys = async () => { + setLoading(true); + const res = await fetch("/api/settings/api-keys"); + if (res.ok) { + const data = await res.json(); + setKeys(data); + } + setLoading(false); + }; + + useEffect(() => { + fetchKeys(); + }, []); + + const handleDelete = async (purpose: string) => { + setDeleting(purpose); + const res = await fetch(`/api/settings/api-keys/${purpose}`, { method: "DELETE" }); + if (res.ok) { + setKeys((prev) => prev.filter((k) => k.purpose !== purpose)); + toast.success("API key deleted"); + } else { + const data = await res.json(); + toast.error(data.message ?? "Failed to delete API key"); + } + setDeleting(null); + }; + + const handleRegenerate = async (purpose: string) => { + setRegenerating(purpose); + const res = await fetch(`/api/settings/api-keys/${purpose}`, { method: "PUT" }); + if (res.ok) { + await fetchKeys(); + toast.success("API key regenerated"); + } else { + const data = await res.json(); + toast.error(data.message ?? "Failed to regenerate API key"); + } + setRegenerating(null); + }; + + return ( + +
+
+ + + API Keys + + Managed API keys created by Power Tools in your Immich instance. + These are used internally for features that require unauthenticated access (e.g. share links). + + + + {loading && ( +

Loading...

+ )} + {!loading && keys.length === 0 && ( +

No API keys created yet.

+ )} + {!loading && keys.length > 0 && ( +
    + {keys.map((key) => ( +
  • +
    +
    + {key.keyName} + {key.purpose} +
    + + Created {new Date(key.createdAt).toLocaleDateString()} + +
    +
    + handleRegenerate(key.purpose)} + > + + + handleDelete(key.purpose)} + > + + +
    +
  • + ))} +
+ )} +
+
+
+ + ); +} From eafb44a4e92ca80ac90d31b713ad43636d664c38 Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 19:34:09 +0530 Subject: [PATCH 03/30] refactor: migrate direct fetch calls to API handler pattern Replace raw fetch() in settings, share-key, and import-shared with centralized API handlers via src/lib/api.ts. Also auto-create the data/ directory on startup so the SQLite db path is always valid. Co-Authored-By: Claude Sonnet 4.6 --- bun.lockb | Bin 490115 -> 388737 bytes src/components/shared/ShareAssetsTrigger.tsx | 13 ++-- src/config/routes.ts | 13 +++- src/db/index.ts | 3 + src/handlers/api/import-shared.handler.ts | 15 +++++ src/handlers/api/settings.handler.ts | 14 +++++ src/handlers/api/share-key.handler.ts | 10 ++++ src/pages/assets/import-shared.tsx | 59 ++++++------------- src/pages/settings/index.tsx | 26 ++++---- 9 files changed, 91 insertions(+), 62 deletions(-) create mode 100644 src/handlers/api/import-shared.handler.ts create mode 100644 src/handlers/api/settings.handler.ts create mode 100644 src/handlers/api/share-key.handler.ts diff --git a/bun.lockb b/bun.lockb index f6133adbc69ad5e7cc7fcab1dd5887b36eb046c2..f521ce9ea9cd14132e5e6796fd2091b384060045 100755 GIT binary patch delta 99797 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 diff --git a/src/components/shared/ShareAssetsTrigger.tsx b/src/components/shared/ShareAssetsTrigger.tsx index 8b90d36..0e3756a 100644 --- a/src/components/shared/ShareAssetsTrigger.tsx +++ b/src/components/shared/ShareAssetsTrigger.tsx @@ -3,6 +3,7 @@ import { Dialog, DialogTitle, DialogContent, DialogHeader, DialogTrigger, Dialog import { Button, ButtonProps } from '../ui/button'; import { ShareLinkFilters } from '@/types/shareLink'; import { generateShareLink } from '@/handlers/api/shareLink.handler'; +import { createShareKey, getShareKey } from '@/handlers/api/share-key.handler'; import { Input } from '../ui/input'; import { Label } from '@radix-ui/react-label'; @@ -28,8 +29,7 @@ export default function ShareAssetsTrigger({ filters, buttonProps }: ShareAssets const [keyError, setKeyError] = useState(null); const checkShareKey = async () => { - const res = await fetch('/api/share-key'); - const data = await res.json(); + const data = await getShareKey(); setEndpointConfigured(data.endpointConfigured); setShareKeyExists(data.exists); }; @@ -37,12 +37,11 @@ export default function ShareAssetsTrigger({ filters, buttonProps }: ShareAssets const handleCreateKey = async () => { setCreatingKey(true); setKeyError(null); - const res = await fetch('/api/share-key', { method: 'POST' }); - if (res.ok) { + try { + await createShareKey(); setShareKeyExists(true); - } else { - const data = await res.json(); - setKeyError(data.message ?? 'Failed to create share key'); + } catch (err: any) { + setKeyError(err.message ?? 'Failed to create share key'); } setCreatingKey(false); }; diff --git a/src/config/routes.ts b/src/config/routes.ts index 5011619..87e7d32 100644 --- a/src/config/routes.ts +++ b/src/config/routes.ts @@ -83,4 +83,15 @@ export const SHARE_LINK_PEOPLE_PATH = (token: string) => BASE_API_ENDPOINT + "/s export const SHARE_LINK_DOWNLOAD_PATH = (token: string) => BASE_API_ENDPOINT + "/share-link/" + token + "/download"; export const DOWNLOAD_ASSETS_PATH = BASE_PROXY_ENDPOINT + "/download/archive"; -export const LIST_DUPLICATES_PATH = BASE_PROXY_ENDPOINT + "/duplicates"; \ No newline at end of file +export const LIST_DUPLICATES_PATH = BASE_PROXY_ENDPOINT + "/duplicates"; + +// Settings +export const SETTINGS_API_KEYS_PATH = BASE_API_ENDPOINT + "/settings/api-keys"; +export const SETTINGS_API_KEY_PATH = (purpose: string) => BASE_API_ENDPOINT + "/settings/api-keys/" + purpose; + +// Share Key +export const SHARE_KEY_PATH = BASE_API_ENDPOINT + "/share-key"; + +// Import Shared +export const IMPORT_SHARED_PATH = BASE_API_ENDPOINT + "/import-shared"; +export const IMPORT_SHARED_UPLOAD_ALL_PATH = BASE_API_ENDPOINT + "/import-shared/upload-all"; \ No newline at end of file diff --git a/src/db/index.ts b/src/db/index.ts index ea91391..993fd62 100644 --- a/src/db/index.ts +++ b/src/db/index.ts @@ -1,12 +1,15 @@ import { createClient } from "@libsql/client"; import { drizzle } from "drizzle-orm/libsql"; import { migrate } from "drizzle-orm/libsql/migrator"; +import fs from "fs"; import path from "path"; import * as schema from "./schema"; const DB_PATH = process.env.APP_DB_PATH || path.join(process.cwd(), "data", "app.db"); +fs.mkdirSync(path.dirname(DB_PATH), { recursive: true }); + const client = createClient({ url: `file:${DB_PATH}` }); export const appDb = drizzle(client, { schema }); diff --git a/src/handlers/api/import-shared.handler.ts b/src/handlers/api/import-shared.handler.ts new file mode 100644 index 0000000..648d86e --- /dev/null +++ b/src/handlers/api/import-shared.handler.ts @@ -0,0 +1,15 @@ +import { IMPORT_SHARED_PATH, IMPORT_SHARED_UPLOAD_ALL_PATH } from "@/config/routes"; +import API from "@/lib/api"; + +export const importShared = async (link: string) => { + return API.post(IMPORT_SHARED_PATH, { link }); +}; + +export const importSharedUploadAll = async (params: { + origin: string; + key: string; + assets: object[]; + albumOptions: object; +}) => { + return API.post(IMPORT_SHARED_UPLOAD_ALL_PATH, params); +}; diff --git a/src/handlers/api/settings.handler.ts b/src/handlers/api/settings.handler.ts new file mode 100644 index 0000000..494f818 --- /dev/null +++ b/src/handlers/api/settings.handler.ts @@ -0,0 +1,14 @@ +import { SETTINGS_API_KEYS_PATH, SETTINGS_API_KEY_PATH } from "@/config/routes"; +import API from "@/lib/api"; + +export const getApiKeys = async () => { + return API.get(SETTINGS_API_KEYS_PATH); +}; + +export const deleteApiKey = async (purpose: string) => { + return API.delete(SETTINGS_API_KEY_PATH(purpose)); +}; + +export const regenerateApiKey = async (purpose: string) => { + return API.put(SETTINGS_API_KEY_PATH(purpose)); +}; diff --git a/src/handlers/api/share-key.handler.ts b/src/handlers/api/share-key.handler.ts new file mode 100644 index 0000000..2fb8b8c --- /dev/null +++ b/src/handlers/api/share-key.handler.ts @@ -0,0 +1,10 @@ +import { SHARE_KEY_PATH } from "@/config/routes"; +import API from "@/lib/api"; + +export const getShareKey = async () => { + return API.get(SHARE_KEY_PATH); +}; + +export const createShareKey = async () => { + return API.post(SHARE_KEY_PATH); +}; diff --git a/src/pages/assets/import-shared.tsx b/src/pages/assets/import-shared.tsx index 86843f4..25cbefb 100644 --- a/src/pages/assets/import-shared.tsx +++ b/src/pages/assets/import-shared.tsx @@ -22,6 +22,7 @@ import { DialogTitle, } from "@/components/ui/dialog"; import { listAlbums } from "@/handlers/api/album.handler"; +import { importShared, importSharedUploadAll } from "@/handlers/api/import-shared.handler"; import { IAlbum } from "@/types/album"; interface IAlbumContributorCount { @@ -200,27 +201,14 @@ export default function ImportSharedPage() { setLoading(true); try { - const response = await fetch("/api/import-shared", { - method: "POST", - headers: { - "Content-Type": "application/json", - }, - body: JSON.stringify({ link: shareLink }), - }); - - if (!response.ok) { - const errorPayload = await response.json().catch(() => ({})); - throw new Error(errorPayload.error || "Failed to import shared album"); - } - - const payload: IImportSharedResponse = await response.json(); + const payload: IImportSharedResponse = await importShared(shareLink); setSharedData(payload); setSubmittedLink(payload.link); setUploadBanner(null); setImportAllLoading(false); setAlbumImportMode("album"); - } catch (err) { - const message = err instanceof Error ? err.message : "Unexpected error"; + } catch (err: any) { + const message = err.message ?? "Unexpected error"; setError(message); } finally { setLoading(false); @@ -309,33 +297,22 @@ export default function ImportSharedPage() { setUploadBanner(null); setImportAllLoading(true); try { - const response = await fetch("/api/import-shared/upload-all", { - method: "POST", - headers: { - "Content-Type": "application/json", - }, - body: JSON.stringify({ - origin: sharedData.origin, - key: sharedData.key, - assets: uploadableAssets.map((asset) => ({ - id: asset.id, - originalFileName: asset.originalFileName, - type: asset.type, - fileCreatedAt: asset.fileCreatedAt ?? null, - localDateTime: asset.localDateTime ?? null, - duration: asset.duration ?? null, - isFavorite: asset.isFavorite ?? false, - isArchived: asset.isArchived ?? false, - })), - albumOptions, - }), + const result = await importSharedUploadAll({ + origin: sharedData.origin, + key: sharedData.key, + assets: uploadableAssets.map((asset) => ({ + id: asset.id, + originalFileName: asset.originalFileName, + type: asset.type, + fileCreatedAt: asset.fileCreatedAt ?? null, + localDateTime: asset.localDateTime ?? null, + duration: asset.duration ?? null, + isFavorite: asset.isFavorite ?? false, + isArchived: asset.isArchived ?? false, + })), + albumOptions, }); - const result = await response.json().catch(() => ({})); - if (!response.ok) { - throw new Error(result.error || "Failed to import shared archive"); - } - const processedAssetIds: string[] = result.processedAssetIds ?? []; const skippedAssetIds: string[] = result.skippedAssetIds ?? []; const failed: { assetId: string; reason?: string }[] = result.failed ?? []; diff --git a/src/pages/settings/index.tsx b/src/pages/settings/index.tsx index 65ae191..1e165d8 100644 --- a/src/pages/settings/index.tsx +++ b/src/pages/settings/index.tsx @@ -1,5 +1,6 @@ import PageLayout from "@/components/layouts/PageLayout"; import Header from "@/components/shared/Header"; +import { deleteApiKey, getApiKeys, regenerateApiKey } from "@/handlers/api/settings.handler"; import { AlertDialog } from "@/components/ui/alert-dialog"; import { Badge } from "@/components/ui/badge"; import { Button } from "@/components/ui/button"; @@ -23,10 +24,11 @@ export default function SettingsPage() { const fetchKeys = async () => { setLoading(true); - const res = await fetch("/api/settings/api-keys"); - if (res.ok) { - const data = await res.json(); + try { + const data = await getApiKeys(); setKeys(data); + } catch { + // silently fail — keys list stays empty } setLoading(false); }; @@ -37,26 +39,24 @@ export default function SettingsPage() { const handleDelete = async (purpose: string) => { setDeleting(purpose); - const res = await fetch(`/api/settings/api-keys/${purpose}`, { method: "DELETE" }); - if (res.ok) { + try { + await deleteApiKey(purpose); setKeys((prev) => prev.filter((k) => k.purpose !== purpose)); toast.success("API key deleted"); - } else { - const data = await res.json(); - toast.error(data.message ?? "Failed to delete API key"); + } catch (err: any) { + toast.error(err.message ?? "Failed to delete API key"); } setDeleting(null); }; const handleRegenerate = async (purpose: string) => { setRegenerating(purpose); - const res = await fetch(`/api/settings/api-keys/${purpose}`, { method: "PUT" }); - if (res.ok) { + try { + await regenerateApiKey(purpose); await fetchKeys(); toast.success("API key regenerated"); - } else { - const data = await res.json(); - toast.error(data.message ?? "Failed to regenerate API key"); + } catch (err: any) { + toast.error(err.message ?? "Failed to regenerate API key"); } setRegenerating(null); }; From 060e410099ac10e3fc718871d3daa5a3d63886e2 Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 19:35:06 +0530 Subject: [PATCH 04/30] chore: remove unused db:push script Co-Authored-By: Claude Sonnet 4.6 --- package.json | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/package.json b/package.json index 15ac611..88b0984 100644 --- a/package.json +++ b/package.json @@ -9,8 +9,7 @@ "lint": "next lint", "db:generate": "drizzle-kit generate --config=drizzle.app.config.ts", "db:migrate": "drizzle-kit migrate --config=drizzle.app.config.ts", - "db:studio": "drizzle-kit studio --config=drizzle.app.config.ts", - "db:push": "drizzle-kit push --config=drizzle.app.config.ts" + "db:studio": "drizzle-kit studio --config=drizzle.app.config.ts" }, "author": { "name": "Varun Raj Manoharan", From d44adc6a24486d4e063aaec1dcb91fa344611352 Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 20:05:35 +0530 Subject: [PATCH 05/30] docs: add import queue implementation plan --- docs/plans/2026-04-03-import-queue.md | 784 ++++++++++++++++++++++++++ 1 file changed, 784 insertions(+) create mode 100644 docs/plans/2026-04-03-import-queue.md diff --git a/docs/plans/2026-04-03-import-queue.md b/docs/plans/2026-04-03-import-queue.md new file mode 100644 index 0000000..4e7dfef --- /dev/null +++ b/docs/plans/2026-04-03-import-queue.md @@ -0,0 +1,784 @@ +# Import Queue Implementation Plan + +> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. + +**Goal:** Replace the synchronous fire-and-wait import with a SQLite-backed job queue so imports survive page closes and show live progress via polling. + +**Architecture:** A job is created in SQLite on request, a background worker processes items concurrently (4 at a time) and writes per-item status back to the db. The frontend polls a status endpoint every 2s. Platform-specific logic is encapsulated in processor classes so Nextcloud/PhotoPrism can be added by dropping in a new file. On server restart, any stuck `processing` jobs are reset to `pending` and restarted when the user's next poll hits the status endpoint. + +**Tech Stack:** Drizzle ORM + libsql (SQLite), Next.js API routes, TypeScript, React (polling via `useEffect` + `setInterval`) + +--- + +### Task 1: Add schema tables + +**Files:** +- Create: `src/db/schema/importJobs.schema.ts` +- Modify: `src/db/schema/index.ts` + +**Step 1: Create the schema file** + +```typescript +// src/db/schema/importJobs.schema.ts +import { sqliteTable, text, integer } from "drizzle-orm/sqlite-core"; +import { randomUUID } from "crypto"; + +export const importJobs = sqliteTable("import_jobs", { + id: text("id").primaryKey().$defaultFn(() => randomUUID()), + userId: text("user_id").notNull(), + platform: text("platform").notNull(), // 'immich' | 'nextcloud' | 'photoprism' + status: text("status").notNull().default("pending"), // pending | processing | completed | failed + url: text("url").notNull(), // base URL of source + urlConfig: text("url_config").notNull().default("{}"), // JSON: auth/connection (key, token, etc.) + importData: text("import_data").notNull().default("{}"), // JSON: album options, resolved albumId, etc. + totalCount: integer("total_count").notNull().default(0), + uploadedCount: integer("uploaded_count").notNull().default(0), + skippedCount: integer("skipped_count").notNull().default(0), + failedCount: integer("failed_count").notNull().default(0), + createdAt: integer("created_at", { mode: "timestamp" }).$defaultFn(() => new Date()), + updatedAt: integer("updated_at", { mode: "timestamp" }) + .$defaultFn(() => new Date()) + .$onUpdate(() => new Date()), +}); + +export const importJobItems = sqliteTable("import_job_items", { + id: text("id").primaryKey().$defaultFn(() => randomUUID()), + jobId: text("job_id").notNull().references(() => importJobs.id), + assetId: text("asset_id").notNull(), // source platform's asset ID + status: text("status").notNull().default("pending"), // pending | processing | uploaded | skipped | failed + itemData: text("item_data").notNull().default("{}"), // JSON: filename, type, dates, isFavorite, etc. + immichId: text("immich_id"), // Immich asset ID after successful upload + error: text("error"), + createdAt: integer("created_at", { mode: "timestamp" }).$defaultFn(() => new Date()), + updatedAt: integer("updated_at", { mode: "timestamp" }) + .$defaultFn(() => new Date()) + .$onUpdate(() => new Date()), +}); +``` + +**Step 2: Export from schema index** + +In `src/db/schema/index.ts`, add: +```typescript +export * from "./importJobs.schema"; +``` + +**Step 3: Commit** + +```bash +git add src/db/schema/importJobs.schema.ts src/db/schema/index.ts +git commit -m "feat: add import_jobs and import_job_items schema tables" +``` + +--- + +### Task 2: Generate and apply migration + +**Files:** +- Create: `src/db/migrations/` (auto-generated by drizzle-kit) + +**Step 1: Generate migration** + +```bash +bun run db:generate +``` + +Expected: a new `.sql` file appears in `src/db/migrations/` containing `CREATE TABLE import_jobs` and `CREATE TABLE import_job_items`. + +**Step 2: Verify migration SQL looks correct** + +Open the generated file and confirm it has both tables with all columns. No manual edits needed. + +**Step 3: Test that migrations run** + +```bash +bun run dev +``` + +Expected: server starts without errors. The migration auto-runs via `instrumentation.ts → runMigrations()`. + +**Step 4: Commit** + +```bash +git add src/db/migrations/ +git commit -m "feat: add migration for import_jobs and import_job_items" +``` + +--- + +### Task 3: Processor interface and registry + +**Files:** +- Create: `src/workers/import/types.ts` +- Create: `src/workers/import/registry.ts` + +**Step 1: Define the processor interface** + +```typescript +// src/workers/import/types.ts +import type { importJobs, importJobItems } from "@/db/schema"; + +export type ImportJob = typeof importJobs.$inferSelect; +export type ImportJobItem = typeof importJobItems.$inferSelect; + +export interface ProcessorContext { + headers: Record; // user auth headers for Immich API calls + albumId?: string; // resolved after setup() +} + +export interface SetupResult { + skipAssetIds: string[]; // source asset IDs already in Immich → mark skipped + albumId?: string; // created or resolved album ID + importDataPatch?: Record; // merged into job.importData in db +} + +export interface ImportProcessor { + /** Called once per job before items are processed. Dedup + album creation. */ + setup(job: ImportJob, context: ProcessorContext): Promise; + /** Called once per item. Returns the Immich asset ID on success, throws on failure. */ + processItem(job: ImportJob, item: ImportJobItem, context: ProcessorContext): Promise<{ immichId: string }>; +} +``` + +**Step 2: Create the registry** + +```typescript +// src/workers/import/registry.ts +import type { ImportProcessor } from "./types"; + +const processors = new Map(); + +export function registerProcessor(platform: string, processor: ImportProcessor) { + processors.set(platform, processor); +} + +export function getProcessor(platform: string): ImportProcessor { + const processor = processors.get(platform); + if (!processor) { + throw new Error(`No import processor registered for platform: ${platform}`); + } + return processor; +} +``` + +**Step 3: Commit** + +```bash +git add src/workers/import/types.ts src/workers/import/registry.ts +git commit -m "feat: add import processor interface and registry" +``` + +--- + +### Task 4: Immich shared-link processor + +**Files:** +- Create: `src/workers/import/processors/immich-shared-link.ts` + +This extracts the core download/upload logic from `src/pages/api/import-shared/upload-all.ts` into the processor interface. The helpers (`downloadSharedAsset`, `uploadAssetBuffer`, `createImmichAlbum`, `addAssetToAlbum`, `ensurePowerToolsTag`) already exist in `upload-all.ts` and `helpers.ts` — copy/import them as needed. + +**Step 1: Create the processor** + +```typescript +// src/workers/import/processors/immich-shared-link.ts +import { ENV } from "@/config/environment"; +import { + ensurePowerToolsTag, + tagAssetWithPowerTools, + type HeadersRecord, +} from "@/pages/api/import-shared/helpers"; +import type { ImportJob, ImportJobItem, ImportProcessor, ProcessorContext, SetupResult } from "../types"; + +// --- helpers copied/imported from upload-all.ts --- +// (parseFileNameFromDisposition, guessContentType, inferAssetTypeFromName, +// downloadSharedAsset, uploadAssetBuffer, createImmichAlbum, addAssetToAlbum) +// Copy them here verbatim from upload-all.ts so upload-all.ts stays intact. + +const DEVICE_ID = "immich-power-tools"; +const makeDeviceAssetId = (assetId: string) => `shared-${assetId}`; + +export class ImmichSharedLinkProcessor implements ImportProcessor { + async setup(job: ImportJob, context: ProcessorContext): Promise { + const urlConfig = JSON.parse(job.urlConfig) as { key: string }; + const items = await getJobItems(job.id); // helper defined in runner.ts, passed via closure or import + const deviceAssetIds = items.map((i) => makeDeviceAssetId(i.assetId)); + const lookup = new Map(items.map((i) => [makeDeviceAssetId(i.assetId).toLowerCase(), i.assetId])); + + const skipAssetIds: string[] = []; + try { + const res = await fetch(`${ENV.IMMICH_URL}/api/assets/exist`, { + method: "POST", + headers: { ...context.headers, "Content-Type": "application/json" }, + body: JSON.stringify({ deviceAssetIds, deviceId: DEVICE_ID }), + }); + if (res.ok) { + const { existingIds = [] } = await res.json(); + for (const id of existingIds) { + const assetId = lookup.get(id.toLowerCase()); + if (assetId) skipAssetIds.push(assetId); + } + } + } catch (e) { + console.warn("Dedup check failed, continuing without it", e); + } + + const importData = JSON.parse(job.importData) as { + albumOptions?: { createAlbum?: boolean; albumName?: string; addToAlbumId?: string }; + albumId?: string; + }; + + let albumId: string | undefined; + const albumOptions = importData.albumOptions; + if (albumOptions?.createAlbum) { + const name = albumOptions.albumName?.trim() || `Shared import ${new Date().toISOString()}`; + albumId = await createImmichAlbum(name, { + ...context.headers, + "Content-Type": "application/json", + } as HeadersRecord); + } else if (albumOptions?.addToAlbumId) { + albumId = albumOptions.addToAlbumId; + } + + return { skipAssetIds, albumId, importDataPatch: albumId ? { albumId } : undefined }; + } + + async processItem(job: ImportJob, item: ImportJobItem, context: ProcessorContext): Promise<{ immichId: string }> { + const urlConfig = JSON.parse(job.urlConfig) as { key: string }; + const itemData = JSON.parse(item.itemData) as { + originalFileName?: string; + type: string; + fileCreatedAt?: string | null; + localDateTime?: string | null; + duration?: string | null; + isFavorite?: boolean; + isArchived?: boolean; + }; + + const asset = { id: item.assetId, ...itemData }; + const { ["Content-Type"]: _omit, ...uploadHeaders } = context.headers as HeadersRecord; + + const downloaded = await downloadSharedAsset(asset, job.url, urlConfig.key); + const tag = await ensurePowerToolsTag(context.headers as HeadersRecord); + const immichId = await uploadAssetBuffer( + asset, + downloaded, + uploadHeaders as HeadersRecord, + context.headers as HeadersRecord, + tag.id + ); + + if (context.albumId) { + await addAssetToAlbum(context.albumId, immichId, { + ...context.headers, + "Content-Type": "application/json", + } as HeadersRecord); + } + + return { immichId }; + } +} +``` + +**Step 2: Register the processor** + +Create `src/workers/import/processors/index.ts`: +```typescript +import { registerProcessor } from "../registry"; +import { ImmichSharedLinkProcessor } from "./immich-shared-link"; + +registerProcessor("immich", new ImmichSharedLinkProcessor()); +``` + +**Step 3: Commit** + +```bash +git add src/workers/import/processors/ +git commit -m "feat: add immich shared-link import processor" +``` + +--- + +### Task 5: Worker runner + +**Files:** +- Create: `src/workers/import/runner.ts` + +The runner owns the active-job tracking (in-memory Set), processes items concurrently, and updates the db after each item. + +**Step 1: Create the runner** + +```typescript +// src/workers/import/runner.ts +import { eq, inArray } from "drizzle-orm"; +import { appDb } from "@/db"; +import { importJobs, importJobItems } from "@/db/schema"; +import { getProcessor } from "./registry"; +import "./processors/index"; // side-effect: registers all processors + +export type { ImportJob, ImportJobItem } from "./types"; + +const activeJobs = new Set(); +const CONCURRENCY = 4; + +export function isJobActive(jobId: string) { + return activeJobs.has(jobId); +} + +export async function getJobItems(jobId: string) { + return appDb.select().from(importJobItems).where(eq(importJobItems.jobId, jobId)); +} + +export async function resumePendingJobs() { + // Reset any jobs stuck in 'processing' from a previous crashed run + await appDb + .update(importJobs) + .set({ status: "pending" }) + .where(eq(importJobs.status, "processing")); +} + +export async function runImportJob( + jobId: string, + headers: Record +): Promise { + if (activeJobs.has(jobId)) return; + activeJobs.add(jobId); + + try { + const [job] = await appDb.select().from(importJobs).where(eq(importJobs.id, jobId)); + if (!job || job.status === "completed" || job.status === "failed") return; + + await appDb.update(importJobs).set({ status: "processing" }).where(eq(importJobs.id, jobId)); + + const processor = getProcessor(job.platform); + const context = { headers }; + + // --- Setup: dedup + album creation --- + const { skipAssetIds, albumId, importDataPatch } = await processor.setup(job, context); + + if (importDataPatch) { + const merged = { ...JSON.parse(job.importData), ...importDataPatch }; + await appDb.update(importJobs).set({ importData: JSON.stringify(merged) }).where(eq(importJobs.id, jobId)); + } + + if (skipAssetIds.length > 0) { + await appDb + .update(importJobItems) + .set({ status: "skipped" }) + .where(inArray(importJobItems.assetId, skipAssetIds)); + await appDb + .update(importJobs) + .set({ skippedCount: skipAssetIds.length }) + .where(eq(importJobs.id, jobId)); + } + + const processorContext = { ...context, albumId }; + const pendingItems = await appDb + .select() + .from(importJobItems) + .where(eq(importJobItems.status, "pending")); + + // --- Concurrent item processing --- + let idx = 0; + const worker = async () => { + while (true) { + const item = pendingItems[idx++]; + if (!item) break; + + await appDb + .update(importJobItems) + .set({ status: "processing" }) + .where(eq(importJobItems.id, item.id)); + + try { + const { immichId } = await processor.processItem(job, item, processorContext); + await appDb + .update(importJobItems) + .set({ status: "uploaded", immichId }) + .where(eq(importJobItems.id, item.id)); + await appDb + .update(importJobs) + .set({ uploadedCount: job.uploadedCount + 1 }) + .where(eq(importJobs.id, jobId)); + } catch (err: any) { + await appDb + .update(importJobItems) + .set({ status: "failed", error: err?.message ?? "Unknown error" }) + .where(eq(importJobItems.id, item.id)); + await appDb + .update(importJobs) + .set({ failedCount: job.failedCount + 1 }) + .where(eq(importJobs.id, jobId)); + } + } + }; + + const concurrency = Math.min(CONCURRENCY, pendingItems.length); + await Promise.all(Array.from({ length: concurrency }, worker)); + + await appDb + .update(importJobs) + .set({ status: "completed" }) + .where(eq(importJobs.id, jobId)); + } catch (err: any) { + console.error(`Import job ${jobId} failed fatally:`, err); + await appDb + .update(importJobs) + .set({ status: "failed" }) + .where(eq(importJobs.id, jobId)); + } finally { + activeJobs.delete(jobId); + } +} +``` + +**Step 2: Commit** + +```bash +git add src/workers/import/runner.ts +git commit -m "feat: add import job worker runner with concurrency and db tracking" +``` + +--- + +### Task 6: Update instrumentation.ts for startup resume + +**Files:** +- Modify: `instrumentation.ts` + +**Step 1: Add resume call** + +```typescript +// instrumentation.ts +export async function register() { + if (process.env.NEXT_RUNTIME === "nodejs") { + const { runMigrations } = await import("./src/db"); + await runMigrations(); + + const { resumePendingJobs } = await import("./src/workers/import/runner"); + await resumePendingJobs(); + } +} +``` + +`resumePendingJobs` only resets `processing → pending`; it doesn't start workers (no user headers available at boot). Workers restart on next poll. + +**Step 2: Commit** + +```bash +git add instrumentation.ts +git commit -m "feat: reset stuck import jobs to pending on startup" +``` + +--- + +### Task 7: Job creation API endpoint + +**Files:** +- Create: `src/pages/api/import-jobs/index.ts` + +**Step 1: Create the endpoint** + +```typescript +// src/pages/api/import-jobs/index.ts +import type { NextApiRequest, NextApiResponse } from "next"; +import { appDb } from "@/db"; +import { importJobs, importJobItems } from "@/db/schema"; +import { getCurrentUser } from "@/handlers/serverUtils/user.utils"; +import { getUserHeaders } from "@/helpers/user.helper"; +import { runImportJob } from "@/workers/import/runner"; + +export default async function handler(req: NextApiRequest, res: NextApiResponse) { + if (req.method !== "POST") { + res.setHeader("Allow", "POST"); + return res.status(405).json({ error: "Method Not Allowed" }); + } + + const currentUser = await getCurrentUser(req); + if (!currentUser) return res.status(401).json({ error: "Unauthorized" }); + + const { platform, url, urlConfig, importData, assets } = req.body; + + if (!platform || !url || !Array.isArray(assets) || assets.length === 0) { + return res.status(400).json({ error: "platform, url, and assets are required" }); + } + + // Create job row + const [job] = await appDb + .insert(importJobs) + .values({ + userId: currentUser.id, + platform, + url, + urlConfig: JSON.stringify(urlConfig ?? {}), + importData: JSON.stringify(importData ?? {}), + totalCount: assets.length, + }) + .returning(); + + // Create one item row per asset + await appDb.insert(importJobItems).values( + assets.map((asset: { id: string; [key: string]: unknown }) => ({ + jobId: job.id, + assetId: asset.id, + itemData: JSON.stringify(asset), + })) + ); + + // Fire-and-forget: start the worker without awaiting + const headers = getUserHeaders(currentUser) as Record; + runImportJob(job.id, headers).catch((err) => + console.error("Unhandled error in runImportJob", err) + ); + + return res.status(201).json({ jobId: job.id }); +} +``` + +**Step 2: Commit** + +```bash +git add src/pages/api/import-jobs/index.ts +git commit -m "feat: add POST /api/import-jobs endpoint to create and enqueue import jobs" +``` + +--- + +### Task 8: Job status polling endpoint + +**Files:** +- Create: `src/pages/api/import-jobs/[jobId].ts` + +**Step 1: Create the endpoint** + +```typescript +// src/pages/api/import-jobs/[jobId].ts +import type { NextApiRequest, NextApiResponse } from "next"; +import { eq } from "drizzle-orm"; +import { appDb } from "@/db"; +import { importJobs, importJobItems } from "@/db/schema"; +import { getCurrentUser } from "@/handlers/serverUtils/user.utils"; +import { getUserHeaders } from "@/helpers/user.helper"; +import { isJobActive, runImportJob } from "@/workers/import/runner"; + +export default async function handler(req: NextApiRequest, res: NextApiResponse) { + if (req.method !== "GET") { + res.setHeader("Allow", "GET"); + return res.status(405).json({ error: "Method Not Allowed" }); + } + + const currentUser = await getCurrentUser(req); + if (!currentUser) return res.status(401).json({ error: "Unauthorized" }); + + const { jobId } = req.query as { jobId: string }; + + const [job] = await appDb.select().from(importJobs).where(eq(importJobs.id, jobId)); + if (!job || job.userId !== currentUser.id) { + return res.status(404).json({ error: "Job not found" }); + } + + // Auto-resume: if job is pending but has no active worker (e.g. after server restart) + if (job.status === "pending" && !isJobActive(jobId)) { + const headers = getUserHeaders(currentUser) as Record; + runImportJob(jobId, headers).catch((err) => + console.error("Unhandled error in runImportJob (resume)", err) + ); + } + + const items = await appDb + .select() + .from(importJobItems) + .where(eq(importJobItems.jobId, jobId)); + + return res.status(200).json({ job, items }); +} +``` + +**Step 2: Commit** + +```bash +git add src/pages/api/import-jobs/[jobId].ts +git commit -m "feat: add GET /api/import-jobs/[jobId] polling endpoint with auto-resume" +``` + +--- + +### Task 9: Route constants and client handler + +**Files:** +- Modify: `src/config/routes.ts` +- Create: `src/handlers/api/import-jobs.handler.ts` + +**Step 1: Add routes** + +In `src/config/routes.ts`, append: +```typescript +// Import Jobs (queue) +export const IMPORT_JOBS_PATH = BASE_API_ENDPOINT + "/import-jobs"; +export const IMPORT_JOB_PATH = (jobId: string) => BASE_API_ENDPOINT + "/import-jobs/" + jobId; +``` + +**Step 2: Create handler** + +```typescript +// src/handlers/api/import-jobs.handler.ts +import { IMPORT_JOBS_PATH, IMPORT_JOB_PATH } from "@/config/routes"; +import API from "@/lib/api"; + +export interface CreateImportJobParams { + platform: string; + url: string; + urlConfig: Record; + importData: Record; + assets: { id: string; [key: string]: unknown }[]; +} + +export const createImportJob = async (params: CreateImportJobParams): Promise<{ jobId: string }> => { + return API.post(IMPORT_JOBS_PATH, params); +}; + +export const getImportJob = async (jobId: string) => { + return API.get(IMPORT_JOB_PATH(jobId)); +}; +``` + +**Step 3: Commit** + +```bash +git add src/config/routes.ts src/handlers/api/import-jobs.handler.ts +git commit -m "feat: add import-jobs route constants and client handler" +``` + +--- + +### Task 10: Update frontend to use job queue + polling + +**Files:** +- Modify: `src/pages/assets/import-shared.tsx` + +**Step 1: Add state for active job** + +In the component state block, add: +```typescript +const [activeJobId, setActiveJobId] = useState(null); +const [jobProgress, setJobProgress] = useState<{ uploaded: number; skipped: number; failed: number; total: number } | null>(null); +``` + +**Step 2: Replace `handleImportAll` body** + +Replace the `importSharedUploadAll(...)` call block with: + +```typescript +const job = await createImportJob({ + platform: "immich", + url: sharedData.origin, + urlConfig: { key: sharedData.key }, + importData: { albumOptions }, + assets: uploadableAssets.map((asset) => ({ + id: asset.id, + originalFileName: asset.originalFileName, + type: asset.type, + fileCreatedAt: asset.fileCreatedAt ?? null, + localDateTime: asset.localDateTime ?? null, + duration: asset.duration ?? null, + isFavorite: asset.isFavorite ?? false, + isArchived: asset.isArchived ?? false, + })), +}); +setActiveJobId(job.jobId); +setJobProgress({ uploaded: 0, skipped: 0, failed: 0, total: uploadableAssets.length }); +// importAllLoading stays true while polling +``` + +Remove the old result-parsing and banner-setting code from `handleImportAll` — that moves to the polling effect below. + +**Step 3: Add polling effect** + +```typescript +useEffect(() => { + if (!activeJobId) return; + + const interval = setInterval(async () => { + try { + const { job, items } = await getImportJob(activeJobId); + setJobProgress({ + uploaded: job.uploadedCount, + skipped: job.skippedCount, + failed: job.failedCount, + total: job.totalCount, + }); + + if (job.status === "completed" || job.status === "failed") { + clearInterval(interval); + setActiveJobId(null); + setImportAllLoading(false); + + const importData = JSON.parse(job.importData); + const failedCount = job.failedCount; + const skippedCount = job.skippedCount; + const uploadedCount = job.uploadedCount; + let bannerType: "success" | "error" = failedCount ? "error" : "success"; + let message: string; + + if (!uploadedCount && skippedCount && !failedCount) { + message = `All ${skippedCount} assets already exist on Immich.`; + } else if (failedCount) { + const skippedSuffix = skippedCount ? `, ${skippedCount} skipped` : ""; + message = `Imported ${uploadedCount} assets, ${failedCount} failed${skippedSuffix}.`; + } else if (skippedCount) { + message = `Imported ${uploadedCount} assets, skipped ${skippedCount} already on Immich.`; + } else { + message = `Imported ${uploadedCount} assets successfully.`; + } + + if (importData.albumId && uploadedCount > 0) { + const albumName = options.albumName || "selected album"; + message = `${message} Added to album "${albumName}".`; + } + + setUploadBanner({ type: bannerType, message }); + } + } catch (err) { + console.error("Polling error", err); + } + }, 2000); + + return () => clearInterval(interval); +}, [activeJobId]); +``` + +**Step 4: Update the progress UI** + +Replace the spinner/loading button text with a live counter when `jobProgress` is set: + +```tsx +{importAllLoading && jobProgress && ( +

+ {jobProgress.uploaded + jobProgress.skipped} / {jobProgress.total} processed + {jobProgress.failed > 0 && ` · ${jobProgress.failed} failed`} +

+)} +``` + +**Step 5: Add imports at the top of the file** + +```typescript +import { createImportJob, getImportJob } from "@/handlers/api/import-jobs.handler"; +``` + +**Step 6: Commit** + +```bash +git add src/pages/assets/import-shared.tsx +git commit -m "feat: migrate import-shared to job queue with live progress polling" +``` + +--- + +## Done + +At this point: +- Imports are non-blocking: the page can be navigated away and the import continues server-side +- Progress is visible: `X / Y processed` updates every 2s +- Server restarts are handled: `instrumentation.ts` resets stuck jobs; next poll auto-resumes +- New platforms (Nextcloud, PhotoPrism) only need a new processor file + `registerProcessor` call in `processors/index.ts` +- The old `/api/import-shared/upload-all` endpoint is untouched and can be removed in a follow-up From 53a6e820a97ad7cb244e7ab18e28801eb266460a Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 20:07:22 +0530 Subject: [PATCH 06/30] feat: add import_jobs and import_job_items schema tables --- src/db/schema/importJobs.schema.ts | 34 ++++++++++++++++++++++++++++++ src/db/schema/index.ts | 1 + 2 files changed, 35 insertions(+) create mode 100644 src/db/schema/importJobs.schema.ts diff --git a/src/db/schema/importJobs.schema.ts b/src/db/schema/importJobs.schema.ts new file mode 100644 index 0000000..259f16d --- /dev/null +++ b/src/db/schema/importJobs.schema.ts @@ -0,0 +1,34 @@ +import { sqliteTable, text, integer } from "drizzle-orm/sqlite-core"; +import { randomUUID } from "crypto"; + +export const importJobs = sqliteTable("import_jobs", { + id: text("id").primaryKey().$defaultFn(() => randomUUID()), + userId: text("user_id").notNull(), + platform: text("platform").notNull(), // 'immich' | 'nextcloud' | 'photoprism' + status: text("status").notNull().default("pending"), // pending | processing | completed | failed + url: text("url").notNull(), // base URL of source + urlConfig: text("url_config").notNull().default("{}"), // JSON: auth/connection (key, token, etc.) + importData: text("import_data").notNull().default("{}"), // JSON: album options, resolved albumId, etc. + totalCount: integer("total_count").notNull().default(0), + uploadedCount: integer("uploaded_count").notNull().default(0), + skippedCount: integer("skipped_count").notNull().default(0), + failedCount: integer("failed_count").notNull().default(0), + createdAt: integer("created_at", { mode: "timestamp" }).$defaultFn(() => new Date()), + updatedAt: integer("updated_at", { mode: "timestamp" }) + .$defaultFn(() => new Date()) + .$onUpdate(() => new Date()), +}); + +export const importJobItems = sqliteTable("import_job_items", { + id: text("id").primaryKey().$defaultFn(() => randomUUID()), + jobId: text("job_id").notNull().references(() => importJobs.id), + assetId: text("asset_id").notNull(), // source platform's asset ID + status: text("status").notNull().default("pending"), // pending | processing | uploaded | skipped | failed + itemData: text("item_data").notNull().default("{}"), // JSON: filename, type, dates, isFavorite, etc. + immichId: text("immich_id"), // Immich asset ID after successful upload + error: text("error"), + createdAt: integer("created_at", { mode: "timestamp" }).$defaultFn(() => new Date()), + updatedAt: integer("updated_at", { mode: "timestamp" }) + .$defaultFn(() => new Date()) + .$onUpdate(() => new Date()), +}); diff --git a/src/db/schema/index.ts b/src/db/schema/index.ts index 5c0e3da..df0931d 100644 --- a/src/db/schema/index.ts +++ b/src/db/schema/index.ts @@ -1,2 +1,3 @@ export * from "./settings.schema"; export * from "./apiKeys.schema"; +export * from "./importJobs.schema"; From 619b2e178532c80d4edd83db515db4a8012b597e Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 20:08:41 +0530 Subject: [PATCH 07/30] feat: add migration for import_jobs and import_job_items --- .../migrations/0001_rainy_jamie_braddock.sql | 28 ++ src/db/migrations/meta/0001_snapshot.json | 314 ++++++++++++++++++ src/db/migrations/meta/_journal.json | 7 + 3 files changed, 349 insertions(+) create mode 100644 src/db/migrations/0001_rainy_jamie_braddock.sql create mode 100644 src/db/migrations/meta/0001_snapshot.json diff --git a/src/db/migrations/0001_rainy_jamie_braddock.sql b/src/db/migrations/0001_rainy_jamie_braddock.sql new file mode 100644 index 0000000..507a47f --- /dev/null +++ b/src/db/migrations/0001_rainy_jamie_braddock.sql @@ -0,0 +1,28 @@ +CREATE TABLE `import_job_items` ( + `id` text PRIMARY KEY NOT NULL, + `job_id` text NOT NULL, + `asset_id` text NOT NULL, + `status` text DEFAULT 'pending' NOT NULL, + `item_data` text DEFAULT '{}' NOT NULL, + `immich_id` text, + `error` text, + `created_at` integer, + `updated_at` integer, + FOREIGN KEY (`job_id`) REFERENCES `import_jobs`(`id`) ON UPDATE no action ON DELETE no action +); +--> statement-breakpoint +CREATE TABLE `import_jobs` ( + `id` text PRIMARY KEY NOT NULL, + `user_id` text NOT NULL, + `platform` text NOT NULL, + `status` text DEFAULT 'pending' NOT NULL, + `url` text NOT NULL, + `url_config` text DEFAULT '{}' NOT NULL, + `import_data` text DEFAULT '{}' NOT NULL, + `total_count` integer DEFAULT 0 NOT NULL, + `uploaded_count` integer DEFAULT 0 NOT NULL, + `skipped_count` integer DEFAULT 0 NOT NULL, + `failed_count` integer DEFAULT 0 NOT NULL, + `created_at` integer, + `updated_at` integer +); diff --git a/src/db/migrations/meta/0001_snapshot.json b/src/db/migrations/meta/0001_snapshot.json new file mode 100644 index 0000000..026a6bf --- /dev/null +++ b/src/db/migrations/meta/0001_snapshot.json @@ -0,0 +1,314 @@ +{ + "version": "6", + "dialect": "sqlite", + "id": "bec76260-a0eb-4895-a32e-244df56b6c2e", + "prevId": "8b257fc8-972b-47da-ae98-7a83316d6df6", + "tables": { + "settings": { + "name": "settings", + "columns": { + "key": { + "name": "key", + "type": "text", + "primaryKey": true, + "notNull": true, + "autoincrement": false + }, + "value": { + "name": "value", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false + }, + "updated_at": { + "name": "updated_at", + "type": "integer", + "primaryKey": false, + "notNull": false, + "autoincrement": false + } + }, + "indexes": {}, + "foreignKeys": {}, + "compositePrimaryKeys": {}, + "uniqueConstraints": {}, + "checkConstraints": {} + }, + "api_keys": { + "name": "api_keys", + "columns": { + "id": { + "name": "id", + "type": "text", + "primaryKey": true, + "notNull": true, + "autoincrement": false + }, + "user_id": { + "name": "user_id", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false + }, + "purpose": { + "name": "purpose", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false + }, + "key_name": { + "name": "key_name", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false + }, + "secret": { + "name": "secret", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false + }, + "immich_key_id": { + "name": "immich_key_id", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false + }, + "created_at": { + "name": "created_at", + "type": "integer", + "primaryKey": false, + "notNull": false, + "autoincrement": false + } + }, + "indexes": { + "api_keys_user_id_purpose_unique": { + "name": "api_keys_user_id_purpose_unique", + "columns": [ + "user_id", + "purpose" + ], + "isUnique": true + } + }, + "foreignKeys": {}, + "compositePrimaryKeys": {}, + "uniqueConstraints": {}, + "checkConstraints": {} + }, + "import_job_items": { + "name": "import_job_items", + "columns": { + "id": { + "name": "id", + "type": "text", + "primaryKey": true, + "notNull": true, + "autoincrement": false + }, + "job_id": { + "name": "job_id", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false + }, + "asset_id": { + "name": "asset_id", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false + }, + "status": { + "name": "status", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false, + "default": "'pending'" + }, + "item_data": { + "name": "item_data", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false, + "default": "'{}'" + }, + "immich_id": { + "name": "immich_id", + "type": "text", + "primaryKey": false, + "notNull": false, + "autoincrement": false + }, + "error": { + "name": "error", + "type": "text", + "primaryKey": false, + "notNull": false, + "autoincrement": false + }, + "created_at": { + "name": "created_at", + "type": "integer", + "primaryKey": false, + "notNull": false, + "autoincrement": false + }, + "updated_at": { + "name": "updated_at", + "type": "integer", + "primaryKey": false, + "notNull": false, + "autoincrement": false + } + }, + "indexes": {}, + "foreignKeys": { + "import_job_items_job_id_import_jobs_id_fk": { + "name": "import_job_items_job_id_import_jobs_id_fk", + "tableFrom": "import_job_items", + "tableTo": "import_jobs", + "columnsFrom": [ + "job_id" + ], + "columnsTo": [ + "id" + ], + "onDelete": "no action", + "onUpdate": "no action" + } + }, + "compositePrimaryKeys": {}, + "uniqueConstraints": {}, + "checkConstraints": {} + }, + "import_jobs": { + "name": "import_jobs", + "columns": { + "id": { + "name": "id", + "type": "text", + "primaryKey": true, + "notNull": true, + "autoincrement": false + }, + "user_id": { + "name": "user_id", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false + }, + "platform": { + "name": "platform", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false + }, + "status": { + "name": "status", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false, + "default": "'pending'" + }, + "url": { + "name": "url", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false + }, + "url_config": { + "name": "url_config", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false, + "default": "'{}'" + }, + "import_data": { + "name": "import_data", + "type": "text", + "primaryKey": false, + "notNull": true, + "autoincrement": false, + "default": "'{}'" + }, + "total_count": { + "name": "total_count", + "type": "integer", + "primaryKey": false, + "notNull": true, + "autoincrement": false, + "default": 0 + }, + "uploaded_count": { + "name": "uploaded_count", + "type": "integer", + "primaryKey": false, + "notNull": true, + "autoincrement": false, + "default": 0 + }, + "skipped_count": { + "name": "skipped_count", + "type": "integer", + "primaryKey": false, + "notNull": true, + "autoincrement": false, + "default": 0 + }, + "failed_count": { + "name": "failed_count", + "type": "integer", + "primaryKey": false, + "notNull": true, + "autoincrement": false, + "default": 0 + }, + "created_at": { + "name": "created_at", + "type": "integer", + "primaryKey": false, + "notNull": false, + "autoincrement": false + }, + "updated_at": { + "name": "updated_at", + "type": "integer", + "primaryKey": false, + "notNull": false, + "autoincrement": false + } + }, + "indexes": {}, + "foreignKeys": {}, + "compositePrimaryKeys": {}, + "uniqueConstraints": {}, + "checkConstraints": {} + } + }, + "views": {}, + "enums": {}, + "_meta": { + "schemas": {}, + "tables": {}, + "columns": {} + }, + "internal": { + "indexes": {} + } +} \ No newline at end of file diff --git a/src/db/migrations/meta/_journal.json b/src/db/migrations/meta/_journal.json index 655df45..05662f3 100644 --- a/src/db/migrations/meta/_journal.json +++ b/src/db/migrations/meta/_journal.json @@ -8,6 +8,13 @@ "when": 1774242821856, "tag": "0000_vengeful_kylun", "breakpoints": true + }, + { + "idx": 1, + "version": "6", + "when": 1775227109706, + "tag": "0001_rainy_jamie_braddock", + "breakpoints": true } ] } \ No newline at end of file From fbcff5f380f6bce55c3e616de1c6f56ab1f7782b Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 20:09:28 +0530 Subject: [PATCH 08/30] feat: add import processor interface and registry --- src/workers/import/registry.ts | 15 +++++++++++++++ src/workers/import/types.ts | 22 ++++++++++++++++++++++ 2 files changed, 37 insertions(+) create mode 100644 src/workers/import/registry.ts create mode 100644 src/workers/import/types.ts diff --git a/src/workers/import/registry.ts b/src/workers/import/registry.ts new file mode 100644 index 0000000..1292413 --- /dev/null +++ b/src/workers/import/registry.ts @@ -0,0 +1,15 @@ +import type { ImportProcessor } from "./types"; + +const processors = new Map(); + +export function registerProcessor(platform: string, processor: ImportProcessor) { + processors.set(platform, processor); +} + +export function getProcessor(platform: string): ImportProcessor { + const processor = processors.get(platform); + if (!processor) { + throw new Error(`No import processor registered for platform: ${platform}`); + } + return processor; +} diff --git a/src/workers/import/types.ts b/src/workers/import/types.ts new file mode 100644 index 0000000..0b98aaa --- /dev/null +++ b/src/workers/import/types.ts @@ -0,0 +1,22 @@ +import type { importJobs, importJobItems } from "@/db/schema"; + +export type ImportJob = typeof importJobs.$inferSelect; +export type ImportJobItem = typeof importJobItems.$inferSelect; + +export interface ProcessorContext { + headers: Record; // user auth headers for Immich API calls + albumId?: string; // resolved after setup() +} + +export interface SetupResult { + skipAssetIds: string[]; // source asset IDs already in Immich → mark skipped + albumId?: string; // created or resolved album ID + importDataPatch?: Record; // merged into job.importData in db +} + +export interface ImportProcessor { + /** Called once per job before items are processed. Dedup + album creation. */ + setup(job: ImportJob, context: ProcessorContext): Promise; + /** Called once per item. Returns the Immich asset ID on success, throws on failure. */ + processItem(job: ImportJob, item: ImportJobItem, context: ProcessorContext): Promise<{ immichId: string }>; +} From 4e867f7691c32647fedf8fa71f3673898adced94 Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 20:11:19 +0530 Subject: [PATCH 09/30] feat: add immich shared-link import processor Co-Authored-By: Claude Sonnet 4.6 --- .../import/processors/immich-shared-link.ts | 350 ++++++++++++++++++ src/workers/import/processors/index.ts | 4 + 2 files changed, 354 insertions(+) create mode 100644 src/workers/import/processors/immich-shared-link.ts create mode 100644 src/workers/import/processors/index.ts diff --git a/src/workers/import/processors/immich-shared-link.ts b/src/workers/import/processors/immich-shared-link.ts new file mode 100644 index 0000000..c944ace --- /dev/null +++ b/src/workers/import/processors/immich-shared-link.ts @@ -0,0 +1,350 @@ +import { eq } from "drizzle-orm"; +import { appDb } from "@/db"; +import { importJobItems } from "@/db/schema"; +import { ENV } from "@/config/environment"; +import { + ensurePowerToolsTag, + HeadersRecord, +} from "@/pages/api/import-shared/helpers"; +import type { ImportJob, ImportJobItem, ImportProcessor, ProcessorContext, SetupResult } from "../types"; + +const DEVICE_ID = "immich-power-tools"; +const makeDeviceAssetId = (assetId: string) => `shared-${assetId}`; + +interface ISharedAssetPayload { + id: string; + originalFileName?: string; + type: string; + fileCreatedAt?: string | null; + localDateTime?: string | null; + duration?: string | null; + isFavorite?: boolean; + isArchived?: boolean; +} + +interface DownloadedAssetPayload { + buffer: Buffer; + fileName: string; + contentType: string | null; +} + +const inferAssetTypeFromName = (fileName: string): "IMAGE" | "VIDEO" => { + const extension = fileName.split(".").pop()?.toLowerCase(); + if (!extension) return "IMAGE"; + switch (extension) { + case "mp4": + case "mov": + case "m4v": + case "avi": + case "mkv": + case "webm": + case "3gp": + case "3g2": + case "mts": + case "m2ts": + return "VIDEO"; + default: + return "IMAGE"; + } +}; + +const parseFileNameFromDisposition = (disposition?: string | null): string | null => { + if (!disposition) return null; + const match = disposition.match(/filename\*?=([^;]+)/i); + if (!match || !match[1]) return null; + const value = match[1].trim().replace(/^UTF-8''/i, "").replace(/^"|"$/g, "").replace(/^'|'$/g, ""); + try { + return decodeURIComponent(value); + } catch { + return value; + } +}; + +const guessContentType = (fileName: string): string => { + const extension = fileName.toLowerCase().split(".").pop(); + switch (extension) { + case "jpg": + case "jpeg": + case "jfif": + return "image/jpeg"; + case "png": + return "image/png"; + case "heic": + return "image/heic"; + case "heif": + return "image/heif"; + case "webp": + return "image/webp"; + case "gif": + return "image/gif"; + case "tif": + case "tiff": + return "image/tiff"; + case "bmp": + return "image/bmp"; + case "mp4": + case "m4v": + return "video/mp4"; + case "mov": + return "video/quicktime"; + case "avi": + return "video/x-msvideo"; + case "mkv": + return "video/x-matroska"; + case "webm": + return "video/webm"; + case "3gp": + case "3g2": + return "video/3gpp"; + case "mts": + case "m2ts": + return "video/MP2T"; + default: + return "application/octet-stream"; + } +}; + +const createImmichAlbum = async (albumName: string, headers: HeadersRecord): Promise => { + const response = await fetch(`${ENV.IMMICH_URL}/api/albums`, { + method: "POST", + headers, + body: JSON.stringify({ albumName }), + }); + if (!response.ok) { + const body = await response.text().catch(() => ""); + throw new Error(`Failed to create album "${albumName}" (status ${response.status}): ${body || "Unknown error"}`); + } + const album = await response.json().catch(() => null); + const albumId = album?.id; + if (!albumId || typeof albumId !== "string") { + throw new Error("Immich album creation response did not include an id"); + } + return albumId; +}; + +const addAssetToAlbum = async (albumId: string, assetId: string, headers: HeadersRecord): Promise => { + const response = await fetch(`${ENV.IMMICH_URL}/api/albums/${albumId}/assets`, { + method: "PUT", + headers, + body: JSON.stringify({ ids: [assetId] }), + }); + if (!response.ok) { + const body = await response.text().catch(() => ""); + throw new Error( + `Failed to attach asset ${assetId} to album ${albumId} (status ${response.status}): ${body || "Unknown error"}` + ); + } +}; + +const downloadSharedAsset = async ( + asset: ISharedAssetPayload, + origin: string, + key: string +): Promise => { + const url = `${origin}/api/assets/${asset.id}/original?key=${key}`; + const response = await fetch(url, { method: "GET", headers: { accept: "*/*" } }); + if (!response.ok) { + throw new Error(`Failed to download ${asset.originalFileName ?? asset.id} (status ${response.status})`); + } + const buffer = Buffer.from(await response.arrayBuffer()); + const disposition = response.headers.get("content-disposition"); + const inferredName = parseFileNameFromDisposition(disposition); + const fallbackExtension = asset.type === "VIDEO" ? "mp4" : "jpg"; + const fileName = inferredName ?? asset.originalFileName ?? `${asset.id}.${fallbackExtension}`; + return { buffer, fileName, contentType: response.headers.get("content-type") }; +}; + +const uploadAssetBuffer = async ( + asset: ISharedAssetPayload, + payload: DownloadedAssetPayload, + uploadHeaders: HeadersRecord, + jsonHeaders: HeadersRecord, + tagId: string +): Promise => { + const fileType = asset.type ?? inferAssetTypeFromName(payload.fileName); + const resolvedFileName = payload.fileName || asset.originalFileName || `${asset.id}.bin`; + const contentType = payload.contentType ?? guessContentType(resolvedFileName); + const uint8Array = new Uint8Array(payload.buffer.byteLength); + uint8Array.set(payload.buffer); + const blob = new Blob([uint8Array.buffer], { type: contentType }); + const createdAt = asset.fileCreatedAt ?? asset.localDateTime ?? new Date().toISOString(); + const modifiedAt = asset.localDateTime ?? asset.fileCreatedAt ?? createdAt; + + const formData = new FormData(); + formData.set("deviceAssetId", makeDeviceAssetId(asset.id)); + formData.set("deviceId", DEVICE_ID); + formData.set("fileCreatedAt", createdAt); + formData.set("fileModifiedAt", modifiedAt); + formData.set("fileType", fileType); + formData.set("duration", asset.duration ?? "0:00:00.000000"); + formData.set("assetData", blob, resolvedFileName); + if (asset.isArchived) formData.set("isArchived", String(asset.isArchived)); + if (asset.isFavorite) formData.set("isFavorite", String(asset.isFavorite)); + + const uploadResponse = await fetch(`${ENV.IMMICH_URL}/api/assets`, { + method: "POST", + headers: uploadHeaders, + body: formData, + }); + + if (!uploadResponse.ok) { + const body = await uploadResponse.text().catch(() => ""); + throw new Error( + `Upload failed for ${asset.originalFileName ?? asset.id} (status ${uploadResponse.status}): ${body || "Unknown error"}` + ); + } + + const uploaded = await uploadResponse.json(); + const uploadedId = uploaded?.id; + if (!uploadedId) { + throw new Error("Immich upload response did not include an asset id"); + } + + const { tagAssetWithPowerTools } = await import("@/pages/api/import-shared/helpers"); + await tagAssetWithPowerTools(tagId, uploadedId, jsonHeaders); + return uploadedId; +}; + +export class ImmichSharedLinkProcessor implements ImportProcessor { + async setup(job: ImportJob, context: ProcessorContext): Promise { + const headers = context.headers as HeadersRecord; + + // Load all items for this job from the db + const items = await appDb + .select() + .from(importJobItems) + .where(eq(importJobItems.jobId, job.id)); + + // Build deviceAssetIds for dedup check + const deviceAssetIds: string[] = []; + const deviceAssetIdLookup = new Map(); + for (const item of items) { + const deviceAssetId = makeDeviceAssetId(item.assetId); + deviceAssetIds.push(deviceAssetId); + deviceAssetIdLookup.set(deviceAssetId.toLowerCase(), item.assetId); + } + + // Check which assets already exist in Immich + const skipAssetIds: string[] = []; + if (deviceAssetIds.length > 0) { + try { + const jsonHeadersWithContentType: HeadersRecord = { + ...headers, + "Content-Type": "application/json", + }; + const checkResponse = await fetch(`${ENV.IMMICH_URL}/api/assets/exist`, { + method: "POST", + headers: jsonHeadersWithContentType, + body: JSON.stringify({ deviceAssetIds, deviceId: DEVICE_ID }), + }); + + if (checkResponse.ok) { + const existPayload = await checkResponse.json().catch(() => ({})); + const existingIds: string[] = existPayload?.existingIds ?? []; + for (const deviceAssetId of existingIds) { + if (typeof deviceAssetId !== "string") continue; + const matchedAssetId = deviceAssetIdLookup.get(deviceAssetId.toLowerCase()); + if (matchedAssetId) { + skipAssetIds.push(matchedAssetId); + } + } + } else { + console.warn(`[ImmichSharedLinkProcessor] Failed to check existing assets (status ${checkResponse.status})`); + } + } catch (error) { + console.warn("[ImmichSharedLinkProcessor] Unable to check existing assets", error); + } + } + + // Parse importData for album options + let importData: Record = {}; + try { + importData = JSON.parse(job.importData); + } catch { + // ignore parse errors, treat as empty + } + + const albumOptions = importData.albumOptions as { + createAlbum?: boolean; + albumName?: string; + addToAlbumId?: string; + } | undefined; + + let albumId: string | undefined; + const jsonHeadersWithContentType: HeadersRecord = { + ...headers, + "Content-Type": "application/json", + }; + + if (albumOptions?.createAlbum) { + const desiredAlbumName = + albumOptions.albumName?.trim() || `Shared import ${new Date().toISOString()}`; + albumId = await createImmichAlbum(desiredAlbumName, jsonHeadersWithContentType); + console.log(`[ImmichSharedLinkProcessor] Created album ${albumId} (${desiredAlbumName})`); + } else if (typeof albumOptions?.addToAlbumId === "string" && albumOptions.addToAlbumId.trim()) { + albumId = albumOptions.addToAlbumId.trim(); + } + + return { + skipAssetIds, + albumId, + importDataPatch: albumId ? { albumId } : undefined, + }; + } + + async processItem( + job: ImportJob, + item: ImportJobItem, + context: ProcessorContext + ): Promise<{ immichId: string }> { + const headers = context.headers as HeadersRecord; + + // Parse item metadata + let asset: ISharedAssetPayload; + try { + const parsed = JSON.parse(item.itemData); + asset = { + id: item.assetId, + originalFileName: parsed.originalFileName, + type: parsed.type ?? "IMAGE", + fileCreatedAt: parsed.fileCreatedAt ?? null, + localDateTime: parsed.localDateTime ?? null, + duration: parsed.duration ?? null, + isFavorite: parsed.isFavorite ?? false, + isArchived: parsed.isArchived ?? false, + }; + } catch { + asset = { id: item.assetId, type: "IMAGE" }; + } + + // Parse urlConfig for the share key + let urlConfig: Record = {}; + try { + urlConfig = JSON.parse(job.urlConfig); + } catch { + // ignore + } + const key = typeof urlConfig.key === "string" ? urlConfig.key : ""; + + // Download the asset from the shared link + const downloaded = await downloadSharedAsset(asset, job.url, key); + + // Strip Content-Type for multipart upload (same pattern as upload-all.ts) + const { ["Content-Type"]: _omit, ...uploadHeaders } = headers; + + // Ensure the power-tools tag exists and upload + const tag = await ensurePowerToolsTag(headers); + const immichId = await uploadAssetBuffer(asset, downloaded, uploadHeaders, headers, tag.id); + + // Add to album if one was resolved during setup + if (context.albumId) { + const jsonHeadersWithContentType: HeadersRecord = { + ...headers, + "Content-Type": "application/json", + }; + await addAssetToAlbum(context.albumId, immichId, jsonHeadersWithContentType); + } + + return { immichId }; + } +} diff --git a/src/workers/import/processors/index.ts b/src/workers/import/processors/index.ts new file mode 100644 index 0000000..00cc5d7 --- /dev/null +++ b/src/workers/import/processors/index.ts @@ -0,0 +1,4 @@ +import { registerProcessor } from "../registry"; +import { ImmichSharedLinkProcessor } from "./immich-shared-link"; + +registerProcessor("immich", new ImmichSharedLinkProcessor()); From 8dbef1e1b14ce139a95d851181aeea6c095c77d7 Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 20:12:53 +0530 Subject: [PATCH 10/30] fix: add Content-Type header to ensurePowerToolsTag POST request --- src/pages/api/import-shared/helpers.ts | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/src/pages/api/import-shared/helpers.ts b/src/pages/api/import-shared/helpers.ts index 09aee47..48fca46 100644 --- a/src/pages/api/import-shared/helpers.ts +++ b/src/pages/api/import-shared/helpers.ts @@ -26,7 +26,10 @@ export const ensurePowerToolsTag = async (headers: HeadersRecord) => { const createResponse = await fetch(`${ENV.IMMICH_URL}/api/tags`, { method: "POST", - headers, + headers: { + ...headers, + "Content-Type": "application/json", + }, body: JSON.stringify({ name: POWER_TOOLS_TAG_NAME }), }); From 0de78ad2000a7985a0277ba11c3deda74f9e5ca5 Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 20:14:08 +0530 Subject: [PATCH 11/30] feat: add import job worker runner with concurrency and db tracking Co-Authored-By: Claude Sonnet 4.6 --- src/workers/import/runner.ts | 143 +++++++++++++++++++++++++++++++++++ 1 file changed, 143 insertions(+) create mode 100644 src/workers/import/runner.ts diff --git a/src/workers/import/runner.ts b/src/workers/import/runner.ts new file mode 100644 index 0000000..3806b3b --- /dev/null +++ b/src/workers/import/runner.ts @@ -0,0 +1,143 @@ +import { eq, inArray, sql } from "drizzle-orm"; +import { appDb } from "@/db"; +import { importJobs, importJobItems } from "@/db/schema"; +import { getProcessor } from "./registry"; +import "./processors/index"; // side-effect: registers all processors + +export type { ImportJob, ImportJobItem } from "./types"; + +const activeJobs = new Set(); +const CONCURRENCY = 4; + +export function isJobActive(jobId: string) { + return activeJobs.has(jobId); +} + +export async function getJobItems(jobId: string) { + return appDb + .select() + .from(importJobItems) + .where(eq(importJobItems.jobId, jobId)); +} + +export async function resumePendingJobs() { + await appDb + .update(importJobs) + .set({ status: "pending" }) + .where(eq(importJobs.status, "processing")); +} + +export async function runImportJob( + jobId: string, + headers: Record +): Promise { + if (activeJobs.has(jobId)) return; + activeJobs.add(jobId); + + try { + const [job] = await appDb + .select() + .from(importJobs) + .where(eq(importJobs.id, jobId)); + if (!job || job.status === "completed" || job.status === "failed") return; + + await appDb + .update(importJobs) + .set({ status: "processing" }) + .where(eq(importJobs.id, jobId)); + + const processor = getProcessor(job.platform); + const context = { headers }; + + // Setup: dedup + album creation + const { skipAssetIds, albumId, importDataPatch } = await processor.setup( + job, + context + ); + + if (importDataPatch) { + const merged = { ...JSON.parse(job.importData), ...importDataPatch }; + await appDb + .update(importJobs) + .set({ importData: JSON.stringify(merged) }) + .where(eq(importJobs.id, jobId)); + } + + if (skipAssetIds.length > 0) { + await appDb + .update(importJobItems) + .set({ status: "skipped" }) + .where(inArray(importJobItems.assetId, skipAssetIds)); + await appDb + .update(importJobs) + .set({ skippedCount: skipAssetIds.length }) + .where(eq(importJobs.id, jobId)); + } + + // Fetch only the items that are still pending for this job (after skip updates) + const pending = await appDb + .select() + .from(importJobItems) + .where(eq(importJobItems.jobId, jobId)) + .then((rows) => rows.filter((r) => r.status === "pending")); + + const processorContext = { ...context, albumId }; + + let currentIndex = 0; + const worker = async () => { + while (true) { + const index = currentIndex++; + if (index >= pending.length) break; + const item = pending[index]; + + await appDb + .update(importJobItems) + .set({ status: "processing" }) + .where(eq(importJobItems.id, item.id)); + + try { + const { immichId } = await processor.processItem( + job, + item, + processorContext + ); + await appDb + .update(importJobItems) + .set({ status: "uploaded", immichId }) + .where(eq(importJobItems.id, item.id)); + await appDb + .update(importJobs) + .set({ uploadedCount: sql`${importJobs.uploadedCount} + 1` }) + .where(eq(importJobs.id, jobId)); + } catch (err: any) { + await appDb + .update(importJobItems) + .set({ status: "failed", error: err?.message ?? "Unknown error" }) + .where(eq(importJobItems.id, item.id)); + await appDb + .update(importJobs) + .set({ failedCount: sql`${importJobs.failedCount} + 1` }) + .where(eq(importJobs.id, jobId)); + } + } + }; + + const concurrency = Math.min(CONCURRENCY, pending.length); + if (concurrency > 0) { + await Promise.all(Array.from({ length: concurrency }, worker)); + } + + await appDb + .update(importJobs) + .set({ status: "completed" }) + .where(eq(importJobs.id, jobId)); + } catch (err: any) { + console.error(`Import job ${jobId} failed fatally:`, err); + await appDb + .update(importJobs) + .set({ status: "failed" }) + .where(eq(importJobs.id, jobId)); + } finally { + activeJobs.delete(jobId); + } +} From 86beffc88ea570e32d102098d4fd6d4255f0d900 Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 20:15:51 +0530 Subject: [PATCH 12/30] fix: scope skip update to jobId, use DB WHERE for pending items, SQL-increment skippedCount --- src/workers/import/runner.ts | 9 ++++----- 1 file changed, 4 insertions(+), 5 deletions(-) diff --git a/src/workers/import/runner.ts b/src/workers/import/runner.ts index 3806b3b..eaa1d52 100644 --- a/src/workers/import/runner.ts +++ b/src/workers/import/runner.ts @@ -1,4 +1,4 @@ -import { eq, inArray, sql } from "drizzle-orm"; +import { and, eq, inArray, sql } from "drizzle-orm"; import { appDb } from "@/db"; import { importJobs, importJobItems } from "@/db/schema"; import { getProcessor } from "./registry"; @@ -67,10 +67,10 @@ export async function runImportJob( await appDb .update(importJobItems) .set({ status: "skipped" }) - .where(inArray(importJobItems.assetId, skipAssetIds)); + .where(and(eq(importJobItems.jobId, jobId), inArray(importJobItems.assetId, skipAssetIds))); await appDb .update(importJobs) - .set({ skippedCount: skipAssetIds.length }) + .set({ skippedCount: sql`${importJobs.skippedCount} + ${skipAssetIds.length}` }) .where(eq(importJobs.id, jobId)); } @@ -78,8 +78,7 @@ export async function runImportJob( const pending = await appDb .select() .from(importJobItems) - .where(eq(importJobItems.jobId, jobId)) - .then((rows) => rows.filter((r) => r.status === "pending")); + .where(and(eq(importJobItems.jobId, jobId), eq(importJobItems.status, "pending"))); const processorContext = { ...context, albumId }; From 87732eba7c1c2c250cc7ff0bcf6e99ab745629fd Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 20:16:47 +0530 Subject: [PATCH 13/30] feat: reset stuck import jobs to pending on startup --- instrumentation.ts | 3 +++ 1 file changed, 3 insertions(+) diff --git a/instrumentation.ts b/instrumentation.ts index e8982e3..496412a 100644 --- a/instrumentation.ts +++ b/instrumentation.ts @@ -3,5 +3,8 @@ export async function register() { if (process.env.NEXT_RUNTIME === "nodejs") { const { runMigrations } = await import("./src/db"); await runMigrations(); + + const { resumePendingJobs } = await import("./src/workers/import/runner"); + await resumePendingJobs(); } } From bcd17ae72d3bacaf1e3c9a617c53fde154a6ffd2 Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 20:17:03 +0530 Subject: [PATCH 14/30] feat: add POST /api/import-jobs endpoint to create and enqueue import jobs --- src/pages/api/import-jobs/index.ts | 49 ++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) create mode 100644 src/pages/api/import-jobs/index.ts diff --git a/src/pages/api/import-jobs/index.ts b/src/pages/api/import-jobs/index.ts new file mode 100644 index 0000000..3638dfa --- /dev/null +++ b/src/pages/api/import-jobs/index.ts @@ -0,0 +1,49 @@ +import type { NextApiRequest, NextApiResponse } from "next"; +import { appDb } from "@/db"; +import { importJobs, importJobItems } from "@/db/schema"; +import { getCurrentUser } from "@/handlers/serverUtils/user.utils"; +import { getUserHeaders } from "@/helpers/user.helper"; +import { runImportJob } from "@/workers/import/runner"; + +export default async function handler(req: NextApiRequest, res: NextApiResponse) { + if (req.method !== "POST") { + res.setHeader("Allow", "POST"); + return res.status(405).json({ error: "Method Not Allowed" }); + } + + const currentUser = await getCurrentUser(req); + if (!currentUser) return res.status(401).json({ error: "Unauthorized" }); + + const { platform, url, urlConfig, importData, assets } = req.body; + + if (!platform || !url || !Array.isArray(assets) || assets.length === 0) { + return res.status(400).json({ error: "platform, url, and assets are required" }); + } + + const [job] = await appDb + .insert(importJobs) + .values({ + userId: currentUser.id, + platform, + url, + urlConfig: JSON.stringify(urlConfig ?? {}), + importData: JSON.stringify(importData ?? {}), + totalCount: assets.length, + }) + .returning(); + + await appDb.insert(importJobItems).values( + assets.map((asset: { id: string; [key: string]: unknown }) => ({ + jobId: job.id, + assetId: asset.id, + itemData: JSON.stringify(asset), + })) + ); + + const headers = getUserHeaders(currentUser) as Record; + runImportJob(job.id, headers).catch((err) => + console.error("Unhandled error in runImportJob", err) + ); + + return res.status(201).json({ jobId: job.id }); +} From 61e2dad0291380a45b731b4be7c7bfb6839e8e1d Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 20:17:14 +0530 Subject: [PATCH 15/30] feat: add GET /api/import-jobs/[jobId] polling endpoint with auto-resume --- src/pages/api/import-jobs/[jobId].ts | 38 ++++++++++++++++++++++++++++ 1 file changed, 38 insertions(+) create mode 100644 src/pages/api/import-jobs/[jobId].ts diff --git a/src/pages/api/import-jobs/[jobId].ts b/src/pages/api/import-jobs/[jobId].ts new file mode 100644 index 0000000..1289028 --- /dev/null +++ b/src/pages/api/import-jobs/[jobId].ts @@ -0,0 +1,38 @@ +import type { NextApiRequest, NextApiResponse } from "next"; +import { eq } from "drizzle-orm"; +import { appDb } from "@/db"; +import { importJobs, importJobItems } from "@/db/schema"; +import { getCurrentUser } from "@/handlers/serverUtils/user.utils"; +import { getUserHeaders } from "@/helpers/user.helper"; +import { isJobActive, runImportJob } from "@/workers/import/runner"; + +export default async function handler(req: NextApiRequest, res: NextApiResponse) { + if (req.method !== "GET") { + res.setHeader("Allow", "GET"); + return res.status(405).json({ error: "Method Not Allowed" }); + } + + const currentUser = await getCurrentUser(req); + if (!currentUser) return res.status(401).json({ error: "Unauthorized" }); + + const { jobId } = req.query as { jobId: string }; + + const [job] = await appDb.select().from(importJobs).where(eq(importJobs.id, jobId)); + if (!job || job.userId !== currentUser.id) { + return res.status(404).json({ error: "Job not found" }); + } + + if (job.status === "pending" && !isJobActive(jobId)) { + const headers = getUserHeaders(currentUser) as Record; + runImportJob(jobId, headers).catch((err) => + console.error("Unhandled error in runImportJob (resume)", err) + ); + } + + const items = await appDb + .select() + .from(importJobItems) + .where(eq(importJobItems.jobId, jobId)); + + return res.status(200).json({ job, items }); +} From 93a4cabb01ecb6b560089ba4fb65660d98058400 Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 20:17:25 +0530 Subject: [PATCH 16/30] feat: add import-jobs route constants and client handler --- src/config/routes.ts | 6 +++++- src/handlers/api/import-jobs.handler.ts | 18 ++++++++++++++++++ 2 files changed, 23 insertions(+), 1 deletion(-) create mode 100644 src/handlers/api/import-jobs.handler.ts diff --git a/src/config/routes.ts b/src/config/routes.ts index 87e7d32..5aebadb 100644 --- a/src/config/routes.ts +++ b/src/config/routes.ts @@ -94,4 +94,8 @@ export const SHARE_KEY_PATH = BASE_API_ENDPOINT + "/share-key"; // Import Shared export const IMPORT_SHARED_PATH = BASE_API_ENDPOINT + "/import-shared"; -export const IMPORT_SHARED_UPLOAD_ALL_PATH = BASE_API_ENDPOINT + "/import-shared/upload-all"; \ No newline at end of file +export const IMPORT_SHARED_UPLOAD_ALL_PATH = BASE_API_ENDPOINT + "/import-shared/upload-all"; + +// Import Jobs (queue) +export const IMPORT_JOBS_PATH = BASE_API_ENDPOINT + "/import-jobs"; +export const IMPORT_JOB_PATH = (jobId: string) => BASE_API_ENDPOINT + "/import-jobs/" + jobId; \ No newline at end of file diff --git a/src/handlers/api/import-jobs.handler.ts b/src/handlers/api/import-jobs.handler.ts new file mode 100644 index 0000000..bff95d9 --- /dev/null +++ b/src/handlers/api/import-jobs.handler.ts @@ -0,0 +1,18 @@ +import { IMPORT_JOBS_PATH, IMPORT_JOB_PATH } from "@/config/routes"; +import API from "@/lib/api"; + +export interface CreateImportJobParams { + platform: string; + url: string; + urlConfig: Record; + importData: Record; + assets: { id: string; [key: string]: unknown }[]; +} + +export const createImportJob = async (params: CreateImportJobParams): Promise<{ jobId: string }> => { + return API.post(IMPORT_JOBS_PATH, params); +}; + +export const getImportJob = async (jobId: string) => { + return API.get(IMPORT_JOB_PATH(jobId)); +}; From ae9fd45f0a84497bedccbb780458dd3b8526a3ac Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 20:19:20 +0530 Subject: [PATCH 17/30] fix: add asset id validation, type getImportJob, document resumePendingJobs limitation --- src/handlers/api/import-jobs.handler.ts | 22 +++++++++++++++++++++- src/pages/api/import-jobs/index.ts | 4 ++++ src/workers/import/runner.ts | 4 ++++ 3 files changed, 29 insertions(+), 1 deletion(-) diff --git a/src/handlers/api/import-jobs.handler.ts b/src/handlers/api/import-jobs.handler.ts index bff95d9..f2c2690 100644 --- a/src/handlers/api/import-jobs.handler.ts +++ b/src/handlers/api/import-jobs.handler.ts @@ -13,6 +13,26 @@ export const createImportJob = async (params: CreateImportJobParams): Promise<{ return API.post(IMPORT_JOBS_PATH, params); }; -export const getImportJob = async (jobId: string) => { +export interface ImportJobStatus { + job: { + id: string; + status: string; + platform: string; + totalCount: number; + uploadedCount: number; + skippedCount: number; + failedCount: number; + importData: string; + }; + items: { + id: string; + assetId: string; + status: string; + immichId: string | null; + error: string | null; + }[]; +} + +export const getImportJob = async (jobId: string): Promise => { return API.get(IMPORT_JOB_PATH(jobId)); }; diff --git a/src/pages/api/import-jobs/index.ts b/src/pages/api/import-jobs/index.ts index 3638dfa..10084bf 100644 --- a/src/pages/api/import-jobs/index.ts +++ b/src/pages/api/import-jobs/index.ts @@ -20,6 +20,10 @@ export default async function handler(req: NextApiRequest, res: NextApiResponse) return res.status(400).json({ error: "platform, url, and assets are required" }); } + if (assets.some((a: unknown) => typeof (a as any).id !== "string")) { + return res.status(400).json({ error: "Each asset must have a string id" }); + } + const [job] = await appDb .insert(importJobs) .values({ diff --git a/src/workers/import/runner.ts b/src/workers/import/runner.ts index eaa1d52..3cd9a98 100644 --- a/src/workers/import/runner.ts +++ b/src/workers/import/runner.ts @@ -21,6 +21,10 @@ export async function getJobItems(jobId: string) { } export async function resumePendingJobs() { + // Reset jobs that were mid-flight when the server last crashed. + // We cannot restart workers here — no auth headers are available at boot. + // Workers restart automatically when the polling endpoint (GET /api/import-jobs/[jobId]) + // detects a pending job with no active worker. await appDb .update(importJobs) .set({ status: "pending" }) From 06536e2699393e7bb160f32b1d6feea989ca2682 Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 20:21:07 +0530 Subject: [PATCH 18/30] feat: migrate import-shared to job queue with live progress polling Co-Authored-By: Claude Sonnet 4.6 --- src/pages/assets/import-shared.tsx | 107 +++++++++++++++++++---------- 1 file changed, 71 insertions(+), 36 deletions(-) diff --git a/src/pages/assets/import-shared.tsx b/src/pages/assets/import-shared.tsx index 25cbefb..5be34d3 100644 --- a/src/pages/assets/import-shared.tsx +++ b/src/pages/assets/import-shared.tsx @@ -22,7 +22,8 @@ import { DialogTitle, } from "@/components/ui/dialog"; import { listAlbums } from "@/handlers/api/album.handler"; -import { importShared, importSharedUploadAll } from "@/handlers/api/import-shared.handler"; +import { importShared } from "@/handlers/api/import-shared.handler"; +import { createImportJob, getImportJob } from "@/handlers/api/import-jobs.handler"; import { IAlbum } from "@/types/album"; interface IAlbumContributorCount { @@ -164,6 +165,8 @@ export default function ImportSharedPage() { const [selectedAssetIds, setSelectedAssetIds] = useState>(new Set()); const [existingAlbums, setExistingAlbums] = useState([]); const [selectedAlbumId, setSelectedAlbumId] = useState(null); + const [activeJobId, setActiveJobId] = useState(null); + const [jobProgress, setJobProgress] = useState<{ uploaded: number; skipped: number; failed: number; total: number } | null>(null); useEffect(() => { if (importAllDialogOpen) { @@ -181,6 +184,57 @@ export default function ImportSharedPage() { } }, [sharedData]); + useEffect(() => { + if (!activeJobId) return; + + const interval = setInterval(async () => { + try { + const { job, items } = await getImportJob(activeJobId); + setJobProgress({ + uploaded: job.uploadedCount, + skipped: job.skippedCount, + failed: job.failedCount, + total: job.totalCount, + }); + + if (job.status === "completed" || job.status === "failed") { + clearInterval(interval); + setActiveJobId(null); + setImportAllLoading(false); + setImportAllDialogOpen(false); + + const importData = JSON.parse(job.importData); + const failedCount = job.failedCount; + const skippedCount = job.skippedCount; + const uploadedCount = job.uploadedCount; + const bannerType: "success" | "error" = failedCount > 0 ? "error" : "success"; + let message: string; + + if (!uploadedCount && skippedCount && !failedCount) { + message = `All ${skippedCount} assets already exist on Immich.`; + } else if (failedCount) { + const skippedSuffix = skippedCount ? `, ${skippedCount} skipped` : ""; + message = `Imported ${uploadedCount} assets, ${failedCount} failed${skippedSuffix}.`; + } else if (skippedCount) { + message = `Imported ${uploadedCount} assets, skipped ${skippedCount} already on Immich.`; + } else { + message = `Imported ${uploadedCount} assets successfully.`; + } + + if (importData.albumId && uploadedCount > 0) { + message = `${message} Added to album "${albumNameInput || "selected album"}".`; + } + + setUploadBanner({ type: bannerType, message }); + } + } catch (err) { + console.error("Polling error", err); + } + }, 2000); + + return () => clearInterval(interval); + }, [activeJobId]); + const handleSubmit = async (event: FormEvent) => { event.preventDefault(); setError(null); @@ -297,9 +351,11 @@ export default function ImportSharedPage() { setUploadBanner(null); setImportAllLoading(true); try { - const result = await importSharedUploadAll({ - origin: sharedData.origin, - key: sharedData.key, + const job = await createImportJob({ + platform: "immich", + url: sharedData.origin, + urlConfig: { key: sharedData.key }, + importData: { albumOptions }, assets: uploadableAssets.map((asset) => ({ id: asset.id, originalFileName: asset.originalFileName, @@ -310,39 +366,12 @@ export default function ImportSharedPage() { isFavorite: asset.isFavorite ?? false, isArchived: asset.isArchived ?? false, })), - albumOptions, }); - - const processedAssetIds: string[] = result.processedAssetIds ?? []; - const skippedAssetIds: string[] = result.skippedAssetIds ?? []; - const failed: { assetId: string; reason?: string }[] = result.failed ?? []; - - const failedCount = failed.length; - const skippedCount = skippedAssetIds.length; - const uploadedCount = result.uploadedCount ?? processedAssetIds.length; - let bannerType: "success" | "error" = failedCount ? "error" : "success"; - let message: string; - if (!uploadedCount && skippedCount && !failedCount) { - message = `All ${skippedCount} assets already exist on Immich.`; - } else if (failedCount) { - const skippedSuffix = skippedCount ? `, ${skippedCount} skipped` : ""; - message = `Imported ${uploadedCount} assets, ${failedCount} failed${skippedSuffix}.`; - } else if (skippedCount) { - message = `Imported ${uploadedCount} assets, skipped ${skippedCount} already on Immich.`; - } else { - message = `Imported ${uploadedCount} assets successfully.`; - } - if (options.createAlbum && uploadedCount > 0 && normalizedAlbumName) { - message = `${message} Added to album "${normalizedAlbumName}".`; - } else if (options.addToAlbumId && uploadedCount > 0) { - const album = existingAlbums.find((a) => a.id === options.addToAlbumId); - message = `${message} Added to album "${album?.albumName || "existing album"}".`; - } - setUploadBanner({ type: bannerType, message }); - } catch (err) { - const message = err instanceof Error ? err.message : "Failed to import shared archive"; - setUploadBanner({ type: "error", message }); - } finally { + setActiveJobId(job.jobId); + setJobProgress({ uploaded: 0, skipped: 0, failed: 0, total: uploadableAssets.length }); + // importAllLoading stays true — cleared when polling detects completion + } catch (err: any) { + setUploadBanner({ type: "error", message: err.message ?? "Failed to start import" }); setImportAllLoading(false); } }; @@ -687,6 +716,12 @@ export default function ImportSharedPage() { )} + {importAllLoading && jobProgress && ( +

+ {jobProgress.uploaded + jobProgress.skipped} / {jobProgress.total} processed + {jobProgress.failed > 0 && ` · ${jobProgress.failed} failed`} +

+ )}
+``` + +Also remove the `setAlbumImportMode("album")` reset that was in the old onClick — the inline card owns the mode state now. + +**Step 5: Commit** + +```bash +git add src/pages/assets/import-shared.tsx +git commit -m "refactor: wire import button directly to handleImportAll, fetch albums on sharedData load" +``` + +--- + +### Task 2: Add inline Destination card + +**Files:** +- Modify: `src/pages/assets/import-shared.tsx` + +**Step 1: Find the insertion point** + +In the JSX return, inside the `
` element, there is: +- An album details `` rendered when `sharedData` is set +- A gallery `` rendered when `sharedData && albumDetails` + +Insert the Destination card between them — after the album details card, before the gallery card. It should only render when `sharedData && albumDetails` (same condition as the gallery). + +**Step 2: Add the Destination card** + +```tsx +{sharedData && albumDetails && ( + + + Destination + + Choose where to save the imported assets in your Immich library. + + + +
+ + + +
+ + {albumImportMode === "album" && ( +
+ + setAlbumNameInput(e.target.value)} + placeholder="Imported shared album" + disabled={importAllLoading} + /> +
+ )} + + {albumImportMode === "existing-album" && ( +
+ + +
+ )} + + {importAllLoading && jobProgress && ( +

+ {jobProgress.uploaded + jobProgress.skipped} / {jobProgress.total} processed + {jobProgress.failed > 0 && ` · ${jobProgress.failed} failed`} +

+ )} +
+
+)} +``` + +**Step 3: Commit** + +```bash +git add src/pages/assets/import-shared.tsx +git commit -m "feat: add inline destination card for album selection on import-shared screen" +``` + +--- + +### Task 3: Remove the import Dialog + +**Files:** +- Modify: `src/pages/assets/import-shared.tsx` + +The import Dialog (open/close controlled by `importAllDialogOpen`) now needs to be removed. The video and image preview Dialogs must be kept — do not touch those. + +**Step 1: Remove the import Dialog JSX** + +Delete the entire Dialog block that starts with: +```tsx + + + ... + + +``` + +It ends just before the video preview Dialog (``). + +**Step 2: Remove unused Dialog imports if any** + +Check the import statement at the top. The `Dialog`, `DialogContent`, `DialogHeader`, `DialogTitle`, `DialogDescription` components are still used by the video and image preview dialogs — keep them. No imports need removing. + +**Step 3: Verify the progress counter is gone from the dialog (it was moved to the Destination card in Task 2)** + +Confirm no duplicate progress `

` exists. + +**Step 4: Commit** + +```bash +git add src/pages/assets/import-shared.tsx +git commit -m "refactor: remove import dialog, destination selection is now inline" +``` + +--- + +## Done + +After Task 3: +- Album destination (create / existing / none) is visible on the screen without clicking anything +- The import button calls `handleImportAll` directly +- Progress shows inline in the Destination card while importing +- The import Dialog is gone +- No backend changes From 4732688fa2368a02e5c256f9c822a8939c6e7601 Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 21:02:42 +0530 Subject: [PATCH 23/30] refactor: wire import button directly to handleImportAll, fetch albums on sharedData load Co-Authored-By: Claude Sonnet 4.6 --- src/pages/assets/import-shared.tsx | 32 ++++++++++++++++-------------- 1 file changed, 17 insertions(+), 15 deletions(-) diff --git a/src/pages/assets/import-shared.tsx b/src/pages/assets/import-shared.tsx index 34988a7..3b25d6d 100644 --- a/src/pages/assets/import-shared.tsx +++ b/src/pages/assets/import-shared.tsx @@ -159,7 +159,6 @@ export default function ImportSharedPage() { const [previewLoading, setPreviewLoading] = useState(false); const [uploadBanner, setUploadBanner] = useState<{ type: "success" | "error"; message: string } | null>(null); const [importAllLoading, setImportAllLoading] = useState(false); - const [importAllDialogOpen, setImportAllDialogOpen] = useState(false); const [albumImportMode, setAlbumImportMode] = useState<"album" | "no-album" | "existing-album">("album"); const [albumNameInput, setAlbumNameInput] = useState(""); const [selectedAssetIds, setSelectedAssetIds] = useState>(new Set()); @@ -175,10 +174,10 @@ export default function ImportSharedPage() { }, [albumNameInput]); useEffect(() => { - if (importAllDialogOpen) { + if (sharedData) { listAlbums().then(setExistingAlbums).catch(console.error); } - }, [importAllDialogOpen]); + }, [sharedData]); useEffect(() => { if (sharedData?.album?.albumName) { @@ -207,7 +206,6 @@ export default function ImportSharedPage() { clearInterval(interval); setActiveJobId(null); setImportAllLoading(false); - setImportAllDialogOpen(false); let importData: Record = {}; try { @@ -253,7 +251,6 @@ export default function ImportSharedPage() { setSubmittedLink(null); setUploadBanner(null); setImportAllLoading(false); - setImportAllDialogOpen(false); setAlbumImportMode("album"); setAlbumNameInput(""); setSelectedAssetIds(new Set()); @@ -402,7 +399,6 @@ export default function ImportSharedPage() { setPreviewLoading(false); setUploadBanner(null); setImportAllLoading(false); - setImportAllDialogOpen(false); setAlbumImportMode("album"); setAlbumNameInput(""); setSelectedAssetIds(new Set()); @@ -430,16 +426,22 @@ export default function ImportSharedPage() { + + +

+ + {albumImportMode === "album" && ( +
+ + setAlbumNameInput(e.target.value)} + placeholder="Imported shared album" + disabled={importAllLoading} + /> +
+ )} + + {albumImportMode === "existing-album" && ( +
+ + +
+ )} + + {importAllLoading && jobProgress && ( +

+ {jobProgress.uploaded + jobProgress.skipped} / {jobProgress.total} processed + {jobProgress.failed > 0 && ` · ${jobProgress.failed} failed`} +

+ )} + + + )} + {albumDetails && sharedData && ( From 52aff37697143294d73aaecef75c937d1ef3ae05 Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 21:05:32 +0530 Subject: [PATCH 25/30] refactor: remove import dialog, destination selection is now inline Co-Authored-By: Claude Sonnet 4.6 --- src/pages/assets/import-shared.tsx | 122 ----------------------------- 1 file changed, 122 deletions(-) diff --git a/src/pages/assets/import-shared.tsx b/src/pages/assets/import-shared.tsx index e4613e7..afa052c 100644 --- a/src/pages/assets/import-shared.tsx +++ b/src/pages/assets/import-shared.tsx @@ -17,7 +17,6 @@ import { import { Dialog, DialogContent, - DialogDescription, DialogHeader, DialogTitle, } from "@/components/ui/dialog"; @@ -734,127 +733,6 @@ export default function ImportSharedPage() { )} - { - if (importAllLoading) { - return; - } - setImportAllDialogOpen(open); - }} - > - - - {selectedAssetIds.size > 0 ? "Import selected assets" : "Import all assets"} - - Decide whether to create a new Immich album for these imported assets. - - -
-
- -
- - - -
-
- {albumImportMode === "album" && ( -
- - setAlbumNameInput(event.target.value)} - placeholder="Imported shared album" - disabled={importAllLoading} - /> -
- )} - {albumImportMode === "existing-album" && ( -
- - -
- )} -
- {importAllLoading && jobProgress && ( -

- {jobProgress.uploaded + jobProgress.skipped} / {jobProgress.total} processed - {jobProgress.failed > 0 && ` · ${jobProgress.failed} failed`} -

- )} -
- - -
-
-
- { From 48e5f009f0567f87d5671634c789a707b6233e75 Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 21:08:58 +0530 Subject: [PATCH 26/30] feat: merge album details and destination into single card --- src/pages/assets/import-shared.tsx | 176 +++++++++++++++-------------- 1 file changed, 90 insertions(+), 86 deletions(-) diff --git a/src/pages/assets/import-shared.tsx b/src/pages/assets/import-shared.tsx index afa052c..7241049 100644 --- a/src/pages/assets/import-shared.tsx +++ b/src/pages/assets/import-shared.tsx @@ -1,5 +1,5 @@ import React, { FormEvent, useEffect, useRef, useState } from "react"; -import { Loader2 } from "lucide-react"; +import { Calendar, Loader2, Images, User, Clock } from "lucide-react"; import PageLayout from "@/components/layouts/PageLayout"; import Header from "@/components/shared/Header"; import { Button } from "@/components/ui/button"; @@ -489,102 +489,106 @@ export default function ImportSharedPage() { )} {sharedLinkDetails && sharedData && albumDetails && ( - - - {albumDetails.albumName} + + {/* Album identity */} + + {albumDetails.albumName} +
+ + + {albumDetails.assetCount} assets + + {albumDetails.owner?.name && ( + + + {albumDetails.owner.name} + + )} + {albumDetails.startDate && ( + + + {formatDateOnly(albumDetails.startDate)} + {albumDetails.endDate && albumDetails.endDate !== albumDetails.startDate && ( + <> → {formatDateOnly(albumDetails.endDate)} + )} + + )} + {sharedLinkDetails.expiresAt && ( + + + Expires {formatDate(sharedLinkDetails.expiresAt)} + + )} +
- - - {albumDetails && ( - <> - - - - - )} - -
- )} - {sharedData && albumDetails && ( - - - Destination - - Choose where to save the imported assets in your Immich library. - - - -
- - - + {/* Divider */} +
+ + {/* Destination */} + +
+ +
+ {(["album", "existing-album", "no-album"] as const).map((mode, i) => ( + + ))} +
{albumImportMode === "album" && ( -
- - setAlbumNameInput(e.target.value)} - placeholder="Imported shared album" - disabled={importAllLoading} - /> -
+ setAlbumNameInput(e.target.value)} + placeholder="Album name" + disabled={importAllLoading} + /> )} {albumImportMode === "existing-album" && ( -
- - -
+ )} {importAllLoading && jobProgress && ( -

- {jobProgress.uploaded + jobProgress.skipped} / {jobProgress.total} processed - {jobProgress.failed > 0 && ` · ${jobProgress.failed} failed`} -

+
+ +

+ {jobProgress.uploaded + jobProgress.skipped} / {jobProgress.total} processed + {jobProgress.failed > 0 && ( + · {jobProgress.failed} failed + )} +

+
)}
From 37a168cf2f75ba5efe861c0c0bd11c9f1f8b1787 Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 21:10:44 +0530 Subject: [PATCH 27/30] chore: gitignore docs/plans --- .gitignore | 3 + ...26-04-03-import-destination-inline-plan.md | 252 ------ .../2026-04-03-import-destination-inline.md | 40 - docs/plans/2026-04-03-import-queue.md | 784 ------------------ 4 files changed, 3 insertions(+), 1076 deletions(-) delete mode 100644 docs/plans/2026-04-03-import-destination-inline-plan.md delete mode 100644 docs/plans/2026-04-03-import-destination-inline.md delete mode 100644 docs/plans/2026-04-03-import-queue.md diff --git a/.gitignore b/.gitignore index 315d974..fcdd3c9 100644 --- a/.gitignore +++ b/.gitignore @@ -40,4 +40,7 @@ yarn-error.log* *.tsbuildinfo next-env.d.ts +# plans +/docs/plans + .env \ No newline at end of file diff --git a/docs/plans/2026-04-03-import-destination-inline-plan.md b/docs/plans/2026-04-03-import-destination-inline-plan.md deleted file mode 100644 index d342acb..0000000 --- a/docs/plans/2026-04-03-import-destination-inline-plan.md +++ /dev/null @@ -1,252 +0,0 @@ -# Import Destination Inline Implementation Plan - -> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. - -**Goal:** Move album destination selection from a dialog into an inline card on the import-shared screen, between the album details card and the gallery card. - -**Architecture:** All changes are in a single file (`src/pages/assets/import-shared.tsx`). Remove `importAllDialogOpen` state and its Dialog component. Add a Destination card rendered inline when `sharedData && albumDetails`. The import button in the header calls `handleImportAll` directly. No backend changes needed. - -**Tech Stack:** React, Next.js, shadcn/ui (Card, Button, Input, Select, Label) - ---- - -### Task 1: Remove dialog state, update fetch trigger, wire import button directly - -**Files:** -- Modify: `src/pages/assets/import-shared.tsx` - -All changes are in one file. Read it fully before starting. - -**Step 1: Remove `importAllDialogOpen` state** - -Delete this line (~line 162): -```typescript -const [importAllDialogOpen, setImportAllDialogOpen] = useState(false); -``` - -**Step 2: Update the albums fetch effect** - -The current effect fetches albums when the dialog opens. Change it to fetch when `sharedData` loads instead: - -```typescript -// BEFORE -useEffect(() => { - if (importAllDialogOpen) { - listAlbums().then(setExistingAlbums).catch(console.error); - } -}, [importAllDialogOpen]); - -// AFTER -useEffect(() => { - if (sharedData) { - listAlbums().then(setExistingAlbums).catch(console.error); - } -}, [sharedData]); -``` - -**Step 3: Update the Back button handler** - -Remove `setImportAllDialogOpen(false)` from the Back button's onClick (it's one of the reset lines in the Header `leftComponent`). - -**Step 4: Update the import button in the Header rightComponent** - -Replace the current onClick (which opens the dialog) with a direct `handleImportAll` call: - -```tsx - -``` - -Also remove the `setAlbumImportMode("album")` reset that was in the old onClick — the inline card owns the mode state now. - -**Step 5: Commit** - -```bash -git add src/pages/assets/import-shared.tsx -git commit -m "refactor: wire import button directly to handleImportAll, fetch albums on sharedData load" -``` - ---- - -### Task 2: Add inline Destination card - -**Files:** -- Modify: `src/pages/assets/import-shared.tsx` - -**Step 1: Find the insertion point** - -In the JSX return, inside the `
` element, there is: -- An album details `` rendered when `sharedData` is set -- A gallery `` rendered when `sharedData && albumDetails` - -Insert the Destination card between them — after the album details card, before the gallery card. It should only render when `sharedData && albumDetails` (same condition as the gallery). - -**Step 2: Add the Destination card** - -```tsx -{sharedData && albumDetails && ( - - - Destination - - Choose where to save the imported assets in your Immich library. - - - -
- - - -
- - {albumImportMode === "album" && ( -
- - setAlbumNameInput(e.target.value)} - placeholder="Imported shared album" - disabled={importAllLoading} - /> -
- )} - - {albumImportMode === "existing-album" && ( -
- - -
- )} - - {importAllLoading && jobProgress && ( -

- {jobProgress.uploaded + jobProgress.skipped} / {jobProgress.total} processed - {jobProgress.failed > 0 && ` · ${jobProgress.failed} failed`} -

- )} -
-
-)} -``` - -**Step 3: Commit** - -```bash -git add src/pages/assets/import-shared.tsx -git commit -m "feat: add inline destination card for album selection on import-shared screen" -``` - ---- - -### Task 3: Remove the import Dialog - -**Files:** -- Modify: `src/pages/assets/import-shared.tsx` - -The import Dialog (open/close controlled by `importAllDialogOpen`) now needs to be removed. The video and image preview Dialogs must be kept — do not touch those. - -**Step 1: Remove the import Dialog JSX** - -Delete the entire Dialog block that starts with: -```tsx - - - ... - - -``` - -It ends just before the video preview Dialog (``). - -**Step 2: Remove unused Dialog imports if any** - -Check the import statement at the top. The `Dialog`, `DialogContent`, `DialogHeader`, `DialogTitle`, `DialogDescription` components are still used by the video and image preview dialogs — keep them. No imports need removing. - -**Step 3: Verify the progress counter is gone from the dialog (it was moved to the Destination card in Task 2)** - -Confirm no duplicate progress `

` exists. - -**Step 4: Commit** - -```bash -git add src/pages/assets/import-shared.tsx -git commit -m "refactor: remove import dialog, destination selection is now inline" -``` - ---- - -## Done - -After Task 3: -- Album destination (create / existing / none) is visible on the screen without clicking anything -- The import button calls `handleImportAll` directly -- Progress shows inline in the Destination card while importing -- The import Dialog is gone -- No backend changes diff --git a/docs/plans/2026-04-03-import-destination-inline.md b/docs/plans/2026-04-03-import-destination-inline.md deleted file mode 100644 index 861a2a3..0000000 --- a/docs/plans/2026-04-03-import-destination-inline.md +++ /dev/null @@ -1,40 +0,0 @@ -# Import Destination Inline Design - -**Date:** 2026-04-03 - -## Goal - -Show album destination selection inline on the import-shared screen rather than inside a dialog, so users can set their target album before browsing and importing. - -## Design - -A "Destination" card is inserted between the album details card and the gallery card. It is only rendered when `sharedData` is loaded. The import dialog is removed entirely. - -### Layout - -``` -[Album Details Card] -[Destination Card] ← new - Destination: [Create new album] [Existing Album] [No Album] - Album name: [____________] ← shown when "Create new album" selected - Select album: [dropdown ] ← shown when "Existing Album" selected - Progress: X / Y processed · Z failed ← shown while importing -[Gallery Card] -``` - -### Behaviour changes - -- The "Import all" / "Import selected (N)" header button calls `handleImportAll` directly without opening a dialog -- `importAllDialogOpen` state and the Dialog component are removed -- Album options are read from existing state: `albumImportMode`, `albumNameInput`, `selectedAlbumId` -- `existingAlbums` is fetched when `sharedData` loads (moved from `importAllDialogOpen` effect) -- Progress counter moves into the Destination card while importing -- Upload banner stays in the gallery card - -### No backend changes - -The `albumOptions` shape passed to `createImportJob` is unchanged. - -## Files changed - -- `src/pages/assets/import-shared.tsx` — only file touched diff --git a/docs/plans/2026-04-03-import-queue.md b/docs/plans/2026-04-03-import-queue.md deleted file mode 100644 index 4e7dfef..0000000 --- a/docs/plans/2026-04-03-import-queue.md +++ /dev/null @@ -1,784 +0,0 @@ -# Import Queue Implementation Plan - -> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task. - -**Goal:** Replace the synchronous fire-and-wait import with a SQLite-backed job queue so imports survive page closes and show live progress via polling. - -**Architecture:** A job is created in SQLite on request, a background worker processes items concurrently (4 at a time) and writes per-item status back to the db. The frontend polls a status endpoint every 2s. Platform-specific logic is encapsulated in processor classes so Nextcloud/PhotoPrism can be added by dropping in a new file. On server restart, any stuck `processing` jobs are reset to `pending` and restarted when the user's next poll hits the status endpoint. - -**Tech Stack:** Drizzle ORM + libsql (SQLite), Next.js API routes, TypeScript, React (polling via `useEffect` + `setInterval`) - ---- - -### Task 1: Add schema tables - -**Files:** -- Create: `src/db/schema/importJobs.schema.ts` -- Modify: `src/db/schema/index.ts` - -**Step 1: Create the schema file** - -```typescript -// src/db/schema/importJobs.schema.ts -import { sqliteTable, text, integer } from "drizzle-orm/sqlite-core"; -import { randomUUID } from "crypto"; - -export const importJobs = sqliteTable("import_jobs", { - id: text("id").primaryKey().$defaultFn(() => randomUUID()), - userId: text("user_id").notNull(), - platform: text("platform").notNull(), // 'immich' | 'nextcloud' | 'photoprism' - status: text("status").notNull().default("pending"), // pending | processing | completed | failed - url: text("url").notNull(), // base URL of source - urlConfig: text("url_config").notNull().default("{}"), // JSON: auth/connection (key, token, etc.) - importData: text("import_data").notNull().default("{}"), // JSON: album options, resolved albumId, etc. - totalCount: integer("total_count").notNull().default(0), - uploadedCount: integer("uploaded_count").notNull().default(0), - skippedCount: integer("skipped_count").notNull().default(0), - failedCount: integer("failed_count").notNull().default(0), - createdAt: integer("created_at", { mode: "timestamp" }).$defaultFn(() => new Date()), - updatedAt: integer("updated_at", { mode: "timestamp" }) - .$defaultFn(() => new Date()) - .$onUpdate(() => new Date()), -}); - -export const importJobItems = sqliteTable("import_job_items", { - id: text("id").primaryKey().$defaultFn(() => randomUUID()), - jobId: text("job_id").notNull().references(() => importJobs.id), - assetId: text("asset_id").notNull(), // source platform's asset ID - status: text("status").notNull().default("pending"), // pending | processing | uploaded | skipped | failed - itemData: text("item_data").notNull().default("{}"), // JSON: filename, type, dates, isFavorite, etc. - immichId: text("immich_id"), // Immich asset ID after successful upload - error: text("error"), - createdAt: integer("created_at", { mode: "timestamp" }).$defaultFn(() => new Date()), - updatedAt: integer("updated_at", { mode: "timestamp" }) - .$defaultFn(() => new Date()) - .$onUpdate(() => new Date()), -}); -``` - -**Step 2: Export from schema index** - -In `src/db/schema/index.ts`, add: -```typescript -export * from "./importJobs.schema"; -``` - -**Step 3: Commit** - -```bash -git add src/db/schema/importJobs.schema.ts src/db/schema/index.ts -git commit -m "feat: add import_jobs and import_job_items schema tables" -``` - ---- - -### Task 2: Generate and apply migration - -**Files:** -- Create: `src/db/migrations/` (auto-generated by drizzle-kit) - -**Step 1: Generate migration** - -```bash -bun run db:generate -``` - -Expected: a new `.sql` file appears in `src/db/migrations/` containing `CREATE TABLE import_jobs` and `CREATE TABLE import_job_items`. - -**Step 2: Verify migration SQL looks correct** - -Open the generated file and confirm it has both tables with all columns. No manual edits needed. - -**Step 3: Test that migrations run** - -```bash -bun run dev -``` - -Expected: server starts without errors. The migration auto-runs via `instrumentation.ts → runMigrations()`. - -**Step 4: Commit** - -```bash -git add src/db/migrations/ -git commit -m "feat: add migration for import_jobs and import_job_items" -``` - ---- - -### Task 3: Processor interface and registry - -**Files:** -- Create: `src/workers/import/types.ts` -- Create: `src/workers/import/registry.ts` - -**Step 1: Define the processor interface** - -```typescript -// src/workers/import/types.ts -import type { importJobs, importJobItems } from "@/db/schema"; - -export type ImportJob = typeof importJobs.$inferSelect; -export type ImportJobItem = typeof importJobItems.$inferSelect; - -export interface ProcessorContext { - headers: Record; // user auth headers for Immich API calls - albumId?: string; // resolved after setup() -} - -export interface SetupResult { - skipAssetIds: string[]; // source asset IDs already in Immich → mark skipped - albumId?: string; // created or resolved album ID - importDataPatch?: Record; // merged into job.importData in db -} - -export interface ImportProcessor { - /** Called once per job before items are processed. Dedup + album creation. */ - setup(job: ImportJob, context: ProcessorContext): Promise; - /** Called once per item. Returns the Immich asset ID on success, throws on failure. */ - processItem(job: ImportJob, item: ImportJobItem, context: ProcessorContext): Promise<{ immichId: string }>; -} -``` - -**Step 2: Create the registry** - -```typescript -// src/workers/import/registry.ts -import type { ImportProcessor } from "./types"; - -const processors = new Map(); - -export function registerProcessor(platform: string, processor: ImportProcessor) { - processors.set(platform, processor); -} - -export function getProcessor(platform: string): ImportProcessor { - const processor = processors.get(platform); - if (!processor) { - throw new Error(`No import processor registered for platform: ${platform}`); - } - return processor; -} -``` - -**Step 3: Commit** - -```bash -git add src/workers/import/types.ts src/workers/import/registry.ts -git commit -m "feat: add import processor interface and registry" -``` - ---- - -### Task 4: Immich shared-link processor - -**Files:** -- Create: `src/workers/import/processors/immich-shared-link.ts` - -This extracts the core download/upload logic from `src/pages/api/import-shared/upload-all.ts` into the processor interface. The helpers (`downloadSharedAsset`, `uploadAssetBuffer`, `createImmichAlbum`, `addAssetToAlbum`, `ensurePowerToolsTag`) already exist in `upload-all.ts` and `helpers.ts` — copy/import them as needed. - -**Step 1: Create the processor** - -```typescript -// src/workers/import/processors/immich-shared-link.ts -import { ENV } from "@/config/environment"; -import { - ensurePowerToolsTag, - tagAssetWithPowerTools, - type HeadersRecord, -} from "@/pages/api/import-shared/helpers"; -import type { ImportJob, ImportJobItem, ImportProcessor, ProcessorContext, SetupResult } from "../types"; - -// --- helpers copied/imported from upload-all.ts --- -// (parseFileNameFromDisposition, guessContentType, inferAssetTypeFromName, -// downloadSharedAsset, uploadAssetBuffer, createImmichAlbum, addAssetToAlbum) -// Copy them here verbatim from upload-all.ts so upload-all.ts stays intact. - -const DEVICE_ID = "immich-power-tools"; -const makeDeviceAssetId = (assetId: string) => `shared-${assetId}`; - -export class ImmichSharedLinkProcessor implements ImportProcessor { - async setup(job: ImportJob, context: ProcessorContext): Promise { - const urlConfig = JSON.parse(job.urlConfig) as { key: string }; - const items = await getJobItems(job.id); // helper defined in runner.ts, passed via closure or import - const deviceAssetIds = items.map((i) => makeDeviceAssetId(i.assetId)); - const lookup = new Map(items.map((i) => [makeDeviceAssetId(i.assetId).toLowerCase(), i.assetId])); - - const skipAssetIds: string[] = []; - try { - const res = await fetch(`${ENV.IMMICH_URL}/api/assets/exist`, { - method: "POST", - headers: { ...context.headers, "Content-Type": "application/json" }, - body: JSON.stringify({ deviceAssetIds, deviceId: DEVICE_ID }), - }); - if (res.ok) { - const { existingIds = [] } = await res.json(); - for (const id of existingIds) { - const assetId = lookup.get(id.toLowerCase()); - if (assetId) skipAssetIds.push(assetId); - } - } - } catch (e) { - console.warn("Dedup check failed, continuing without it", e); - } - - const importData = JSON.parse(job.importData) as { - albumOptions?: { createAlbum?: boolean; albumName?: string; addToAlbumId?: string }; - albumId?: string; - }; - - let albumId: string | undefined; - const albumOptions = importData.albumOptions; - if (albumOptions?.createAlbum) { - const name = albumOptions.albumName?.trim() || `Shared import ${new Date().toISOString()}`; - albumId = await createImmichAlbum(name, { - ...context.headers, - "Content-Type": "application/json", - } as HeadersRecord); - } else if (albumOptions?.addToAlbumId) { - albumId = albumOptions.addToAlbumId; - } - - return { skipAssetIds, albumId, importDataPatch: albumId ? { albumId } : undefined }; - } - - async processItem(job: ImportJob, item: ImportJobItem, context: ProcessorContext): Promise<{ immichId: string }> { - const urlConfig = JSON.parse(job.urlConfig) as { key: string }; - const itemData = JSON.parse(item.itemData) as { - originalFileName?: string; - type: string; - fileCreatedAt?: string | null; - localDateTime?: string | null; - duration?: string | null; - isFavorite?: boolean; - isArchived?: boolean; - }; - - const asset = { id: item.assetId, ...itemData }; - const { ["Content-Type"]: _omit, ...uploadHeaders } = context.headers as HeadersRecord; - - const downloaded = await downloadSharedAsset(asset, job.url, urlConfig.key); - const tag = await ensurePowerToolsTag(context.headers as HeadersRecord); - const immichId = await uploadAssetBuffer( - asset, - downloaded, - uploadHeaders as HeadersRecord, - context.headers as HeadersRecord, - tag.id - ); - - if (context.albumId) { - await addAssetToAlbum(context.albumId, immichId, { - ...context.headers, - "Content-Type": "application/json", - } as HeadersRecord); - } - - return { immichId }; - } -} -``` - -**Step 2: Register the processor** - -Create `src/workers/import/processors/index.ts`: -```typescript -import { registerProcessor } from "../registry"; -import { ImmichSharedLinkProcessor } from "./immich-shared-link"; - -registerProcessor("immich", new ImmichSharedLinkProcessor()); -``` - -**Step 3: Commit** - -```bash -git add src/workers/import/processors/ -git commit -m "feat: add immich shared-link import processor" -``` - ---- - -### Task 5: Worker runner - -**Files:** -- Create: `src/workers/import/runner.ts` - -The runner owns the active-job tracking (in-memory Set), processes items concurrently, and updates the db after each item. - -**Step 1: Create the runner** - -```typescript -// src/workers/import/runner.ts -import { eq, inArray } from "drizzle-orm"; -import { appDb } from "@/db"; -import { importJobs, importJobItems } from "@/db/schema"; -import { getProcessor } from "./registry"; -import "./processors/index"; // side-effect: registers all processors - -export type { ImportJob, ImportJobItem } from "./types"; - -const activeJobs = new Set(); -const CONCURRENCY = 4; - -export function isJobActive(jobId: string) { - return activeJobs.has(jobId); -} - -export async function getJobItems(jobId: string) { - return appDb.select().from(importJobItems).where(eq(importJobItems.jobId, jobId)); -} - -export async function resumePendingJobs() { - // Reset any jobs stuck in 'processing' from a previous crashed run - await appDb - .update(importJobs) - .set({ status: "pending" }) - .where(eq(importJobs.status, "processing")); -} - -export async function runImportJob( - jobId: string, - headers: Record -): Promise { - if (activeJobs.has(jobId)) return; - activeJobs.add(jobId); - - try { - const [job] = await appDb.select().from(importJobs).where(eq(importJobs.id, jobId)); - if (!job || job.status === "completed" || job.status === "failed") return; - - await appDb.update(importJobs).set({ status: "processing" }).where(eq(importJobs.id, jobId)); - - const processor = getProcessor(job.platform); - const context = { headers }; - - // --- Setup: dedup + album creation --- - const { skipAssetIds, albumId, importDataPatch } = await processor.setup(job, context); - - if (importDataPatch) { - const merged = { ...JSON.parse(job.importData), ...importDataPatch }; - await appDb.update(importJobs).set({ importData: JSON.stringify(merged) }).where(eq(importJobs.id, jobId)); - } - - if (skipAssetIds.length > 0) { - await appDb - .update(importJobItems) - .set({ status: "skipped" }) - .where(inArray(importJobItems.assetId, skipAssetIds)); - await appDb - .update(importJobs) - .set({ skippedCount: skipAssetIds.length }) - .where(eq(importJobs.id, jobId)); - } - - const processorContext = { ...context, albumId }; - const pendingItems = await appDb - .select() - .from(importJobItems) - .where(eq(importJobItems.status, "pending")); - - // --- Concurrent item processing --- - let idx = 0; - const worker = async () => { - while (true) { - const item = pendingItems[idx++]; - if (!item) break; - - await appDb - .update(importJobItems) - .set({ status: "processing" }) - .where(eq(importJobItems.id, item.id)); - - try { - const { immichId } = await processor.processItem(job, item, processorContext); - await appDb - .update(importJobItems) - .set({ status: "uploaded", immichId }) - .where(eq(importJobItems.id, item.id)); - await appDb - .update(importJobs) - .set({ uploadedCount: job.uploadedCount + 1 }) - .where(eq(importJobs.id, jobId)); - } catch (err: any) { - await appDb - .update(importJobItems) - .set({ status: "failed", error: err?.message ?? "Unknown error" }) - .where(eq(importJobItems.id, item.id)); - await appDb - .update(importJobs) - .set({ failedCount: job.failedCount + 1 }) - .where(eq(importJobs.id, jobId)); - } - } - }; - - const concurrency = Math.min(CONCURRENCY, pendingItems.length); - await Promise.all(Array.from({ length: concurrency }, worker)); - - await appDb - .update(importJobs) - .set({ status: "completed" }) - .where(eq(importJobs.id, jobId)); - } catch (err: any) { - console.error(`Import job ${jobId} failed fatally:`, err); - await appDb - .update(importJobs) - .set({ status: "failed" }) - .where(eq(importJobs.id, jobId)); - } finally { - activeJobs.delete(jobId); - } -} -``` - -**Step 2: Commit** - -```bash -git add src/workers/import/runner.ts -git commit -m "feat: add import job worker runner with concurrency and db tracking" -``` - ---- - -### Task 6: Update instrumentation.ts for startup resume - -**Files:** -- Modify: `instrumentation.ts` - -**Step 1: Add resume call** - -```typescript -// instrumentation.ts -export async function register() { - if (process.env.NEXT_RUNTIME === "nodejs") { - const { runMigrations } = await import("./src/db"); - await runMigrations(); - - const { resumePendingJobs } = await import("./src/workers/import/runner"); - await resumePendingJobs(); - } -} -``` - -`resumePendingJobs` only resets `processing → pending`; it doesn't start workers (no user headers available at boot). Workers restart on next poll. - -**Step 2: Commit** - -```bash -git add instrumentation.ts -git commit -m "feat: reset stuck import jobs to pending on startup" -``` - ---- - -### Task 7: Job creation API endpoint - -**Files:** -- Create: `src/pages/api/import-jobs/index.ts` - -**Step 1: Create the endpoint** - -```typescript -// src/pages/api/import-jobs/index.ts -import type { NextApiRequest, NextApiResponse } from "next"; -import { appDb } from "@/db"; -import { importJobs, importJobItems } from "@/db/schema"; -import { getCurrentUser } from "@/handlers/serverUtils/user.utils"; -import { getUserHeaders } from "@/helpers/user.helper"; -import { runImportJob } from "@/workers/import/runner"; - -export default async function handler(req: NextApiRequest, res: NextApiResponse) { - if (req.method !== "POST") { - res.setHeader("Allow", "POST"); - return res.status(405).json({ error: "Method Not Allowed" }); - } - - const currentUser = await getCurrentUser(req); - if (!currentUser) return res.status(401).json({ error: "Unauthorized" }); - - const { platform, url, urlConfig, importData, assets } = req.body; - - if (!platform || !url || !Array.isArray(assets) || assets.length === 0) { - return res.status(400).json({ error: "platform, url, and assets are required" }); - } - - // Create job row - const [job] = await appDb - .insert(importJobs) - .values({ - userId: currentUser.id, - platform, - url, - urlConfig: JSON.stringify(urlConfig ?? {}), - importData: JSON.stringify(importData ?? {}), - totalCount: assets.length, - }) - .returning(); - - // Create one item row per asset - await appDb.insert(importJobItems).values( - assets.map((asset: { id: string; [key: string]: unknown }) => ({ - jobId: job.id, - assetId: asset.id, - itemData: JSON.stringify(asset), - })) - ); - - // Fire-and-forget: start the worker without awaiting - const headers = getUserHeaders(currentUser) as Record; - runImportJob(job.id, headers).catch((err) => - console.error("Unhandled error in runImportJob", err) - ); - - return res.status(201).json({ jobId: job.id }); -} -``` - -**Step 2: Commit** - -```bash -git add src/pages/api/import-jobs/index.ts -git commit -m "feat: add POST /api/import-jobs endpoint to create and enqueue import jobs" -``` - ---- - -### Task 8: Job status polling endpoint - -**Files:** -- Create: `src/pages/api/import-jobs/[jobId].ts` - -**Step 1: Create the endpoint** - -```typescript -// src/pages/api/import-jobs/[jobId].ts -import type { NextApiRequest, NextApiResponse } from "next"; -import { eq } from "drizzle-orm"; -import { appDb } from "@/db"; -import { importJobs, importJobItems } from "@/db/schema"; -import { getCurrentUser } from "@/handlers/serverUtils/user.utils"; -import { getUserHeaders } from "@/helpers/user.helper"; -import { isJobActive, runImportJob } from "@/workers/import/runner"; - -export default async function handler(req: NextApiRequest, res: NextApiResponse) { - if (req.method !== "GET") { - res.setHeader("Allow", "GET"); - return res.status(405).json({ error: "Method Not Allowed" }); - } - - const currentUser = await getCurrentUser(req); - if (!currentUser) return res.status(401).json({ error: "Unauthorized" }); - - const { jobId } = req.query as { jobId: string }; - - const [job] = await appDb.select().from(importJobs).where(eq(importJobs.id, jobId)); - if (!job || job.userId !== currentUser.id) { - return res.status(404).json({ error: "Job not found" }); - } - - // Auto-resume: if job is pending but has no active worker (e.g. after server restart) - if (job.status === "pending" && !isJobActive(jobId)) { - const headers = getUserHeaders(currentUser) as Record; - runImportJob(jobId, headers).catch((err) => - console.error("Unhandled error in runImportJob (resume)", err) - ); - } - - const items = await appDb - .select() - .from(importJobItems) - .where(eq(importJobItems.jobId, jobId)); - - return res.status(200).json({ job, items }); -} -``` - -**Step 2: Commit** - -```bash -git add src/pages/api/import-jobs/[jobId].ts -git commit -m "feat: add GET /api/import-jobs/[jobId] polling endpoint with auto-resume" -``` - ---- - -### Task 9: Route constants and client handler - -**Files:** -- Modify: `src/config/routes.ts` -- Create: `src/handlers/api/import-jobs.handler.ts` - -**Step 1: Add routes** - -In `src/config/routes.ts`, append: -```typescript -// Import Jobs (queue) -export const IMPORT_JOBS_PATH = BASE_API_ENDPOINT + "/import-jobs"; -export const IMPORT_JOB_PATH = (jobId: string) => BASE_API_ENDPOINT + "/import-jobs/" + jobId; -``` - -**Step 2: Create handler** - -```typescript -// src/handlers/api/import-jobs.handler.ts -import { IMPORT_JOBS_PATH, IMPORT_JOB_PATH } from "@/config/routes"; -import API from "@/lib/api"; - -export interface CreateImportJobParams { - platform: string; - url: string; - urlConfig: Record; - importData: Record; - assets: { id: string; [key: string]: unknown }[]; -} - -export const createImportJob = async (params: CreateImportJobParams): Promise<{ jobId: string }> => { - return API.post(IMPORT_JOBS_PATH, params); -}; - -export const getImportJob = async (jobId: string) => { - return API.get(IMPORT_JOB_PATH(jobId)); -}; -``` - -**Step 3: Commit** - -```bash -git add src/config/routes.ts src/handlers/api/import-jobs.handler.ts -git commit -m "feat: add import-jobs route constants and client handler" -``` - ---- - -### Task 10: Update frontend to use job queue + polling - -**Files:** -- Modify: `src/pages/assets/import-shared.tsx` - -**Step 1: Add state for active job** - -In the component state block, add: -```typescript -const [activeJobId, setActiveJobId] = useState(null); -const [jobProgress, setJobProgress] = useState<{ uploaded: number; skipped: number; failed: number; total: number } | null>(null); -``` - -**Step 2: Replace `handleImportAll` body** - -Replace the `importSharedUploadAll(...)` call block with: - -```typescript -const job = await createImportJob({ - platform: "immich", - url: sharedData.origin, - urlConfig: { key: sharedData.key }, - importData: { albumOptions }, - assets: uploadableAssets.map((asset) => ({ - id: asset.id, - originalFileName: asset.originalFileName, - type: asset.type, - fileCreatedAt: asset.fileCreatedAt ?? null, - localDateTime: asset.localDateTime ?? null, - duration: asset.duration ?? null, - isFavorite: asset.isFavorite ?? false, - isArchived: asset.isArchived ?? false, - })), -}); -setActiveJobId(job.jobId); -setJobProgress({ uploaded: 0, skipped: 0, failed: 0, total: uploadableAssets.length }); -// importAllLoading stays true while polling -``` - -Remove the old result-parsing and banner-setting code from `handleImportAll` — that moves to the polling effect below. - -**Step 3: Add polling effect** - -```typescript -useEffect(() => { - if (!activeJobId) return; - - const interval = setInterval(async () => { - try { - const { job, items } = await getImportJob(activeJobId); - setJobProgress({ - uploaded: job.uploadedCount, - skipped: job.skippedCount, - failed: job.failedCount, - total: job.totalCount, - }); - - if (job.status === "completed" || job.status === "failed") { - clearInterval(interval); - setActiveJobId(null); - setImportAllLoading(false); - - const importData = JSON.parse(job.importData); - const failedCount = job.failedCount; - const skippedCount = job.skippedCount; - const uploadedCount = job.uploadedCount; - let bannerType: "success" | "error" = failedCount ? "error" : "success"; - let message: string; - - if (!uploadedCount && skippedCount && !failedCount) { - message = `All ${skippedCount} assets already exist on Immich.`; - } else if (failedCount) { - const skippedSuffix = skippedCount ? `, ${skippedCount} skipped` : ""; - message = `Imported ${uploadedCount} assets, ${failedCount} failed${skippedSuffix}.`; - } else if (skippedCount) { - message = `Imported ${uploadedCount} assets, skipped ${skippedCount} already on Immich.`; - } else { - message = `Imported ${uploadedCount} assets successfully.`; - } - - if (importData.albumId && uploadedCount > 0) { - const albumName = options.albumName || "selected album"; - message = `${message} Added to album "${albumName}".`; - } - - setUploadBanner({ type: bannerType, message }); - } - } catch (err) { - console.error("Polling error", err); - } - }, 2000); - - return () => clearInterval(interval); -}, [activeJobId]); -``` - -**Step 4: Update the progress UI** - -Replace the spinner/loading button text with a live counter when `jobProgress` is set: - -```tsx -{importAllLoading && jobProgress && ( -

- {jobProgress.uploaded + jobProgress.skipped} / {jobProgress.total} processed - {jobProgress.failed > 0 && ` · ${jobProgress.failed} failed`} -

-)} -``` - -**Step 5: Add imports at the top of the file** - -```typescript -import { createImportJob, getImportJob } from "@/handlers/api/import-jobs.handler"; -``` - -**Step 6: Commit** - -```bash -git add src/pages/assets/import-shared.tsx -git commit -m "feat: migrate import-shared to job queue with live progress polling" -``` - ---- - -## Done - -At this point: -- Imports are non-blocking: the page can be navigated away and the import continues server-side -- Progress is visible: `X / Y processed` updates every 2s -- Server restarts are handled: `instrumentation.ts` resets stuck jobs; next poll auto-resumes -- New platforms (Nextcloud, PhotoPrism) only need a new processor file + `registerProcessor` call in `processors/index.ts` -- The old `/api/import-shared/upload-all` endpoint is untouched and can be removed in a follow-up From 5169ae3ebdcf15ff32c8f439b19bb7e472567e86 Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 21:13:17 +0530 Subject: [PATCH 28/30] fix: copy migration files into Docker runner image for standalone output Co-Authored-By: Claude Sonnet 4.6 --- Dockerfile | 1 + 1 file changed, 1 insertion(+) diff --git a/Dockerfile b/Dockerfile index a6992f3..8e8bad8 100644 --- a/Dockerfile +++ b/Dockerfile @@ -42,6 +42,7 @@ COPY --from=builder /app/package.json ./package.json # https://nextjs.org/docs/advanced-features/output-file-tracing COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./ COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static +COPY --from=builder --chown=nextjs:nodejs /app/src/db/migrations ./src/db/migrations USER nextjs From 550199d4f1127e8ba65681cc9e2be778d62e8fb3 Mon Sep 17 00:00:00 2001 From: Varun Date: Fri, 3 Apr 2026 21:51:00 +0530 Subject: [PATCH 29/30] fix: make migrations and job queue work in Docker standalone build MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Move instrumentation.ts to src/ so Next.js picks it up (required when using src/ layout) - Enable experimental.instrumentationHook in next.config.mjs (required in Next.js 14) - Switch Dockerfile deps stage from npm to bun to match lockfile - Explicitly copy @libsql and libsql into standalone runner — Next.js file tracing misses dynamically required native modules (require(`@libsql/${target}`)) Co-Authored-By: Claude Sonnet 4.6 --- Dockerfile | 17 +++++++++-------- next.config.mjs | 3 +++ instrumentation.ts => src/instrumentation.ts | 4 ++-- 3 files changed, 14 insertions(+), 10 deletions(-) rename instrumentation.ts => src/instrumentation.ts (61%) diff --git a/Dockerfile b/Dockerfile index 8e8bad8..712cfed 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,13 +1,10 @@ # Source: https://github.com/vercel/next.js/blob/canary/examples/with-docker/README.md # Install dependencies only when needed -FROM node:22-alpine AS deps -# Check https://github.com/nodejs/docker-node/tree/b4117f9333da4138b03a546ec926ef50a31506c3#nodealpine to understand why libc6-compat might be needed. - -RUN apk add --no-cache libc6-compat +FROM oven/bun:1-alpine AS deps WORKDIR /app -COPY package.json ./ -RUN npm install --frozen-lockfile +COPY package.json bun.lockb ./ +RUN bun install --frozen-lockfile # Rebuild the source code only when needed FROM node:22-alpine AS builder @@ -38,12 +35,16 @@ RUN adduser -S nextjs -u 1001 COPY --from=builder /app/public ./public COPY --from=builder /app/package.json ./package.json -# Automatically leverage output traces to reduce image size +# Automatically leverage output traces to reduce image size # https://nextjs.org/docs/advanced-features/output-file-tracing COPY --from=builder --chown=nextjs:nodejs /app/.next/standalone ./ COPY --from=builder --chown=nextjs:nodejs /app/.next/static ./.next/static COPY --from=builder --chown=nextjs:nodejs /app/src/db/migrations ./src/db/migrations +# Copy native libsql binaries — Next.js standalone tracing misses dynamically required native modules +COPY --from=deps --chown=nextjs:nodejs /app/node_modules/@libsql ./node_modules/@libsql +COPY --from=deps --chown=nextjs:nodejs /app/node_modules/libsql ./node_modules/libsql + USER nextjs EXPOSE 3000 @@ -59,4 +60,4 @@ ENV HOSTNAME=0.0.0.0 CMD ["node", "server.js"] -HEALTHCHECK CMD curl --fail http://localhost:3000/api/health || exit 1 \ No newline at end of file +HEALTHCHECK CMD curl --fail http://localhost:3000/api/health || exit 1 diff --git a/next.config.mjs b/next.config.mjs index 65ab7b9..3f1b21a 100644 --- a/next.config.mjs +++ b/next.config.mjs @@ -3,6 +3,9 @@ const nextConfig = { reactStrictMode: false, output: 'standalone', + experimental: { + instrumentationHook: true, + }, images: { unoptimized: true, }, diff --git a/instrumentation.ts b/src/instrumentation.ts similarity index 61% rename from instrumentation.ts rename to src/instrumentation.ts index 496412a..3a733b4 100644 --- a/instrumentation.ts +++ b/src/instrumentation.ts @@ -1,10 +1,10 @@ export async function register() { // Only run on the Node.js server, not in the Edge runtime or client if (process.env.NEXT_RUNTIME === "nodejs") { - const { runMigrations } = await import("./src/db"); + const { runMigrations } = await import("./db"); await runMigrations(); - const { resumePendingJobs } = await import("./src/workers/import/runner"); + const { resumePendingJobs } = await import("./workers/import/runner"); await resumePendingJobs(); } } From da3f865450af07b8bda1d5abc12e682bd6590757 Mon Sep 17 00:00:00 2001 From: Varun Date: Mon, 6 Apr 2026 09:42:42 +0530 Subject: [PATCH 30/30] feat: api key fix and the import status and history dialog Signed-off-by: Varun --- .claude/settings.json | 6 + .../import/ImportJobDetailDialog.tsx | 164 ++++++++++++++++++ src/config/routes.ts | 3 + src/handlers/api/import-jobs.handler.ts | 18 ++ .../api/validate-permissions.handler.ts | 10 ++ src/pages/api/import-jobs/index.ts | 17 +- src/pages/api/validate-permissions.ts | 33 ++++ src/pages/assets/import-shared.tsx | 109 +++++++++++- .../import/processors/immich-shared-link.ts | 27 ++- src/workers/import/runner.ts | 13 +- 10 files changed, 384 insertions(+), 16 deletions(-) create mode 100644 .claude/settings.json create mode 100644 src/components/import/ImportJobDetailDialog.tsx create mode 100644 src/handlers/api/validate-permissions.handler.ts create mode 100644 src/pages/api/validate-permissions.ts diff --git a/.claude/settings.json b/.claude/settings.json new file mode 100644 index 0000000..671a084 --- /dev/null +++ b/.claude/settings.json @@ -0,0 +1,6 @@ +{ + "attribution": { + "commit": "", + "pr": "" + } +} diff --git a/src/components/import/ImportJobDetailDialog.tsx b/src/components/import/ImportJobDetailDialog.tsx new file mode 100644 index 0000000..e1abd74 --- /dev/null +++ b/src/components/import/ImportJobDetailDialog.tsx @@ -0,0 +1,164 @@ +import React from "react"; +import { useQuery } from "@tanstack/react-query"; +import { ExternalLink, Loader2 } from "lucide-react"; +import { + Dialog, + DialogContent, + DialogHeader, + DialogTitle, +} from "@/components/ui/dialog"; +import { getImportJob } from "@/handlers/api/import-jobs.handler"; +import { useConfig } from "@/contexts/ConfigContext"; + +const InfoRow = ({ label, value }: { label: string; value: React.ReactNode }) => ( +
+

{label}

+

{value ?? "—"}

+
+); + +const statusBadge = (status: string) => { + const styles = + status === "uploaded" || status === "completed" + ? "bg-emerald-500/10 text-emerald-600" + : status === "skipped" + ? "bg-amber-500/10 text-amber-600" + : status === "failed" + ? "bg-destructive/10 text-destructive" + : "bg-muted text-muted-foreground"; + + return ( + + {status} + + ); +}; + +interface ImportJobDetailDialogProps { + jobId: string | null; + onClose: () => void; +} + +export default function ImportJobDetailDialog({ jobId, onClose }: ImportJobDetailDialogProps) { + const { exImmichUrl } = useConfig(); + + const { data: detailJob, isLoading } = useQuery({ + queryKey: ["import-job-detail", jobId], + queryFn: () => getImportJob(jobId!), + enabled: !!jobId, + }); + + let dImportData: Record = {}; + let dAlbumOpts: { createAlbum?: boolean; albumName?: string; addToAlbumId?: string } | undefined; + let dError: string | null = null; + let albumId: string | undefined; + + if (detailJob) { + try { + dImportData = JSON.parse(detailJob.job.importData); + } catch { /* ignore */ } + dAlbumOpts = dImportData.albumOptions as typeof dAlbumOpts; + dError = typeof dImportData.error === "string" ? dImportData.error : null; + albumId = typeof dImportData.albumId === "string" ? dImportData.albumId : undefined; + } + + return ( + { if (!open) onClose(); }}> + + {isLoading && ( +
+ +
+ )} + {detailJob && (() => { + const dJob = detailJob.job; + + return ( + <> + + {dAlbumOpts?.albumName || "Import details"} + + +
+ + + + + + + {albumId && ( + + {dAlbumOpts?.albumName || albumId} + + + } /> + )} + {!albumId && dAlbumOpts?.albumName && ( + + )} +
+ + {dError && ( +
+ {dError} +
+ )} + +
+ + + + + + + + + + {detailJob.items.map((item) => { + let itemData: Record = {}; + try { itemData = JSON.parse(item.itemData ?? "{}"); } catch { /* ignore */ } + const fileName = (itemData.originalFileName as string) || item.assetId; + + return ( + + + + + + ); + })} + +
AssetStatusDetails
+ {item.immichId ? ( + e.stopPropagation()} + > + {fileName} + + + ) : ( + fileName + )} + + {statusBadge(item.status)} + + {item.error || "—"} +
+
+ + ); + })()} +
+
+ ); +} diff --git a/src/config/routes.ts b/src/config/routes.ts index 5aebadb..9067511 100644 --- a/src/config/routes.ts +++ b/src/config/routes.ts @@ -96,6 +96,9 @@ export const SHARE_KEY_PATH = BASE_API_ENDPOINT + "/share-key"; export const IMPORT_SHARED_PATH = BASE_API_ENDPOINT + "/import-shared"; export const IMPORT_SHARED_UPLOAD_ALL_PATH = BASE_API_ENDPOINT + "/import-shared/upload-all"; +// Permissions +export const VALIDATE_PERMISSIONS_PATH = BASE_API_ENDPOINT + "/validate-permissions"; + // Import Jobs (queue) export const IMPORT_JOBS_PATH = BASE_API_ENDPOINT + "/import-jobs"; export const IMPORT_JOB_PATH = (jobId: string) => BASE_API_ENDPOINT + "/import-jobs/" + jobId; \ No newline at end of file diff --git a/src/handlers/api/import-jobs.handler.ts b/src/handlers/api/import-jobs.handler.ts index f2c2690..3f27132 100644 --- a/src/handlers/api/import-jobs.handler.ts +++ b/src/handlers/api/import-jobs.handler.ts @@ -13,6 +13,23 @@ export const createImportJob = async (params: CreateImportJobParams): Promise<{ return API.post(IMPORT_JOBS_PATH, params); }; +export interface ImportJobSummary { + id: string; + platform: string; + status: string; + url: string; + importData: string; + totalCount: number; + uploadedCount: number; + skippedCount: number; + failedCount: number; + createdAt: string; +} + +export const listImportJobs = async (): Promise<{ jobs: ImportJobSummary[] }> => { + return API.get(IMPORT_JOBS_PATH); +}; + export interface ImportJobStatus { job: { id: string; @@ -28,6 +45,7 @@ export interface ImportJobStatus { id: string; assetId: string; status: string; + itemData: string; immichId: string | null; error: string | null; }[]; diff --git a/src/handlers/api/validate-permissions.handler.ts b/src/handlers/api/validate-permissions.handler.ts new file mode 100644 index 0000000..c37f59c --- /dev/null +++ b/src/handlers/api/validate-permissions.handler.ts @@ -0,0 +1,10 @@ +import { VALIDATE_PERMISSIONS_PATH } from "@/config/routes"; +import API from "@/lib/api"; + +export interface PermissionsResult { + canUpload: boolean; +} + +export const validatePermissions = async (): Promise => { + return API.get(VALIDATE_PERMISSIONS_PATH); +}; diff --git a/src/pages/api/import-jobs/index.ts b/src/pages/api/import-jobs/index.ts index a1dfe0e..b0c6590 100644 --- a/src/pages/api/import-jobs/index.ts +++ b/src/pages/api/import-jobs/index.ts @@ -1,4 +1,5 @@ import type { NextApiRequest, NextApiResponse } from "next"; +import { desc, eq } from "drizzle-orm"; import { appDb } from "@/db"; import { importJobs, importJobItems } from "@/db/schema"; import { getCurrentUser } from "@/handlers/serverUtils/user.utils"; @@ -7,8 +8,22 @@ import { runImportJob } from "@/workers/import/runner"; import { getProcessor } from "@/workers/import/registry"; export default async function handler(req: NextApiRequest, res: NextApiResponse) { + if (req.method === "GET") { + const currentUser = await getCurrentUser(req); + if (!currentUser) return res.status(401).json({ error: "Unauthorized" }); + + const jobs = await appDb + .select() + .from(importJobs) + .where(eq(importJobs.userId, currentUser.id)) + .orderBy(desc(importJobs.createdAt)) + .limit(20); + + return res.status(200).json({ jobs }); + } + if (req.method !== "POST") { - res.setHeader("Allow", "POST"); + res.setHeader("Allow", "GET, POST"); return res.status(405).json({ error: "Method Not Allowed" }); } diff --git a/src/pages/api/validate-permissions.ts b/src/pages/api/validate-permissions.ts new file mode 100644 index 0000000..37959f9 --- /dev/null +++ b/src/pages/api/validate-permissions.ts @@ -0,0 +1,33 @@ +import type { NextApiRequest, NextApiResponse } from "next"; +import { ENV } from "@/config/environment"; +import { getCurrentUser } from "@/handlers/serverUtils/user.utils"; +import { getUserHeaders } from "@/helpers/user.helper"; + +export default async function handler(req: NextApiRequest, res: NextApiResponse) { + if (req.method !== "GET") { + return res.status(405).json({ message: "Method not allowed" }); + } + + const currentUser = await getCurrentUser(req); + if (!currentUser) { + return res.status(401).json({ message: "Unauthorized" }); + } + + const headers = getUserHeaders(currentUser, { "Content-Type": "application/json" }); + + const result = { canUpload: false }; + + // Test asset upload permission by calling a no-op endpoint + try { + const response = await fetch(`${ENV.IMMICH_URL}/api/assets/exist`, { + method: "POST", + headers, + body: JSON.stringify({ deviceAssetIds: ["permission-check"], deviceId: "immich-power-tools-check" }), + }); + result.canUpload = response.ok; + } catch { + result.canUpload = false; + } + + return res.status(200).json(result); +} diff --git a/src/pages/assets/import-shared.tsx b/src/pages/assets/import-shared.tsx index 7241049..95289c2 100644 --- a/src/pages/assets/import-shared.tsx +++ b/src/pages/assets/import-shared.tsx @@ -1,5 +1,6 @@ import React, { FormEvent, useEffect, useRef, useState } from "react"; -import { Calendar, Loader2, Images, User, Clock } from "lucide-react"; +import { useQuery } from "@tanstack/react-query"; +import { Calendar, Loader2, Images, User, Clock, CheckCircle2, XCircle, Clock3 } from "lucide-react"; import PageLayout from "@/components/layouts/PageLayout"; import Header from "@/components/shared/Header"; import { Button } from "@/components/ui/button"; @@ -22,8 +23,11 @@ import { } from "@/components/ui/dialog"; import { listAlbums } from "@/handlers/api/album.handler"; import { importShared } from "@/handlers/api/import-shared.handler"; -import { createImportJob, getImportJob } from "@/handlers/api/import-jobs.handler"; +import { createImportJob, getImportJob, listImportJobs } from "@/handlers/api/import-jobs.handler"; +import ImportJobDetailDialog from "@/components/import/ImportJobDetailDialog"; +import { validatePermissions } from "@/handlers/api/validate-permissions.handler"; import { IAlbum } from "@/types/album"; +import { AlertTriangle } from "lucide-react"; interface IAlbumContributorCount { userId: string; @@ -165,6 +169,22 @@ export default function ImportSharedPage() { const [selectedAlbumId, setSelectedAlbumId] = useState(null); const [activeJobId, setActiveJobId] = useState(null); const [jobProgress, setJobProgress] = useState<{ uploaded: number; skipped: number; failed: number; total: number } | null>(null); + const [tagAssets, setTagAssets] = useState(true); + const [detailJobId, setDetailJobId] = useState(null); + + const { data: permissions } = useQuery({ + queryKey: ["validate-permissions"], + queryFn: validatePermissions, + staleTime: 5 * 60 * 1000, + retry: false, + }); + + const { data: importHistory, refetch: refetchHistory } = useQuery({ + queryKey: ["import-jobs"], + queryFn: listImportJobs, + staleTime: 30 * 1000, + }); + const albumNameRef = useRef(albumNameInput); @@ -215,10 +235,12 @@ export default function ImportSharedPage() { const failedCount = job.failedCount; const skippedCount = job.skippedCount; const uploadedCount = job.uploadedCount; - const bannerType: "success" | "error" = failedCount > 0 ? "error" : "success"; + const bannerType: "success" | "error" = (failedCount > 0 || job.status === "failed") ? "error" : "success"; let message: string; - if (!uploadedCount && skippedCount && !failedCount) { + if (job.status === "failed" && importData.error && typeof importData.error === "string") { + message = importData.error; + } else if (!uploadedCount && skippedCount && !failedCount) { message = `All ${skippedCount} assets already exist on Immich.`; } else if (failedCount) { const skippedSuffix = skippedCount ? `, ${skippedCount} skipped` : ""; @@ -234,6 +256,7 @@ export default function ImportSharedPage() { } setUploadBanner({ type: bannerType, message }); + refetchHistory(); } } catch (err) { console.error("Polling error", err); @@ -362,7 +385,7 @@ export default function ImportSharedPage() { platform: "immich", url: sharedData.origin, urlConfig: { key: sharedData.key }, - importData: { albumOptions }, + importData: { albumOptions, tagAssets }, assets: uploadableAssets.map((asset) => ({ id: asset.id, originalFileName: asset.originalFileName, @@ -428,7 +451,8 @@ export default function ImportSharedPage() { disabled={ importAllLoading || importableAssetCount === 0 || - (albumImportMode === "existing-album" && !selectedAlbumId) + (albumImportMode === "existing-album" && !selectedAlbumId) || + (permissions && !permissions.canUpload) } onClick={() => { if (importAllLoading) return; @@ -452,6 +476,12 @@ export default function ImportSharedPage() { />
+ {permissions?.canUpload === false && ( +
+ + Your API key does not have permission to upload assets. Import will not work until this is fixed. +
+ )} {!sharedData && ( @@ -488,6 +518,60 @@ export default function ImportSharedPage() { )} + {!sharedData && importHistory?.jobs && importHistory.jobs.length > 0 && ( + + + Previous imports + + +
+ {importHistory.jobs.map((job) => { + let jobImportData: Record = {}; + try { jobImportData = JSON.parse(job.importData); } catch { /* ignore */ } + const albumOpts = jobImportData.albumOptions as { albumName?: string } | undefined; + const albumName = albumOpts?.albumName; + const statusIcon = job.status === "completed" ? ( + + ) : job.status === "failed" ? ( + + ) : ( + + ); + + return ( +
setDetailJobId(job.id)} + > + {statusIcon} +
+

+ {albumName || job.url} +

+

+ {job.uploadedCount} uploaded + {job.skippedCount > 0 && `, ${job.skippedCount} skipped`} + {job.failedCount > 0 && `, ${job.failedCount} failed`} + {" · "} + {formatDate(job.createdAt)} +

+
+ + {job.status} + +
+ ); + })} +
+
+
+ )} + {sharedLinkDetails && sharedData && albumDetails && ( {/* Album identity */} @@ -579,6 +663,18 @@ export default function ImportSharedPage() { )} +
+ setTagAssets(!!checked)} + disabled={importAllLoading} + /> + +
+ {importAllLoading && jobProgress && (
@@ -800,6 +896,7 @@ export default function ImportSharedPage() { )}
+ setDetailJobId(null)} /> ); } diff --git a/src/workers/import/processors/immich-shared-link.ts b/src/workers/import/processors/immich-shared-link.ts index e3eb9a3..3784d3a 100644 --- a/src/workers/import/processors/immich-shared-link.ts +++ b/src/workers/import/processors/immich-shared-link.ts @@ -111,6 +111,9 @@ const createImmichAlbum = async (albumName: string, headers: HeadersRecord): Pro body: JSON.stringify({ albumName }), }); if (!response.ok) { + if (response.status === 403) { + throw new Error(`Your API key does not have permission to create albums. Try importing without creating an album, or use an API key with album.create permission.`); + } const body = await response.text().catch(() => ""); throw new Error(`Failed to create album "${albumName}" (status ${response.status}): ${body || "Unknown error"}`); } @@ -159,7 +162,7 @@ const uploadAssetBuffer = async ( payload: DownloadedAssetPayload, uploadHeaders: HeadersRecord, jsonHeaders: HeadersRecord, - tagId: string + tagId?: string ): Promise => { const fileType = asset.type ?? inferAssetTypeFromName(payload.fileName); const resolvedFileName = payload.fileName || asset.originalFileName || `${asset.id}.bin`; @@ -200,8 +203,10 @@ const uploadAssetBuffer = async ( throw new Error("Immich upload response did not include an asset id"); } - const { tagAssetWithPowerTools } = await import("@/pages/api/import-shared/helpers"); - await tagAssetWithPowerTools(tagId, uploadedId, jsonHeaders); + if (tagId) { + const { tagAssetWithPowerTools } = await import("@/pages/api/import-shared/helpers"); + await tagAssetWithPowerTools(tagId, uploadedId, jsonHeaders); + } return uploadedId; }; @@ -285,10 +290,19 @@ export class ImmichSharedLinkProcessor implements ImportProcessor { albumId = albumOptions.addToAlbumId.trim(); } - const tag = await ensurePowerToolsTag({ ...context.headers, "Content-Type": "application/json" } as HeadersRecord); const importDataPatch: Record = {}; if (albumId) importDataPatch.albumId = albumId; - importDataPatch.tagId = tag.id; + + // Tag assets with "immich-power-tools" if enabled + const tagAssets = importData.tagAssets !== false; // default true for backwards compat + if (tagAssets) { + try { + const tag = await ensurePowerToolsTag({ ...context.headers, "Content-Type": "application/json" } as HeadersRecord); + importDataPatch.tagId = tag.id; + } catch (err) { + console.warn("[ImmichSharedLinkProcessor] Failed to create power-tools tag, skipping tagging", err); + } + } return { skipAssetIds, albumId, importDataPatch }; } @@ -333,10 +347,9 @@ export class ImmichSharedLinkProcessor implements ImportProcessor { // Strip Content-Type for multipart upload (same pattern as upload-all.ts) const { ["Content-Type"]: _omit, ...uploadHeaders } = headers; - // Read tagId from importData set during setup() + // Read tagId from importData set during setup() (optional) const importData = JSON.parse(job.importData) as { albumId?: string; tagId?: string }; const tagId = importData.tagId; - if (!tagId) throw new Error("tagId missing from job importData — setup() may not have completed"); const immichId = await uploadAssetBuffer(asset, downloaded, uploadHeaders as HeadersRecord, headers as HeadersRecord, tagId); diff --git a/src/workers/import/runner.ts b/src/workers/import/runner.ts index 476b38b..c3b7dcd 100644 --- a/src/workers/import/runner.ts +++ b/src/workers/import/runner.ts @@ -76,10 +76,12 @@ export async function runImportJob( if (importDataPatch) { const merged = { ...JSON.parse(job.importData), ...importDataPatch }; + const mergedStr = JSON.stringify(merged); await appDb .update(importJobs) - .set({ importData: JSON.stringify(merged) }) + .set({ importData: mergedStr }) .where(eq(importJobs.id, jobId)); + job.importData = mergedStr; } if (skipAssetIds.length > 0) { @@ -151,9 +153,16 @@ export async function runImportJob( .where(eq(importJobs.id, jobId)); } catch (err: any) { console.error(`Import job ${jobId} failed fatally:`, err); + // Store error message in importData so the UI can display it + let existingData: Record = {}; + try { + const [current] = await appDb.select({ importData: importJobs.importData }).from(importJobs).where(eq(importJobs.id, jobId)); + if (current) existingData = JSON.parse(current.importData); + } catch { /* ignore */ } + existingData.error = err?.message ?? "Unknown error"; await appDb .update(importJobs) - .set({ status: "failed" }) + .set({ status: "failed", importData: JSON.stringify(existingData) }) .where(eq(importJobs.id, jobId)); } finally { activeJobs.delete(jobId);