@tulip-systems/drive 0.7.0

package/src/providers/google/lib/validators.ts

@@ -0,0 +1,148 @@
+import z from "zod";
+import { type DriveNodeChild, driveNodeSchema } from "@/lib/dto";
+import {
+  createDriveFolderInputSchema,
+  driveTableFiltersSchema,
+  getNodesByParentIdInputSchema,
+  listDriveTreeInputSchema,
+  updateDriveNodeInputSchema,
+  uploadDriveFileInputSchema,
+} from "@/lib/validators";
+
+/**
+ * GoogleDriveNode schema
+ * @description zod schema for validating the shape of a GoogleDriveNode
+ */
+export const googleDriveNodeSchema = driveNodeSchema.extend({
+  /**
+   * Constant discriminator for Google-backed nodes.
+   * Maps to the provider implementation, not to a Google Drive API field.
+   */
+  provider: z.literal("google"),
+  /**
+   * Native Google shared drive id from `drive_v3.Schema$File.driveId`.
+   * We keep this provider-specific field only as source metadata. The shared
+   * `DriveNode.namespace` field is the canonical namespace used by callers.
+   */
+  googleDriveId: z.string().nullable(),
+  /**
+   * Original Google Drive MIME type from `drive_v3.Schema$File.mimeType`.
+   * The common `contentType` field uses the same source for files and `null`
+   * for folders so consumers can treat folders consistently across providers.
+   */
+  mimeType: z.string().nullable(),
+  /**
+   * Browser view URL from `drive_v3.Schema$File.webViewLink`.
+   * This is Google Drive's closest equivalent to a provider-neutral view URL.
+   */
+  webViewLink: z.string().nullable(),
+
+  /**
+   * Download URL from `drive_v3.Schema$File.webContentLink`.
+   * Google only returns this for binary files, not for all Google-native docs.
+   */
+  webContentLink: z.string().nullable(),
+  /**
+   * Thumbnail URL from `drive_v3.Schema$File.thumbnailLink`.
+   * Google provides this opportunistically, so the common `links.thumbnail`
+   * field is nullable.
+   */
+  thumbnailLink: z.string().nullable(),
+  /**
+   * Native Google trash state from `drive_v3.Schema$File.trashed`.
+   * The common `archivedAt` field derives from this because the local provider
+   * models soft removal as archive while Google Drive models it as trash.
+   */
+  trashed: z.boolean(),
+  /**
+   * Native Google trash timestamp from `drive_v3.Schema$File.trashedTime`.
+   * The common `archivedAt` field uses this when available, falling back to the
+   * modified time when Google only exposes `trashed: true`.
+   */
+  trashedAt: z.date().nullable(),
+  /**
+   * Raw Google parent ids from `drive_v3.Schema$File.parents`.
+   * The common `parentId` field uses the first parent, with the configured
+   * namespace converted to `null` so root nodes match the local provider shape.
+   */
+  googleParents: z.array(z.string()),
+
+  /**
+   * Google edit capability from `drive_v3.Schema$File.capabilities.canEdit`.
+   * The common `readonly` field is true when Google content restrictions mark
+   * the file readonly or when Google says the user cannot edit the file.
+   */
+  canEdit: z.boolean().nullable(),
+});
+
+export type GoogleDriveNode = z.infer<typeof googleDriveNodeSchema>;
+export type GoogleDriveNodeChild = DriveNodeChild<GoogleDriveNode>;
+
+/**
+ * GoogleDriveNodeWithChildren schema
+ * @description zod schema for validating the shape of a GoogleDriveNode with children
+ */
+export const googleDriveNodeWithChildrenSchema = googleDriveNodeSchema.extend({
+  children: z.array(googleDriveNodeSchema),
+});
+
+export type GoogleDriveNodeWithChildren = z.infer<typeof googleDriveNodeWithChildrenSchema>;
+
+/**
+ * Create drive folder input schema
+ * @description zod schema for validating the input of the create drive folder command
+ */
+export const createGoogleDriveFolderInputSchema = createDriveFolderInputSchema;
+
+export type CreateGoogleDriveFolderInput = z.input<typeof createGoogleDriveFolderInputSchema>;
+export type CreateGoogleDriveFolderSchema = z.infer<typeof createGoogleDriveFolderInputSchema>;
+
+/**
+ * Update drive node input schema
+ * @description zod schema for validating the input of the update drive node command
+ */
+export const updateGoogleDriveNodeInputSchema = updateDriveNodeInputSchema.extend({
+  isArchived: z.boolean().optional(),
+});
+
+export type UpdateGoogleDriveNodeInput = z.input<typeof updateGoogleDriveNodeInputSchema>;
+export type UpdateGoogleDriveNodeSchema = z.infer<typeof updateGoogleDriveNodeInputSchema>;
+
+/**
+ * Upload drive file input schema
+ * @description zod schema for validating the input of the upload drive file command
+ */
+export const uploadGoogleDriveFileInputSchema = uploadDriveFileInputSchema;
+
+export type UploadGoogleDriveFileInput = z.input<typeof uploadGoogleDriveFileInputSchema>;
+export type UploadGoogleDriveFileSchema = z.infer<typeof uploadGoogleDriveFileInputSchema>;
+
+/**
+ * Filters
+ */
+export const googleDriveTableFiltersSchema = driveTableFiltersSchema;
+
+export type GoogleDriveTableFilters = z.infer<typeof googleDriveTableFiltersSchema>;
+export type GoogleDriveTableFiltersInput = z.input<typeof googleDriveTableFiltersSchema>;
+
+/**
+ * List drive tree input schema
+ * @description zod schema for validating the input of the list drive tree command
+ */
+export const listGoogleDriveTreeInputSchema = listDriveTreeInputSchema;
+
+export type ListGoogleDriveTreeInput = z.input<typeof listGoogleDriveTreeInputSchema>;
+export type ListGoogleDriveTreeSchema = z.infer<typeof listGoogleDriveTreeInputSchema>;
+
+/**
+ * Get drive nodes by parent id input schema
+ * @description zod schema for validating the input of the get drive nodes by parent id command
+ */
+export const getGoogleDriveNodesByParentIdInputSchema = getNodesByParentIdInputSchema;
+
+export type GetGoogleDriveNodesByParentIdInput = z.input<
+  typeof getGoogleDriveNodesByParentIdInputSchema
+>;
+export type GetGoogleDriveNodesByParentIdSchema = z.infer<
+  typeof getGoogleDriveNodesByParentIdInputSchema
+>;

