@oscharko-dev/keiko-server 0.2.0

package/dist/files.d.ts

@@ -0,0 +1,97 @@
+import type { IncomingMessage } from "node:http";
+import { type EditorDocumentSession, type EditorDocumentVersion } from "@oscharko-dev/keiko-contracts";
+import { type RouteContext, type RouteResult } from "./routes.js";
+import type { UiHandlerDeps } from "./deps.js";
+import type { UiStore } from "./store/index.js";
+type FilesMetadataRedactor = UiHandlerDeps["redactor"];
+export interface FilesDirectoryRoot {
+    readonly label: string;
+    readonly path: string;
+}
+export interface FilesDirectoryEntry {
+    readonly name: string;
+    readonly path: string;
+}
+export interface FilesDirectoryListing {
+    readonly path: string;
+    readonly parent: string | null;
+    readonly entries: readonly FilesDirectoryEntry[];
+    readonly roots: readonly FilesDirectoryRoot[];
+}
+export type FilesEntryKind = "directory" | "file" | "symlink";
+export interface FilesTreeEntry {
+    readonly name: string;
+    readonly path: string;
+    readonly kind: FilesEntryKind;
+    readonly sizeBytes: number;
+    readonly modifiedAt: number;
+    readonly extension: string | null;
+    readonly symlink: boolean;
+    readonly readable: boolean;
+}
+export interface FilesTreeResponse {
+    readonly root: string;
+    readonly path: string;
+    readonly entries: readonly FilesTreeEntry[];
+    readonly truncated: boolean;
+}
+interface FilesPreviewBase {
+    readonly root: string;
+    readonly path: string;
+    readonly name: string;
+    readonly sizeBytes: number;
+    readonly modifiedAt: number;
+    readonly extension: string | null;
+    readonly mime: string;
+    readonly symlink: boolean;
+}
+export type FilesPreviewResponse = (FilesPreviewBase & {
+    readonly kind: "text";
+    readonly content: string;
+    readonly truncated: boolean;
+    readonly maxBytes: number;
+}) | (FilesPreviewBase & {
+    readonly kind: "image";
+    readonly dataUrl: string;
+    readonly maxBytes: number;
+}) | (FilesPreviewBase & {
+    readonly kind: "binary";
+    readonly reason: "unsupported" | "too_large";
+    readonly maxBytes?: number | undefined;
+});
+export interface FilesContentResponse extends FilesPreviewBase {
+    readonly content: string;
+    readonly maxBytes: number;
+    readonly session: EditorDocumentSession;
+}
+export declare class FilesError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+export interface ResolvedProjectRoot {
+    readonly root: string;
+    readonly realRoot: string;
+}
+export declare function runFilesHandler(work: () => Promise<RouteResult> | RouteResult): Promise<RouteResult>;
+export declare function resolveRoot(store: UiStore, rootInput: string | null, redactor: FilesMetadataRedactor): Promise<ResolvedProjectRoot>;
+export declare function listFilesDirectories(store: UiStore, rootInput: string | null, pathInput?: string, redactor?: FilesMetadataRedactor): Promise<FilesDirectoryListing>;
+export declare function readFilesTree(store: UiStore, rootInput: string | null, pathInput: string | null, redactor?: FilesMetadataRedactor): Promise<FilesTreeResponse>;
+export declare function readJsonObject(req: IncomingMessage, maxBytes: number): Promise<Record<string, unknown> | RouteResult>;
+export declare function readFilesContent(store: UiStore, rootInput: string | null, pathInput: string | null, redactor?: FilesMetadataRedactor): Promise<FilesContentResponse>;
+export declare function writeFilesContent(args: {
+    readonly store: UiStore;
+    readonly rootInput: string | null;
+    readonly pathInput: string | null;
+    readonly content: string;
+    readonly expectedModifiedAt?: number | undefined;
+    readonly baseVersion?: EditorDocumentVersion | undefined;
+    readonly redactor?: FilesMetadataRedactor | undefined;
+}): Promise<FilesContentResponse>;
+export declare function readFilesPreview(store: UiStore, rootInput: string | null, pathInput: string | null, redactor?: FilesMetadataRedactor): Promise<FilesPreviewResponse>;
+export declare function handleFilesDirectories(ctx: RouteContext, deps: UiHandlerDeps): Promise<RouteResult>;
+export declare function handleFilesTree(ctx: RouteContext, deps: UiHandlerDeps): Promise<RouteResult>;
+export declare function handleFilesPreview(ctx: RouteContext, deps: UiHandlerDeps): Promise<RouteResult>;
+export declare function handleFilesContent(ctx: RouteContext, deps: UiHandlerDeps): Promise<RouteResult>;
+export {};
+//# sourceMappingURL=files.d.ts.map

package/dist/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../src/files.ts"],"names":[],"mappings":"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"}