@cobaltcore-dev/aurora 0.18.0 → 0.19.1

package/dist/client/trpcClient-BxcNKnhv.mjs

@@ -0,0 +1,65 @@
+import { createTRPCReact as e } from "@trpc/react-query";
+import { createTRPCClient as t, httpBatchLink as n, httpBatchStreamLink as r, httpLink as i, httpSubscriptionLink as a, isNonJsonSerializable as o, splitLink as s } from "@trpc/client";
+//#region src/client/trpcClient.ts
+var c = {
+	token: null,
+	pending: null,
+	async getHeaders() {
+		if (this.token) return { "x-csrf-token": this.token };
+		this.pending ||= fetch("/csrf-token").then((e) => e.json()).then(({ csrfToken: e }) => (this.token = e, this.pending = null, e)).catch((e) => (this.pending = null, console.error("Failed to fetch CSRF token:", e), null));
+		let e = await this.pending;
+		return e ? { "x-csrf-token": e } : {};
+	},
+	invalidate() {
+		this.token = null;
+	}
+}, l = new Set(["storage.swift.downloadObject", "storage.ceph.objects.downloadObject"]), u = { bffEndpoint: "/polaris-bff" };
+function d(e) {
+	u.bffEndpoint = e;
+}
+var f = () => [s({
+	condition: (e) => e.type === "subscription",
+	true: a({
+		url: u.bffEndpoint,
+		eventSourceOptions: async () => ({ headers: await c.getHeaders() })
+	}),
+	false: s({
+		condition: (e) => o(e.input),
+		true: i({
+			url: u.bffEndpoint,
+			async headers({ op: e }) {
+				let t = await c.getHeaders(), n = e.context?.headers ?? {};
+				return {
+					...t,
+					...n
+				};
+			}
+		}),
+		false: s({
+			condition: (e) => l.has(e.path),
+			true: r({
+				url: u.bffEndpoint,
+				async headers() {
+					return c.getHeaders();
+				}
+			}),
+			false: n({
+				url: u.bffEndpoint,
+				async headers() {
+					return c.getHeaders();
+				}
+			})
+		})
+	})
+})], p = e(), m = {
+	react: null,
+	vanilla: null
+}, h = new Proxy({}, { get(e, t) {
+	return m.react ||= p.createClient({ links: f() }), m.react[t];
+} }), g = new Proxy({}, { get(e, n) {
+	return m.vanilla ||= t({ links: f() }), m.vanilla[n];
+} });
+//#endregion
+export { h as i, g as n, p as r, d as t };
+
+//# sourceMappingURL=trpcClient-BxcNKnhv.mjs.map