package/src/providers/local/components/command-file-update.tsx

@@ -0,0 +1,93 @@
+"use client";
+
+import { zodResolver } from "@hookform/resolvers/zod";
+import type { DefaultError, MutationOptions } from "@tanstack/react-query";
+import {
+  CommandFormDialog,
+  CommandFormDialogCancel,
+  CommandFormDialogContent,
+  CommandFormDialogFields,
+  CommandFormDialogFooter,
+  CommandFormDialogHeader,
+  CommandFormDialogSubmit,
+  CommandFormDialogTitle,
+  CommandFormDialogTrigger,
+  CommandLabel,
+} from "@tulip-systems/core/commands/client";
+import { Input } from "@tulip-systems/core/components";
+import {
+  Form,
+  FormControl,
+  FormField,
+  FormItem,
+  FormLabel,
+  FormMessage,
+} from "@tulip-systems/core/components/client";
+import { FilePen } from "lucide-react";
+import { useForm } from "react-hook-form";
+import { type UpdateLocalDriveNodeInput, updateLocalDriveNodeInputSchema } from "../lib/validators";
+
+export type LocalDriveFileUpdateCommandProps<
+  TData = unknown,
+  TError = DefaultError,
+  TVariables = unknown,
+  TOnMutateResult = unknown,
+> = {
+  defaultValues: Partial<UpdateLocalDriveNodeInput>;
+  variables: (values: UpdateLocalDriveNodeInput) => TVariables;
+  mutation: MutationOptions<TData, TError, TVariables, TOnMutateResult>;
+};
+
+export function LocalDriveFileUpdateCommand<
+  TData = unknown,
+  TError = DefaultError,
+  TVariables = unknown,
+  TOnMutateResult = unknown,
+>({
+  defaultValues,
+  variables,
+  mutation,
+}: LocalDriveFileUpdateCommandProps<TData, TError, TVariables, TOnMutateResult>) {
+  const form = useForm<UpdateLocalDriveNodeInput>({
+    resolver: zodResolver(updateLocalDriveNodeInputSchema),
+    defaultValues,
+  });
+
+  return (
+    <Form {...form}>
+      <CommandFormDialog>
+        <CommandFormDialogTrigger label="Wijzigen">
+          <FilePen className="size-4" />
+          <CommandLabel />
+        </CommandFormDialogTrigger>
+
+        <CommandFormDialogContent variables={variables} mutation={mutation}>
+          <CommandFormDialogHeader>
+            <CommandFormDialogTitle>Bestand wijzigen</CommandFormDialogTitle>
+          </CommandFormDialogHeader>
+
+          <CommandFormDialogFields>
+            <FormField
+              control={form.control}
+              name="name"
+              render={({ field }) => (
+                <FormItem>
+                  <FormLabel>Naam</FormLabel>
+                  <FormControl>
+                    <Input {...field} value={field.value ?? ""} />
+                  </FormControl>
+                  <FormMessage />
+                </FormItem>
+              )}
+            />
+          </CommandFormDialogFields>
+
+          <CommandFormDialogFooter>
+            <CommandFormDialogCancel>Annuleren</CommandFormDialogCancel>
+            <CommandFormDialogSubmit>Opslaan</CommandFormDialogSubmit>
+          </CommandFormDialogFooter>
+        </CommandFormDialogContent>
+      </CommandFormDialog>
+    </Form>
+  );
+}

