Source Code added

open-api/typescript-sdk/.npmignore

@@ -0,0 +1,3 @@
+package-lock.json
+tsconfig.json
+src/

open-api/typescript-sdk/.nvmrc

@@ -0,0 +1 @@
+24.13.0

open-api/typescript-sdk/README.md

@@ -0,0 +1,26 @@
+# @immich/sdk
+
+A TypeScript SDK for interfacing with the [Immich](https://immich.app/) API.
+
+## Install
+
+```bash
+npm i --save @immich/sdk
+```
+
+## Usage
+
+For a more detailed example, check out the [`@immich/cli`](https://github.com/immich-app/immich/tree/main/cli).
+
+```typescript
+import { getAllAlbums, getMyUser, init } from "@immich/sdk";
+
+const API_KEY = "<API_KEY>"; // process.env.IMMICH_API_KEY
+
+init({ baseUrl: "https://demo.immich.app/api", apiKey: API_KEY });
+
+const user = await getMyUser();
+const albums = await getAllAlbums({});
+
+console.log({ user, albums });
+```

open-api/typescript-sdk/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@immich/sdk",
+  "version": "2.5.2",
+  "description": "Auto-generated TypeScript SDK for the Immich API",
+  "type": "module",
+  "main": "./build/index.js",
+  "types": "./build/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./build/index.d.ts",
+      "default": "./build/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc"
+  },
+  "license": "GNU Affero General Public License version 3",
+  "dependencies": {
+    "@oazapfts/runtime": "^1.0.2"
+  },
+  "devDependencies": {
+    "@types/node": "^24.10.9",
+    "typescript": "^5.3.3"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/immich-app/immich.git",
+    "directory": "open-api/typescript-sdk"
+  },
+  "volta": {
+    "node": "24.13.0"
+  }
+}

open-api/typescript-sdk/src/fetch-errors.ts

@@ -0,0 +1,15 @@
+import { HttpError } from '@oazapfts/runtime';
+
+export interface ApiExceptionResponse {
+  message: string;
+  error?: string;
+  statusCode: number;
+}
+
+export interface ApiHttpError extends HttpError {
+  data: ApiExceptionResponse;
+}
+
+export function isHttpError(error: unknown): error is ApiHttpError {
+  return error instanceof HttpError;
+}

open-api/typescript-sdk/src/index.ts

@@ -0,0 +1,62 @@
+import { defaults } from './fetch-client.js';
+
+export * from './fetch-client.js';
+export * from './fetch-errors.js';
+
+export interface InitOptions {
+  baseUrl: string;
+  apiKey: string;
+  headers?: Record<string, string>;
+}
+
+export const init = ({ baseUrl, apiKey, headers }: InitOptions) => {
+  setBaseUrl(baseUrl);
+  setApiKey(apiKey);
+  if (headers) {
+    setHeaders(headers);
+  }
+};
+
+export const getBaseUrl = () => defaults.baseUrl;
+
+export const setBaseUrl = (baseUrl: string) => {
+  defaults.baseUrl = baseUrl;
+};
+
+export const setApiKey = (apiKey: string) => {
+  defaults.headers = defaults.headers || {};
+  defaults.headers['x-api-key'] = apiKey;
+};
+
+export const setHeader = (key: string, value: string) => {
+  assertNoApiKey(key);
+  defaults.headers = defaults.headers || {};
+  defaults.headers[key] = value;
+};
+
+export const setHeaders = (headers: Record<string, string>) => {
+  defaults.headers = defaults.headers || {};
+  for (const [key, value] of Object.entries(headers)) {
+    assertNoApiKey(key);
+    defaults.headers[key] = value;
+  }
+};
+
+const assertNoApiKey = (headerKey: string) => {
+  if (headerKey.toLowerCase() === 'x-api-key') {
+    throw new Error('The API key header can only be set using setApiKey().');
+  }
+};
+
+export const getAssetOriginalPath = (id: string) => `/assets/${id}/original`;
+
+export const getAssetThumbnailPath = (id: string) => `/assets/${id}/thumbnail`;
+
+export const getAssetPlaybackPath = (id: string) =>
+  `/assets/${id}/video/playback`;
+
+export const getUserProfileImagePath = (userId: string) =>
+  `/users/${userId}/profile-image`;
+
+export const getPeopleThumbnailPath = (personId: string) =>
+  `/people/${personId}/thumbnail`;

open-api/typescript-sdk/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "esnext",
+    "strict": true,
+    "skipLibCheck": true,
+    "declaration": true,
+    "outDir": "build",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "lib": ["esnext", "dom"]
+  },
+  "include": ["src/**/*.ts"]
+}