@tulip-systems/drive 0.8.1 → 0.8.3

package/dist/components/navigation/view-switcher.client.mjs

@@ -0,0 +1,35 @@
+"use client";
+
+import { useDriveViewContext } from "../view.client.mjs";
+import { LayoutGridIcon, StretchVerticalIcon } from "lucide-react";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { ToggleGroup, ToggleGroupItem } from "@tulip-systems/core/components/client";
+
+//#region src/components/navigation/view-switcher.client.tsx
+/**
+* Drive view switcher
+*/
+function DriveViewSwitcher() {
+	const { view, onViewChange } = useDriveViewContext();
+	return /* @__PURE__ */ jsxs(ToggleGroup, {
+		type: "single",
+		variant: "outline",
+		value: view,
+		onValueChange: (value) => {
+			console.log("DriveViewSwitcher: Changing view to", value);
+			onViewChange(value ? value : "grid");
+		},
+		children: [/* @__PURE__ */ jsx(ToggleGroupItem, {
+			value: "grid",
+			"aria-label": "Toggle grid view",
+			children: /* @__PURE__ */ jsx(LayoutGridIcon, {})
+		}), /* @__PURE__ */ jsx(ToggleGroupItem, {
+			value: "list",
+			"aria-label": "Toggle list view",
+			children: /* @__PURE__ */ jsx(StretchVerticalIcon, {})
+		})]
+	});
+}
+
+//#endregion
+export { DriveViewSwitcher };

package/dist/components/selection.client.d.mts

@@ -0,0 +1,27 @@
+import { DriveNode } from "../lib/dto.mjs";
+import { Selection } from "@tulip-systems/core/data-tables";
+import { PropsWithChildren } from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/selection.client.d.ts
+/**
+ * DriveSelectionContextValue
+ */
+type DriveSelectionContextValue = {
+  selection?: Selection;
+  selectionConditions?: (node: DriveNode) => boolean | boolean[];
+};
+/**
+ * useDriveSelectionContext
+ */
+declare function useDriveSelectionContext(): DriveSelectionContextValue | null;
+/**
+ * DriveSelectionProvider
+ */
+declare function DriveSelectionProvider({
+  selection,
+  selectionConditions,
+  children
+}: PropsWithChildren<DriveSelectionContextValue>): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { DriveSelectionContextValue, DriveSelectionProvider, useDriveSelectionContext };

package/dist/components/selection.client.mjs