package/src/providers/local/components/command-file-upload.tsx

@@ -0,0 +1,29 @@
+"use client";
+
+import { CommandEmpty, CommandLabel } from "@tulip-systems/core/commands/client";
+import { Input } from "@tulip-systems/core/components";
+import { cn } from "@tulip-systems/core/lib";
+import { UploadIcon } from "lucide-react";
+import type { ComponentProps } from "react";
+import { useLocalDriveUploadZone } from "./upload-zone-context.client";
+
+export function LocalDriveFilesUploadCommand({ className, ...props }: ComponentProps<"div">) {
+  const { onUpload } = useLocalDriveUploadZone();
+
+  return (
+    <CommandEmpty {...props} className={cn("relative gap-2", className)} label="Upload">
+      <UploadIcon className="h-3 w-3" />
+      <CommandLabel />
+
+      <Input
+        type="file"
+        className="absolute inset-0 z-10 h-full w-full cursor-pointer opacity-0"
+        multiple
+        onChange={(event) => {
+          if (!event.target.files) return;
+          Array.from(event.target.files).forEach(onUpload);
+        }}
+      />
+    </CommandEmpty>
+  );
+}

package/src/providers/local/components/command-folder-create.tsx

@@ -0,0 +1,100 @@
+"use client";
+
+import { zodResolver } from "@hookform/resolvers/zod";
+import type { DefaultError, MutationOptions } from "@tanstack/react-query";
+import {
+  CommandFormDialog,
+  CommandFormDialogCancel,
+  CommandFormDialogContent,
+  CommandFormDialogFields,
+  CommandFormDialogFooter,
+  CommandFormDialogHeader,
+  CommandFormDialogSubmit,
+  CommandFormDialogTitle,
+  CommandFormDialogTrigger,
+  CommandLabel,
+} from "@tulip-systems/core/commands/client";
+import { Input } from "@tulip-systems/core/components";
+import {
+  Form,
+  FormControl,
+  FormField,
+  FormItem,
+  FormLabel,
+  FormMessage,
+} from "@tulip-systems/core/components/client";
+import { FolderPlus } from "lucide-react";
+import { useQueryStates } from "nuqs";
+import { useForm } from "react-hook-form";
+import { driveTreeSearchParams } from "@/lib/search-params";
+import {
+  type CreateLocalDriveFolderInput,
+  createLocalDriveFolderInputSchema,
+} from "../lib/validators";
+
+export type LocalDriveFoldersCreateCommandProps<
+  TData = unknown,
+  TError = DefaultError,
+  TVariables = unknown,
+  TOnMutateResult = unknown,
+> = {
+  defaultValues?: Partial<CreateLocalDriveFolderInput>;
+  variables: (values: CreateLocalDriveFolderInput) => TVariables;
+  mutation: MutationOptions<TData, TError, TVariables, TOnMutateResult>;
+};
+
+export function LocalDriveFoldersCreateCommand<
+  TData = unknown,
+  TError = DefaultError,
+  TVariables = unknown,
+  TOnMutateResult = unknown,
+>({
+  defaultValues,
+  variables,
+  mutation,
+}: LocalDriveFoldersCreateCommandProps<TData, TError, TVariables, TOnMutateResult>) {
+  const [{ parentId }] = useQueryStates(driveTreeSearchParams);
+
+  const form = useForm<CreateLocalDriveFolderInput>({
+    resolver: zodResolver(createLocalDriveFolderInputSchema),
+    defaultValues: { ...defaultValues, parentId },
+  });
+
+  return (
+    <Form {...form}>
+      <CommandFormDialog>
+        <CommandFormDialogTrigger label="Folder toevoegen" hotkey="mod+i">
+          <FolderPlus className="size-4" />
+          <CommandLabel />
+        </CommandFormDialogTrigger>
+
+        <CommandFormDialogContent variables={variables} mutation={mutation}>
+          <CommandFormDialogHeader>
+            <CommandFormDialogTitle>Folder toevoegen</CommandFormDialogTitle>
+          </CommandFormDialogHeader>
+
+          <CommandFormDialogFields>
+            <FormField
+              control={form.control}
+              name="name"
+              render={({ field }) => (
+                <FormItem>
+                  <FormLabel>Naam</FormLabel>
+                  <FormControl>
+                    <Input {...field} value={field.value ?? ""} />
+                  </FormControl>
+                  <FormMessage />
+                </FormItem>
+              )}
+            />
+          </CommandFormDialogFields>
+
+          <CommandFormDialogFooter>
+            <CommandFormDialogCancel>Annuleren</CommandFormDialogCancel>
+            <CommandFormDialogSubmit>Toevoegen</CommandFormDialogSubmit>
+          </CommandFormDialogFooter>
+        </CommandFormDialogContent>
+      </CommandFormDialog>
+    </Form>
+  );
+}