package/dist/client/trpcClient-BxcNKnhv.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"trpcClient-BxcNKnhv.mjs","names":["createTRPCReact","createTRPCClient","httpBatchLink","httpBatchStreamLink","httpLink","splitLink","isNonJsonSerializable","httpSubscriptionLink","csrfCache","token","pending","getHeaders","fetch","then","res","json","csrfToken","catch","error","console","invalidate","invalidateCsrfToken","STREAMING_PROCEDURES","Set","config","bffEndpoint","setBffEndpoint","endpoint","getLinks","condition","op","type","true","url","eventSourceOptions","headers","false","input","csrf","extra","context","has","path","trpcReact","clients","react","vanilla","trpcReactClient","Proxy","get","_target","prop","createClient","links","trpcClient"],"sources":["../../src/client/trpcClient.ts"],"sourcesContent":["import { createTRPCReact } from \"@trpc/react-query\"\nimport type { CreateTRPCReact } from \"@trpc/react-query\"\nimport { createTRPCClient, type TRPCClient } from \"@trpc/client\"\nimport {\n  httpBatchLink,\n  httpBatchStreamLink,\n  httpLink,\n  splitLink,\n  isNonJsonSerializable,\n  httpSubscriptionLink,\n} from \"@trpc/client\"\nimport type { AuroraRouter } from \"../server/routers\"\n\n/** Type alias for the React tRPC client */\nexport type TrpcReact = ReturnType<typeof createTRPCReact<AuroraRouter>>\n\n/** Type alias for the vanilla tRPC client */\nexport type TrpcClient = ReturnType<typeof createTRPCClient<AuroraRouter>>\n\n/** Generic type for creating a typed React tRPC client with a custom router */\nexport type CreateTypedTrpcReact<TRouter extends AuroraRouter> = CreateTRPCReact<TRouter, unknown>\n\n/** Generic type for creating a typed vanilla tRPC client with a custom router */\nexport type CreateTypedTrpcClient<TRouter extends AuroraRouter> = TRPCClient<TRouter>\n\n// CSRF token cache with request deduplication\nconst csrfCache = {\n  token: null as string | null,\n  pending: null as Promise<string | null> | null,\n\n  async getHeaders() {\n    if (this.token) {\n      return { \"x-csrf-token\": this.token }\n    }\n\n    // Dedupe concurrent fetches - only one request in flight at a time\n    if (!this.pending) {\n      this.pending = fetch(\"/csrf-token\")\n        .then((res) => res.json())\n        .then(({ csrfToken }) => {\n          this.token = csrfToken\n          this.pending = null\n          return csrfToken as string\n        })\n        .catch((error) => {\n          this.pending = null\n          console.error(\"Failed to fetch CSRF token:\", error)\n          return null\n        })\n    }\n\n    const token = await this.pending\n    return token ? { \"x-csrf-token\": token } : {}\n  },\n\n  invalidate() {\n    this.token = null\n  },\n}\n\n/**\n * Invalidate the cached CSRF token.\n * Call this when receiving a 403 response to trigger a fresh token fetch on the next request.\n */\nexport const invalidateCsrfToken = () => csrfCache.invalidate()\n\n// Procedures that return async iterables (chunked streaming responses).\n// These are routed through httpBatchStreamLink instead of httpBatchLink.\n// Add any new streaming procedure paths here.\nconst STREAMING_PROCEDURES = new Set<string>([\"storage.swift.downloadObject\", \"storage.ceph.objects.downloadObject\"])\n\n// BFF endpoint - set once by App before any tRPC calls are made\nconst config = {\n  bffEndpoint: \"/polaris-bff\",\n}\n\nexport function setBffEndpoint(endpoint: string) {\n  config.bffEndpoint = endpoint\n}\n\nconst getLinks = () => [\n  splitLink({\n    // First check: is it a subscription?\n    condition: (op) => op.type === \"subscription\",\n    // Use HTTP subscription link for subscriptions (long-polling)\n    true: httpSubscriptionLink({\n      url: config.bffEndpoint,\n      // Callback to populate headers\n      eventSourceOptions: async () => {\n        return { headers: await csrfCache.getHeaders() }\n      },\n    }),\n    // For non-subscriptions, check for non-JSON data or streaming procedures\n    false: splitLink({\n      // Non-JSON serializable input (FormData, Blob, ArrayBuffer, etc.) → plain httpLink.\n      condition: (op) => isNonJsonSerializable(op.input),\n      true: httpLink({\n        url: config.bffEndpoint,\n        async headers({ op }) {\n          const csrf = await csrfCache.getHeaders()\n          // Per-request headers can be injected via tRPC operation context.\n          // op.context is set by the caller and forwarded through the link chain.\n          const extra = (op.context as { headers?: Record<string, string> } | undefined)?.headers ?? {}\n          return { ...csrf, ...extra }\n        },\n      }),\n      // For JSON procedures, decide between streaming and regular batching\n      false: splitLink({\n        // Procedures returning async iterables must use httpBatchStreamLink.\n        // httpBatchLink buffers the full response before resolving, which\n        // breaks streaming. httpBatchStreamLink preserves batching while\n        // supporting chunked/streamed responses.\n        // Note: httpBatchStreamLink is intentionally NOT used globally because\n        // it is incompatible with the @fastify/csrf-protection cookie rotation\n        // used in this app — CSRF tokens can expire mid-stream on long-lived\n        // connections. Scope it only to procedures that actually need streaming.\n        condition: (op) => STREAMING_PROCEDURES.has(op.path),\n        true: httpBatchStreamLink({\n          url: config.bffEndpoint,\n          async headers() {\n            return csrfCache.getHeaders()\n          },\n        }),\n        // Regular JSON mutations/queries — standard batching\n        false: httpBatchLink({\n          url: config.bffEndpoint,\n          async headers() {\n            return csrfCache.getHeaders()\n          },\n        }),\n      }),\n    }),\n  }),\n]\n\n// React Query client (for hooks like useQuery/useMutation/useSubscription)\nexport const trpcReact: TrpcReact = createTRPCReact<AuroraRouter>()\n\n// Lazy-initialized clients - created on first access after setBffEndpoint() has been called by App\nconst clients = {\n  react: null as ReturnType<typeof trpcReact.createClient> | null,\n  vanilla: null as TrpcClient | null,\n}\n\nexport const trpcReactClient = new Proxy({} as ReturnType<typeof trpcReact.createClient>, {\n  get(_target, prop) {\n    if (!clients.react) {\n      clients.react = trpcReact.createClient({ links: getLinks() })\n    }\n    return (clients.react as Record<string | symbol, unknown>)[prop]\n  },\n})\n\nexport const trpcClient: TrpcClient = new Proxy({} as TrpcClient, {\n  get(_target, prop) {\n    if (!clients.vanilla) {\n      clients.vanilla = createTRPCClient<AuroraRouter>({ links: getLinks() })\n    }\n    return (clients.vanilla as Record<string | symbol, unknown>)[prop]\n  },\n})\n"],"mappings":";;;AA0BA,IAAMQ,IAAY;CAChBC,OAAO;CACPC,SAAS;CAET,MAAMC,aAAAA;EACJ,IAAI,KAAKF,OACP,OAAO,EAAE,gBAAgB,KAAKA,MAAM;EAItC,AACE,KAAKC,YAAUE,MAAM,aAAA,EAClBC,MAAMC,MAAQA,EAAIC,KAAI,CAAA,EACtBF,MAAM,EAAEG,oBACP,KAAKP,QAAQO,GACb,KAAKN,UAAU,MACRM,EACT,EACCC,OAAOC,OACN,KAAKR,UAAU,MACfS,QAAQD,MAAM,+BAA+BA,CAAAA,GACtC,KACT;EAGJ,IAAMT,IAAQ,MAAM,KAAKC;EACzB,OAAOD,IAAQ,EAAE,gBAAgBA,EAAM,IAAI,CAAC;CAC9C;CAEAW,aAAAA;EACE,KAAKX,QAAQ;CACf;AACF,GAWMa,IAAuB,IAAIC,IAAY,CAAC,gCAAgC,qCAAA,CAAsC,GAG9GC,IAAS,EACbC,aAAa,eACf;AAEA,SAAgBC,EAAeC,GAAgB;CAC7CH,EAAOC,cAAcE;AACvB;AAEA,IAAMC,UAAiB,CACrBvB,EAAU;CAERwB,YAAYC,MAAOA,EAAGC,SAAS;CAE/BC,MAAMzB,EAAqB;EACzB0B,KAAKT,EAAOC;EAEZS,oBAAoB,aACX,EAAEC,SAAS,MAAM3B,EAAUG,WAAU,EAAG;CAEnD,CAAA;CAEAyB,OAAO/B,EAAU;EAEfwB,YAAYC,MAAOxB,EAAsBwB,EAAGO,KAAK;EACjDL,MAAM5B,EAAS;GACb6B,KAAKT,EAAOC;GACZ,MAAMU,QAAQ,EAAEL,SAAI;IAClB,IAAMQ,IAAO,MAAM9B,EAAUG,WAAU,GAGjC4B,IAAQ,EAAIC,SAA8DL,WAAW,CAAC;IAC5F,OAAO;KAAE,GAAGG;KAAM,GAAGC;IAAM;GAC7B;EACF,CAAA;EAEAH,OAAO/B,EAAU;GASfwB,YAAYC,MAAOR,EAAqBmB,IAAIX,EAAGY,IAAI;GACnDV,MAAM7B,EAAoB;IACxB8B,KAAKT,EAAOC;IACZ,MAAMU,UAAAA;KACJ,OAAO3B,EAAUG,WAAU;IAC7B;GACF,CAAA;GAEAyB,OAAOlC,EAAc;IACnB+B,KAAKT,EAAOC;IACZ,MAAMU,UAAAA;KACJ,OAAO3B,EAAUG,WAAU;IAC7B;GACF,CAAA;EACF,CAAA;CACF,CAAA;AACF,CAAA,CAAA,GAIWgC,IAAuB3C,EAAAA,GAG9B4C,IAAU;CACdC,OAAO;CACPC,SAAS;AACX,GAEaC,IAAkB,IAAIC,MAAM,CAAC,GAAgD,EACxFC,IAAIC,GAASC,GAAI;CAIf,OAHA,AACEP,EAAQC,UAAQF,EAAUS,aAAa,EAAEC,OAAOzB,EAAAA,EAAW,CAAA,GAEtD,EAASiB,MAA2CM;AAC7D,EACF,CAAA,GAEaG,IAAyB,IAAIN,MAAM,CAAC,GAAiB,EAChEC,IAAIC,GAASC,GAAI;CAIf,OAHA,AACEP,EAAQE,YAAU7C,EAA+B,EAAEoD,OAAOzB,EAAAA,EAAW,CAAA,GAEhE,EAASkB,QAA6CK;AAC/D,EACF,CAAA"}

