@putkoff/abstract-utilities 0.0.3

package/dist/esm/file_utils/src/upload_utils/src/patch_file_settings.d.ts

@@ -0,0 +1,2 @@
+/** Generic PATCH helper kept for other admin forms */
+export declare function patchFileSetting(fileId: string, field: string, value: unknown): Promise<Record<string, unknown>>;

package/dist/esm/file_utils/src/upload_utils/src/upload_file.d.ts

@@ -0,0 +1,2 @@
+/** Classic file-upload for the fallback HTML page. */
+export declare function uploadFile(file: any, subdir: any): Promise<any>;

package/dist/esm/file_utils/src/upload_utils/src/upload_files.d.ts

@@ -0,0 +1,5 @@
+interface UploadResponse {
+    filepath: string;
+}
+export declare function uploadFiles(file: File, subdir?: string): Promise<UploadResponse>;
+export {};

package/dist/esm/functions/auth_utils/imports.d.ts

@@ -0,0 +1 @@
+export type { JwtPayload } from './../../types';

package/dist/esm/functions/auth_utils/index.d.ts

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

package/dist/esm/functions/auth_utils/src/index.d.ts

@@ -0,0 +1 @@
+export * from "./token_utils";

package/dist/esm/functions/auth_utils/src/token_utils.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Helpers for dealing with the JWT stored in localStorage.
+ */
+import { JwtPayload } from './../imports';
+/**
+***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`.
+*
+*/
+export declare function isLoggedIn(): boolean;
+/** Read raw JWT from LocalStorage (or null if absent) */
+export declare function getToken(): string | null;
+/**
+ * Add a Bearer Authorization header.
+ * A shallow copy of headers is returned so callers can keep chaining.
+ */
+export 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. */
+export declare function requireToken(): string;
+/** True if token is structurally bad or its exp ≤ now. */
+export declare function isTokenExpired(token: string): boolean;
+/** Convenience wrapper: return username from the JWT (or null). */
+export declare function currentUsername(): string | null;
+export declare function currentUsernames(): any;
+export declare function decodeJwt(token: string): JwtPayload;

package/dist/esm/functions/constants_utils/index.d.ts

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

package/dist/esm/functions/constants_utils/src/constants.d.ts

@@ -0,0 +1,7 @@
+export declare const PROTOCOL = "https://";
+export declare const DOMAIN_NAME = "abstractendeavors";
+export declare const BASE_URL = "https://abstractendeavors.com";
+export declare const SUB_DIR = "secure-files";
+export declare const PROD_PREFIX = "/secure-files/";
+export declare const API_PREFIX = "/secure-files/api";
+export declare const DEV_PREFIX = "/secure-files-dev/";

package/dist/esm/functions/constants_utils/src/index.d.ts

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

package/dist/esm/functions/env_utils/imports.d.ts

@@ -0,0 +1 @@
+export { BASE_URL, DEV_PREFIX } from './../constants_utils/index';

package/dist/esm/functions/env_utils/index.d.ts

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

package/dist/esm/functions/env_utils/src/index.d.ts

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

package/dist/esm/functions/env_utils/src/window_utils.d.ts

@@ -0,0 +1,4 @@
+export declare function get_window(): (Window & typeof globalThis) | null;
+export declare function get_window_location(): Location | "https://abstractendeavors.com" | null;
+export declare function get_window_pathname(): string | null;
+export declare function get_window_parts(): Location | "https://abstractendeavors.com" | null;

package/dist/esm/functions/fetch_utils/imports.d.ts

@@ -0,0 +1,7 @@
+export { getAuthorizationHeader } from "./../auth_utils";
+export { make_path } from './../path_utils';
+export { stripPrefixes } from './../string_utils';
+export { alertit } from './../rndm_utils';
+export { ensure_list } from './../type_utils';
+export { eatInner } from './../string_utils';
+export type { LogoutButtonProps, FetchVariables } from './../../types';

package/dist/esm/functions/fetch_utils/index.d.ts

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

package/dist/esm/functions/fetch_utils/src/fetchIt_utils.d.ts

