@asteby/metacore-app-providers 4.0.0 → 5.0.0

package/dist/index.d.ts

@@ -4,5 +4,6 @@ export { LayoutProvider, useLayout, type Collapsible, type Variant, } from './la
 export { SearchProvider, useSearch, type SearchProviderProps } from './search-provider';
 export { getCookie, setCookie, removeCookie } from './cookies';
 export { PlatformConfigProvider, usePlatformConfig, applyBranding, applyCachedBranding, FALLBACK_BRANDING, type PlatformBranding, type BrandingFetcher, type PlatformConfigProviderProps, } from './platform-config-provider';
+export { OrgConfigProvider, useOrgConfig, FALLBACK_ORG_CONFIG, type OrgConfig, type OrgConfigFetcher, type OrgConfigProviderProps, } from './org-config-provider';
 export { MetacoreAppShell, type MetacoreAppShellProps, } from './metacore-app-shell';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACtF,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAC/E,OAAO,EACL,cAAc,EACd,SAAS,EACT,KAAK,WAAW,EAChB,KAAK,OAAO,GACb,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC9D,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,2BAA2B,GACjC,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,KAAK,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACtF,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,KAAK,iBAAiB,EAAE,MAAM,iBAAiB,CAAA;AAC/E,OAAO,EACL,cAAc,EACd,SAAS,EACT,KAAK,WAAW,EAChB,KAAK,OAAO,GACb,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC9D,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,EACjB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,2BAA2B,GACjC,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,EACnB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,GAC5B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,gBAAgB,EAChB,KAAK,qBAAqB,GAC3B,MAAM,sBAAsB,CAAA"}

package/dist/index.js

@@ -4,5 +4,6 @@ export { LayoutProvider, useLayout, } from './layout-provider';
 export { SearchProvider, useSearch } from './search-provider';
 export { getCookie, setCookie, removeCookie } from './cookies';
 export { PlatformConfigProvider, usePlatformConfig, applyBranding, applyCachedBranding, FALLBACK_BRANDING, } from './platform-config-provider';
+export { OrgConfigProvider, useOrgConfig, FALLBACK_ORG_CONFIG, } from './org-config-provider';
 export { MetacoreAppShell, } from './metacore-app-shell';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAkB,MAAM,sBAAsB,CAAA;AACtF,OAAO,EAAE,YAAY,EAAE,OAAO,EAA0B,MAAM,iBAAiB,CAAA;AAC/E,OAAO,EACL,cAAc,EACd,SAAS,GAGV,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,cAAc,EAAE,SAAS,EAA4B,MAAM,mBAAmB,CAAA;AACvF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC9D,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,GAIlB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACL,gBAAgB,GAEjB,MAAM,sBAAsB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAkB,MAAM,sBAAsB,CAAA;AACtF,OAAO,EAAE,YAAY,EAAE,OAAO,EAA0B,MAAM,iBAAiB,CAAA;AAC/E,OAAO,EACL,cAAc,EACd,SAAS,GAGV,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,cAAc,EAAE,SAAS,EAA4B,MAAM,mBAAmB,CAAA;AACvF,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAC9D,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,aAAa,EACb,mBAAmB,EACnB,iBAAiB,GAIlB,MAAM,4BAA4B,CAAA;AACnC,OAAO,EACL,iBAAiB,EACjB,YAAY,EACZ,mBAAmB,GAIpB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EACL,gBAAgB,GAEjB,MAAM,sBAAsB,CAAA"}

package/dist/org-config-provider.d.ts