package/dist/client/trpcClient.d.ts

@@ -9,6 +9,11 @@ export type TrpcClient = ReturnType<typeof createTRPCClient<AuroraRouter>>;
 export type CreateTypedTrpcReact<TRouter extends AuroraRouter> = CreateTRPCReact<TRouter, unknown>;
 /** Generic type for creating a typed vanilla tRPC client with a custom router */
 export type CreateTypedTrpcClient<TRouter extends AuroraRouter> = TRPCClient<TRouter>;
+/**
+ * Invalidate the cached CSRF token.
+ * Call this when receiving a 403 response to trigger a fresh token fetch on the next request.
+ */
+export declare const invalidateCsrfToken: () => void;
 export declare function setBffEndpoint(endpoint: string): void;
 export declare const trpcReact: TrpcReact;
 export declare const trpcReactClient: TRPCClient<import('@trpc/server').TRPCBuiltRouter<{
@@ -50,22 +55,25 @@ export declare const trpcReactClient: TRPCClient<import('@trpc/server').TRPCBuil
                         } | undefined;
                         configuration?: {
                             subject: {
-                                common_name: string;
+                                named_attributes: {
+                                    cn: string;
+                                    c?: string[] | undefined;
+                                    l?: string[] | undefined;
+                                    o?: string[] | undefined;
+                                    ou?: string[] | undefined;
+                                    postal_code?: string[] | undefined;
+                                    st?: string[] | undefined;
+                                    serial_number?: string | undefined;
+                                    street?: string[] | undefined;
+                                };
                                 additional_attribute?: {
                                     key: number[];
                                     value: string;
                                 }[] | undefined;
-                                country?: string[] | undefined;
-                                locality?: string[] | undefined;
-                                organization?: string[] | undefined;
-                                organizational_unit?: string[] | undefined;
-                                postal_code?: string[] | undefined;
-                                province?: string[] | undefined;
-                                serial_number?: string | undefined;
-                                street_address?: string[] | undefined;
                             };
                         } | undefined;
                         csr?: string | undefined;