@@ -0,0 +1,14 @@
+/**
+
+***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 */
+export 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>;
+export declare function secureFetchIt<T>(endpoint: string, body?: unknown, method?: string, headers?: Record<string, string> | null, blob?: false, noApi?: boolean, requireAuth?: boolean): Promise<T>;
+export declare function secureFetchIt(endpoint: string, body?: unknown, method?: string, headers?: Record<string, string> | null, blob?: boolean, noApi?: boolean, withCredentials?: boolean, returnJson?: boolean): Promise<Blob>;
+export declare function requestPatch(url: string, body?: unknown): Promise<Response>;
+export declare function fetchSharePatch(file: unknown): Promise<void>;

package/dist/esm/functions/fetch_utils/src/index.d.ts

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

package/dist/esm/functions/fetch_utils/src/utils.d.ts

@@ -0,0 +1,18 @@
+import { FetchVariables } from './../imports';
+export declare function ensureAbstractUrl(endpoint: string, slices?: string[]): string;
+/**
+ * Unwraps nested { result } fields until you hit a non-object or no more "result" keys.
+ */
+export declare function getResult<T>(obj: unknown): T;
+/** Pulls base-URL from AppConfig.API_BASE_URL, strips trailing slashes */
+export declare function getRawConfigUrl(): any;
+export declare function api(endpoint: string): string;
+export declare function checkResponse(res: Response): any;
+export declare function parseResult(res: Response): Promise<unknown>;
+export declare function getMethod(method?: string | null, body?: unknown): string;
+export declare function getHeaders(headers?: Record<string, string>, method?: string | null, body?: unknown): Record<string, string>;
+export declare function getBody(body?: unknown, method?: string | null): string | undefined;
+export declare function getFetchVars(headers?: Record<string, string> | null, method?: string | null, body?: any): FetchVariables;
+export declare function getHtmlDirectory(directory: string, filename: string): string;
+export declare function fetchIndexHtml(filename: string, directory?: string, base?: string): Promise<string>;
+export declare function fetchIndexHtmlContainer(filename: string, doc?: Document, directory?: string): Promise<void>;

package/dist/esm/functions/index.d.ts

@@ -0,0 +1,9 @@
+export * from './auth_utils';
+export * from './constants_utils';
+export * from './env_utils';
+export * from './fetch_utils';
+export * from './path_utils';
+export * from './rndm_utils';
+export * from './string_utils';
+export * from './type_utils';
+export * from './ui_utils';

package/dist/esm/functions/path_utils/imports.d.ts

@@ -0,0 +1,20 @@
+/**
+ * In the browser we already have a WHATWG URL constructor on window.
+ * Here we re-export it as “url” so other modules can import it.
+ */
+export declare const url: {
+    new (url: string | URL, base?: string | URL): URL;
+    prototype: URL;
+    canParse(url: string | URL, base?: string | URL): boolean;
+    createObjectURL(obj: Blob | MediaSource): string;
+    parse(url: string | URL, base?: string | URL): URL | null;
+    revokeObjectURL(url: string): void;
+};
+/**
+ * Minimal fileURLToPath implementation for browser-side code.
+ * If you only ever need to strip off “file://” in development, this is enough.
+ */
+export declare function fileURLToPath(fileUrl: string): string;
+export { eatOuter, eatInner } from './../string_utils';
+export { ensure_list } from './../type_utils';
+export declare function getAbsolutePath(): string;

package/dist/esm/functions/path_utils/index.d.ts

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

package/dist/esm/functions/path_utils/src/base_dirs.d.ts

@@ -0,0 +1,4 @@
+export declare function getBaseDir(): string;
+export declare function getPublicDir(): string;
+export declare function getDistDir(): string;
+export declare function getEnvDir(): string;

package/dist/esm/functions/path_utils/src/function_dirs.d.ts

@@ -0,0 +1,10 @@
+export declare function getFunctionsDir(): string;
+export declare function geAuthsUtilsDirectory(): string;
+export declare function geBackupsUtilsDirectory(): string;
+export declare function geConstantsUtilsDirectory(): string;
+export declare function geEnvUtilsDirectory(): string;
+export declare function geFetchUtilsDirectory(): string;
+export declare function geFileUtilsDirectory(): string;
+export declare function gePathUtilsDirectory(): string;
+export declare function geStringUtilsDirectory(): string;
+export declare function geTypeUtilsDirectory(): string;

