@marcwelti/mw-core 0.2.0

package/dist/storage-BU_rfYCi.d.mts

@@ -0,0 +1,43 @@
+import { FullMetadata, StorageReference, ListResult, UploadMetadata, UploadTask } from 'firebase/storage';
+
+/**
+ * Get a reference to a storage location
+ */
+declare function getStorageRef(path: string): StorageReference;
+/**
+ * Upload a file to storage
+ */
+declare function uploadFile(path: string, file: Blob | Uint8Array | ArrayBuffer, metadata?: UploadMetadata): Promise<string>;
+/**
+ * Upload a file with progress tracking
+ */
+declare function uploadFileWithProgress(path: string, file: Blob | Uint8Array | ArrayBuffer, onProgress?: (progress: number) => void, metadata?: UploadMetadata): {
+    task: UploadTask;
+    promise: Promise<string>;
+};
+/**
+ * Get the download URL for a file
+ */
+declare function getFileURL(path: string): Promise<string>;
+/**
+ * Delete a file from storage
+ */
+declare function deleteFile(path: string): Promise<void>;
+/**
+ * List all files in a directory
+ */
+declare function listFiles(path: string): Promise<ListResult>;
+/**
+ * Get metadata for a file
+ */
+declare function getFileMetadata(path: string): Promise<FullMetadata>;
+/**
+ * Update metadata for a file
+ */
+declare function updateFileMetadata(path: string, metadata: Partial<UploadMetadata>): Promise<FullMetadata>;
+/**
+ * Generate a unique file path with timestamp
+ */
+declare function generateFilePath(folder: string, filename: string, userId?: string): string;
+
+export { getFileMetadata as a, getFileURL as b, getStorageRef as c, deleteFile as d, uploadFile as e, uploadFileWithProgress as f, generateFilePath as g, listFiles as l, updateFileMetadata as u };

package/dist/storage-BU_rfYCi.d.ts

@@ -0,0 +1,43 @@
+import { FullMetadata, StorageReference, ListResult, UploadMetadata, UploadTask } from 'firebase/storage';
+
+/**
+ * Get a reference to a storage location
+ */
+declare function getStorageRef(path: string): StorageReference;
+/**
+ * Upload a file to storage
+ */
+declare function uploadFile(path: string, file: Blob | Uint8Array | ArrayBuffer, metadata?: UploadMetadata): Promise<string>;
+/**
+ * Upload a file with progress tracking
+ */
+declare function uploadFileWithProgress(path: string, file: Blob | Uint8Array | ArrayBuffer, onProgress?: (progress: number) => void, metadata?: UploadMetadata): {
+    task: UploadTask;
+    promise: Promise<string>;
+};
+/**
+ * Get the download URL for a file
+ */
+declare function getFileURL(path: string): Promise<string>;
+/**
+ * Delete a file from storage
+ */
+declare function deleteFile(path: string): Promise<void>;
+/**
+ * List all files in a directory
+ */
+declare function listFiles(path: string): Promise<ListResult>;
+/**
+ * Get metadata for a file
+ */
+declare function getFileMetadata(path: string): Promise<FullMetadata>;
+/**
+ * Update metadata for a file
+ */
+declare function updateFileMetadata(path: string, metadata: Partial<UploadMetadata>): Promise<FullMetadata>;
+/**
+ * Generate a unique file path with timestamp
+ */
+declare function generateFilePath(folder: string, filename: string, userId?: string): string;
+
+export { getFileMetadata as a, getFileURL as b, getStorageRef as c, deleteFile as d, uploadFile as e, uploadFileWithProgress as f, generateFilePath as g, listFiles as l, updateFileMetadata as u };

package/dist/types/index.d.mts