package/src/providers/local/components/command-folder-update.tsx

@@ -0,0 +1,93 @@
+"use client";
+
+import { zodResolver } from "@hookform/resolvers/zod";
+import type { DefaultError, MutationOptions } from "@tanstack/react-query";
+import {
+  CommandFormDialog,
+  CommandFormDialogCancel,
+  CommandFormDialogContent,
+  CommandFormDialogFields,
+  CommandFormDialogFooter,
+  CommandFormDialogHeader,
+  CommandFormDialogSubmit,
+  CommandFormDialogTitle,
+  CommandFormDialogTrigger,
+  CommandLabel,
+} from "@tulip-systems/core/commands/client";
+import { Input } from "@tulip-systems/core/components";
+import {
+  Form,
+  FormControl,
+  FormField,
+  FormItem,
+  FormLabel,
+  FormMessage,
+} from "@tulip-systems/core/components/client";
+import { FolderPen } from "lucide-react";
+import { useForm } from "react-hook-form";
+import { type UpdateLocalDriveNodeInput, updateLocalDriveNodeInputSchema } from "../lib/validators";
+
+export type LocalDriveFoldersUpdateCommandProps<
+  TData = unknown,
+  TError = DefaultError,
+  TVariables = unknown,
+  TOnMutateResult = unknown,
+> = {
+  defaultValues: Partial<UpdateLocalDriveNodeInput>;
+  variables: (values: UpdateLocalDriveNodeInput) => TVariables;
+  mutation: MutationOptions<TData, TError, TVariables, TOnMutateResult>;
+};
+
+export function LocalDriveFoldersUpdateCommand<
+  TData = unknown,
+  TError = DefaultError,
+  TVariables = unknown,
+  TOnMutateResult = unknown,
+>({
+  defaultValues,
+  variables,
+  mutation,
+}: LocalDriveFoldersUpdateCommandProps<TData, TError, TVariables, TOnMutateResult>) {
+  const form = useForm<UpdateLocalDriveNodeInput>({
+    resolver: zodResolver(updateLocalDriveNodeInputSchema),
+    defaultValues,
+  });
+
+  return (
+    <Form {...form}>
+      <CommandFormDialog>
+        <CommandFormDialogTrigger label="Wijzigen">
+          <FolderPen className="size-4" />
+          <CommandLabel />
+        </CommandFormDialogTrigger>
+
+        <CommandFormDialogContent variables={variables} mutation={mutation}>
+          <CommandFormDialogHeader>
+            <CommandFormDialogTitle>Folder wijzigen</CommandFormDialogTitle>
+          </CommandFormDialogHeader>
+
+          <CommandFormDialogFields>
+            <FormField
+              control={form.control}
+              name="name"
+              render={({ field }) => (
+                <FormItem>
+                  <FormLabel>Naam</FormLabel>
+                  <FormControl>
+                    <Input {...field} value={field.value ?? ""} />
+                  </FormControl>
+                  <FormMessage />
+                </FormItem>
+              )}
+            />
+          </CommandFormDialogFields>
+
+          <CommandFormDialogFooter>
+            <CommandFormDialogCancel>Annuleren</CommandFormDialogCancel>
+            <CommandFormDialogSubmit>Opslaan</CommandFormDialogSubmit>
+          </CommandFormDialogFooter>
+        </CommandFormDialogContent>
+      </CommandFormDialog>
+    </Form>
+  );
+}