package/dist/esm/functions/path_utils/src/index.d.ts

@@ -0,0 +1,6 @@
+export * from './path_utils';
+export * from './paths';
+export * from './function_dirs';
+export * from './src_dirs';
+export * from './base_dirs';
+export * from './misc_dirs';

package/dist/esm/functions/path_utils/src/misc_dirs.d.ts

@@ -0,0 +1,4 @@
+export declare function getEnvPath(string?: string): string;
+export declare function getDbConfigsPath(): string;
+export declare function getSchemasPath(): string;
+export declare function getSchemasDirPath(subPath: string): string;

package/dist/esm/functions/path_utils/src/path_utils.d.ts

@@ -0,0 +1,17 @@
+export declare function get_dirname(filePath: string | null): string;
+export declare function get_basename(filePath: string | null): string;
+export declare function get_filename(file_path: string): string;
+export declare function get_extname(filePath: string | null): string;
+export declare function get_splitext(filePath: string | null): {
+    filename: string;
+    extname: string;
+    ext?: undefined;
+} | {
+    filename: string;
+    ext: string;
+    extname?: undefined;
+};
+export declare function make_path(...segments: string[]): string;
+export declare function sanitizeFilename(filename: string): string;
+export declare function make_sanitized_path(...paths: string[]): string;
+export declare function normalizeUrl(base: string, p?: string): string;

package/dist/esm/functions/path_utils/src/paths.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Returns the absolute path of the current file.
+ */
+export declare function getAbsDir(): string;
+export declare function getAbsPath(subPath: string): string;

package/dist/esm/functions/path_utils/src/src_dirs.d.ts

@@ -0,0 +1,6 @@
+export declare function getSrcDir(): string;
+export declare function geStaticDirectory(): string;
+export declare function getLibUtilsDirectory(): string;
+export declare function getHooksUtilsDirectory(): string;
+export declare function getFunctionsUtilsDirectory(): string;
+export declare function getComponentsUtilsDirectory(): string;

package/dist/esm/functions/rndm_utils/index.d.ts

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

package/dist/esm/functions/rndm_utils/src/index.d.ts

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

package/dist/esm/functions/rndm_utils/src/utils.d.ts

@@ -0,0 +1 @@
+export declare function alertit(obj?: any): void;

package/dist/esm/functions/string_utils/index.d.ts

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

package/dist/esm/functions/string_utils/src/index.d.ts

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

package/dist/esm/functions/string_utils/src/string_utils.d.ts

@@ -0,0 +1,39 @@
+export declare function getSubstring(obj: string, maxLength?: number | null, minLength?: number | null): string;
+export 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'
+ */
+export 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.
+ */
+export 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.
+ */
+export 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.
+ */
+export declare function eatAll(str: string, listObjects: string | string[]): string;
+export declare function eatEnd(obj: string, endings?: string[]): string;

package/dist/esm/functions/type_utils/index.d.ts

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

package/dist/esm/functions/type_utils/src/index.d.ts

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

package/dist/esm/functions/type_utils/src/type_utils.d.ts

@@ -0,0 +1 @@
+export declare function ensure_list<T>(obj: T | T[]): T[];

package/dist/esm/functions/ui_utils/imports.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+export declare const useState: typeof React.useState, useEffect: typeof React.useEffect, useCallback: typeof React.useCallback;
+export { fetchIt } from './../fetch_utils';
+export { currentUsername, isTokenExpired, getToken } from './../auth_utils';
+export { uploadFile, downloadFile } from './../../file_utils';
+export { useFiles } from './../../hooks/useFiles';

package/dist/esm/functions/ui_utils/index.d.ts

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

package/dist/esm/functions/ui_utils/src/button.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+export declare function Button({ children, color, ...rest }: React.ButtonHTMLAttributes<HTMLButtonElement> & {
+    color?: 'gray' | 'green' | 'blue';
+}): import("react/jsx-runtime").JSX.Element;