@@ -0,0 +1,108 @@
+import { Timestamp } from 'firebase/firestore';
+export { Timestamp } from 'firebase/firestore';
+export { User, UserCredential } from 'firebase/auth';
+
+/**
+ * Base interface for all Firestore documents
+ * Includes common fields like id and timestamps
+ */
+interface BaseDocument {
+    id: string;
+    createdAt?: Timestamp;
+    updatedAt?: Timestamp;
+}
+/**
+ * User profile stored in Firestore
+ * Extends the Firebase Auth user with additional fields
+ */
+interface UserProfile extends BaseDocument {
+    uid: string;
+    email: string;
+    displayName?: string;
+    photoURL?: string;
+    phoneNumber?: string;
+    role: UserRole;
+    isActive: boolean;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * User roles for authorization
+ */
+type UserRole = 'admin' | 'user' | 'guest';
+/**
+ * Generic API response type
+ */
+interface ApiResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * Pagination parameters
+ */
+interface PaginationParams {
+    page?: number;
+    limit?: number;
+    cursor?: string;
+}
+/**
+ * Paginated response
+ */
+interface PaginatedResponse<T> {
+    items: T[];
+    total: number;
+    page: number;
+    limit: number;
+    hasMore: boolean;
+    nextCursor?: string;
+}
+/**
+ * Sort direction
+ */
+type SortDirection = 'asc' | 'desc';
+/**
+ * Sort parameters
+ */
+interface SortParams<T = string> {
+    field: T;
+    direction: SortDirection;
+}
+/**
+ * Filter operator types
+ */
+type FilterOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'in' | 'notIn';
+/**
+ * Filter parameter
+ */
+interface FilterParam<T = string> {
+    field: T;
+    operator: FilterOperator;
+    value: unknown;
+}
+/**
+ * Async operation state
+ */
+interface AsyncState<T = unknown> {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+}
+/**
+ * Form field error
+ */
+interface FieldError {
+    field: string;
+    message: string;
+}
+/**
+ * Form validation result
+ */
+interface ValidationResult {
+    valid: boolean;
+    errors: FieldError[];
+}
+
+export type { ApiResponse, AsyncState, BaseDocument, FieldError, FilterOperator, FilterParam, PaginatedResponse, PaginationParams, SortDirection, SortParams, UserProfile, UserRole, ValidationResult };

package/dist/types/index.d.ts

@@ -0,0 +1,108 @@
+import { Timestamp } from 'firebase/firestore';
+export { Timestamp } from 'firebase/firestore';
+export { User, UserCredential } from 'firebase/auth';
+
+/**
+ * Base interface for all Firestore documents
+ * Includes common fields like id and timestamps
+ */
+interface BaseDocument {
+    id: string;
+    createdAt?: Timestamp;
+    updatedAt?: Timestamp;
+}
+/**
+ * User profile stored in Firestore
+ * Extends the Firebase Auth user with additional fields
+ */
+interface UserProfile extends BaseDocument {
+    uid: string;
+    email: string;
+    displayName?: string;
+    photoURL?: string;
+    phoneNumber?: string;
+    role: UserRole;
+    isActive: boolean;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * User roles for authorization
+ */
+type UserRole = 'admin' | 'user' | 'guest';
+/**
+ * Generic API response type
+ */
+interface ApiResponse<T = unknown> {
+    success: boolean;
+    data?: T;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
+/**
+ * Pagination parameters
+ */
+interface PaginationParams {
+    page?: number;
+    limit?: number;
+    cursor?: string;
+}
+/**
+ * Paginated response
+ */
+interface PaginatedResponse<T> {
+    items: T[];
+    total: number;
+    page: number;
+    limit: number;
+    hasMore: boolean;
+    nextCursor?: string;
+}
+/**
+ * Sort direction
+ */
+type SortDirection = 'asc' | 'desc';
+/**
+ * Sort parameters
+ */
+interface SortParams<T = string> {
+    field: T;
+    direction: SortDirection;
+}
+/**
+ * Filter operator types
+ */
+type FilterOperator = 'eq' | 'neq' | 'gt' | 'gte' | 'lt' | 'lte' | 'contains' | 'in' | 'notIn';
+/**
+ * Filter parameter
+ */
+interface FilterParam<T = string> {
+    field: T;
+    operator: FilterOperator;
+    value: unknown;
+}
+/**
+ * Async operation state
+ */
+interface AsyncState<T = unknown> {
+    data: T | null;
+    loading: boolean;
+    error: Error | null;
+}
+/**
+ * Form field error
+ */
+interface FieldError {
+    field: string;
+    message: string;
+}
+/**
+ * Form validation result
+ */
+interface ValidationResult {
+    valid: boolean;
+    errors: FieldError[];
+}
+
+export type { ApiResponse, AsyncState, BaseDocument, FieldError, FilterOperator, FilterParam, PaginatedResponse, PaginationParams, SortDirection, SortParams, UserProfile, UserRole, ValidationResult };

package/dist/types/index.js

@@ -0,0 +1,12 @@
+'use strict';
+
+var firestore = require('firebase/firestore');
+
+
+
+Object.defineProperty(exports, "Timestamp", {
+  enumerable: true,
+  get: function () { return firestore.Timestamp; }
+});
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js","sourcesContent":[]}

package/dist/types/index.mjs

@@ -0,0 +1,3 @@
+export { Timestamp } from 'firebase/firestore';
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/types/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.mjs","sourcesContent":[]}

package/package.json

@@ -0,0 +1,91 @@
+{
+  "name": "@marcwelti/mw-core",
+  "version": "0.2.0",
+  "description": "Marc Welti - Shared Firebase utilities, React hooks, and server-side auth",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./firebase": {
+      "types": "./dist/firebase/index.d.ts",
+      "import": "./dist/firebase/index.mjs",
+      "require": "./dist/firebase/index.js"
+    },
+    "./hooks": {
+      "types": "./dist/hooks/index.d.ts",
+      "import": "./dist/hooks/index.mjs",
+      "require": "./dist/hooks/index.js"
+    },
+    "./context": {
+      "types": "./dist/context/index.d.ts",
+      "import": "./dist/context/index.mjs",
+      "require": "./dist/context/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.mjs",
+      "require": "./dist/types/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.mjs",
+      "require": "./dist/server/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build",
+    "typecheck": "tsc --noEmit"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "react-dom": "^18.0.0 || ^19.0.0",
+    "firebase": "^10.0.0 || ^11.0.0 || ^12.0.0",
+    "firebase-admin": "^12.0.0 || ^13.0.0"
+  },
+  "peerDependenciesMeta": {
+    "firebase-admin": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "firebase": "^11.0.0",
+    "firebase-admin": "^13.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "keywords": [
+    "firebase",
+    "firebase-admin",
+    "react",
+    "hooks",
+    "authentication",
+    "firestore",
+    "session",
+    "marc-welti"
+  ],
+  "author": "Marc Welti",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/marcwelti/mw-core.git"
+  },
+  "publishConfig": {
+    "access": "restricted"
+  }
+}