@@ -0,0 +1,67 @@
+import { type ReactNode } from 'react';
+export interface OrgConfig {
+    /** ISO 4217 currency code, e.g. "MXN", "COP", "USD". */
+    currency: string;
+    /** BCP-47 locale tag, e.g. "es-MX", "es-CO", "en-US". */
+    locale: string;
+    /**
+     * Validator identifiers keyed by the `$org.<key>` reference shape used
+     * by the kernel. e.g.
+     *   { tax_id_validator: 'rfc.tax_id', postal_code: 'mx.cp' }
+     * The SDK resolves each $org.<key> token through this map at form time.
+     */
+    validators: Record<string, string>;
+    /**
+     * Address layout slug. The SDK has no built-in formats — apps register
+     * their own renderers and this string picks one. Empty defaults to a
+     * neutral 4-line layout.
+     */
+    addressFormat: string;
+    /**
+     * Free-form bag for app-specific config the SDK does not type. Use
+     * sparingly: anything the SDK consumes should land in a typed field
+     * above first.
+     */
+    extra: Record<string, unknown>;
+}
+export declare const FALLBACK_ORG_CONFIG: OrgConfig;
+interface OrgConfigContextValue {
+    config: OrgConfig;
+    loading: boolean;
+    /**
+     * Resolves a `$org.<key>` reference (or a plain key) to the configured
+     * validator identifier. Returns null when the org has not configured
+     * that validator — callers decide between a built-in fallback and
+     * surfacing the missing config to the operator.
+     */
+    resolveValidator: (refOrKey: string) => string | null;
+    refetch: () => void;
+}
+export type OrgConfigFetcher = () => Promise<Partial<OrgConfig>>;
+export interface OrgConfigProviderProps {
+    children: ReactNode;
+    /**
+     * Async function returning the current org's config. Apps wire whatever
+     * transport they already use (axios, fetch, ofetch).
+     */
+    fetcher: OrgConfigFetcher;
+    /**
+     * Defaults applied while the fetcher hasn't resolved yet OR when the
+     * server omits a field. Apps pass their static brand defaults
+     * (currency, locale) so the SDK never paints with FALLBACK_ORG_CONFIG.
+     */
+    defaults?: OrgConfig;
+    /** TanStack Query staleTime, defaults to 5 minutes. */
+    staleTime?: number;
+}
+export declare function OrgConfigProvider({ children, fetcher, defaults, staleTime, }: OrgConfigProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Returns the current org config plus a `resolveValidator` helper for
+ * `$org.<key>` references. Throws if used outside an `<OrgConfigProvider>`
+ * is NOT the contract — the hook returns the FALLBACK so legacy app
+ * shells without the provider keep rendering, just without locale-aware
+ * behaviour. Apps that depend on org config should mount the provider.
+ */
+export declare function useOrgConfig(): OrgConfigContextValue;
+export {};
+//# sourceMappingURL=org-config-provider.d.ts.map

package/dist/org-config-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-config-provider.d.ts","sourceRoot":"","sources":["../src/org-config-provider.tsx"],"names":[],"mappings":"AAeA,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,OAAO,CAAA;AAGd,MAAM,WAAW,SAAS;IACxB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAA;IAChB,yDAAyD;IACzD,MAAM,EAAE,MAAM,CAAA;IACd;;;;;OAKG;IACH,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC;;;;OAIG;IACH,aAAa,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC/B;AAED,eAAO,MAAM,mBAAmB,EAAE,SAMjC,CAAA;AAED,UAAU,qBAAqB;IAC7B,MAAM,EAAE,SAAS,CAAA;IACjB,OAAO,EAAE,OAAO,CAAA;IAChB;;;;;OAKG;IACH,gBAAgB,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAA;IACrD,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB;AASD,MAAM,MAAM,gBAAgB,GAAG,MAAM,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAA;AAEhE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,SAAS,CAAA;IACnB;;;OAGG;IACH,OAAO,EAAE,gBAAgB,CAAA;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,SAAS,CAAA;IACpB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,wBAAgB,iBAAiB,CAAC,EAChC,QAAQ,EACR,OAAO,EACP,QAA8B,EAC9B,SAAyB,GAC1B,EAAE,sBAAsB,2CAmCxB;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,IAAI,qBAAqB,CAEpD"}

package/dist/org-config-provider.js

@@ -0,0 +1,88 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// OrgConfigProvider — sibling to PlatformConfigProvider that exposes the
+// per-org configuration the SDK needs for locale-aware behaviour:
+//   • currency / locale defaults
+//   • tax-id validator identifier (the kernel's $org.tax_id_validator
+//     reference resolves to whatever this provider returns for the key)
+//   • address format slug
+//   • any other org-scoped configuration the app wants to surface
+//
+// The principle (from project-wide doctrine): NOTHING fiscal/regional
+// hardcoded in the SDK. The SDK only knows how to apply a validator the
+// org config picks. This provider is the resolver surface — apps wire a
+// fetcher pointing at their own /api/org/config endpoint and the SDK
+// reads `validators[<key>]` / `currency` / etc. through `useOrgConfig`.
+//
+// Decoupled from the app: the fetcher is injected, no axios import here.
+import { createContext, useContext, useMemo, } from 'react';
+import { useQuery } from '@tanstack/react-query';
+export const FALLBACK_ORG_CONFIG = {
+    currency: 'USD',
+    locale: 'en-US',
+    validators: {},
+    addressFormat: '',
+    extra: {},
+};
+const OrgConfigContext = createContext({
+    config: FALLBACK_ORG_CONFIG,
+    loading: false,
+    resolveValidator: () => null,
+    refetch: () => { },
+});
+export function OrgConfigProvider({ children, fetcher, defaults = FALLBACK_ORG_CONFIG, staleTime = 5 * 60 * 1000, }) {
+    const { data, isLoading, refetch } = useQuery({
+        queryKey: ['metacore-org-config'],
+        queryFn: async () => {
+            const res = await fetcher();
+            return mergeOrgConfig(defaults, res);
+        },
+        staleTime,
+        retry: 1,
+    });
+    const value = useMemo(() => {
+        const config = data ?? defaults;
+        return {
+            config,
+            loading: isLoading,
+            resolveValidator: (refOrKey) => {
+                if (!refOrKey)
+                    return null;
+                const key = refOrKey.startsWith('$org.')
+                    ? refOrKey.slice('$org.'.length)
+                    : refOrKey;
+                const resolved = config.validators?.[key];
+                return resolved && resolved.length > 0 ? resolved : null;
+            },
+            refetch: () => {
+                refetch();
+            },
+        };
+    }, [data, defaults, isLoading, refetch]);
+    return (_jsx(OrgConfigContext, { value: value, children: children }));
+}
+/**
+ * Returns the current org config plus a `resolveValidator` helper for
+ * `$org.<key>` references. Throws if used outside an `<OrgConfigProvider>`
+ * is NOT the contract — the hook returns the FALLBACK so legacy app
+ * shells without the provider keep rendering, just without locale-aware
+ * behaviour. Apps that depend on org config should mount the provider.
+ */
+export function useOrgConfig() {
+    return useContext(OrgConfigContext);
+}
+function mergeOrgConfig(defaults, partial) {
+    return {
+        currency: partial.currency || defaults.currency,
+        locale: partial.locale || defaults.locale,
+        validators: {
+            ...defaults.validators,
+            ...(partial.validators || {}),
+        },
+        addressFormat: partial.addressFormat || defaults.addressFormat,
+        extra: {
+            ...defaults.extra,
+            ...(partial.extra || {}),
+        },
+    };
+}
+//# sourceMappingURL=org-config-provider.js.map

package/dist/org-config-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"org-config-provider.js","sourceRoot":"","sources":["../src/org-config-provider.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@asteby/metacore-app-providers",
-  "version": "4.0.0",
+  "version": "5.0.0",
   "description": "Providers genéricos reutilizables para apps metacore (direction, font, layout, search, platform-config)",
   "license": "Apache-2.0",
   "repository": {
@@ -27,7 +27,7 @@
     "react": ">=18",
     "react-dom": ">=18",
     "@asteby/metacore-pwa": ">=0.3.1",
-    "@asteby/metacore-runtime-react": ">=9.1.0",
+    "@asteby/metacore-runtime-react": ">=9.2.0",
     "@asteby/metacore-ui": ">=2.0.0",
     "sonner": ">=1.7"
   },
@@ -50,9 +50,9 @@
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "sonner": "^2.0.0",
-    "typescript": "^5.6.0",
+    "typescript": "^6.0.0",
     "@asteby/metacore-pwa": "0.3.1",
-    "@asteby/metacore-runtime-react": "9.1.0",
+    "@asteby/metacore-runtime-react": "9.2.0",
     "@asteby/metacore-ui": "2.0.0"
   },
   "publishConfig": {