package/dist/esm/functions/ui_utils/src/checkbox.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+export declare function Checkbox({ label, ...rest }: React.InputHTMLAttributes<HTMLInputElement> & {
+    label: string;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/esm/functions/ui_utils/src/index.d.ts

@@ -0,0 +1,4 @@
+export * from './button';
+export * from './checkbox';
+export * from './input';
+export * from './spinner';

package/dist/esm/functions/ui_utils/src/input.d.ts

@@ -0,0 +1,5 @@
+import React from 'react';
+export declare function Input({ label, trailing, ...rest }: React.InputHTMLAttributes<HTMLInputElement> & {
+    label: string;
+    trailing?: React.ReactNode;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/esm/functions/ui_utils/src/spinner.d.ts

@@ -0,0 +1 @@
+export declare function Spinner(): import("react/jsx-runtime").JSX.Element;

package/dist/esm/hooks/index.d.ts

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

package/dist/esm/hooks/useFiles/imports.d.ts

@@ -0,0 +1,6 @@
+export { useCallback } from 'react';
+export type { FileItem, ApiRow } from './../../types';
+export { secureFetchIt, fetchSharePatch } from './../../functions/fetch_utils';
+export { alertit } from './../../functions/rndm_utils';
+export { useState, useEffect } from 'react';
+export { toggleShare, removeFile, listFiles } from './../../file_utils';

package/dist/esm/hooks/useFiles/index.d.ts

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

package/dist/esm/hooks/useFiles/src/deleteFile.d.ts

@@ -0,0 +1,5 @@
+import { FileItem } from './../imports';
+/**
+ * Custom hook to toggle share settings on a file item
+ */
+export declare const useDeleteFile: (setFiles: React.Dispatch<React.SetStateAction<FileItem[]>>) => (file: FileItem) => Promise<void>;

package/dist/esm/hooks/useFiles/src/index.d.ts

@@ -0,0 +1,5 @@
+export * from './load';
+export * from './toggleShare';
+export * from './patchShareSettings';
+export * from './useFiles';
+export * from './deleteFile';

package/dist/esm/hooks/useFiles/src/load.d.ts

@@ -0,0 +1,5 @@
+import { FileItem } from './../imports';
+/**
+ * Custom hook that returns a memoized loadFiles callback
+ */
+export declare const useLoadFiles: (setLoading: React.Dispatch<React.SetStateAction<boolean>>, setError: React.Dispatch<React.SetStateAction<Error | null>>, setFiles: React.Dispatch<React.SetStateAction<FileItem[]>>) => () => Promise<void>;

package/dist/esm/hooks/useFiles/src/patchShareSettings.d.ts

@@ -0,0 +1,9 @@
+import { FileItem } from './../imports';
+/**
+ * Custom hook for optimistic share-setting patch updates
+ */
+/**
+ * Custom hook to toggle share settings on a file item
+ */
+export declare const usePatchShareSettings: (setFiles: React.Dispatch<React.SetStateAction<FileItem[]>>) => (file: FileItem) => Promise<void>;
+export default usePatchShareSettings;

package/dist/esm/hooks/useFiles/src/toggleShare.d.ts

@@ -0,0 +1,5 @@
+import { FileItem } from './../imports';
+/**
+ * Custom hook to toggle share settings on a file item
+ */
+export declare const useToggleShare: (setFiles: React.Dispatch<React.SetStateAction<FileItem[]>>) => (file: FileItem) => Promise<void>;

package/dist/esm/hooks/useFiles/src/useFiles.d.ts

@@ -0,0 +1,13 @@
+import { FileItem } from './../imports';
+export 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: import("react").Dispatch<import("react").SetStateAction<FileItem[]>>;
+    setLoading: import("react").Dispatch<import("react").SetStateAction<boolean>>;
+    setError: import("react").Dispatch<import("react").SetStateAction<Error | null>>;
+};

package/dist/esm/index.d.ts

@@ -0,0 +1,5 @@
+export * from './config';
+export * from './file_utils';
+export * from './functions';
+export * from './hooks';
+export * from './types';