@bid-scents/shared-sdk 1.0.0

package/dist/stores/auth.js

@@ -0,0 +1,58 @@
+// Manages user authentication state with Supabase integration.
+import { create } from 'zustand';
+import { persist } from 'zustand/middleware';
+/**
+ * Zustand store for authentication state management with Supabase.
+ *
+ * Manages user data and Supabase session which contains tokens.
+ * Supabase automatically handles token refresh in the background.
+ *
+ * @returns Auth store with user state, session, and actions
+ */
+export const useAuthStore = create()(persist((set) => ({
+    user: null,
+    session: null,
+    isAuthenticated: false,
+    isOnboarded: false,
+    /**
+     * Updates the current user and onboarding status.
+     *
+     * @param user - User profile data or null to clear
+     */
+    setUser: (user) => {
+        set({
+            user,
+            isOnboarded: !!user?.onboarded_at
+        });
+    },
+    /**
+     * Updates the Supabase session and authentication status.
+     *
+     * @param session - Supabase session object containing tokens
+     */
+    setSession: (session) => {
+        set({
+            session,
+            isAuthenticated: !!session
+        });
+    },
+    /**
+     * Clears all authentication state.
+     */
+    logout: () => {
+        set({
+            user: null,
+            session: null,
+            isAuthenticated: false,
+            isOnboarded: false
+        });
+    }
+}), {
+    name: 'auth-storage',
+    partialize: (state) => ({
+        user: state.user,
+        session: state.session,
+        isAuthenticated: state.isAuthenticated,
+        isOnboarded: state.isOnboarded
+    })
+}));

package/dist/stores/index.d.ts

@@ -0,0 +1,2 @@
+export { useAuthStore } from './auth';
+//# sourceMappingURL=index.d.ts.map

package/dist/stores/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/stores/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA"}

package/dist/stores/index.js

@@ -0,0 +1,2 @@
+// Central export for all Zustand stores.
+export { useAuthStore } from './auth';

package/dist/types/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/types/index.js

@@ -0,0 +1 @@
+"use strict";

package/dist/utils/auth/supabase-config.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Handles Supabase authentication state changes.
+ *
+ * Call this function from Supabase's onAuthStateChange callback
+ * to sync the session with your app state and configure API client.
+ *
+ * @param event - Auth event type from Supabase
+ * @param session - Current Supabase session or null
+ */
+export declare const handleAuthStateChange: (event: string, session: any) => void;
+/**
+ * Initializes authentication system on app startup.
+ *
+ * Configures API client with stored tokens. Call this once during app initialization.
+ */
+export declare const initializeAuth: () => void;
+//# sourceMappingURL=supabase-config.d.ts.map

package/dist/utils/auth/supabase-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supabase-config.d.ts","sourceRoot":"","sources":["../../../src/utils/auth/supabase-config.ts"],"names":[],"mappings":"AAqBA;;;;;;;;GAQG;AACH,eAAO,MAAM,qBAAqB,GAAI,OAAO,MAAM,EAAE,SAAS,GAAG,KAAG,IAUnE,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,cAAc,QAAO,IAEjC,CAAA"}

package/dist/utils/auth/supabase-config.js

@@ -0,0 +1,44 @@
+// Supabase authentication configuration and token management.
+import { useAuthStore } from '../../stores/auth';
+import { OpenAPI } from '../../api/core/OpenAPI';
+/**
+ * Configures the OpenAPI client with the current Supabase access token.
+ *
+ * Internal function that extracts the access token from the Supabase session
+ * and configures all API requests to include it in the Authorization header.
+ */
+const configureApiWithSupabaseToken = () => {
+    const { session } = useAuthStore.getState();
+    if (session?.access_token) {
+        OpenAPI.TOKEN = session.access_token;
+    }
+    else {
+        OpenAPI.TOKEN = undefined;
+    }
+};
+/**
+ * Handles Supabase authentication state changes.
+ *
+ * Call this function from Supabase's onAuthStateChange callback
+ * to sync the session with your app state and configure API client.
+ *
+ * @param event - Auth event type from Supabase
+ * @param session - Current Supabase session or null
+ */
+export const handleAuthStateChange = (event, session) => {
+    const { setSession, logout } = useAuthStore.getState();
+    setSession(session);
+    configureApiWithSupabaseToken();
+    // Clear user data on logout
+    if (event === 'SIGNED_OUT' || !session) {
+        logout();
+    }
+};
+/**
+ * Initializes authentication system on app startup.
+ *
+ * Configures API client with stored tokens. Call this once during app initialization.
+ */
+export const initializeAuth = () => {
+    configureApiWithSupabaseToken();
+};

package/dist/utils/index.d.ts

