@object-ui/tenant 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 ObjectQL
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/TenantContext.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { TenantContext } from '@object-ui/types';
+export interface TenantContextValue extends TenantContext {
+    /** Switch to a different tenant */
+    switchTenant: (tenantId: string) => Promise<void>;
+    /** Whether tenant is loading */
+    isLoading: boolean;
+    /** Error if tenant resolution failed */
+    error: Error | null;
+}
+export declare const TenantCtx: import("react").Context<TenantContextValue | null>;
+//# sourceMappingURL=TenantContext.d.ts.map

package/dist/TenantContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TenantContext.d.ts","sourceRoot":"","sources":["../src/TenantContext.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD,MAAM,WAAW,kBAAmB,SAAQ,aAAa;IACvD,mCAAmC;IACnC,YAAY,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,gCAAgC;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,eAAO,MAAM,SAAS,oDAAiD,CAAC"}

package/dist/TenantContext.js

@@ -0,0 +1,10 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { createContext } from 'react';
+export const TenantCtx = createContext(null);
+TenantCtx.displayName = 'TenantContext';

package/dist/TenantGuard.d.ts

@@ -0,0 +1,26 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React from 'react';
+export interface TenantGuardProps {
+    /** Required feature flag */
+    feature?: string;
+    /** Required tenant plan(s) */
+    plan?: string | string[];
+    /** Required tenant status */
+    status?: string;
+    /** Fallback content when guard fails */
+    fallback?: React.ReactNode;
+    /** Children to render when guard passes */
+    children: React.ReactNode;
+}
+/**
+ * Guard component that conditionally renders children based on tenant configuration.
+ * Useful for feature gating and plan-based access control.
+ */
+export declare function TenantGuard({ feature, plan, status, fallback, children, }: TenantGuardProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=TenantGuard.d.ts.map

package/dist/TenantGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TenantGuard.d.ts","sourceRoot":"","sources":["../src/TenantGuard.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAG1B,MAAM,WAAW,gBAAgB;IAC/B,4BAA4B;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8BAA8B;IAC9B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACzB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;IAC3B,2CAA2C;IAC3C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,IAAI,EACJ,MAAM,EACN,QAAe,EACf,QAAQ,GACT,EAAE,gBAAgB,2CA0BlB"}

package/dist/TenantGuard.js

@@ -0,0 +1,28 @@
+import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
+import { useTenant } from './useTenant';
+/**
+ * Guard component that conditionally renders children based on tenant configuration.
+ * Useful for feature gating and plan-based access control.
+ */
+export function TenantGuard({ feature, plan, status, fallback = null, children, }) {
+    const tenantCtx = useTenant();
+    if (!tenantCtx) {
+        return _jsx(_Fragment, { children: fallback });
+    }
+    // Check feature flag
+    if (feature && !tenantCtx.features[feature]) {
+        return _jsx(_Fragment, { children: fallback });
+    }
+    // Check plan
+    if (plan) {
+        const allowedPlans = Array.isArray(plan) ? plan : [plan];
+        if (tenantCtx.tenant.plan && !allowedPlans.includes(tenantCtx.tenant.plan)) {
+            return _jsx(_Fragment, { children: fallback });
+        }
+    }
+    // Check status
+    if (status && tenantCtx.tenant.status !== status) {
+        return _jsx(_Fragment, { children: fallback });
+    }
+    return _jsx(_Fragment, { children: children });
+}

package/dist/TenantProvider.d.ts

@@ -0,0 +1,23 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import React from 'react';
+import type { TenantConfig, TenantBranding, TenantProviderConfig } from '@object-ui/types';
+export interface TenantProviderProps {
+    /** Tenant configuration or function to resolve tenant */
+    tenant?: TenantConfig;
+    /** Tenant provider configuration */
+    config?: TenantProviderConfig;
+    /** Callback to fetch tenant by ID */
+    fetchTenant?: (tenantId: string) => Promise<TenantConfig>;
+    /** Default branding to merge with tenant branding */
+    defaultBranding?: Partial<TenantBranding>;
+    /** Children */
+    children: React.ReactNode;
+}
+export declare function TenantProvider({ tenant: initialTenant, config, fetchTenant, defaultBranding, children, }: TenantProviderProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=TenantProvider.d.ts.map

package/dist/TenantProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TenantProvider.d.ts","sourceRoot":"","sources":["../src/TenantProvider.tsx"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAoD,MAAM,OAAO,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAG3F,MAAM,WAAW,mBAAmB;IAClC,yDAAyD;IACzD,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,oCAAoC;IACpC,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,qCAAqC;IACrC,WAAW,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1D,qDAAqD;IACrD,eAAe,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IAC1C,eAAe;IACf,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;CAC3B;AAQD,wBAAgB,cAAc,CAAC,EAC7B,MAAM,EAAE,aAAa,EACrB,MAAM,EACN,WAAW,EACX,eAAe,EACf,QAAQ,GACT,EAAE,mBAAmB,2CA4ErB"}

package/dist/TenantProvider.js

@@ -0,0 +1,83 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { useState, useEffect, useCallback, useMemo } from 'react';
+import { TenantCtx } from './TenantContext';
+const DEFAULT_BRANDING = {
+    companyName: 'ObjectUI',
+    primaryColor: '#3b82f6',
+    secondaryColor: '#64748b',
+};
+export function TenantProvider({ tenant: initialTenant, config, fetchTenant, defaultBranding, children, }) {
+    const [tenant, setTenant] = useState(initialTenant ?? null);
+    const [isLoading, setIsLoading] = useState(!initialTenant);
+    const [error, setError] = useState(null);
+    // Resolve tenant on mount
+    useEffect(() => {
+        if (initialTenant) {
+            setTenant(initialTenant);
+            setIsLoading(false);
+            return;
+        }
+        if (config?.defaultTenantId && fetchTenant) {
+            setIsLoading(true);
+            fetchTenant(config.defaultTenantId)
+                .then((resolved) => {
+                setTenant(resolved);
+                setError(null);
+            })
+                .catch((err) => {
+                setError(err instanceof Error ? err : new Error(String(err)));
+            })
+                .finally(() => {
+                setIsLoading(false);
+            });
+        }
+        else {
+            setIsLoading(false);
+        }
+    }, [initialTenant, config?.defaultTenantId, fetchTenant]);
+    const switchTenant = useCallback(async (tenantId) => {
+        if (!fetchTenant) {
+            throw new Error('fetchTenant is required to switch tenants');
+        }
+        setIsLoading(true);
+        try {
+            const resolved = await fetchTenant(tenantId);
+            setTenant(resolved);
+            setError(null);
+        }
+        catch (err) {
+            setError(err instanceof Error ? err : new Error(String(err)));
+            throw err;
+        }
+        finally {
+            setIsLoading(false);
+        }
+    }, [fetchTenant]);
+    const mergedBranding = useMemo(() => ({
+        ...DEFAULT_BRANDING,
+        ...defaultBranding,
+        ...tenant?.branding,
+    }), [defaultBranding, tenant?.branding]);
+    const value = useMemo(() => {
+        if (!tenant)
+            return null;
+        return {
+            tenant,
+            isTenantAdmin: false,
+            branding: mergedBranding,
+            features: tenant.features ?? {},
+            switchTenant,
+            isLoading,
+            error,
+        };
+    }, [tenant, mergedBranding, switchTenant, isLoading, error]);
+    // While loading or if no tenant, still render children (they can handle null context)
+    return _jsx(TenantCtx.Provider, { value: value, children: children });
+}

package/dist/TenantScopedQuery.d.ts

@@ -0,0 +1,24 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { TenantScopedQueryConfig } from '@object-ui/types';
+export interface TenantScopedQueryProps {
+    /** Base query/filter */
+    filter?: Record<string, unknown>[];
+    /** Tenant ID to scope to */
+    tenantId: string;
+    /** Scoped query configuration */
+    config: TenantScopedQueryConfig;
+    /** Object name for exclusion check */
+    objectName?: string;
+}
+/**
+ * Applies tenant scoping to a query filter.
+ * Returns the original filter with tenant isolation applied.
+ */
+export declare function TenantScopedQuery({ filter, tenantId, config, objectName, }: TenantScopedQueryProps): Record<string, unknown>[];
+//# sourceMappingURL=TenantScopedQuery.d.ts.map

package/dist/TenantScopedQuery.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TenantScopedQuery.d.ts","sourceRoot":"","sources":["../src/TenantScopedQuery.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAEhE,MAAM,WAAW,sBAAsB;IACrC,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;IACnC,4BAA4B;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,iCAAiC;IACjC,MAAM,EAAE,uBAAuB,CAAC;IAChC,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,MAAW,EACX,QAAQ,EACR,MAAM,EACN,UAAU,GACX,EAAE,sBAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAkBpD"}

package/dist/TenantScopedQuery.js

@@ -0,0 +1,27 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Applies tenant scoping to a query filter.
+ * Returns the original filter with tenant isolation applied.
+ */
+export function TenantScopedQuery({ filter = [], tenantId, config, objectName, }) {
+    // Skip scoping for excluded objects
+    if (objectName && config.excludedObjects?.includes(objectName)) {
+        return filter;
+    }
+    if (!config.autoFilter) {
+        return filter;
+    }
+    // Add tenant filter condition
+    const tenantFilter = {
+        field: config.tenantField,
+        operator: '=',
+        value: tenantId,
+    };
+    return [...filter, tenantFilter];
+}

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * @object-ui/tenant
+ *
+ * Multi-tenancy support for Object UI providing:
+ * - TenantProvider context for React apps
+ * - useTenant hook for accessing tenant context
+ * - Tenant isolation and scoped queries
+ * - Custom branding per tenant
+ *
+ * @packageDocumentation
+ */
+export { TenantProvider, type TenantProviderProps } from './TenantProvider';
+export { useTenant } from './useTenant';
+export { useTenantBranding } from './useTenantBranding';
+export { TenantGuard, type TenantGuardProps } from './TenantGuard';
+export { createTenantResolver, type TenantResolver } from './resolver';
+export { TenantScopedQuery, type TenantScopedQueryProps } from './TenantScopedQuery';
+export type { TenantConfig, TenantBranding, TenantLimits, TenantContext, TenantProviderConfig, TenantScopedQueryConfig, TenantIsolationStrategy, TenantStatus, TenantPlan, TenantResolutionStrategy, } from '@object-ui/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,cAAc,EAAE,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,KAAK,cAAc,EAAE,MAAM,YAAY,CAAC;AACvE,OAAO,EAAE,iBAAiB,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAGrF,YAAY,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,uBAAuB,EACvB,uBAAuB,EACvB,YAAY,EACZ,UAAU,EACV,wBAAwB,GACzB,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * @object-ui/tenant
+ *
+ * Multi-tenancy support for Object UI providing:
+ * - TenantProvider context for React apps
+ * - useTenant hook for accessing tenant context
+ * - Tenant isolation and scoped queries
+ * - Custom branding per tenant
+ *
+ * @packageDocumentation
+ */
+export { TenantProvider } from './TenantProvider';
+export { useTenant } from './useTenant';
+export { useTenantBranding } from './useTenantBranding';
+export { TenantGuard } from './TenantGuard';
+export { createTenantResolver } from './resolver';
+export { TenantScopedQuery } from './TenantScopedQuery';

package/dist/resolver.d.ts

@@ -0,0 +1,26 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { TenantResolutionStrategy } from '@object-ui/types';
+export interface TenantResolver {
+    /** Resolve tenant ID from the current context */
+    resolve: () => string | null;
+}
+/**
+ * Creates a tenant resolver based on the specified strategy.
+ *
+ * @param strategy - How to extract the tenant identifier
+ * @param options - Strategy-specific options
+ * @returns A TenantResolver instance
+ */
+export declare function createTenantResolver(strategy: TenantResolutionStrategy, options?: {
+    headerName?: string;
+    queryParam?: string;
+    cookieName?: string;
+    customResolver?: () => string | null;
+}): TenantResolver;
+//# sourceMappingURL=resolver.d.ts.map

package/dist/resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../src/resolver.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,OAAO,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,wBAAwB,EAClC,OAAO,CAAC,EAAE;IACR,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACtC,GACA,cAAc,CA8DhB"}

package/dist/resolver.js

@@ -0,0 +1,76 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+/**
+ * Creates a tenant resolver based on the specified strategy.
+ *
+ * @param strategy - How to extract the tenant identifier
+ * @param options - Strategy-specific options
+ * @returns A TenantResolver instance
+ */
+export function createTenantResolver(strategy, options) {
+    switch (strategy) {
+        case 'subdomain':
+            return {
+                resolve: () => {
+                    if (typeof window === 'undefined')
+                        return null;
+                    const parts = window.location.hostname.split('.');
+                    return parts.length > 2 ? parts[0] : null;
+                },
+            };
+        case 'path':
+            return {
+                resolve: () => {
+                    if (typeof window === 'undefined')
+                        return null;
+                    const parts = window.location.pathname.split('/').filter(Boolean);
+                    return parts.length > 0 ? parts[0] : null;
+                },
+            };
+        case 'header':
+            return {
+                resolve: () => null, // Headers are server-side only
+            };
+        case 'query':
+            return {
+                resolve: () => {
+                    if (typeof window === 'undefined')
+                        return null;
+                    const params = new URLSearchParams(window.location.search);
+                    return params.get(options?.queryParam ?? 'tenant');
+                },
+            };
+        case 'cookie':
+            return {
+                resolve: () => {
+                    if (typeof document === 'undefined')
+                        return null;
+                    const name = options?.cookieName ?? 'tenant_id';
+                    const cookies = document.cookie.split('; ');
+                    for (const cookie of cookies) {
+                        const eqIndex = cookie.indexOf('=');
+                        if (eqIndex === -1)
+                            continue;
+                        const key = cookie.substring(0, eqIndex);
+                        if (key === name) {
+                            return decodeURIComponent(cookie.substring(eqIndex + 1));
+                        }
+                    }
+                    return null;
+                },
+            };
+        case 'custom':
+            return {
+                resolve: () => options?.customResolver?.() ?? null,
+            };
+        default:
+            return {
+                resolve: () => null,
+            };
+    }
+}

package/dist/useTenant.d.ts

@@ -0,0 +1,16 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { type TenantContextValue } from './TenantContext';
+/**
+ * Hook to access the current tenant context.
+ * Must be used within a TenantProvider.
+ *
+ * @returns Tenant context value or null if no tenant is configured
+ */
+export declare function useTenant(): TenantContextValue | null;
+//# sourceMappingURL=useTenant.d.ts.map

package/dist/useTenant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTenant.d.ts","sourceRoot":"","sources":["../src/useTenant.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAa,KAAK,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErE;;;;;GAKG;AACH,wBAAgB,SAAS,IAAI,kBAAkB,GAAG,IAAI,CAErD"}

package/dist/useTenant.js

@@ -0,0 +1,18 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { useContext } from 'react';
+import { TenantCtx } from './TenantContext';
+/**
+ * Hook to access the current tenant context.
+ * Must be used within a TenantProvider.
+ *
+ * @returns Tenant context value or null if no tenant is configured
+ */
+export function useTenant() {
+    return useContext(TenantCtx);
+}

package/dist/useTenantBranding.d.ts

@@ -0,0 +1,14 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import type { TenantBranding } from '@object-ui/types';
+/**
+ * Hook to access resolved tenant branding.
+ * Returns default branding if no tenant is configured.
+ */
+export declare function useTenantBranding(): TenantBranding;
+//# sourceMappingURL=useTenantBranding.d.ts.map

package/dist/useTenantBranding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTenantBranding.d.ts","sourceRoot":"","sources":["../src/useTenantBranding.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGvD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,cAAc,CAYlD"}

package/dist/useTenantBranding.js

@@ -0,0 +1,21 @@
+/**
+ * ObjectUI
+ * Copyright (c) 2024-present ObjectStack Inc.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ */
+import { useMemo } from 'react';
+import { useTenant } from './useTenant';
+/**
+ * Hook to access resolved tenant branding.
+ * Returns default branding if no tenant is configured.
+ */
+export function useTenantBranding() {
+    const tenantCtx = useTenant();
+    return useMemo(() => tenantCtx?.branding ?? {
+        companyName: 'ObjectUI',
+        primaryColor: '#3b82f6',
+        secondaryColor: '#64748b',
+    }, [tenantCtx?.branding]);
+}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@object-ui/tenant",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "description": "Multi-tenancy support for Object UI with tenant isolation, scoped queries, and custom branding.",
+  "homepage": "https://www.objectui.org",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/objectstack-ai/objectui.git",
+    "directory": "packages/tenant"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0"
+  },
+  "dependencies": {
+    "@object-ui/types": "0.5.0"
+  },
+  "devDependencies": {
+    "@types/react": "^19.2.13",
+    "react": "^19.1.0",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint ."
+  }
+}