package/src/providers/local/components/content.client.tsx

@@ -0,0 +1,3 @@
+import { DriveContent } from "@/components/content";
+
+export const LocalDriveContent = DriveContent;

package/src/providers/local/components/navigation.client.tsx

@@ -0,0 +1,23 @@
+"use client";
+
+import {
+  DriveHeader,
+  DriveHeaderBreadcrumbs,
+  DriveHeaderTools,
+} from "@/components/navigation/header.client";
+import {
+  DriveToolbar,
+  DriveToolbarBreadcrumbs,
+  DriveToolbarTools,
+} from "@/components/navigation/toolbar.client";
+import { DriveViewSwitcher } from "@/components/navigation/view-switcher.client";
+
+export type { DriveBreadcrumb } from "@/components/navigation/breadcrumbs.client";
+
+export const LocalDriveHeader = DriveHeader;
+export const LocalDriveHeaderBreadcrumbs = DriveHeaderBreadcrumbs;
+export const LocalDriveHeaderTools = DriveHeaderTools;
+export const LocalDriveToolbar = DriveToolbar;
+export const LocalDriveToolbarBreadcrumbs = DriveToolbarBreadcrumbs;
+export const LocalDriveToolbarTools = DriveToolbarTools;
+export const LocalDriveViewSwitcher = DriveViewSwitcher;

package/src/providers/local/components/provider.client.tsx