@@ -0,0 +1,4 @@
+export { handleAuthStateChange, initializeAuth } from './auth/supabase-config';
+export { onboardingSchema, usernameSchema } from './validation/schemas';
+export type { OnboardingFormData } from './validation/schemas';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACH,qBAAqB,EACrB,cAAc,EACf,MAAM,wBAAwB,CAAA;AAEjC,OAAO,EACH,gBAAgB,EAChB,cAAc,EACf,MAAM,sBAAsB,CAAA;AAE/B,YAAY,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/utils/index.js

@@ -0,0 +1,3 @@
+// Central export for all utilities.
+export { handleAuthStateChange, initializeAuth } from './auth/supabase-config';
+export { onboardingSchema, usernameSchema } from './validation/schemas';

package/dist/utils/validation/schemas.d.ts

@@ -0,0 +1,40 @@
+import { z } from 'zod';
+/**
+ * Validation schema for user onboarding form data.
+ *
+ * Enforces username format rules, name requirements, and optional profile fields.
+ * Used for client-side validation before API submission.
+ */
+export declare const onboardingSchema: z.ZodObject<{
+    username: z.ZodString;
+    first_name: z.ZodString;
+    last_name: z.ZodString;
+    profile_image_url: z.ZodOptional<z.ZodString>;
+    cover_image_url: z.ZodOptional<z.ZodString>;
+    bio: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    username: string;
+    first_name: string;
+    last_name: string;
+    profile_image_url?: string | undefined;
+    cover_image_url?: string | undefined;
+    bio?: string | undefined;
+}, {
+    username: string;
+    first_name: string;
+    last_name: string;
+    profile_image_url?: string | undefined;
+    cover_image_url?: string | undefined;
+    bio?: string | undefined;
+}>;
+/**
+ * TypeScript type inferred from the onboarding validation schema.
+ * Use this type for form components and validation results.
+ */
+export type OnboardingFormData = z.infer<typeof onboardingSchema>;
+/**
+ * Validation schema for username availability checking.
+ * Used for real-time username validation during form input.
+ */
+export declare const usernameSchema: z.ZodString;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/utils/validation/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../../src/utils/validation/schemas.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;EAiC3B,CAAA;AAGF;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAA;AAEjE;;;GAGG;AACH,eAAO,MAAM,cAAc,aAI+D,CAAA"}

package/dist/utils/validation/schemas.js

@@ -0,0 +1,46 @@
+// Zod validation schemas for form inputs and data validation.
+import { z } from 'zod';
+/**
+ * Validation schema for user onboarding form data.
+ *
+ * Enforces username format rules, name requirements, and optional profile fields.
+ * Used for client-side validation before API submission.
+ */
+export const onboardingSchema = z.object({
+    username: z
+        .string()
+        .min(3, 'Username must be at least 3 characters')
+        .max(50, 'Username must be less than 50 characters')
+        .regex(/^[a-zA-Z0-9_]+$/, 'Username can only contain letters, numbers, and underscores'),
+    first_name: z
+        .string()
+        .min(1, 'First name is required')
+        .max(50, 'First name must be less than 50 characters')
+        .trim(),
+    last_name: z
+        .string()
+        .min(1, 'Last name is required')
+        .max(50, 'Last name must be less than 50 characters')
+        .trim(),
+    profile_image_url: z
+        .string()
+        .url('Must be a valid URL')
+        .optional(),
+    cover_image_url: z
+        .string()
+        .url('Must be a valid URL')
+        .optional(),
+    bio: z
+        .string()
+        .max(500, 'Bio must be less than 500 characters')
+        .optional()
+});
+/**
+ * Validation schema for username availability checking.
+ * Used for real-time username validation during form input.
+ */
+export const usernameSchema = z
+    .string()
+    .min(3, 'Username must be at least 3 characters')
+    .max(50, 'Username must be less than 50 characters')
+    .regex(/^[a-zA-Z0-9_]+$/, 'Username can only contain letters, numbers, and underscores');

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@bid-scents/shared-sdk",
+  "version": "1.0.0",
+  "description": "Shared SDK for marketplace applications",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist",
+    "test": "vitest",
+    "lint": "eslint src --ext .ts,.tsx",
+    "type-check": "tsc --noEmit",
+    "generate-api": "openapi -i http://localhost:8000/openapi.json -o src/api",
+    "prepublishOnly": "bun run clean && bun run build"
+  },
+  "keywords": ["marketplace", "sdk", "react", "typescript"],
+  "author": "Shawarmaa",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/BidScents/shared-sdk.git"
+  },
+  "peerDependencies": {
+    "react": ">=18.0.0",
+    "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "zustand": "^5.0.5",
+    "zod": "^3.25.64",
+    "@tanstack/react-query": "^5.80.7"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "@types/node": "^24.0.3",
+    "@types/react": "^19.1.8",
+    "eslint": "^8.0.0",
+    "openapi-typescript-codegen": "^0.29.0",
+    "typescript": "^5.8.3",
+    "vitest": "^1.0.0"
+  }
+}