+                        display_subject?: string | undefined;
                         imported_certificate_chain?: string | undefined;
                     }[];
                     links: {
@@ -81,19 +89,9 @@ export declare const trpcReactClient: TRPCClient<import('@trpc/server').TRPCBuil
                     project_id: string;
                     configuration: {
                         subject: {
-                            common_name: string;
-                            additional_attribute?: {
-                                key: number[];
-                                value: string;
-                            }[] | undefined;
-                            country?: string[] | undefined;
-                            locality?: string[] | undefined;
-                            organization?: string[] | undefined;
-                            organizational_unit?: string[] | undefined;
-                            postal_code?: string[] | undefined;
-                            province?: string[] | undefined;
-                            serial_number?: string | undefined;
-                            street_address?: string[] | undefined;
+                            named_attributes: {
+                                cn: string;
+                            };
                         };
                     };
                 };
@@ -116,22 +114,25 @@ export declare const trpcReactClient: TRPCClient<import('@trpc/server').TRPCBuil
                     } | undefined;
                     configuration?: {
                         subject: {
-                            common_name: string;
+                            named_attributes: {
+                                cn: string;
+                                c?: string[] | undefined;
+                                l?: string[] | undefined;
+                                o?: string[] | undefined;
+                                ou?: string[] | undefined;
+                                postal_code?: string[] | undefined;
+                                st?: string[] | undefined;
+                                serial_number?: string | undefined;
+                                street?: string[] | undefined;
+                            };
                             additional_attribute?: {
                                 key: number[];
                                 value: string;
                             }[] | undefined;
-                            country?: string[] | undefined;
-                            locality?: string[] | undefined;
-                            organization?: string[] | undefined;
-                            organizational_unit?: string[] | undefined;
-                            postal_code?: string[] | undefined;
-                            province?: string[] | undefined;
-                            serial_number?: string | undefined;
-                            street_address?: string[] | undefined;
                         };
                     } | undefined;
                     csr?: string | undefined;
