@putkoff/abstract-utilities 0.0.3

package/dist/index.d.ts

@@ -0,0 +1,360 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as react from 'react';
+import react__default from 'react';
+
+interface AppConfig {
+    API_BASE_URL: string;
+}
+declare let AppConfig: AppConfig;
+declare function loadConfig(): Promise<void>;
+
+/** Non-React “direct download” used by some old links (kept for parity) */
+declare function directDownload(relPath: string, filename: string): Promise<void>;
+
+/**
+
+***Changes**: None, as it’s self-contained and doesn’t rely on external imports.
+*
+*4. **secureFetchIt** (`src/functions/fetch/secureFetchIt.ts`):
+*   Since `secureFetchIt` isn’t provided, we’ll create a minimal implementation based on its usage in `Login` and `uploadFiles`. It’s assumed to be a wrapper around `fetch` that handles authentication and JSON parsing.
+*
+*/
+/** Pulls base-URL from AppConfig.API_BASE_URL, strips trailing slashes */
+declare function fetchIt(endpoint: string, body?: unknown, method?: string | null, headers?: Record<string, string> | null, blob?: boolean | null, no_api?: boolean, requireAuth?: boolean): Promise<unknown>;
+declare function secureFetchIt<T>(endpoint: string, body?: unknown, method?: string, headers?: Record<string, string> | null, blob?: false, noApi?: boolean, requireAuth?: boolean): Promise<T>;
+declare function secureFetchIt(endpoint: string, body?: unknown, method?: string, headers?: Record<string, string> | null, blob?: boolean, noApi?: boolean, withCredentials?: boolean, returnJson?: boolean): Promise<Blob>;
+declare function requestPatch(url: string, body?: unknown): Promise<Response>;
+declare function fetchSharePatch(file: unknown): Promise<void>;
+
+interface FileItem {
+    id: number | string;
+    filename: string;
+    uploader_id: string;
+    filepath: string;
+    created_at: string;
+    download_count: number;
+    download_limit: number | null;
+    shareable: boolean;
+    needsPassword: boolean;
+    share_password: string | null;
+}
+interface ApiRow {
+    id: number | string;
+    filename: string;
+    uploader_id: string;
+    filepath: string;
+    created_at: string;
+    download_count: number;
+    download_limit: number | null;
+    shareable: boolean;
+    needsPassword: boolean;
+    share_password: string;
+}
+interface FileListResponse {
+    files?: ApiRow[];
+}
+
+interface ChangePasswordProps {
+    onSuccess?: () => void;
+    onCancel?: () => void;
+}
+interface ChangePasswordFormProps {
+    username: string;
+    setUsername: (value: string) => void;
+    currentPwd: string;
+    setCurrentPwd: (value: string) => void;
+    newPwd: string;
+    setNewPwd: (value: string) => void;
+    busy: boolean;
+    msg: string | null;
+    onSubmit: (e: React.FormEvent) => void;
+    onCancel?: () => void;
+}
+
+interface InputProps {
+    label?: any;
+    type?: any;
+    value?: any;
+    onChange?: any;
+    disabled?: any;
+    placeholder?: any;
+    error?: string;
+}
+interface FetchVariables {
+    method: string;
+    headers: Record<string, string>;
+    body?: string | FormData;
+}
+/**
+ * Helpers for dealing with the JWT stored in localStorage.
+ */
+interface JwtPayload {
+    /** UNIX-epoch seconds (standard exp claim) */
+    exp: number;
+    /** Your backend also stores the username here */
+    username?: string;
+    /** Any other claims are allowed */
+    [key: string]: unknown;
+}
+
+interface LogoutButtonProps {
+    /** Fired after the user is fully logged out so you can redirect to /login */
+    onLoggedOut?: () => void;
+}
+
+interface LoginProps {
+    onSuccess?: () => void;
+}
+interface LoginFormProps {
+    username: string;
+    setUsername: (value: string) => void;
+    password: string;
+    setPassword: (value: string) => void;
+    error: string | null;
+    busy: boolean;
+    onSubmit: (e: React.FormEvent) => void;
+}
+
+/**
+ * Helpers for dealing with the JWT stored in localStorage.
+ */
+
+/**
+***Changes**:
+*- Updated import path for `InputProps` to `../../types/interfaces`.
+*
+*3. **Token Utilities** (`src/functions/auth/token_utils.ts`):
+*   Copy from `/var/www/abstractendeavors/my-login-app/src/functions/auth_utils/token_utils.ts`.
+*
+*/
+declare function isLoggedIn(): boolean;
+/** Read raw JWT from LocalStorage (or null if absent) */
+declare function getToken(): string | null;
+/**
+ * Add a Bearer Authorization header.
+ * A shallow copy of headers is returned so callers can keep chaining.
+ */
+declare function getAuthorizationHeader(headers?: Record<string, string> | null, token?: string | null): Record<string, string>;
+/** Throw + redirect if there’s no valid token; otherwise return it. */
+declare function requireToken(): string;
+/** True if token is structurally bad or its exp ≤ now. */
+declare function isTokenExpired(token: string): boolean;
+/** Convenience wrapper: return username from the JWT (or null). */
+declare function currentUsername(): string | null;
+declare function currentUsernames(): any;
+declare function decodeJwt(token: string): JwtPayload;
+
+declare function alertit(obj?: any): void;
+
+declare function downloadFile(item: FileItem): Promise<void>;
+
+declare function downloadSelect(relPath: string, filename: string): Promise<void>;
+
+/** Given a checkbox inside a table-row → download that row’s file. */
+declare function downloadRow(cb: HTMLInputElement): Promise<void>;
+/** Bulk download: pass a NodeList or array of checkboxes. */
+declare function downloadSelected(checkboxes: Iterable<HTMLInputElement>): Promise<void>;
+
+/** Helper function to trigger file download */
+declare function triggerDownload(blob: Blob, filename: string): void;
+
+/** Wire up header + row checkboxes once the table is in the DOM. */
+declare function initSelectAll(): void;
+
+/**
+ * Classic “select all rows” logic (still handy in non-React views
+ * such as the admin dashboard).
+ */
+declare function syncHeaderCheckbox(): void;
+
+/** Utility for other screens: toggle a list of checkboxes on/off. */
+declare function toggleCheckboxes(cbs: HTMLInputElement[]): void;
+
+/** Generic PATCH helper kept for other admin forms */
+declare function patchFileSetting(fileId: string, field: string, value: unknown): Promise<Record<string, unknown>>;
+
+/** Classic file-upload for the fallback HTML page. */
+declare function uploadFile(file: any, subdir: any): Promise<any>;
+
+interface UploadResponse {
+    filepath: string;
+}
+declare function uploadFiles(file: File, subdir?: string): Promise<UploadResponse>;
+
+declare function removeFile(item: any): Promise<void>;
+
+/** Bulk download: pass a NodeList or array of checkboxes. */
+declare function removeSelected(checkboxes: Iterable<HTMLInputElement>): Promise<void>;
+
+/** Given a checkbox inside a table-row → download that row’s file. */
+declare function removeRow(cb: HTMLInputElement): Promise<void>;
+
+/** GET /secure-list */
+declare function listFiles(setFiles?: any): Promise<any>;
+
+declare function getToggleShare(file: any): boolean;
+declare function updateFileShare(file: any): FileItem;
+/**
+ * Custom hook to toggle share settings on a file item
+ */
+declare function toggleShare(file: FileItem): Promise<void>;
+
+declare const PROTOCOL = "https://";
+declare const DOMAIN_NAME = "abstractendeavors";
+declare const BASE_URL = "https://abstractendeavors.com";
+declare const SUB_DIR = "secure-files";
+declare const PROD_PREFIX = "/secure-files/";
+declare const API_PREFIX = "/secure-files/api";
+declare const DEV_PREFIX = "/secure-files-dev/";
+
+declare function get_window(): (Window & typeof globalThis) | null;
+declare function get_window_location(): Location | "https://abstractendeavors.com" | null;
+declare function get_window_pathname(): string | null;
+declare function get_window_parts(): Location | "https://abstractendeavors.com" | null;
+
+declare function get_dirname(filePath: string | null): string;
+declare function get_basename(filePath: string | null): string;
+declare function get_filename(file_path: string): string;
+declare function get_extname(filePath: string | null): string;
+declare function get_splitext(filePath: string | null): {
+    filename: string;
+    extname: string;
+    ext?: undefined;
+} | {
+    filename: string;
+    ext: string;
+    extname?: undefined;
+};
+declare function make_path(...segments: string[]): string;
+declare function sanitizeFilename(filename: string): string;
+declare function make_sanitized_path(...paths: string[]): string;
+declare function normalizeUrl(base: string, p?: string): string;
+
+/**
+ * Returns the absolute path of the current file.
+ */
+declare function getAbsDir(): string;
+declare function getAbsPath(subPath: string): string;
+
+declare function getFunctionsDir(): string;
+declare function geAuthsUtilsDirectory(): string;
+declare function geBackupsUtilsDirectory(): string;
+declare function geConstantsUtilsDirectory(): string;
+declare function geEnvUtilsDirectory(): string;
+declare function geFetchUtilsDirectory(): string;
+declare function geFileUtilsDirectory(): string;
+declare function gePathUtilsDirectory(): string;
+declare function geStringUtilsDirectory(): string;
+declare function geTypeUtilsDirectory(): string;
+
+declare function getSrcDir(): string;
+declare function geStaticDirectory(): string;
+declare function getLibUtilsDirectory(): string;
+declare function getHooksUtilsDirectory(): string;
+declare function getFunctionsUtilsDirectory(): string;
+declare function getComponentsUtilsDirectory(): string;
+
+declare function getBaseDir(): string;
+declare function getPublicDir(): string;
+declare function getDistDir(): string;
+declare function getEnvDir(): string;
+
+declare function getEnvPath(string?: string): string;
+declare function getDbConfigsPath(): string;
+declare function getSchemasPath(): string;
+declare function getSchemasDirPath(subPath: string): string;
+
+declare function getSubstring(obj: string, maxLength?: number | null, minLength?: number | null): string;
+declare function truncateString(obj: string, maxLength?: number): string;
+/**
+ * Remove *every* occurrence of any prefix in `bases` from the *beginning*
+ * of `str`, looping until no prefix matches.
+ *
+ * @example
+ *   stripPrefixes('/site/site/docs', ['/site', '/static']);
+ *   // → '/docs'
+ */
+declare function stripPrefixes(str: string, bases?: string | string[]): string;
+/**
+ * Removes characters from the beginning of the string
+ * if they are found in the list of characters.
+ *
+ * @param str - The input string.
+ * @param listObjects - A string or an array of characters to remove.
+ * @returns The modified string.
+ */
+declare function eatInner(str: string, listObjects: string | string[]): string;
+/**
+ * Removes characters from the end of the string
+ * if they are found in the list of characters.
+ *
+ * @param str - The input string.
+ * @param listObjects - A string or an array of characters to remove.
+ * @returns The modified string.
+ */
+declare function eatOuter(str: string, listObjects: string | string[]): string;
+/**
+ * Removes characters from both the beginning and the end of the string
+ * if they are found in the list of characters.
+ *
+ * @param str - The input string.
+ * @param listObjects - A string or an array of characters to remove.
+ * @returns The modified string.
+ */
+declare function eatAll(str: string, listObjects: string | string[]): string;
+declare function eatEnd(obj: string, endings?: string[]): string;
+
+declare function ensure_list<T>(obj: T | T[]): T[];
+
+declare function Button({ children, color, ...rest }: react__default.ButtonHTMLAttributes<HTMLButtonElement> & {
+    color?: 'gray' | 'green' | 'blue';
+}): react_jsx_runtime.JSX.Element;
+
+declare function Checkbox({ label, ...rest }: react__default.InputHTMLAttributes<HTMLInputElement> & {
+    label: string;
+}): react_jsx_runtime.JSX.Element;
+
+declare function Input({ label, trailing, ...rest }: react__default.InputHTMLAttributes<HTMLInputElement> & {
+    label: string;
+    trailing?: react__default.ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+declare function Spinner(): react_jsx_runtime.JSX.Element;
+
+/**
+ * Custom hook that returns a memoized loadFiles callback
+ */
+declare const useLoadFiles: (setLoading: React.Dispatch<React.SetStateAction<boolean>>, setError: React.Dispatch<React.SetStateAction<Error | null>>, setFiles: React.Dispatch<React.SetStateAction<FileItem[]>>) => () => Promise<void>;
+
+/**
+ * Custom hook to toggle share settings on a file item
+ */
+declare const useToggleShare: (setFiles: React.Dispatch<React.SetStateAction<FileItem[]>>) => (file: FileItem) => Promise<void>;
+
+/**
+ * Custom hook for optimistic share-setting patch updates
+ */
+/**
+ * Custom hook to toggle share settings on a file item
+ */
+declare const usePatchShareSettings: (setFiles: React.Dispatch<React.SetStateAction<FileItem[]>>) => (file: FileItem) => Promise<void>;
+
+declare function useFiles(): {
+    files: FileItem[];
+    loading: boolean;
+    error: Error | null;
+    load: () => Promise<void>;
+    toggleShare: (file: FileItem) => Promise<void>;
+    patchShareSettings: (file: FileItem) => Promise<void>;
+    deleteFile: (file: FileItem) => Promise<void>;
+    setFiles: react.Dispatch<react.SetStateAction<FileItem[]>>;
+    setLoading: react.Dispatch<react.SetStateAction<boolean>>;
+    setError: react.Dispatch<react.SetStateAction<Error | null>>;
+};
+
+/**
+ * Custom hook to toggle share settings on a file item
+ */
+declare const useDeleteFile: (setFiles: React.Dispatch<React.SetStateAction<FileItem[]>>) => (file: FileItem) => Promise<void>;
+
+export { API_PREFIX, type ApiRow, AppConfig, BASE_URL, Button, type ChangePasswordFormProps, type ChangePasswordProps, Checkbox, DEV_PREFIX, DOMAIN_NAME, type FetchVariables, type FileItem, type FileListResponse, Input, type InputProps, type JwtPayload, type LoginFormProps, type LoginProps, type LogoutButtonProps, PROD_PREFIX, PROTOCOL, SUB_DIR, Spinner, alertit, currentUsername, currentUsernames, decodeJwt, directDownload, downloadFile, downloadRow, downloadSelect, downloadSelected, eatAll, eatEnd, eatInner, eatOuter, ensure_list, fetchIt, fetchSharePatch, geAuthsUtilsDirectory, geBackupsUtilsDirectory, geConstantsUtilsDirectory, geEnvUtilsDirectory, geFetchUtilsDirectory, geFileUtilsDirectory, gePathUtilsDirectory, geStaticDirectory, geStringUtilsDirectory, geTypeUtilsDirectory, getAbsDir, getAbsPath, getAuthorizationHeader, getBaseDir, getComponentsUtilsDirectory, getDbConfigsPath, getDistDir, getEnvDir, getEnvPath, getFunctionsDir, getFunctionsUtilsDirectory, getHooksUtilsDirectory, getLibUtilsDirectory, getPublicDir, getSchemasDirPath, getSchemasPath, getSrcDir, getSubstring, getToggleShare, getToken, get_basename, get_dirname, get_extname, get_filename, get_splitext, get_window, get_window_location, get_window_parts, get_window_pathname, initSelectAll, isLoggedIn, isTokenExpired, listFiles, loadConfig, make_path, make_sanitized_path, normalizeUrl, patchFileSetting, removeFile, removeRow, removeSelected, requestPatch, requireToken, sanitizeFilename, secureFetchIt, stripPrefixes, syncHeaderCheckbox, toggleCheckboxes, toggleShare, triggerDownload, truncateString, updateFileShare, uploadFile, uploadFiles, useDeleteFile, useFiles, useLoadFiles, usePatchShareSettings, useToggleShare };

package/dist/types/index.d.ts

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

package/dist/types/src/ChangePassword.d.ts

@@ -0,0 +1,16 @@
+export interface ChangePasswordProps {
+    onSuccess?: () => void;
+    onCancel?: () => void;
+}
+export interface ChangePasswordFormProps {
+    username: string;
+    setUsername: (value: string) => void;
+    currentPwd: string;
+    setCurrentPwd: (value: string) => void;
+    newPwd: string;
+    setNewPwd: (value: string) => void;
+    busy: boolean;
+    msg: string | null;
+    onSubmit: (e: React.FormEvent) => void;
+    onCancel?: () => void;
+}

package/dist/types/src/Files.d.ts

@@ -0,0 +1,27 @@
+export interface FileItem {
+    id: number | string;
+    filename: string;
+    uploader_id: string;
+    filepath: string;
+    created_at: string;
+    download_count: number;
+    download_limit: number | null;
+    shareable: boolean;
+    needsPassword: boolean;
+    share_password: string | null;
+}
+export interface ApiRow {
+    id: number | string;
+    filename: string;
+    uploader_id: string;
+    filepath: string;
+    created_at: string;
+    download_count: number;
+    download_limit: number | null;
+    shareable: boolean;
+    needsPassword: boolean;
+    share_password: string;
+}
+export interface FileListResponse {
+    files?: ApiRow[];
+}

package/dist/types/src/index.d.ts

@@ -0,0 +1,5 @@
+export * from './Files';
+export * from './ChangePassword';
+export * from './utils';
+export * from './logout';
+export * from './login';

package/dist/types/src/login.d.ts

@@ -0,0 +1,12 @@
+export interface LoginProps {
+    onSuccess?: () => void;
+}
+export interface LoginFormProps {
+    username: string;
+    setUsername: (value: string) => void;
+    password: string;
+    setPassword: (value: string) => void;
+    error: string | null;
+    busy: boolean;
+    onSubmit: (e: React.FormEvent) => void;
+}

package/dist/types/src/logout.d.ts

@@ -0,0 +1,4 @@
+export interface LogoutButtonProps {
+    /** Fired after the user is fully logged out so you can redirect to /login */
+    onLoggedOut?: () => void;
+}

package/dist/types/src/utils.d.ts

@@ -0,0 +1,25 @@
+export interface InputProps {
+    label?: any;
+    type?: any;
+    value?: any;
+    onChange?: any;
+    disabled?: any;
+    placeholder?: any;
+    error?: string;
+}
+export interface FetchVariables {
+    method: string;
+    headers: Record<string, string>;
+    body?: string | FormData;
+}
+/**
+ * Helpers for dealing with the JWT stored in localStorage.
+ */
+export interface JwtPayload {
+    /** UNIX-epoch seconds (standard exp claim) */
+    exp: number;
+    /** Your backend also stores the username here */
+    username?: string;
+    /** Any other claims are allowed */
+    [key: string]: unknown;
+}

package/package.json

@@ -0,0 +1 @@
+{"name":"@putkoff/abstract-utilities","version":"0.0.003","type":"module","description":"A reusable React Login component with JWT authentication","main":"dist/cjs/index.js","module":"dist/esm/index.js","types":"dist/index.d.ts","scripts":{"build":"tsc --emitDeclarationOnly && rollup -c","test":"jest","prepublishOnly":"npm run build"},"keywords":["react","login","component","jwt","authentication"],"author":"Your Name","license":"MIT","peerDependencies":{"react":"^17.0.0 || ^18.0.0","react-dom":"^17.0.0 || ^18.0.0"},"devDependencies":{"@rollup/plugin-commonjs":"^25.0.7","@rollup/plugin-node-resolve":"^15.2.3","@rollup/plugin-typescript":"^11.1.5","@testing-library/jest-dom":"^6.4.2","@testing-library/react":"^14.2.1","@types/jest":"^29.5.12","@types/react":"^18.2.55","@types/react-dom":"^18.2.19","jest":"^29.7.0","postcss":"^8.5.6","rollup":"^4.12.0","rollup-plugin-dts":"^6.1.0","rollup-plugin-peer-deps-external":"^2.2.4","rollup-plugin-postcss":"^4.0.2","ts-jest":"^29.1.2","typescript":"^5.3.3"},"compilerOptions":{"target":"es2016","module":"esnext","esModuleInterop":true,"forceConsistentCasingInFileNames":true,"strict":true,"skipLibCheck":true,"jsx":"react-jsx","declaration":true,"declarationDir":"dist","outDir":"dist","moduleResolution":"node","allowSyntheticDefaultImports":true,"types":"dist/types/index.d.ts","allowImportingTsExtensions":true},"include":["src/**/*"],"exclude":["node_modules","dist"],"files":["dist/","src/components/Login/login_style.css","src/components/ChangePassword/change_password.css"],"dependencies":{"@putkoff/abstract_utilities":"^0.0.1","path-browserify":"^1.0.1"}}