@unisource/sdk 1.0.0 → 1.1.0-beta.0

package/dist/v2/index.d.mts

@@ -0,0 +1,212 @@
+import { a as BulkOperationResponse, c as FolderListV2Query, d as bulkFolderIdsSchema, f as bulkFolderMoveRequestSchema, g as folderListV2QuerySchema, h as folderBreadcrumbsResponseSchema, i as BulkFolderMoveRequest, l as bulkFileIdsSchema, m as fileRecordsListV2QuerySchema, n as BulkFileMoveRequest, o as FileRecordsListV2Query, p as bulkOperationResponseSchema, r as BulkFolderIds, s as FolderBreadcrumbsResponse, t as BulkFileIds, u as bulkFileMoveRequestSchema } from "../legacy-draft-7fqlx-KW.mjs";
+import { z } from "zod";
+
+//#region src/v2/types.d.ts
+type SortBy = 'created_at' | 'updated_at' | 'name' | 'size';
+type SortDir = 'asc' | 'desc';
+type TrashFilter = 'active' | 'trashed' | 'all';
+interface V2ListQuery {
+  folder_id?: string | null;
+  search?: string;
+  mime_type?: string;
+  trash?: TrashFilter;
+  sort_by?: SortBy;
+  sort_dir?: SortDir;
+  cursor?: string;
+  limit?: number;
+}
+interface V2Page {
+  limit: number;
+  next_cursor: string | null;
+}
+interface V2ListResponse<T> {
+  items: T[];
+  page: V2Page;
+}
+interface V2ErrorBody {
+  error: {
+    code: string;
+    message: string;
+    details?: unknown;
+    request_id: string;
+  };
+}
+//#endregion
+//#region src/v2/files.d.ts
+declare const v2FileSchema: z.ZodObject<{
+  id: z.ZodString;
+  service_id: z.ZodString;
+  user_id: z.ZodString;
+  folder_id: z.ZodNullable<z.ZodString>;
+  upload_id: z.ZodNullable<z.ZodString>;
+  filename: z.ZodString;
+  size: z.ZodNumber;
+  mime_type: z.ZodString;
+  storage_destination: z.ZodEnum<{
+    appwrite: "appwrite";
+    r2: "r2";
+  }>;
+  is_trashed: z.ZodBoolean;
+  trashed_at: z.ZodNullable<z.ZodNumber>;
+  created_at: z.ZodNumber;
+  updated_at: z.ZodNumber;
+}, z.core.$strip>;
+type V2File = z.infer<typeof v2FileSchema>;
+//#endregion
+//#region src/v2/folders.d.ts
+declare const v2FolderSchema: z.ZodObject<{
+  id: z.ZodString;
+  service_id: z.ZodString;
+  user_id: z.ZodString;
+  parent_id: z.ZodNullable<z.ZodString>;
+  name: z.ZodString;
+  color_tag: z.ZodNullable<z.ZodString>;
+  is_trashed: z.ZodBoolean;
+  trashed_at: z.ZodNullable<z.ZodNumber>;
+  created_at: z.ZodNumber;
+  updated_at: z.ZodNumber;
+}, z.core.$strip>;
+type V2Folder = z.infer<typeof v2FolderSchema>;
+declare const v2FolderListQuerySchema: z.ZodObject<{
+  parent_id: z.ZodOptional<z.ZodString>;
+  search: z.ZodOptional<z.ZodString>;
+  trash: z.ZodOptional<z.ZodEnum<{
+    active: "active";
+    all: "all";
+    trashed: "trashed";
+  }>>;
+  sort_by: z.ZodOptional<z.ZodEnum<{
+    created_at: "created_at";
+    name: "name";
+    updated_at: "updated_at";
+  }>>;
+  sort_dir: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+  cursor: z.ZodOptional<z.ZodString>;
+  limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type V2FolderListQuery = z.infer<typeof v2FolderListQuerySchema>;
+declare const v2FolderListResponseSchema: z.ZodObject<{
+  items: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    service_id: z.ZodString;
+    user_id: z.ZodString;
+    parent_id: z.ZodNullable<z.ZodString>;
+    name: z.ZodString;
+    color_tag: z.ZodNullable<z.ZodString>;
+    is_trashed: z.ZodBoolean;
+    trashed_at: z.ZodNullable<z.ZodNumber>;
+    created_at: z.ZodNumber;
+    updated_at: z.ZodNumber;
+  }, z.core.$strip>>;
+  page: z.ZodObject<{
+    limit: z.ZodNumber;
+    next_cursor: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+type V2FolderListResponse = z.infer<typeof v2FolderListResponseSchema>;
+//#endregion
+//#region src/v2/schemas.d.ts
+declare const v2ListQuerySchema: z.ZodObject<{
+  folder_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+  search: z.ZodOptional<z.ZodString>;
+  mime_type: z.ZodOptional<z.ZodString>;
+  trash: z.ZodOptional<z.ZodEnum<{
+    active: "active";
+    all: "all";
+    trashed: "trashed";
+  }>>;
+  sort_by: z.ZodOptional<z.ZodEnum<{
+    created_at: "created_at";
+    name: "name";
+    size: "size";
+    updated_at: "updated_at";
+  }>>;
+  sort_dir: z.ZodOptional<z.ZodEnum<{
+    asc: "asc";
+    desc: "desc";
+  }>>;
+  cursor: z.ZodOptional<z.ZodString>;
+  limit: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+declare const v2PageSchema: z.ZodObject<{
+  limit: z.ZodNumber;
+  next_cursor: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+declare function v2ListResponseSchema<T extends z.ZodTypeAny>(itemSchema: T): z.ZodObject<{
+  items: z.ZodArray<T>;
+  page: z.ZodObject<{
+    limit: z.ZodNumber;
+    next_cursor: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+declare const v2ErrorSchema: z.ZodObject<{
+  error: z.ZodObject<{
+    code: z.ZodString;
+    message: z.ZodString;
+    details: z.ZodOptional<z.ZodUnknown>;
+    request_id: z.ZodString;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+declare const v2FilesListResponseSchema: z.ZodObject<{
+  items: z.ZodArray<z.ZodObject<{
+    id: z.ZodString;
+    service_id: z.ZodString;
+    user_id: z.ZodString;
+    folder_id: z.ZodNullable<z.ZodString>;
+    upload_id: z.ZodNullable<z.ZodString>;
+    filename: z.ZodString;
+    size: z.ZodNumber;
+    mime_type: z.ZodString;
+    storage_destination: z.ZodEnum<{
+      appwrite: "appwrite";
+      r2: "r2";
+    }>;
+    is_trashed: z.ZodBoolean;
+    trashed_at: z.ZodNullable<z.ZodNumber>;
+    created_at: z.ZodNumber;
+    updated_at: z.ZodNumber;
+  }, z.core.$strip>>;
+  page: z.ZodObject<{
+    limit: z.ZodNumber;
+    next_cursor: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+}, z.core.$strip>;
+//#endregion
+//#region src/v2/errors.d.ts
+declare class UnisourceV2Error extends Error {
+  readonly status: number;
+  readonly code: string;
+  readonly requestId: string;
+  readonly details?: unknown;
+  constructor(message: string, status: number, code: string, requestId: string, details?: unknown);
+}
+//#endregion
+//#region src/v2/client.d.ts
+interface UnisourceV2ClientConfig {
+  baseUrl: string;
+  serviceId: string;
+  getToken: () => string | null | undefined | Promise<string | null | undefined>;
+  /** Set to true to suppress the beta warning in console */
+  silentBeta?: boolean;
+}
+declare class UnisourceV2Client {
+  private config;
+  constructor(config: UnisourceV2ClientConfig);
+  readonly files: {
+    list: (query?: V2ListQuery, signal?: AbortSignal, options?: {
+      asUser?: string;
+    }) => Promise<V2ListResponse<V2File>>;
+  };
+  readonly folders: {
+    list: (query?: V2FolderListQuery, signal?: AbortSignal, options?: {
+      asUser?: string;
+    }) => Promise<V2FolderListResponse>;
+  };
+  private _filesList;
+  private _foldersList;
+}
+//#endregion
+export { BulkFileIds, BulkFileMoveRequest, BulkFolderIds, BulkFolderMoveRequest, BulkOperationResponse, FileRecordsListV2Query, FolderBreadcrumbsResponse, FolderListV2Query, SortBy, SortDir, TrashFilter, UnisourceV2Client, type UnisourceV2ClientConfig, UnisourceV2Error, V2ErrorBody, V2File, V2Folder, V2FolderListQuery, V2FolderListResponse, V2ListQuery, V2ListResponse, V2Page, bulkFileIdsSchema, bulkFileMoveRequestSchema, bulkFolderIdsSchema, bulkFolderMoveRequestSchema, bulkOperationResponseSchema, fileRecordsListV2QuerySchema, folderBreadcrumbsResponseSchema, folderListV2QuerySchema, v2ErrorSchema, v2FileSchema, v2FilesListResponseSchema, v2FolderListQuerySchema, v2FolderListResponseSchema, v2FolderSchema, v2ListQuerySchema, v2ListResponseSchema, v2PageSchema };

package/dist/v2/index.mjs

@@ -0,0 +1,194 @@
+import { a as bulkOperationResponseSchema, c as folderListV2QuerySchema, i as bulkFolderMoveRequestSchema, n as bulkFileMoveRequestSchema, o as fileRecordsListV2QuerySchema, r as bulkFolderIdsSchema, s as folderBreadcrumbsResponseSchema, t as bulkFileIdsSchema } from "../legacy-draft-D0hgtTqN.mjs";
+import { z } from "zod";
+//#region src/v2/files.ts
+const v2FileSchema = z.object({
+	id: z.string(),
+	service_id: z.string(),
+	user_id: z.string(),
+	folder_id: z.string().nullable(),
+	upload_id: z.string().nullable(),
+	filename: z.string(),
+	size: z.number(),
+	mime_type: z.string(),
+	storage_destination: z.enum(["r2", "appwrite"]),
+	is_trashed: z.boolean(),
+	trashed_at: z.number().nullable(),
+	created_at: z.number(),
+	updated_at: z.number()
+});
+//#endregion
+//#region src/v2/schemas.ts
+const v2ListQuerySchema = z.object({
+	folder_id: z.string().nullable().optional(),
+	search: z.string().optional(),
+	mime_type: z.string().optional(),
+	trash: z.enum([
+		"active",
+		"trashed",
+		"all"
+	]).optional(),
+	sort_by: z.enum([
+		"created_at",
+		"updated_at",
+		"name",
+		"size"
+	]).optional(),
+	sort_dir: z.enum(["asc", "desc"]).optional(),
+	cursor: z.string().optional(),
+	limit: z.number().int().min(1).optional()
+});
+const v2PageSchema = z.object({
+	limit: z.number(),
+	next_cursor: z.string().nullable()
+});
+function v2ListResponseSchema(itemSchema) {
+	return z.object({
+		items: z.array(itemSchema),
+		page: v2PageSchema
+	});
+}
+const v2ErrorSchema = z.object({ error: z.object({
+	code: z.string(),
+	message: z.string(),
+	details: z.unknown().optional(),
+	request_id: z.string()
+}) });
+const v2FilesListResponseSchema = v2ListResponseSchema(v2FileSchema);
+//#endregion
+//#region src/v2/folders.ts
+const v2FolderSchema = z.object({
+	id: z.string(),
+	service_id: z.string(),
+	user_id: z.string(),
+	parent_id: z.string().nullable(),
+	name: z.string(),
+	color_tag: z.string().nullable(),
+	is_trashed: z.boolean(),
+	trashed_at: z.number().nullable(),
+	created_at: z.number(),
+	updated_at: z.number()
+});
+const v2FolderListQuerySchema = z.object({
+	parent_id: z.string().optional(),
+	search: z.string().max(100).optional(),
+	trash: z.enum([
+		"active",
+		"trashed",
+		"all"
+	]).optional(),
+	sort_by: z.enum([
+		"created_at",
+		"updated_at",
+		"name"
+	]).optional(),
+	sort_dir: z.enum(["asc", "desc"]).optional(),
+	cursor: z.string().optional(),
+	limit: z.number().int().min(1).max(100).optional()
+});
+const v2FolderListResponseSchema = v2ListResponseSchema(v2FolderSchema);
+//#endregion
+//#region src/v2/errors.ts
+var UnisourceV2Error = class extends Error {
+	constructor(message, status, code, requestId, details) {
+		super(message);
+		this.status = status;
+		this.code = code;
+		this.requestId = requestId;
+		this.details = details;
+		this.name = "UnisourceV2Error";
+	}
+};
+//#endregion
+//#region src/v2/client.ts
+let warned = false;
+function parseErrorBody(value) {
+	if (!value || typeof value !== "object") return {};
+	const error = value.error;
+	if (!error || typeof error !== "object") return {};
+	const payload = error;
+	return { error: {
+		code: typeof payload.code === "string" ? payload.code : void 0,
+		message: typeof payload.message === "string" ? payload.message : void 0,
+		details: payload.details
+	} };
+}
+var UnisourceV2Client = class {
+	config;
+	constructor(config) {
+		this.config = config;
+		if (!warned && !config.silentBeta) {
+			console.warn("[unisource-sdk] V2 API is in beta. Breaking changes possible. See https://docs.unisource.example/v2 for stability commitments.");
+			warned = true;
+		}
+	}
+	files = { list: (query, signal, options) => this._filesList(query, signal, options) };
+	folders = { list: (query, signal, options) => this._foldersList(query, signal, options) };
+	async _filesList(query, signal, options) {
+		const token = await this.config.getToken();
+		const headers = { "X-Service-ID": this.config.serviceId };
+		if (token) headers["Authorization"] = `Bearer ${token}`;
+		if (options?.asUser) headers["X-Target-User-ID"] = options.asUser;
+		const url = new URL("/v2/files", this.config.baseUrl);
+		if (query) for (const [k, v] of Object.entries(query)) {
+			if (v === void 0) continue;
+			url.searchParams.set(k, v === null ? "null" : String(v));
+		}
+		let response;
+		try {
+			response = await fetch(url.toString(), {
+				method: "GET",
+				headers,
+				signal
+			});
+		} catch (err) {
+			throw new Error(`Network request failed: ${err}`);
+		}
+		if (!response.ok) {
+			const requestId = response.headers.get("X-Request-Id") ?? "unknown";
+			let body;
+			try {
+				body = parseErrorBody(await response.json());
+			} catch {
+				body = {};
+			}
+			throw new UnisourceV2Error(body.error?.message ?? response.statusText, response.status, body.error?.code ?? "unknown", requestId, body.error?.details);
+		}
+		const data = await response.json();
+		return v2ListResponseSchema(v2FileSchema).parse(data);
+	}
+	async _foldersList(query, signal, options) {
+		const token = await this.config.getToken();
+		const headers = { "X-Service-ID": this.config.serviceId };
+		if (token) headers["Authorization"] = `Bearer ${token}`;
+		if (options?.asUser) headers["X-Target-User-ID"] = options.asUser;
+		const url = new URL("/v2/folders", this.config.baseUrl);
+		if (query) for (const [k, v] of Object.entries(query)) {
+			if (v === void 0) continue;
+			url.searchParams.set(k, v === null ? "null" : String(v));
+		}
+		let response;
+		try {
+			response = await fetch(url.toString(), {
+				method: "GET",
+				headers,
+				signal
+			});
+		} catch (err) {
+			throw new Error(`Network request failed: ${err}`);
+		}
+		if (!response.ok) {
+			const requestId = response.headers.get("X-Request-Id") ?? "unknown";
+			let body;
+			try {
+				body = parseErrorBody(await response.json());
+			} catch {
+				body = {};
+			}
+			throw new UnisourceV2Error(body.error?.message ?? response.statusText, response.status, body.error?.code ?? "unknown", requestId, body.error?.details);
+		}
+		const data = await response.json();
+		return v2FolderListResponseSchema.parse(data);
+	}
+};
+//#endregion
+export { UnisourceV2Client, UnisourceV2Error, bulkFileIdsSchema, bulkFileMoveRequestSchema, bulkFolderIdsSchema, bulkFolderMoveRequestSchema, bulkOperationResponseSchema, fileRecordsListV2QuerySchema, folderBreadcrumbsResponseSchema, folderListV2QuerySchema, v2ErrorSchema, v2FileSchema, v2FilesListResponseSchema, v2FolderListQuerySchema, v2FolderListResponseSchema, v2FolderSchema, v2ListQuerySchema, v2ListResponseSchema, v2PageSchema };

package/package.json

@@ -2,14 +2,9 @@
   "name": "@unisource/sdk",
   "private": false,
   "type": "module",
-  "version": "1.0.0",
+  "version": "1.1.0-beta.0",
   "description": "Wspolne kontrakty danych dla backendu i frontendu UniSource.",
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Dan1el-19/UniSource.git",
-    "directory": "packages/unisource-sdk"
-  },
   "publishConfig": {
     "access": "public"
   },
@@ -19,13 +14,24 @@
       "import": "./dist/index.mjs",
       "default": "./dist/index.mjs"
     },
+    "./v2": {
+      "types": "./dist/v2/index.d.mts",
+      "import": "./dist/v2/index.mjs",
+      "default": "./dist/v2/index.mjs"
+    },
     "./package.json": "./package.json"
   },
   "types": "./dist/index.d.mts",
   "files": [
-    "dist",
-    "src"
+    "dist"
   ],
+  "scripts": {
+    "build": "tsdown",
+    "dev": "tsdown --watch",
+    "test": "pnpm run build && vitest",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "pnpm run build"
+  },
   "devDependencies": {
     "@types/node": "^25.5.0",
     "@typescript/native-preview": "7.0.0-dev.20260328.1",
@@ -36,10 +42,9 @@
   "dependencies": {
     "zod": "^4.3.6"
   },
-  "scripts": {
-    "build": "tsdown",
-    "dev": "tsdown --watch",
-    "test": "pnpm run build && vitest",
-    "typecheck": "tsc --noEmit"
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Dan1el-19/UniSource.git",
+    "directory": "packages/unisource-sdk"
   }
-}
+}