@genispace/geniapp 0.1.0

package/dist/storage/components/AssetThumbnail.d.ts

@@ -0,0 +1,15 @@
+import { AssetPreviewInput } from '../assetPreview';
+
+export type AssetThumbnailSize = 'sm' | 'md' | 'lg';
+export interface AssetThumbnailProps {
+    asset: AssetPreviewInput & {
+        name?: string | null;
+        type?: string | null;
+    };
+    blobUrls?: Record<string, string>;
+    size?: AssetThumbnailSize;
+    onClick?: () => void;
+    className?: string;
+    interactive?: boolean;
+}
+export declare function AssetThumbnail({ asset, blobUrls, size, onClick, className, interactive, }: AssetThumbnailProps): import("react").JSX.Element;

package/dist/storage/components/CopyStorageLinkButton.d.ts

@@ -0,0 +1,13 @@
+import { PlatformStorageClient } from '../platformStorage';
+
+interface CopyStorageLinkButtonProps {
+    client: PlatformStorageClient | null;
+    storageFileId: string | null | undefined;
+    copyLabel?: string;
+    openLabel?: string;
+    expiryHint?: string;
+    className?: string;
+    onError?: (message: string) => void;
+}
+export declare function CopyStorageLinkButton({ client, storageFileId, copyLabel, openLabel, expiryHint, className, onError, }: CopyStorageLinkButtonProps): import("react").JSX.Element | null;
+export {};

package/dist/storage/components/StorageImage.d.ts

@@ -0,0 +1,9 @@
+import { ImgHTMLAttributes } from 'react';
+
+interface StorageImageProps extends ImgHTMLAttributes<HTMLImageElement> {
+    storageFileId?: string | null;
+    fallbackUrl?: string | null;
+    blobUrls: Record<string, string>;
+}
+export declare function StorageImage({ storageFileId, fallbackUrl, blobUrls, src, alt, ...rest }: StorageImageProps): import("react").JSX.Element | null;
+export {};

package/dist/storage/components/StoragePreviewContent.d.ts

@@ -0,0 +1,22 @@
+import { AssetPreviewInput } from '../assetPreview';
+import { PlatformStorageClient } from '../platformStorage';
+
+export interface StoragePreviewContentProps {
+    open: boolean;
+    asset: AssetPreviewInput & {
+        name?: string | null;
+        size_bytes?: number | null;
+        format?: string | null;
+    };
+    client: PlatformStorageClient | null;
+    blobUrls?: Record<string, string>;
+    onDownload?: () => void | Promise<void>;
+    labels?: {
+        loading?: string;
+        loadFailed?: string;
+        downloadOnly?: string;
+        download?: string;
+        emptyText?: string;
+    };
+}
+export declare function StoragePreviewContent({ open, asset, client, blobUrls, onDownload, labels, }: StoragePreviewContentProps): import("react").JSX.Element;

package/dist/storage/components/StorageVideo.d.ts

@@ -0,0 +1,9 @@
+import { VideoHTMLAttributes } from 'react';
+
+interface StorageVideoProps extends VideoHTMLAttributes<HTMLVideoElement> {
+    storageFileId?: string | null;
+    fallbackUrl?: string | null;
+    blobUrls: Record<string, string>;
+}
+export declare function StorageVideo({ storageFileId, fallbackUrl, blobUrls, src, ...rest }: StorageVideoProps): import("react").JSX.Element | null;
+export {};

package/dist/storage/copyTextToClipboard.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Copy text while preserving the user-gesture window for async content.
+ * Pass a Promise when the text is not yet available (e.g. after a network fetch).
+ */
+export declare function copyTextToClipboard(textOrPromise: string | Promise<string>): Promise<void>;

package/dist/storage/hooks/useAuthenticatedStorageBlobs.d.ts

@@ -0,0 +1,3 @@
+import { PlatformStorageClient } from '../platformStorage';
+
+export declare function useAuthenticatedStorageBlobs(client: PlatformStorageClient | null, storageFileIds: Array<string | null | undefined>): Record<string, string>;

package/dist/storage/hooks/useImageThumbnailBlobs.d.ts

@@ -0,0 +1,4 @@
+import { PlatformStorageClient } from '../platformStorage';
+import { AssetPreviewInput } from '../assetPreview';
+
+export declare function useImageThumbnailBlobs(client: PlatformStorageClient | null, items: AssetPreviewInput[]): Record<string, string>;

package/dist/storage/hooks/useShareableStorageLink.d.ts

@@ -0,0 +1,7 @@
+import { PlatformStorageClient } from '../platformStorage';
+
+export declare function useShareableStorageLink(client: PlatformStorageClient | null, onError?: (message: string) => void): {
+    copyLink: (fileId: string) => Promise<string | null>;
+    openShareTab: (fileId: string) => Promise<string | null>;
+    loading: boolean;
+};