+                    display_subject?: string | undefined;
                     imported_certificate_chain?: string | undefined;
                 };
                 meta: object;
@@ -160,22 +161,25 @@ export declare const trpcReactClient: TRPCClient<import('@trpc/server').TRPCBuil
                     } | undefined;
                     configuration?: {
                         subject: {
-                            common_name: string;
+                            named_attributes: {
+                                cn: string;
+                                c?: string[] | undefined;
+                                l?: string[] | undefined;
+                                o?: string[] | undefined;
+                                ou?: string[] | undefined;
+                                postal_code?: string[] | undefined;
+                                st?: string[] | undefined;
+                                serial_number?: string | undefined;
+                                street?: string[] | undefined;
+                            };
                             additional_attribute?: {
                                 key: number[];
                                 value: string;
                             }[] | undefined;
-                            country?: string[] | undefined;
-                            locality?: string[] | undefined;
-                            organization?: string[] | undefined;
-                            organizational_unit?: string[] | undefined;
-                            postal_code?: string[] | undefined;
-                            province?: string[] | undefined;
-                            serial_number?: string | undefined;
-                            street_address?: string[] | undefined;
                         };
                     } | undefined;
                     csr?: string | undefined;
+                    display_subject?: string | undefined;
                     imported_certificate_chain?: string | undefined;
                 };
                 meta: object;
@@ -213,22 +217,25 @@ export declare const trpcReactClient: TRPCClient<import('@trpc/server').TRPCBuil
                     } | undefined;
                     configuration?: {
                         subject: {
-                            common_name: string;
+                            named_attributes: {
+                                cn: string;
+                                c?: string[] | undefined;
+                                l?: string[] | undefined;
+                                o?: string[] | undefined;
+                                ou?: string[] | undefined;
+                                postal_code?: string[] | undefined;
+                                st?: string[] | undefined;
+                                serial_number?: string | undefined;
+                                street?: string[] | undefined;
+                            };
                             additional_attribute?: {
                                 key: number[];
                                 value: string;
                             }[] | undefined;
-                            country?: string[] | undefined;
-                            locality?: string[] | undefined;
-                            organization?: string[] | undefined;
-                            organizational_unit?: string[] | undefined;
-                            postal_code?: string[] | undefined;
-                            province?: string[] | undefined;
-                            serial_number?: string | undefined;
-                            street_address?: string[] | undefined;
                         };
                     } | undefined;
                     csr?: string | undefined;
+                    display_subject?: string | undefined;
                     imported_certificate_chain?: string | undefined;
                 };
                 meta: object;

package/dist/client/utils/buildFilterParams.d.ts

@@ -0,0 +1,5 @@
+import { FilterSettings } from '../components/ListToolbar/types';
+/**
+ * Builds filter parameters from current filter settings
+ */
+export declare const buildFilterParams: (filterSettings: FilterSettings) => Record<string, string | boolean>;

package/dist/client/utils/cn.d.ts