@@ -0,0 +1,36 @@
+"use client";
+
+import { createContext, use, useMemo, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/components/selection.client.tsx
+const DriveSelectionContext = createContext(null);
+/**
+* useDriveSelectionContext
+*/
+function useDriveSelectionContext() {
+	return use(DriveSelectionContext) ?? null;
+}
+/**
+* DriveSelectionProvider
+*/
+function DriveSelectionProvider({ selection, selectionConditions, children }) {
+	const [_rowSelection, _setRowSelection] = useState({});
+	return /* @__PURE__ */ jsx(DriveSelectionContext, {
+		value: useMemo(() => ({
+			selection: {
+				rowSelection: selection?.rowSelection ?? _rowSelection,
+				setRowSelection: selection?.setRowSelection ?? _setRowSelection
+			},
+			selectionConditions
+		}), [
+			selection,
+			selectionConditions,
+			_rowSelection
+		]),
+		children
+	});
+}
+
+//#endregion
+export { DriveSelectionProvider, useDriveSelectionContext };

package/dist/components/view.client.d.mts

@@ -0,0 +1,25 @@
+import { PropsWithChildren } from "react";
+import * as react_jsx_runtime0 from "react/jsx-runtime";
+
+//#region src/components/view.client.d.ts
+type DriveViewMode = "grid" | "list";
+/**
+ * DriveViewContextValue
+ */
+type DriveViewContextValue = {
+  view: DriveViewMode;
+  onViewChange: (view: DriveViewMode) => void;
+};
+/**
+ * useDriveViewContext
+ */
+declare function useDriveViewContext(): DriveViewContextValue;
+/**
+ * DriveViewProvider
+ */
+type DriveViewProviderProps = PropsWithChildren<Partial<DriveViewContextValue>> & {
+  initialView?: DriveViewMode;
+};
+declare function DriveViewProvider(props: DriveViewProviderProps): react_jsx_runtime0.JSX.Element;
+//#endregion
+export { DriveViewContextValue, DriveViewMode, DriveViewProvider, DriveViewProviderProps, useDriveViewContext };

package/dist/components/view.client.mjs

@@ -0,0 +1,43 @@
+"use client";
+
+import { DRIVE_VIEW_COOKIE, DRIVE_VIEW_COOKIE_MAX_AGE } from "../lib/constants.mjs";
+import { createContext, use, useCallback, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/components/view.client.tsx
+const DriveViewContext = createContext(null);
+/**
+* useDriveViewContext
+*/
+function useDriveViewContext() {
+	const context = use(DriveViewContext);
+	if (!context) {
+		console.warn("DriveViewContext not found!");
+		return {
+			view: "grid",
+			onViewChange: () => {
+				throw new Error("DriveViewContext not found!");
+			}
+		};
+	}
+	return context;
+}
+function DriveViewProvider(props) {
+	const [_view, _setView] = useState(props.view ?? props.initialView ?? "grid");
+	const view = props.view ?? _view;
+	return /* @__PURE__ */ jsx(DriveViewContext, {
+		value: {
+			view,
+			onViewChange: useCallback((value) => {
+				const viewState = typeof value === "function" ? value(view) : value;
+				if (props.onViewChange) props.onViewChange(viewState);
+				else _setView(viewState);
+				document.cookie = `${DRIVE_VIEW_COOKIE}=${viewState}; path=/; max-age=${DRIVE_VIEW_COOKIE_MAX_AGE}`;
+			}, [props.onViewChange, view])
+		},
+		children: props.children
+	});
+}
+
+//#endregion
+export { DriveViewProvider, useDriveViewContext };

package/dist/config/filters.mjs

@@ -0,0 +1,14 @@
+import { DRIVE_NODE_TYPES } from "../lib/constants.mjs";
+import z$1 from "zod";
+import { createTableFilters, parseFilterArray, parseFilterBoolean } from "@tulip-systems/core/data-tables";
+
+//#region src/config/filters.ts
+const driveTreeFilters = createTableFilters({
+	types: parseFilterArray(z$1.array(z$1.enum(DRIVE_NODE_TYPES))),
+	contentTypes: parseFilterArray(z$1.array(z$1.string())),
+	nodeIds: parseFilterArray(z$1.array(z$1.string())),
+	isArchived: parseFilterBoolean(z$1.boolean())
+});
+
+//#endregion
+export { driveTreeFilters };

package/dist/config/types.mjs

@@ -0,0 +1,60 @@
+import { createStatusConfig, createStatusVariants } from "@tulip-systems/core/components";
+import { FileArchiveIcon, FileAudioIcon, FileIcon, FileImageIcon, FileSpreadsheetIcon, FileTextIcon, FileVideoIcon } from "lucide-react";
+import { cva } from "class-variance-authority";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/config/types.tsx
+/**
+* Node subtype config
+*/
+const nodeSubtypeConfig = createStatusConfig([
+	{
+		value: "image",
+		label: "Afbeelding",
+		icon: FileImageIcon,
+		className: "stroke-blue-500"
+	},
+	{
+		value: "document",
+		label: "Document",
+		icon: FileTextIcon,
+		className: "stroke-red-600"
+	},
+	{
+		value: "archive",
+		label: "Archief",
+		icon: FileArchiveIcon,
+		className: "stroke-yellow-500"
+	},
+	{
+		value: "audio",
+		label: "Audio",
+		icon: FileAudioIcon,
+		className: "stroke-pink-500"
+	},
+	{
+		value: "video",
+		label: "Video",
+		icon: FileVideoIcon,
+		className: "stroke-purple-500"
+	},
+	{
+		value: "spreadsheet",
+		label: "Tabel",
+		icon: FileSpreadsheetIcon,
+		className: "stroke-green-600"
+	},
+	{
+		value: "other",
+		label: "Bestand",
+		icon: FileIcon,
+		className: "stroke-gray-400"
+	}
+]);
+/**
+* Node subtype variants
+*/
+const nodeSubtypeVariants = cva("", { variants: { status: createStatusVariants(nodeSubtypeConfig) } });
+
+//#endregion
+export { nodeSubtypeConfig, nodeSubtypeVariants };

package/dist/google/client.d.mts

@@ -0,0 +1,8 @@
+import { GoogleDriveFileUpdateCommand, GoogleDriveFileUpdateCommandProps } from "../providers/google/components/command-file-update.mjs";
+import { GoogleDriveFoldersCreateCommand, GoogleDriveFoldersCreateCommandProps } from "../providers/google/components/command-folder-create.mjs";
+import { GoogleDriveFoldersUpdateCommand, GoogleDriveFoldersUpdateCommandProps } from "../providers/google/components/command-folder-update.mjs";
+import { GoogleDriveContent } from "../providers/google/components/content.client.mjs";
+import { GoogleDriveHeader, GoogleDriveHeaderBreadcrumbs, GoogleDriveHeaderTools, GoogleDriveToolbar, GoogleDriveToolbarBreadcrumbs, GoogleDriveToolbarTools, GoogleDriveViewSwitcher } from "../providers/google/components/navigation.client.mjs";
+import { GoogleDriveContext, GoogleDriveContextValue, GoogleDriveProvider, useGoogleDriveContext } from "../providers/google/components/provider.client.mjs";
+import { GoogleDriveView, GoogleDriveViewLoading, GoogleDriveViewProvider } from "../providers/google/components/view.client.mjs";
+export { GoogleDriveContent, GoogleDriveContext, GoogleDriveContextValue, GoogleDriveFileUpdateCommand, GoogleDriveFileUpdateCommandProps, GoogleDriveFoldersCreateCommand, GoogleDriveFoldersCreateCommandProps, GoogleDriveFoldersUpdateCommand, GoogleDriveFoldersUpdateCommandProps, GoogleDriveHeader, GoogleDriveHeaderBreadcrumbs, GoogleDriveHeaderTools, GoogleDriveProvider, GoogleDriveToolbar, GoogleDriveToolbarBreadcrumbs, GoogleDriveToolbarTools, GoogleDriveView, GoogleDriveViewLoading, GoogleDriveViewProvider, GoogleDriveViewSwitcher, useGoogleDriveContext };

package/dist/google/client.mjs

@@ -0,0 +1,9 @@
+import { GoogleDriveFileUpdateCommand } from "../providers/google/components/command-file-update.mjs";
+import { GoogleDriveFoldersCreateCommand } from "../providers/google/components/command-folder-create.mjs";
+import { GoogleDriveFoldersUpdateCommand } from "../providers/google/components/command-folder-update.mjs";
+import { GoogleDriveContent } from "../providers/google/components/content.client.mjs";
+import { GoogleDriveHeader, GoogleDriveHeaderBreadcrumbs, GoogleDriveHeaderTools, GoogleDriveToolbar, GoogleDriveToolbarBreadcrumbs, GoogleDriveToolbarTools, GoogleDriveViewSwitcher } from "../providers/google/components/navigation.client.mjs";
+import { GoogleDriveContext, GoogleDriveProvider, useGoogleDriveContext } from "../providers/google/components/provider.client.mjs";
+import { GoogleDriveView, GoogleDriveViewLoading, GoogleDriveViewProvider } from "../providers/google/components/view.client.mjs";
+
+export { GoogleDriveContent, GoogleDriveContext, GoogleDriveFileUpdateCommand, GoogleDriveFoldersCreateCommand, GoogleDriveFoldersUpdateCommand, GoogleDriveHeader, GoogleDriveHeaderBreadcrumbs, GoogleDriveHeaderTools, GoogleDriveProvider, GoogleDriveToolbar, GoogleDriveToolbarBreadcrumbs, GoogleDriveToolbarTools, GoogleDriveView, GoogleDriveViewLoading, GoogleDriveViewProvider, GoogleDriveViewSwitcher, useGoogleDriveContext };

package/dist/google/server.d.mts

@@ -0,0 +1,3 @@
+import { GoogleDrive, GoogleDriveConfig } from "../providers/google/lib/service.server.mjs";
+import { createGoogleDriveProcedures } from "../providers/google/lib/router.server.mjs";
+export { GoogleDrive, GoogleDriveConfig, createGoogleDriveProcedures };

package/dist/google/server.mjs

@@ -0,0 +1,4 @@
+import { createGoogleDriveProcedures } from "../providers/google/lib/router.server.mjs";
+import { GoogleDrive } from "../providers/google/lib/service.server.mjs";
+
+export { GoogleDrive, createGoogleDriveProcedures };

package/dist/google.d.mts

@@ -0,0 +1,6 @@
+import { CreateGoogleDriveFolderInput, CreateGoogleDriveFolderSchema, GetGoogleDriveNodesByParentIdInput, GetGoogleDriveNodesByParentIdSchema, GoogleDriveNode, GoogleDriveNodeChild, GoogleDriveNodeWithChildren, GoogleDriveTableFilters, GoogleDriveTableFiltersInput, ListGoogleDriveTreeInput, ListGoogleDriveTreeSchema, UpdateGoogleDriveNodeInput, UpdateGoogleDriveNodeSchema, UploadGoogleDriveFileInput, UploadGoogleDriveFileSchema, createGoogleDriveFolderInputSchema, getGoogleDriveNodesByParentIdInputSchema, googleDriveNodeSchema, googleDriveNodeWithChildrenSchema, googleDriveTableFiltersSchema, listGoogleDriveTreeInputSchema, updateGoogleDriveNodeInputSchema, uploadGoogleDriveFileInputSchema } from "./providers/google/lib/validators.mjs";
+import { googleDriveColumns } from "./providers/google/config/columns-data.mjs";
+import { googleDriveTreeFilters } from "./providers/google/config/filters.mjs";
+import { GoogleDriveNodeDTO, GoogleDriveNodeDTOInput } from "./providers/google/lib/dto.mjs";
+import { googleDriveTreeFilterSearchParams } from "./providers/google/lib/search-params.mjs";
+export { CreateGoogleDriveFolderInput, CreateGoogleDriveFolderSchema, GetGoogleDriveNodesByParentIdInput, GetGoogleDriveNodesByParentIdSchema, GoogleDriveNode, GoogleDriveNodeChild, GoogleDriveNodeDTO, GoogleDriveNodeDTOInput, GoogleDriveNodeWithChildren, GoogleDriveTableFilters, GoogleDriveTableFiltersInput, ListGoogleDriveTreeInput, ListGoogleDriveTreeSchema, UpdateGoogleDriveNodeInput, UpdateGoogleDriveNodeSchema, UploadGoogleDriveFileInput, UploadGoogleDriveFileSchema, createGoogleDriveFolderInputSchema, getGoogleDriveNodesByParentIdInputSchema, googleDriveColumns, googleDriveNodeSchema, googleDriveNodeWithChildrenSchema, googleDriveTableFiltersSchema, googleDriveTreeFilterSearchParams, googleDriveTreeFilters, listGoogleDriveTreeInputSchema, updateGoogleDriveNodeInputSchema, uploadGoogleDriveFileInputSchema };

package/dist/google.mjs

@@ -0,0 +1,7 @@
+import { googleDriveColumns } from "./providers/google/config/columns-data.mjs";
+import { googleDriveTreeFilters } from "./providers/google/config/filters.mjs";
+import { GoogleDriveNodeDTO } from "./providers/google/lib/dto.mjs";
+import { googleDriveTreeFilterSearchParams } from "./providers/google/lib/search-params.mjs";
+import { createGoogleDriveFolderInputSchema, getGoogleDriveNodesByParentIdInputSchema, googleDriveNodeSchema, googleDriveNodeWithChildrenSchema, googleDriveTableFiltersSchema, listGoogleDriveTreeInputSchema, updateGoogleDriveNodeInputSchema, uploadGoogleDriveFileInputSchema } from "./providers/google/lib/validators.mjs";
+
+export { GoogleDriveNodeDTO, createGoogleDriveFolderInputSchema, getGoogleDriveNodesByParentIdInputSchema, googleDriveColumns, googleDriveNodeSchema, googleDriveNodeWithChildrenSchema, googleDriveTableFiltersSchema, googleDriveTreeFilterSearchParams, googleDriveTreeFilters, listGoogleDriveTreeInputSchema, updateGoogleDriveNodeInputSchema, uploadGoogleDriveFileInputSchema };

package/dist/index.d.mts

@@ -0,0 +1,7 @@
+import { DriveFolderParent, DriveNode, DriveNodeAvailability, DriveNodeBase, DriveNodeChild, DriveNodeLinks, DriveNodeProvider, DriveNodeSubtype, DriveNodeType, DriveNodeWithChildren, driveNodeAvailabilitySchema, driveNodeLinksSchema, driveNodeProviderSchema, driveNodeSchema, driveNodeSubtypeSchema, driveNodeTypeSchema } from "./lib/dto.mjs";
+import { DRIVE_NODE_SUBTYPES, DRIVE_NODE_TYPES, DRIVE_PROVIDERS, DRIVE_VIEW_COOKIE, DRIVE_VIEW_COOKIE_MAX_AGE } from "./lib/constants.mjs";
+import { CreateDriveFolderInput, CreateDriveFolderSchema, GetDriveNodesByParentIdInput, GetDriveNodesByParentIdSchema, ListDriveTreeInput, ListDriveTreeSchema, NodesTableFilters, PresignDriveFileInput, PresignDriveFileSchema, UpdateDriveNodeInput, UpdateDriveNodeSchema, UploadDriveFileInput, UploadDriveFileSchema, createDriveFolderInputSchema, driveTableFiltersSchema, getNodesByParentIdInputSchema, listDriveTreeInputSchema, presignDriveFileInputSchema, updateDriveNodeInputSchema, uploadDriveFileInputSchema } from "./lib/validators.mjs";
+import { Drive, DriveArchive, DriveDirectUpload, DriveNodeMutations, DrivePresignedUpload, DrivePresignedUploadResult, DrivePreviewGenerator, DriveReader, DriveReadonly } from "./lib/contracts.mjs";
+import { isFile, isFolder, renderBytes } from "./lib/helpers.mjs";
+import { driveTreeSearchParams } from "./lib/search-params.mjs";
+export { CreateDriveFolderInput, CreateDriveFolderSchema, DRIVE_NODE_SUBTYPES, DRIVE_NODE_TYPES, DRIVE_PROVIDERS, DRIVE_VIEW_COOKIE, DRIVE_VIEW_COOKIE_MAX_AGE, Drive, DriveArchive, DriveDirectUpload, DriveFolderParent, DriveNode, DriveNodeAvailability, DriveNodeBase, DriveNodeChild, DriveNodeLinks, DriveNodeMutations, DriveNodeProvider, DriveNodeSubtype, DriveNodeType, DriveNodeWithChildren, DrivePresignedUpload, DrivePresignedUploadResult, DrivePreviewGenerator, DriveReader, DriveReadonly, GetDriveNodesByParentIdInput, GetDriveNodesByParentIdSchema, ListDriveTreeInput, ListDriveTreeSchema, NodesTableFilters, PresignDriveFileInput, PresignDriveFileSchema, UpdateDriveNodeInput, UpdateDriveNodeSchema, UploadDriveFileInput, UploadDriveFileSchema, createDriveFolderInputSchema, driveNodeAvailabilitySchema, driveNodeLinksSchema, driveNodeProviderSchema, driveNodeSchema, driveNodeSubtypeSchema, driveNodeTypeSchema, driveTableFiltersSchema, driveTreeSearchParams, getNodesByParentIdInputSchema, isFile, isFolder, listDriveTreeInputSchema, presignDriveFileInputSchema, renderBytes, updateDriveNodeInputSchema, uploadDriveFileInputSchema };

package/dist/index.mjs

@@ -0,0 +1,7 @@
+import { DRIVE_NODE_SUBTYPES, DRIVE_NODE_TYPES, DRIVE_PROVIDERS, DRIVE_VIEW_COOKIE, DRIVE_VIEW_COOKIE_MAX_AGE } from "./lib/constants.mjs";
+import { driveNodeAvailabilitySchema, driveNodeLinksSchema, driveNodeProviderSchema, driveNodeSchema, driveNodeSubtypeSchema, driveNodeTypeSchema } from "./lib/dto.mjs";
+import { isFile, isFolder, renderBytes } from "./lib/helpers.mjs";
+import { driveTreeSearchParams } from "./lib/search-params.mjs";
+import { createDriveFolderInputSchema, driveTableFiltersSchema, getNodesByParentIdInputSchema, listDriveTreeInputSchema, presignDriveFileInputSchema, updateDriveNodeInputSchema, uploadDriveFileInputSchema } from "./lib/validators.mjs";
+
+export { DRIVE_NODE_SUBTYPES, DRIVE_NODE_TYPES, DRIVE_PROVIDERS, DRIVE_VIEW_COOKIE, DRIVE_VIEW_COOKIE_MAX_AGE, createDriveFolderInputSchema, driveNodeAvailabilitySchema, driveNodeLinksSchema, driveNodeProviderSchema, driveNodeSchema, driveNodeSubtypeSchema, driveNodeTypeSchema, driveTableFiltersSchema, driveTreeSearchParams, getNodesByParentIdInputSchema, isFile, isFolder, listDriveTreeInputSchema, presignDriveFileInputSchema, renderBytes, updateDriveNodeInputSchema, uploadDriveFileInputSchema };

package/dist/lib/constants.d.mts

@@ -0,0 +1,11 @@
+//#region src/lib/constants.d.ts
+declare const DRIVE_PROVIDERS: readonly ["local", "google"];
+declare const DRIVE_NODE_TYPES: readonly ["folder", "file"];
+declare const DRIVE_NODE_SUBTYPES: readonly ["image", "document", "spreadsheet", "video", "audio", "archive", "other"];
+/**
+ * The cookie name for storing the drive view mode (grid or list).
+ */
+declare const DRIVE_VIEW_COOKIE: "tulip.drive_view_mode";
+declare const DRIVE_VIEW_COOKIE_MAX_AGE: number;
+//#endregion
+export { DRIVE_NODE_SUBTYPES, DRIVE_NODE_TYPES, DRIVE_PROVIDERS, DRIVE_VIEW_COOKIE, DRIVE_VIEW_COOKIE_MAX_AGE };

package/dist/lib/constants.mjs

@@ -0,0 +1,20 @@
+//#region src/lib/constants.ts
+const DRIVE_PROVIDERS = ["local", "google"];
+const DRIVE_NODE_TYPES = ["folder", "file"];
+const DRIVE_NODE_SUBTYPES = [
+	"image",
+	"document",
+	"spreadsheet",
+	"video",
+	"audio",
+	"archive",
+	"other"
+];
+/**
+* The cookie name for storing the drive view mode (grid or list).
+*/
+const DRIVE_VIEW_COOKIE = "tulip.drive_view_mode";
+const DRIVE_VIEW_COOKIE_MAX_AGE = 3600 * 24 * 7;
+
+//#endregion
+export { DRIVE_NODE_SUBTYPES, DRIVE_NODE_TYPES, DRIVE_PROVIDERS, DRIVE_VIEW_COOKIE, DRIVE_VIEW_COOKIE_MAX_AGE };

package/dist/lib/contracts.d.mts

@@ -0,0 +1,100 @@
+import { DriveFolderParent, DriveNode, DriveNodeBase, DriveNodeChild, DriveNodeWithChildren } from "./dto.mjs";
+import { CreateDriveFolderInput, GetDriveNodesByParentIdInput, ListDriveTreeInput, PresignDriveFileInput, UpdateDriveNodeInput, UploadDriveFileInput } from "./validators.mjs";
+import { TableQueryResponse } from "@tulip-systems/core/data-tables/server";
+
+//#region src/lib/contracts.d.ts
+type DrivePresignedUploadResult<TNode extends DriveNodeBase = DriveNode> = {
+  uploadId: string;
+  presignedUrl: string;
+  node: TNode;
+};
+/**
+ * Read-only drive operations every provider should be able to support.
+ * This is the base contract for provider-agnostic consumers and intentionally
+ * excludes storage, upload, preview generation, readonly, and soft-delete
+ * behavior because those are provider capabilities, not universal drive reads.
+ */
+interface DriveReader<TNode extends DriveNodeBase = DriveNodeBase, TNodeWithChildren extends DriveNodeWithChildren<TNode> = DriveNodeWithChildren<TNode>, TNodeChild extends DriveNodeChild<TNode> = DriveNodeChild<TNode>> {
+  getNodeById(id: string): Promise<TNode | null>;
+  getNodeWithChildren(input: {
+    id: string;
+    namespace: string;
+  }): Promise<TNodeWithChildren | null>;
+  getNodesByParentId(input: GetDriveNodesByParentIdInput): Promise<TNode[]>;
+  listTree(input: ListDriveTreeInput): Promise<TableQueryResponse<TNode>>;
+  getFolderParents(input: {
+    id: string | null;
+    namespace: string;
+  }): Promise<Array<DriveFolderParent<TNode>>>;
+  getNodeChildren(ids: string[]): Promise<TNodeChild[]>;
+}
+/**
+ * Optional capability for providers that can mutate the node tree.
+ * Providers that are read-only, remote-index-only, or permission-limited should
+ * not implement this contract.
+ */
+interface DriveNodeMutations<TNode extends DriveNodeBase = DriveNodeBase> {
+  createFolder(input: CreateDriveFolderInput): Promise<TNode>;
+  updateNode(id: string, data: UpdateDriveNodeInput): Promise<TNode>;
+  moveNode(input: {
+    id: string;
+    parentId: string | null;
+  }): Promise<TNode>;
+  deleteNode(id: string): Promise<void>;
+  deleteNodes(ids: string[]): Promise<void>;
+}
+/**
+ * Optional capability for providers that accept a file body directly.
+ * The body type is provider-specific so the base contracts do not depend on any
+ * storage package or runtime upload representation.
+ */
+interface DriveDirectUpload<TNode extends DriveNodeBase = DriveNodeBase, TBody = unknown> {
+  uploadFile(input: UploadDriveFileInput & {
+    body: TBody;
+  }): Promise<TNode>;
+}
+/**
+ * Optional capability for providers that create upload sessions/URLs.
+ * The returned metadata is provider-specific; local/object-storage providers can
+ * expose asset metadata here without leaking storage concepts into the base Drive
+ * contract.
+ */
+interface DrivePresignedUpload<TNode extends DriveNodeBase = DriveNodeBase, TResult extends DrivePresignedUploadResult<TNode> = DrivePresignedUploadResult<TNode>> {
+  presignUpload(input: PresignDriveFileInput): Promise<TResult>;
+  confirmUpload(uploadId: string): Promise<TNode>;
+}
+/**
+ * Optional capability for providers that generate and persist preview variants.
+ * This is useful for local/object-storage providers. Providers with native
+ * previews, such as Google Drive, should not implement this just as a no-op.
+ */
+interface DrivePreviewGenerator {
+  generatePreviews(input: {
+    id: string;
+  }): Promise<void>;
+}
+/**
+ * Optional capability for providers that can lock/unlock nodes.
+ * Google Drive maps this to `contentRestrictions.readOnly`; local drive maps it
+ * to its readonly flag. This is intentionally not part of the base reader
+ * contract because not every provider can honestly enforce it.
+ */
+interface DriveReadonly<TNode extends DriveNodeBase = DriveNodeBase> {
+  setReadonly(ids: string[], readonly: boolean): Promise<TNode[]>;
+}
+/**
+ * Optional capability for providers that support soft removal.
+ * Local drive maps this to archive state; Google Drive maps this to trash.
+ */
+interface DriveArchive<TNode extends DriveNodeBase = DriveNodeBase> {
+  archiveNodes(ids: string[]): Promise<TNode[]>;
+  restoreNodes(ids: string[]): Promise<TNode[]>;
+}
+/**
+ * Base provider-agnostic Drive contract.
+ * Additional behavior should be composed by intersecting optional capability
+ * contracts, for example `Drive<TNode> & DriveNodeMutations<TNode>`.
+ */
+type Drive<TNode extends DriveNodeBase = DriveNodeBase> = DriveReader<TNode>;
+//#endregion
+export { Drive, DriveArchive, DriveDirectUpload, DriveNodeMutations, DrivePresignedUpload, DrivePresignedUploadResult, DrivePreviewGenerator, DriveReader, DriveReadonly };

package/dist/lib/dto.d.mts

@@ -0,0 +1,117 @@
+import { z } from "zod";
+
+//#region src/lib/dto.d.ts
+/**
+ * Drive node provider
+ */
+declare const driveNodeProviderSchema: z.ZodEnum<{
+  local: "local";
+  google: "google";
+}>;
+type DriveNodeProvider = z.infer<typeof driveNodeProviderSchema>;
+/**
+ * Drive node type
+ */
+declare const driveNodeTypeSchema: z.ZodEnum<{
+  file: "file";
+  folder: "folder";
+}>;
+type DriveNodeType = z.infer<typeof driveNodeTypeSchema>;
+/**
+ * Drive node subtype
+ */
+declare const driveNodeSubtypeSchema: z.ZodEnum<{
+  image: "image";
+  document: "document";
+  spreadsheet: "spreadsheet";
+  video: "video";
+  audio: "audio";
+  archive: "archive";
+  other: "other";
+}>;
+type DriveNodeSubtype = z.infer<typeof driveNodeSubtypeSchema>;
+/**
+ * Node availability
+ */
+declare const driveNodeAvailabilitySchema: z.ZodEnum<{
+  ready: "ready";
+  pending: "pending";
+  failed: "failed";
+}>;
+type DriveNodeAvailability = z.infer<typeof driveNodeAvailabilitySchema>;
+/**
+ * Node links
+ */
+declare const driveNodeLinksSchema: z.ZodObject<{
+  view: z.ZodNullable<z.ZodString>;
+  download: z.ZodNullable<z.ZodString>;
+  preview: z.ZodNullable<z.ZodString>;
+  thumbnail: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+type DriveNodeLinks = z.infer<typeof driveNodeLinksSchema>;
+/**
+ * Node
+ */
+declare const driveNodeSchema: z.ZodObject<{
+  id: z.ZodString;
+  provider: z.ZodEnum<{
+    local: "local";
+    google: "google";
+  }>;
+  createdAt: z.ZodDate;
+  updatedAt: z.ZodDate;
+  name: z.ZodString;
+  namespace: z.ZodString;
+  type: z.ZodEnum<{
+    file: "file";
+    folder: "folder";
+  }>;
+  subtype: z.ZodEnum<{
+    image: "image";
+    document: "document";
+    spreadsheet: "spreadsheet";
+    video: "video";
+    audio: "audio";
+    archive: "archive";
+    other: "other";
+  }>;
+  size: z.ZodNullable<z.ZodNumber>;
+  contentType: z.ZodNullable<z.ZodString>;
+  readonly: z.ZodBoolean;
+  hidden: z.ZodBoolean;
+  archivedAt: z.ZodNullable<z.ZodDate>;
+  parentId: z.ZodNullable<z.ZodString>;
+  links: z.ZodObject<{
+    view: z.ZodNullable<z.ZodString>;
+    download: z.ZodNullable<z.ZodString>;
+    preview: z.ZodNullable<z.ZodString>;
+    thumbnail: z.ZodNullable<z.ZodString>;
+  }, z.core.$strip>;
+  availability: z.ZodEnum<{
+    ready: "ready";
+    pending: "pending";
+    failed: "failed";
+  }>;
+}, z.core.$strip>;
+type DriveNode = z.infer<typeof driveNodeSchema>;
+type DriveNodeBase = Omit<DriveNode, "provider">;
+/**
+ * Node with children
+ */
+type DriveNodeWithChildren<TNode extends DriveNodeBase = DriveNode> = TNode & {
+  children: TNode[];
+};
+/**
+ * Node parent and child types
+ */
+type DriveFolderParent<TNode extends DriveNodeBase = DriveNode> = Pick<TNode, "id" | "name" | "parentId"> & {
+  depth: number;
+};
+/**
+ * Node child type
+ */
+type DriveNodeChild<TNode extends DriveNodeBase = DriveNode> = TNode & {
+  depth: number;
+};
+//#endregion
+export { DriveFolderParent, DriveNode, DriveNodeAvailability, DriveNodeBase, DriveNodeChild, DriveNodeLinks, DriveNodeProvider, DriveNodeSubtype, DriveNodeType, DriveNodeWithChildren, driveNodeAvailabilitySchema, driveNodeLinksSchema, driveNodeProviderSchema, driveNodeSchema, driveNodeSubtypeSchema, driveNodeTypeSchema };

package/dist/lib/dto.mjs

@@ -0,0 +1,57 @@
+import { DRIVE_NODE_SUBTYPES, DRIVE_NODE_TYPES, DRIVE_PROVIDERS } from "./constants.mjs";
+import { z } from "zod";
+
+//#region src/lib/dto.ts
+/**
+* Drive node provider
+*/
+const driveNodeProviderSchema = z.enum(DRIVE_PROVIDERS);
+/**
+* Drive node type
+*/
+const driveNodeTypeSchema = z.enum(DRIVE_NODE_TYPES);
+/**
+* Drive node subtype
+*/
+const driveNodeSubtypeSchema = z.enum(DRIVE_NODE_SUBTYPES);
+/**
+* Node availability
+*/
+const driveNodeAvailabilitySchema = z.enum([
+	"ready",
+	"pending",
+	"failed"
+]);
+/**
+* Node links
+*/
+const driveNodeLinksSchema = z.object({
+	view: z.string().nullable(),
+	download: z.string().nullable(),
+	preview: z.string().nullable(),
+	thumbnail: z.string().nullable()
+});
+/**
+* Node
+*/
+const driveNodeSchema = z.object({
+	id: z.string(),
+	provider: driveNodeProviderSchema,
+	createdAt: z.date(),
+	updatedAt: z.date(),
+	name: z.string(),
+	namespace: z.string(),
+	type: driveNodeTypeSchema,
+	subtype: driveNodeSubtypeSchema,
+	size: z.number().nullable(),
+	contentType: z.string().nullable(),
+	readonly: z.boolean(),
+	hidden: z.boolean(),
+	archivedAt: z.date().nullable(),
+	parentId: z.string().nullable(),
+	links: driveNodeLinksSchema,
+	availability: driveNodeAvailabilitySchema
+});
+
+//#endregion
+export { driveNodeAvailabilitySchema, driveNodeLinksSchema, driveNodeProviderSchema, driveNodeSchema, driveNodeSubtypeSchema, driveNodeTypeSchema };

package/dist/lib/helpers.d.mts

@@ -0,0 +1,17 @@
+import { DriveNode } from "./dto.mjs";
+
+//#region src/lib/helpers.d.ts
+/**
+ * Check if the node is a file
+ */
+declare function isFile(node: Pick<DriveNode, "type">): node is DriveNode;
+/**
+ * Check if the node is a folder
+ */
+declare function isFolder(node: Pick<DriveNode, "type">): node is DriveNode;
+/**
+ * Render bytes
+ */
+declare function renderBytes(bytes: number): string;
+//#endregion
+export { isFile, isFolder, renderBytes };