@putkoff/abstract-securefiles 0.0.48 → 0.0.50

package/src/styles.css

@@ -0,0 +1,442 @@
+.sf-root {
+  --sf-border: color-mix(in srgb, currentColor 22%, transparent);
+  --sf-subtle: color-mix(in srgb, currentColor 6%, transparent);
+  --sf-accent: #2563eb;
+  --sf-danger: #dc2626;
+  max-width: 1100px;
+  margin: 0 auto;
+  padding: 16px;
+  display: flex;
+  flex-direction: column;
+  gap: 16px;
+  font-size: 14px;
+  text-align: left;
+}
+.sf-root *,
+.sf-root *::before,
+.sf-root *::after {
+  box-sizing: border-box;
+}
+.sf-head {
+  display: flex;
+  align-items: baseline;
+  justify-content: space-between;
+  gap: 12px;
+}
+.sf-head h2 {
+  margin: 0;
+  font-size: 1.4em;
+}
+.sf-muted {
+  opacity: 0.7;
+}
+.sf-error {
+  color: var(--sf-danger);
+}
+.sf-row {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  flex-wrap: wrap;
+}
+.sf-row--end {
+  justify-content: flex-end;
+}
+.sf-field {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  flex: 1;
+  min-width: 200px;
+}
+.sf-input {
+  font: inherit;
+  color: inherit;
+  background: var(--sf-subtle);
+  border: 1px solid var(--sf-border);
+  border-radius: 6px;
+  padding: 6px 10px;
+  width: 100%;
+  min-width: 0;
+}
+.sf-row .sf-input {
+  flex: 1;
+  width: auto;
+}
+.sf-btn {
+  font: inherit;
+  color: inherit;
+  background: var(--sf-subtle);
+  border: 1px solid var(--sf-border);
+  border-radius: 6px;
+  padding: 5px 12px;
+  cursor: pointer;
+  white-space: nowrap;
+}
+.sf-btn:hover:not(:disabled) {
+  border-color: var(--sf-accent);
+}
+.sf-btn:disabled {
+  opacity: 0.45;
+  cursor: default;
+}
+.sf-btn--primary {
+  background: var(--sf-accent);
+  border-color: var(--sf-accent);
+  color: #fff;
+}
+.sf-btn--danger:hover:not(:disabled),
+.sf-btn--armed {
+  border-color: var(--sf-danger);
+  color: var(--sf-danger);
+}
+.sf-btn--armed {
+  background: color-mix(in srgb, var(--sf-danger) 12%, transparent);
+}
+.sf-icon-btn {
+  font: inherit;
+  color: inherit;
+  background: none;
+  border: 1px solid transparent;
+  border-radius: 6px;
+  padding: 3px 6px;
+  cursor: pointer;
+}
+.sf-icon-btn:hover {
+  border-color: var(--sf-border);
+}
+.sf-upload {
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+}
+.sf-drop {
+  border: 2px dashed var(--sf-border);
+  border-radius: 12px;
+  padding: 28px 24px;
+  display: flex;
+  align-items: center;
+  gap: 20px;
+  cursor: pointer;
+  user-select: none;
+  transition: border-color 0.15s, background 0.15s, box-shadow 0.15s;
+}
+.sf-drop:hover,
+.sf-drop:focus-visible {
+  border-color: var(--sf-accent);
+  box-shadow: 0 4px 14px color-mix(in srgb, currentColor 10%, transparent);
+  outline: none;
+}
+.sf-drop p {
+  margin: 0;
+}
+.sf-drop__icon {
+  width: 72px;
+  height: 72px;
+  flex-shrink: 0;
+  opacity: 0.6;
+}
+.sf-drop__title {
+  font-size: 1.1em;
+  font-weight: 600;
+  margin-bottom: 4px !important;
+}
+.sf-drop__count {
+  margin-top: 6px !important;
+  font-weight: 600;
+  color: var(--sf-accent);
+}
+.sf-drop--active {
+  border-color: var(--sf-accent);
+  background: color-mix(in srgb, var(--sf-accent) 8%, transparent);
+}
+.sf-drop--active .sf-drop__icon {
+  opacity: 1;
+  color: var(--sf-accent);
+}
+.sf-mode {
+  gap: 14px;
+}
+.sf-queue progress {
+  width: 120px;
+}
+.sf-upload > .sf-row {
+  align-items: flex-end;
+}
+.sf-queue {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  max-height: 200px;
+  overflow: auto;
+}
+.sf-queue li {
+  display: flex;
+  justify-content: space-between;
+  gap: 12px;
+}
+.sf-queue__name {
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.sf-toolbar {
+  display: flex;
+  justify-content: space-between;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+.sf-search {
+  max-width: 320px;
+}
+.sf-table-wrap {
+  overflow-x: auto;
+  border: 1px solid var(--sf-border);
+  border-radius: 8px;
+}
+.sf-table {
+  width: 100%;
+  border-collapse: collapse;
+}
+.sf-table th,
+.sf-table td {
+  padding: 8px 10px;
+  border-bottom: 1px solid var(--sf-border);
+  text-align: left;
+  vertical-align: middle;
+}
+.sf-table tbody tr:last-child td {
+  border-bottom: none;
+}
+.sf-table th {
+  font-weight: 600;
+  background: var(--sf-subtle);
+}
+.sf-col-check {
+  width: 36px;
+}
+.sf-col-actions {
+  text-align: right !important;
+}
+.sf-dir td {
+  background: var(--sf-subtle);
+}
+.sf-dir__toggle {
+  font: inherit;
+  font-weight: 600;
+  color: inherit;
+  background: none;
+  border: none;
+  padding: 0;
+  cursor: pointer;
+}
+.sf-busy {
+  opacity: 0.55;
+}
+.sf-pill {
+  font: inherit;
+  font-size: 12px;
+  color: inherit;
+  background: var(--sf-subtle);
+  border: 1px solid var(--sf-border);
+  border-radius: 999px;
+  padding: 2px 10px;
+  cursor: pointer;
+}
+.sf-pill--on {
+  background: color-mix(in srgb, #16a34a 18%, transparent);
+  border-color: #16a34a;
+}
+.sf-overlay {
+  position: fixed;
+  inset: 0;
+  background: rgba(0, 0, 0, 0.5);
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  z-index: 1000;
+  padding: 16px;
+}
+.sf-dialog {
+  background: Canvas;
+  color: CanvasText;
+  border-radius: 10px;
+  padding: 18px 20px;
+  width: min(520px, 100%);
+  max-height: 90vh;
+  overflow: auto;
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+  text-align: left;
+  --sf-border: color-mix(in srgb, CanvasText 22%, transparent);
+  --sf-subtle: color-mix(in srgb, CanvasText 6%, transparent);
+}
+.sf-dialog__head {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+}
+.sf-dialog__head h3 {
+  margin: 0;
+}
+.sf-dialog > .sf-muted {
+  margin: 0;
+  word-break: break-all;
+}
+.sf-dialog__foot {
+  justify-content: flex-end;
+}
+.sf-fieldset {
+  border: none;
+  margin: 0;
+  padding: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+.sf-fieldset:disabled {
+  opacity: 0.5;
+}
+.sf-fieldset p {
+  margin: 0;
+}
+.sf-check {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  cursor: pointer;
+}
+.sf-check--inline {
+  display: inline-flex;
+}
+.sf-stack {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+.sf-stack p {
+  margin: 0;
+}
+.sf-row--bottom {
+  align-items: flex-end;
+}
+.sf-field--narrow {
+  flex: 0 1 200px;
+  min-width: 140px;
+}
+.sf-admin {
+  border: 1px solid var(--sf-border);
+  border-radius: 10px;
+  padding: 10px 14px;
+}
+.sf-admin > summary {
+  cursor: pointer;
+  font-weight: 600;
+}
+.sf-admin[open] > summary {
+  margin-bottom: 12px;
+}
+.sf-card {
+  border: 1px solid var(--sf-border);
+  border-radius: 8px;
+  padding: 12px;
+  display: flex;
+  flex-direction: column;
+  gap: 10px;
+}
+.sf-card h4 {
+  margin: 0;
+}
+.sf-card p {
+  margin: 0;
+}
+.sf-code {
+  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;
+  font-size: 12px;
+  resize: vertical;
+}
+.sf-roots {
+  list-style: none;
+  margin: 0;
+  padding: 0;
+  display: flex;
+  flex-direction: column;
+  gap: 6px;
+}
+.sf-roots li {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  gap: 12px;
+}
+.sf-root-select {
+  max-width: 420px;
+}
+.sf-browser {
+  border: 1px solid var(--sf-border);
+  border-radius: 6px;
+  max-height: 320px;
+  overflow: auto;
+  display: flex;
+  flex-direction: column;
+}
+.sf-browser > * {
+  padding: 5px 10px;
+  border-bottom: 1px solid var(--sf-border);
+}
+.sf-browser > *:last-child {
+  border-bottom: none;
+}
+.sf-browser__dir {
+  font: inherit;
+  color: inherit;
+  background: none;
+  border: none;
+  border-bottom: 1px solid var(--sf-border);
+  text-align: left;
+  cursor: pointer;
+}
+.sf-browser__dir:hover {
+  background: var(--sf-subtle);
+}
+.sf-browser__all {
+  background: var(--sf-subtle);
+  font-weight: 600;
+}
+.sf-browser__name {
+  flex: 1;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+}
+.sf-tag {
+  display: inline-block;
+  margin-left: 8px;
+  padding: 0 7px;
+  font-size: 11px;
+  border-radius: 999px;
+  border: 1px solid var(--sf-border);
+  vertical-align: middle;
+}
+.sf-tag--warn {
+  border-color: var(--sf-danger);
+  color: var(--sf-danger);
+}
+.sf-strike {
+  text-decoration: line-through;
+  opacity: 0.7;
+}
+.sf-browser__row {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+.sf-browser__row .sf-browser__dir {
+  flex: 1;
+  border-bottom: none;
+  padding: 0;
+}

package/src/types.ts

@@ -0,0 +1,56 @@
+export interface SecureFile {
+  id: number;
+  filename: string;
+  filepath: string;
+  uploader_id: string;
+  shareable: boolean;
+  has_password: boolean;
+  download_count: number;
+  download_limit: number | null;
+  created_at: string | null;
+  share_url: string;
+  /** true when the entry points at a file elsewhere on the server instead of an upload */
+  linked: boolean;
+  /** "folder" entries download as an uncompressed, resumable .tar of the whole directory */
+  kind: "file" | "folder";
+  source_path: string | null;
+  /** false when the file is missing on disk (or its allowed directory was removed) */
+  available: boolean;
+}
+
+export interface LinkRoot {
+  id: number;
+  path: string;
+  label: string | null;
+  exists: boolean;
+}
+
+export interface RootChallenge {
+  nonce: string;
+  message: string;
+  command: string;
+  expires: number;
+}
+
+export interface BrowseResult {
+  path: string;
+  root: string;
+  parent: string | null;
+  dirs: { name: string; path: string; linked_id: number | null }[];
+  files: { name: string; path: string; size: number; linked_id: number | null }[];
+  truncated: boolean;
+}
+
+export interface ShareUpdate {
+  id: number;
+  shareable?: boolean;
+  download_limit?: number | null;
+  /** null/undefined = leave unchanged, "" = remove, otherwise the new password */
+  password?: string | null;
+  reset_count?: boolean;
+}
+
+export interface SecureFilesProps {
+  /** API origin; defaults to https://api.abstractendeavors.com */
+  apiBase?: string;
+}

package/css.d.ts

@@ -1,2 +0,0 @@
-declare module '*.css';
-declare module '*.module.css';

package/dist/App/SecureFiles.d.ts

@@ -1,4 +0,0 @@
-import './../styles/SecureFiles/index.css';
-import React from 'react';
-declare const SecureFiles: React.FC;
-export default SecureFiles;

package/dist/App/index.d.ts

@@ -1 +0,0 @@
-export { default as SecureFiles } from './SecureFiles';

package/dist/FileHandlers/FileRow/imports.d.ts

@@ -1,2 +0,0 @@
-export type { FileRowProps } from './../imports';
-export { useState, Button, currentUsername } from './../imports';

package/dist/FileHandlers/FileRow/index.d.ts

@@ -1 +0,0 @@
-export { FileRow } from './src';

package/dist/FileHandlers/FileRow/src/index.d.ts

@@ -1 +0,0 @@
-export { default as FileRow } from './row_utils';

package/dist/FileHandlers/FileRow/src/row_utils.d.ts

@@ -1,2 +0,0 @@
-import type { FileRowProps } from './../imports';
-export default function FileRow({ file, onDownload, onSettings, onToggleShare, onDelete, }: FileRowProps): import("react/jsx-runtime").JSX.Element;

package/dist/FileHandlers/FileTable/imports.d.ts

@@ -1,4 +0,0 @@
-export { FileRow } from './../FileRow';
-export { ShareModal } from './../ShareModal';
-export type { FileItem, FileTableProps } from './../imports';
-export { useState, useFiles, downloadFile, Spinner, Input, currentUsername, Button } from './../imports';

package/dist/FileHandlers/FileTable/index.d.ts

@@ -1 +0,0 @@
-export { FileTable } from './src';

package/dist/FileHandlers/FileTable/src/index.d.ts

@@ -1 +0,0 @@
-export { default as FileTable } from './table_utils';

package/dist/FileHandlers/FileTable/src/table_utils.d.ts

@@ -1,2 +0,0 @@
-import type { FileTableProps } from './../imports';
-export default function FileTable({ files, loading, error, onToggleShare, onPatchShare, onDelete }: FileTableProps): import("react/jsx-runtime").JSX.Element;

package/dist/FileHandlers/ShareModal/imports.d.ts

@@ -1,2 +0,0 @@
-export { Button, Checkbox, Input, ClipboardIcon, createPortal, useEffect, useRef, useState } from './../imports';
-export type { ShareModalProps } from './../imports';

package/dist/FileHandlers/ShareModal/index.d.ts

@@ -1 +0,0 @@
-export { ShareModal } from './src';

package/dist/FileHandlers/ShareModal/src/index.d.ts

@@ -1 +0,0 @@
-export { default as ShareModal } from './share_utils';

package/dist/FileHandlers/ShareModal/src/share_utils.d.ts

@@ -1,2 +0,0 @@
-import type { ShareModalProps } from './../../imports';
-export default function ShareModal({ file, onClose, onSave }: ShareModalProps): import("react").ReactPortal | null;

package/dist/FileHandlers/Upload/imports.d.ts

@@ -1,2 +0,0 @@
-export { Input, useFiles, Button, uploadFiles, useState, useRef, useCallback, CloudArrowUpIcon, currentUsername } from './../imports';
-export type { UploadProps, FileItem, QueuedFile } from './../imports';

package/dist/FileHandlers/Upload/index.d.ts

@@ -1 +0,0 @@
-export { Upload } from './src';

package/dist/FileHandlers/Upload/src/index.d.ts

@@ -1,2 +0,0 @@
-export { default as Upload } from './upload_utils';
-export type { QueuedFile, UploadProps } from './../../../types';

package/dist/FileHandlers/Upload/src/upload_utils.d.ts

@@ -1,2 +0,0 @@
-import type { UploadProps } from './../imports';
-export default function Upload({ onUploaded }: UploadProps): import("react/jsx-runtime").JSX.Element;

package/dist/FileHandlers/imports.d.ts

@@ -1,4 +0,0 @@
-export type { QueuedFile, FileItem, FileTableProps, UploadProps, ShareModalProps, FileRowProps } from './../imports';
-export { CloudArrowUpIcon, currentUsername, Button, Checkbox, Input, Spinner, useEffect, useRef, useState, useCallback, ClipboardIcon, createPortal, } from './../imports';
-export { useFiles } from './../hooks';
-export { downloadFile, uploadFiles } from './../file_utils';

package/dist/FileHandlers/index.d.ts

@@ -1,4 +0,0 @@
-export { FileRow } from './FileRow';
-export { FileTable } from './FileTable';
-export { ShareModal } from './ShareModal';
-export { Upload } from './Upload';

package/dist/UI/index.d.ts

@@ -1,28 +0,0 @@
-import React from 'react';
-export type String = string | undefined | null;
-export type Astring = any[] | string | undefined | null;
-export type Trailing = React.ReactNode;
-export type ImportElem = {
-    reaxlEle?: React.InputHTMLAttributes<HTMLInputElement>;
-    label?: String;
-    checked?: boolean;
-    type?: string;
-    onChange?: any;
-    value?: any;
-    trailing?: Trailing;
-    className?: String;
-    classNames?: Astring;
-    disabled?: any;
-    placeholder?: any;
-    error?: string;
-    min?: any;
-    readOnly?: boolean;
-};
-export declare function Button({ children, color, variant, className, ...rest }: React.ButtonHTMLAttributes<HTMLButtonElement> & {
-    color?: 'gray' | 'green' | 'blue';
-    variant?: 'default' | 'icon' | 'primary' | 'secondary';
-    className?: string;
-}): import("react/jsx-runtime").JSX.Element;
-export declare function Checkbox({ label, className, classNames, ...rest }: ImportElem): import("react/jsx-runtime").JSX.Element;
-export declare function Input({ label, trailing, className, classNames, ...rest }: ImportElem): import("react/jsx-runtime").JSX.Element;
-export declare function Spinner(): import("react/jsx-runtime").JSX.Element;

package/dist/file_utils/imports.d.ts

@@ -1,2 +0,0 @@
-export { requireToken, alertit, fetchIt, stripPrefixes, make_path } from "./../imports";
-export type { FileItem, ApiRow } from "./../types";

package/dist/file_utils/index.d.ts

@@ -1 +0,0 @@
-export * from './src';

package/dist/file_utils/src/cookieFetch.d.ts

@@ -1,33 +0,0 @@
-/**
- * Cookie-authenticated API helpers.
- * All requests include credentials: 'include' so the browser sends the
- * session cookie (auth_session) automatically. No JWT tokens are used.
- *
- * API base URL resolution order (first truthy value wins):
- *   1. window.__SECURE_FILES_API_BASE__   – runtime override (any bundler)
- *   2. VITE_SECURE_FILES_API_BASE         – Vite env var
- *   3. REACT_APP_SECURE_FILES_API_BASE    – Create React App env var
- *   4. /api/secure-files                  – same-origin default
- *
- * Subdomain API example (set one of the above to the full origin + path):
- *   VITE_SECURE_FILES_API_BASE=https://api.example.com/secure-files
- */
-/**
- * Generic JSON fetch with session-cookie auth.
- * Throws Error("UNAUTHENTICATED") on 401 so callers can redirect to login.
- */
-export declare function cookieFetch<T = unknown>(path: string, body?: unknown, method?: "GET" | "POST" | "PUT" | "PATCH" | "DELETE"): Promise<T>;
-/**
- * Check whether the current session is valid.
- * Calls /userInfo which requires authentication; returns true if the user
- * is logged in, false otherwise (no exception thrown).
- */
-export declare function checkAuth(): Promise<boolean>;
-/**
- * Upload a single file using multipart/form-data with session-cookie auth.
- * @param file     The File object to upload.
- * @param relPath  Optional relative path within the user's directory.
- */
-export declare function cookieUpload(file: File, relPath?: string): Promise<unknown>;
-/** The resolved API base URL, exported for debugging / display purposes. */
-export declare const SECURE_FILES_API_BASE: string;

package/dist/file_utils/src/delete_utils/imports.d.ts

@@ -1 +0,0 @@
-export { requireToken, alertit } from "./../imports";

package/dist/file_utils/src/delete_utils/index.d.ts

@@ -1 +0,0 @@
-export * from './src';

package/dist/file_utils/src/delete_utils/src/delete_row.d.ts

@@ -1,2 +0,0 @@
-/** Given a checkbox inside a table-row → download that row’s file. */
-export declare function removeRow(cb: HTMLInputElement): Promise<void>;

package/dist/file_utils/src/delete_utils/src/delete_select.d.ts

@@ -1,4 +0,0 @@
-export declare function removeFile(item: {
-    id?: number | string;
-    filename?: string;
-}): Promise<void>;

package/dist/file_utils/src/delete_utils/src/delete_selected.d.ts

@@ -1,2 +0,0 @@
-/** Bulk download: pass a NodeList or array of checkboxes. */
-export declare function removeSelected(checkboxes: Iterable<HTMLInputElement>): Promise<void>;

package/dist/file_utils/src/delete_utils/src/index.d.ts

@@ -1,3 +0,0 @@
-export * from './delete_select';
-export * from './delete_selected';
-export * from './delete_row';

package/dist/file_utils/src/download_utils/imports.d.ts

@@ -1,2 +0,0 @@
-export { requireToken } from './../imports';
-export type { FileItem } from './../imports';

package/dist/file_utils/src/download_utils/index.d.ts

@@ -1 +0,0 @@
-export * from './src';