@@ -0,0 +1,90 @@
+"use client";
+
+import { Allowed } from "@tulip-systems/core/auth/client";
+import { createContext, type PropsWithChildren, use } from "react";
+import type { DriveContextValue } from "@/components/context.client";
+import { DriveDragDropProvider, type DriveDragDropProviderProps } from "@/components/dnd.client";
+import {
+  type DriveSelectionContextValue,
+  DriveSelectionProvider,
+} from "@/components/selection.client";
+import { DriveViewProvider, type DriveViewProviderProps } from "@/components/view.client";
+import { LocalDriveUploadZone, type LocalDriveUploadZoneProps } from "./upload-zone.client";
+
+export type LocalDriveContextValue = DriveContextValue & {
+  readonly?: boolean;
+};
+
+export const LocalDriveContext = createContext({} as LocalDriveContextValue);
+
+export function useLocalDriveContext() {
+  const context = use(LocalDriveContext);
+  if (!context) throw new Error("LocalDriveContext not found!");
+  return context;
+}
+
+export type LocalDriveProviderProps = PropsWithChildren<
+  LocalDriveContextValue &
+    Partial<DriveSelectionContextValue> &
+    Pick<DriveViewProviderProps, "initialView"> &
+    Pick<DriveDragDropProviderProps, "onMove"> &
+    Pick<
+      LocalDriveUploadZoneProps,
+      | "driveUploadClient"
+      | "uploadHooks"
+      | "onUploadCompleted"
+      | "onUploadFailed"
+      | "optimistic"
+      | "disabled"
+      | "className"
+    > & {
+      parentId?: string | null;
+    }
+>;
+
+export function LocalDriveProvider({
+  initialView = "grid",
+  namespace,
+  parentId,
+  permission,
+  meta,
+  readonly = false,
+  selection,
+  selectionConditions,
+  onMove,
+  driveUploadClient,
+  uploadHooks,
+  onUploadCompleted,
+  onUploadFailed,
+  optimistic,
+  disabled,
+  className,
+  children,
+}: LocalDriveProviderProps) {
+  const isDisabled = disabled ?? readonly;
+
+  return (
+    <Allowed permission={permission}>
+      <DriveSelectionProvider selection={selection} selectionConditions={selectionConditions}>
+        <DriveViewProvider initialView={initialView}>
+          <DriveDragDropProvider disabled={isDisabled} onMove={onMove}>
+            <LocalDriveContext value={{ namespace, permission, meta, readonly }}>
+              <LocalDriveUploadZone
+                disabled={isDisabled}
+                className={className}
+                variables={{ namespace, parentId }}
+                driveUploadClient={driveUploadClient}
+                uploadHooks={uploadHooks}
+                onUploadCompleted={onUploadCompleted}
+                onUploadFailed={onUploadFailed}
+                optimistic={optimistic}
+              >
+                {children}
+              </LocalDriveUploadZone>
+            </LocalDriveContext>
+          </DriveDragDropProvider>
+        </DriveViewProvider>
+      </DriveSelectionProvider>
+    </Allowed>
+  );
+}

package/src/providers/local/components/upload-zone-context.client.tsx

@@ -0,0 +1,43 @@
+"use client";
+
+import React from "react";
+import type { LocalDriveUploadClient } from "@/providers/local/lib/upload.client";
+import type { LocalDriveFileNode, LocalDriveNodeWithAsset } from "@/providers/local/lib/validators";
+
+/**
+ * Upload Zone Context Value
+ */
+export type LocalDriveUploadZoneContextValue = {
+  driveUploadClient: LocalDriveUploadClient;
+  onUpload: (file: File) => Promise<LocalDriveFileNode>;
+  onRemove: (ids: string[]) => Promise<void>;
+  optimistic?: {
+    add?: (newValue: LocalDriveNodeWithAsset) => Promise<void> | void;
+    remove?: (ids: string[]) => Promise<void> | void;
+    invalidate?: () => Promise<void> | void;
+    cancel?: () => Promise<void> | void;
+  };
+  disabled?: boolean;
+};
+
+/**
+ * Upload Zone Context
+ */
+export const LocalDriveUploadZoneContext =
+  React.createContext<LocalDriveUploadZoneContextValue | null>(null);
+
+export type DriveUploadZoneContextValue = LocalDriveUploadZoneContextValue;
+export const DriveUploadZoneContext = LocalDriveUploadZoneContext;
+
+/**
+ * Upload Zone Hook
+ */
+export function useLocalDriveUploadZone() {
+  const context = React.useContext(LocalDriveUploadZoneContext);
+  if (!context) {
+    throw new Error("useUploadZone must be used within an UploadZoneContext provider");
+  }
+  return context;
+}
+
+export const useDriveUploadZone = useLocalDriveUploadZone;