package/dist/storage/index.d.ts

@@ -0,0 +1,12 @@
+export { contentUrlFromUpload, createPlatformStorageHelpers, fetchAuthenticatedBlobUrl, isAuthenticatedStorageContentUrl, pickStorageDisplayUrl, resolveAuthenticatedBlobUrls, resolveShareablePublicUrl, resolveShareablePublicUrls, unwrapStorageFileRecord, type AuthenticatedBlobResult, type PlatformStorageClient, type StorageFileRecord, } from './platformStorage';
+export { copyTextToClipboard } from './copyTextToClipboard';
+export { openUrlInNewTab } from './openUrlInNewTab';
+export { inferAssetPreviewKind, inferMimeType, isImagePreviewKind, type AssetPreviewInput, type AssetPreviewKind, } from './assetPreview';
+export { useAuthenticatedStorageBlobs } from './hooks/useAuthenticatedStorageBlobs';
+export { useImageThumbnailBlobs } from './hooks/useImageThumbnailBlobs';
+export { useShareableStorageLink } from './hooks/useShareableStorageLink';
+export { StorageImage } from './components/StorageImage';
+export { StorageVideo } from './components/StorageVideo';
+export { AssetThumbnail, type AssetThumbnailProps, type AssetThumbnailSize } from './components/AssetThumbnail';
+export { StoragePreviewContent, type StoragePreviewContentProps } from './components/StoragePreviewContent';
+export { CopyStorageLinkButton } from './components/CopyStorageLinkButton';

package/dist/storage/openUrlInNewTab.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Open a URL in a new tab after async resolution.
+ * Uses a synchronous `about:blank` popup (without `noopener`) so the opener can navigate it
+ * once the URL is ready; then clears `opener` for security.
+ */
+export declare function openUrlInNewTab(urlOrPromise: string | Promise<string>): Promise<string>;

package/dist/storage/platformStorage.d.ts

@@ -0,0 +1,43 @@
+/** Minimal GeniSpace storage surface used by GeniApps. */
+export interface StorageFileRecord {
+    id: string;
+    url: string;
+    publicUrl?: string;
+    mimeType?: string;
+}
+export interface PlatformStorageClient {
+    storage: {
+        getFile(fileId: string): Promise<StorageFileRecord | {
+            data?: StorageFileRecord;
+        }>;
+        getFileContent(fileId: string): Promise<ArrayBuffer | ArrayBufferView>;
+    };
+}
+/** SDK `get()` returns `{ success, data: file }` — unwrap to the file record. */
+export declare function unwrapStorageFileRecord(raw: unknown): StorageFileRecord;
+export interface AuthenticatedBlobResult {
+    blobUrl: string;
+    revoke: () => void;
+}
+/** JWT-backed `/content` URLs cannot be used in `<img src>` — browser sends no Authorization header. */
+export declare function isAuthenticatedStorageContentUrl(url: string | null | undefined): boolean;
+/** JWT-backed in-app preview: fetch /content and return a blob: URL. */
+export declare function fetchAuthenticatedBlobUrl(client: PlatformStorageClient, fileId: string, mimeType?: string): Promise<AuthenticatedBlobResult>;
+/** Batch fetch blob URLs with limited concurrency. */
+export declare function resolveAuthenticatedBlobUrls(client: PlatformStorageClient, fileIds: string[], concurrency?: number): Promise<Record<string, string>>;
+/** Share/copy/external HTTP: fresh signed publicUrl (TTL ~1h on server). */
+export declare function resolveShareablePublicUrl(client: PlatformStorageClient, fileId: string): Promise<string>;
+export declare function resolveShareablePublicUrls(client: PlatformStorageClient, fileIds: string[]): Promise<Record<string, string>>;
+/** Pick blob URL for display, else external/content fallback. */
+export declare function pickStorageDisplayUrl(storageFileId: string | null | undefined, fallbackUrl: string | null | undefined, blobUrls: Record<string, string>): string | null;
+/** Persist content endpoint URL from upload response — never publicUrl. */
+export declare function contentUrlFromUpload(file: {
+    url: string;
+    publicUrl?: string;
+}): string;
+export declare function createPlatformStorageHelpers(client: PlatformStorageClient): {
+    fetchAuthenticatedBlobUrl: (fileId: string, mimeType?: string) => Promise<AuthenticatedBlobResult>;
+    resolveAuthenticatedBlobUrls: (fileIds: string[]) => Promise<Record<string, string>>;
+    resolveShareablePublicUrl: (fileId: string) => Promise<string>;
+    resolveShareablePublicUrls: (fileIds: string[]) => Promise<Record<string, string>>;
+};

package/dist/storage.d.ts

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