@@ -0,0 +1,27 @@
+import { ClassValue } from 'clsx';
+/**
+ * A utility function that combines clsx and tailwind-merge
+ *
+ * This function takes multiple class values (strings, objects, arrays, etc.)
+ * and combines them into a single string of CSS classes.
+ * It then uses tailwind-merge to resolve any Tailwind CSS conflicts.
+ *
+ * @param inputs - Class values to be combined
+ * @returns A string of CSS classes with Tailwind conflicts resolved
+ *
+ * @example
+ * // Basic usage
+ * cn('text-red-500', 'bg-blue-500')
+ * // => 'text-red-500 bg-blue-500'
+ *
+ * @example
+ * // With conditionals
+ * cn('text-white', isError && 'bg-red-500', !isError && 'bg-blue-500')
+ * // => 'text-white bg-red-500' or 'text-white bg-blue-500'
+ *
+ * @example
+ * // Resolving conflicts
+ * cn('text-red-500', 'text-blue-500')
+ * // => 'text-blue-500' (the latter class wins)
+ */
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/client/utils/formatBytes.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Supported unit systems for byte formatting.
+ *
+ * - `"binary"` (IEC): uses powers of 1024 → B, KiB, MiB, GiB, TiB, PiB, EiB, ZiB, YiB
+ * - `"decimal"` (SI):  uses powers of 1000 → B, KB, MB, GB, TB, PB, EB, ZB, YB
+ *
+ * Default is `"binary"`.
+ */
+export type ByteUnitSystem = "binary" | "decimal";
+export interface FormatBytesOptions {
+    /** Number of decimal places to display. Defaults to `2`. */
+    decimals?: number;
+    /** Unit system to use. Defaults to `"binary"`. */
+    unitSystem?: ByteUnitSystem;
+}
+/**
+ * Formats a raw byte count into a human-readable string.
+ *
+ * @example
+ * formatBytes(1536)                              // "1.50 KiB"  (binary, default)
+ * formatBytes(1500, { unitSystem: "decimal" })   // "1.50 KB"
+ * formatBytes(1073741824)                        // "1.00 GiB"
+ * formatBytes(0)                                 // "0 B"
+ * formatBytes(null)                              // "0 B"
+ */
+export declare function formatBytes(bytes: number | null | undefined, { decimals, unitSystem }?: FormatBytesOptions): string;
+/**
+ * Convenience wrapper that always uses the decimal (SI) unit system.
+ *
+ * @example
+ * formatBytesDecimal(1500000) // "1.50 MB"
+ */
+export declare const formatBytesDecimal: (bytes: number | null | undefined, decimals?: number) => string;
+/**
+ * Convenience wrapper that always uses the binary (IEC) unit system.
+ *
+ * @example
+ * formatBytesBinary(1048576) // "1.00 MiB"
+ */
+export declare const formatBytesBinary: (bytes: number | null | undefined, decimals?: number) => string;

package/dist/client/utils/formatFloatingIpStatus.d.ts

@@ -0,0 +1,6 @@
+import { FloatingIpStatus } from '../../server/Network/types/floatingIp';
+/**
+ * Formats a floating IP status value from uppercase enum to title case.
+ * Example: "ACTIVE" → "Active", "DOWN" → "Down", "ERROR" → "Error"
+ */
+export declare const formatFloatingIpStatus: (status: FloatingIpStatus) => string;

package/dist/client/utils/languageDetection.d.ts

@@ -0,0 +1,11 @@
+export declare const SUPPORTED_LOCALES: readonly ["en", "de"];
+export type SupportedLocale = (typeof SUPPORTED_LOCALES)[number];
+/**
+ * Detects the user's preferred language with fallback chain:
+ * 1. Saved preference (localStorage)
+ * 2. Browser language settings
+ * 3. Default locale
+ */
+export declare function detectLanguage(): SupportedLocale;
+export declare function saveLanguagePreference(locale: SupportedLocale): void;
+export declare function getLanguagePreference(): SupportedLocale | null;

package/dist/client/utils/trpcErrors.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Type guard to check if an error is a tRPC error with UNAUTHORIZED code
+ */
+export declare function isTRPCUnauthorized(error: unknown): boolean;
+/**
+ * Type guard to check if an error is a tRPC error
+ */
+export declare function isTRPCError(error: unknown): error is {
+    data: {
+        code: string;
+    };
+    message?: string;
+};

package/dist/client/utils/useErrorTranslation.d.ts

@@ -0,0 +1,4 @@
+export declare const useErrorTranslation: () => {
+    translateError: (errorCode: string) => string;
+    isRetryableError: (errorCode: string) => boolean;
+};

package/dist/client/utils/useListWithFiltering.d.ts

@@ -0,0 +1,84 @@
+import { FilterSettings, SortOption, SortSettings } from '../components/ListToolbar/types';
+/**
+ * Sort direction enumeration
+ * Used across all sort-enabled list views
+ */
+export type SortDirection = "asc" | "desc";
+/**
+ * Generic required sort settings with guaranteed non-optional properties
+ * Used by components to maintain a fully-defined sort state
+ *
+ * Type parameter K is the sort key type (string literal union of allowed sort fields)
+ *
+ * @example
+ * // For floating IPs
+ * type FloatingIpListSortSettings = ListSortConfig<FloatingIpsSortKey>
+ *
+ * // For security groups
+ * type SecurityGroupListSortSettings = ListSortConfig<"name" | "project_id">
+ */
+export type ListSortConfig<T extends string = string> = {
+    /**
+     * Array of available sort options to display in the UI
+     */
+    options: SortOption[];
+    /**
+     * The currently selected sort field (guaranteed to be one of the available options)
+     */
+    sortBy: T;
+    /**
+     * The currently active sort direction (guaranteed to be either "asc" or "desc")
+     */
+    sortDirection: SortDirection;
+};
+/**
+ * Configuration options for the useListWithFiltering hook
+ */
+export interface UseListWithFilteringOptions<T extends string> {
+    /** Default sort key to use on initial render */
+    defaultSortKey: T;
+    /** Default sort direction to use on initial render */
+    defaultSortDir: SortDirection;
+    /** Available sort options to display in the sort dropdown */
+    sortOptions: Array<{
+        label: string;
+        value: string;
+    }>;
+    /** Initial filter settings configuration */
+    filterSettings: FilterSettings;
+}
+/**
+ * Return value from the useListWithFiltering hook
+ */
+export interface UseListWithFilteringReturn<T extends string> {
+    searchTerm: string;
+    sortSettings: ListSortConfig<T>;
+    filterSettings: FilterSettings;
+    handleSearchChange: (term: string | number | string[] | undefined) => void;
+    handleSortChange: (newSortSettings: SortSettings) => void;
+    handleFilterChange: (newFilterSettings: FilterSettings) => void;
+}
+/**
+ * Custom hook to manage common list view state: search, sort, and filter
+ *
+ * Extracts shared logic from list components to ensure consistent behavior
+ * across all list pages and reduce code duplication.
+ *
+ * @example
+ * ```tsx
+ * const listState = useListWithFiltering({
+ *   defaultSortKey: "name",
+ *   defaultSortDir: "asc",
+ *   sortOptions: [
+ *     { label: t`Name`, value: "name" },
+ *     { label: t`Created`, value: "created_at" },
+ *   ],
+ *   filterSettings: {
+ *     filters: [
+ *       { displayName: t`Status`, filterName: "status", values: ["active", "inactive"] }
+ *     ]
+ *   }
+ * })
+ * ```
+ */
+export declare function useListWithFiltering<T extends string>({ defaultSortKey, defaultSortDir, sortOptions, filterSettings: initialFilterSettings, }: UseListWithFilteringOptions<T>): UseListWithFilteringReturn<T>;

package/dist/client/utils/useModal.d.ts

@@ -0,0 +1,3 @@
+type UseModalReturn = [boolean, () => void];
+export declare const useModal: (initialState?: boolean) => UseModalReturn;
+export {};

package/dist/server/index.d.ts

@@ -708,22 +708,25 @@ declare const buildBaseRouter: (policyDir: string) => _trpc_server.TRPCBuiltRout
                         } | undefined;
                         configuration?: {
                             subject: {
-                                common_name: string;
+                                named_attributes: {
+                                    cn: string;
+                                    c?: string[] | undefined;
+                                    l?: string[] | undefined;
+                                    o?: string[] | undefined;
+                                    ou?: string[] | undefined;
+                                    postal_code?: string[] | undefined;
+                                    st?: string[] | undefined;
+                                    serial_number?: string | undefined;
+                                    street?: string[] | undefined;
+                                };
                                 additional_attribute?: {
                                     key: number[];
                                     value: string;
                                 }[] | undefined;
-                                country?: string[] | undefined;
-                                locality?: string[] | undefined;
-                                organization?: string[] | undefined;
-                                organizational_unit?: string[] | undefined;
-                                postal_code?: string[] | undefined;
-                                province?: string[] | undefined;
-                                serial_number?: string | undefined;
-                                street_address?: string[] | undefined;
                             };
                         } | undefined;
                         csr?: string | undefined;
+                        display_subject?: string | undefined;
                         imported_certificate_chain?: string | undefined;
                     }[];
                     links: {
@@ -739,19 +742,9 @@ declare const buildBaseRouter: (policyDir: string) => _trpc_server.TRPCBuiltRout
                     project_id: string;
                     configuration: {
                         subject: {
-                            common_name: string;
-                            additional_attribute?: {
-                                key: number[];
-                                value: string;
-                            }[] | undefined;
-                            country?: string[] | undefined;
-                            locality?: string[] | undefined;
-                            organization?: string[] | undefined;
-                            organizational_unit?: string[] | undefined;
-                            postal_code?: string[] | undefined;
-                            province?: string[] | undefined;
-                            serial_number?: string | undefined;
-                            street_address?: string[] | undefined;
+                            named_attributes: {
+                                cn: string;
+                            };
                         };
                     };
                 };
@@ -774,22 +767,25 @@ declare const buildBaseRouter: (policyDir: string) => _trpc_server.TRPCBuiltRout
                     } | undefined;
                     configuration?: {
                         subject: {
-                            common_name: string;
+                            named_attributes: {
+                                cn: string;
+                                c?: string[] | undefined;
+                                l?: string[] | undefined;
+                                o?: string[] | undefined;
+                                ou?: string[] | undefined;
+                                postal_code?: string[] | undefined;
+                                st?: string[] | undefined;
+                                serial_number?: string | undefined;
+                                street?: string[] | undefined;
+                            };
                             additional_attribute?: {
                                 key: number[];
                                 value: string;
                             }[] | undefined;
-                            country?: string[] | undefined;
-                            locality?: string[] | undefined;
-                            organization?: string[] | undefined;
-                            organizational_unit?: string[] | undefined;
-                            postal_code?: string[] | undefined;
-                            province?: string[] | undefined;
-                            serial_number?: string | undefined;
-                            street_address?: string[] | undefined;
                         };
                     } | undefined;
                     csr?: string | undefined;
+                    display_subject?: string | undefined;
                     imported_certificate_chain?: string | undefined;
                 };
                 meta: object;
@@ -818,22 +814,25 @@ declare const buildBaseRouter: (policyDir: string) => _trpc_server.TRPCBuiltRout
                     } | undefined;
                     configuration?: {
                         subject: {
-                            common_name: string;
+                            named_attributes: {
+                                cn: string;
+                                c?: string[] | undefined;
+                                l?: string[] | undefined;
+                                o?: string[] | undefined;
+                                ou?: string[] | undefined;
+                                postal_code?: string[] | undefined;
+                                st?: string[] | undefined;
+                                serial_number?: string | undefined;
+                                street?: string[] | undefined;
+                            };
                             additional_attribute?: {
                                 key: number[];
                                 value: string;
                             }[] | undefined;
-                            country?: string[] | undefined;
-                            locality?: string[] | undefined;
-                            organization?: string[] | undefined;
-                            organizational_unit?: string[] | undefined;
-                            postal_code?: string[] | undefined;
-                            province?: string[] | undefined;
-                            serial_number?: string | undefined;
-                            street_address?: string[] | undefined;
                         };
                     } | undefined;
                     csr?: string | undefined;
+                    display_subject?: string | undefined;
                     imported_certificate_chain?: string | undefined;
                 };
                 meta: object;
@@ -871,22 +870,25 @@ declare const buildBaseRouter: (policyDir: string) => _trpc_server.TRPCBuiltRout
                     } | undefined;
                     configuration?: {
                         subject: {
-                            common_name: string;
+                            named_attributes: {
+                                cn: string;
+                                c?: string[] | undefined;
+                                l?: string[] | undefined;
+                                o?: string[] | undefined;
+                                ou?: string[] | undefined;
+                                postal_code?: string[] | undefined;
+                                st?: string[] | undefined;
+                                serial_number?: string | undefined;
+                                street?: string[] | undefined;
+                            };
                             additional_attribute?: {
                                 key: number[];
                                 value: string;
                             }[] | undefined;
-                            country?: string[] | undefined;
-                            locality?: string[] | undefined;
-                            organization?: string[] | undefined;
-                            organizational_unit?: string[] | undefined;
-                            postal_code?: string[] | undefined;
-                            province?: string[] | undefined;
-                            serial_number?: string | undefined;
-                            street_address?: string[] | undefined;
                         };
                     } | undefined;
                     csr?: string | undefined;
+                    display_subject?: string | undefined;
                     imported_certificate_chain?: string | undefined;
                 };
                 meta: object;