@btst/stack 2.12.2 → 3.0.0-rc.1

package/dist/plugins/media/query-keys.d.ts

@@ -1,49 +1,236 @@
-import * as _tanstack_react_query from '@tanstack/react-query';
-import { j as MediaApiRouter, A as AssetListDiscriminator } from '../../shared/stack.COetIi--.js';
+import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
 import { createApiClient } from '@btst/stack/plugins/client';
+import { A as AssetListParams, s as AssetListDiscriminator, r as MediaApiRouter } from '../../shared/stack.C8SwdUz8.js';
 import { S as SerializedAsset, a as SerializedFolder } from '../../shared/stack.BMlLOMED.js';
-import { A as AssetListParams } from '../../shared/stack.DD-ZORI7.js';
 import '@btst/stack/plugins/api';
 import '../../shared/stack.lkebw2nj.js';
 import 'better-call';
 import 'zod';
 import '@btst/db';
 
-declare function createMediaQueryKeys(client: ReturnType<typeof createApiClient<MediaApiRouter>>, headers?: HeadersInit): {
+interface RegisterAssetInput {
+    url: string;
+    filename: string;
+    mimeType?: string;
+    size?: number;
+    folderId?: string;
+}
+interface CreateMediaFolderInput {
+    name: string;
+    parentId?: string;
+}
+declare function paginatedNextPageParam(lastPage: {
+    items?: unknown[];
+    total?: number;
+}, allPages: {
+    items?: unknown[];
+}[]): number | undefined;
+/**
+ * Media resource declaration — the single source of truth for HTTP mappings,
+ * query keys, pagination, and JSON mutations. File uploads stay on the custom
+ * upload transport because direct, S3, and Vercel Blob use different flows.
+ */
+declare const mediaResources: {
     mediaAssets: {
-        _def: readonly ["mediaAssets"];
-    } & {
-        list: ((params?: AssetListParams | undefined) => Omit<Omit<{
-            queryKey: readonly ["mediaAssets", "list", AssetListDiscriminator];
-            queryFn: _tanstack_react_query.QueryFunction<unknown, readonly ["mediaAssets", "list", AssetListDiscriminator]>;
-        }, "queryFn"> & {
-            _def: readonly ["mediaAssets", "list"];
-        }, "_def">) & {
-            _def: readonly ["mediaAssets", "list"];
-        };
-        detail: ((id: string) => Omit<{
-            queryKey: readonly ["mediaAssets", "detail", string];
-            queryFn: _tanstack_react_query.QueryFunction<SerializedAsset | null, readonly ["mediaAssets", "detail", string]>;
-        } & {
-            _def: readonly ["mediaAssets", "detail"];
-        }, "_def">) & {
-            _def: readonly ["mediaAssets", "detail"];
+        queries: {
+            list: {
+                path: string;
+                query: (params?: AssetListParams) => {
+                    folderId: string | undefined;
+                    mimeType: string | undefined;
+                    query: string | undefined;
+                    limit: number;
+                };
+                key: (params?: AssetListParams) => AssetListDiscriminator[];
+                select: (data: any) => {
+                    items: SerializedAsset[];
+                    total: number;
+                    limit?: number;
+                    offset?: number;
+                };
+                infinite: true;
+                pageSize: (params?: AssetListParams) => number;
+                nextPageParam: typeof paginatedNextPageParam;
+            };
+        };
+        mutations: {
+            create: {
+                path: string;
+                method: "POST";
+                input: (input: RegisterAssetInput) => {
+                    body: {
+                        filename: string;
+                        originalName: string;
+                        mimeType: string;
+                        size: number;
+                        url: string;
+                        folderId: string | undefined;
+                    };
+                };
+                select: (data: any) => SerializedAsset;
+                invalidates: string[];
+                refetchType: "all";
+                refresh: false;
+            };
+            delete: {
+                path: string;
+                method: "DELETE";
+                input: (id: string) => {
+                    params: {
+                        id: string;
+                    };
+                };
+                select: (data: any) => {
+                    success: boolean;
+                };
+                invalidates: string[];
+                refetchType: "all";
+                refresh: false;
+            };
         };
     };
     mediaFolders: {
-        _def: readonly ["mediaFolders"];
-    } & {
-        list: ((parentId?: string | null | undefined) => Omit<{
-            queryKey: readonly ["mediaFolders", "list", string];
-            queryFn: _tanstack_react_query.QueryFunction<SerializedFolder[], readonly ["mediaFolders", "list", string]>;
-        } & {
-            _def: readonly ["mediaFolders", "list"];
-        }, "_def">) & {
-            _def: readonly ["mediaFolders", "list"];
+        queries: {
+            list: {
+                path: string;
+                query: (parentId?: string | null) => {
+                    parentId?: undefined;
+                } | {
+                    parentId: string;
+                };
+                key: (parentId?: string | null) => string[];
+                select: (data: any) => SerializedFolder[];
+            };
+        };
+        mutations: {
+            create: {
+                path: string;
+                method: "POST";
+                input: (input: CreateMediaFolderInput) => {
+                    body: CreateMediaFolderInput;
+                };
+                select: (data: any) => SerializedFolder;
+                invalidates: string[];
+                refresh: false;
+            };
+            delete: {
+                path: string;
+                method: "DELETE";
+                input: (id: string) => {
+                    params: {
+                        id: string;
+                    };
+                };
+                select: (data: any) => {
+                    success: boolean;
+                };
+                invalidates: string[];
+                refresh: false;
+            };
         };
     };
 };
+declare function createMediaQueryKeys(client: ReturnType<typeof createApiClient<MediaApiRouter>>, headers?: HeadersInit): _btst_stack_plugins_client.ResourceQueryKeys<{
+    mediaAssets: {
+        queries: {
+            list: {
+                path: string;
+                query: (params?: AssetListParams) => {
+                    folderId: string | undefined;
+                    mimeType: string | undefined;
+                    query: string | undefined;
+                    limit: number;
+                };
+                key: (params?: AssetListParams) => AssetListDiscriminator[];
+                select: (data: any) => {
+                    items: SerializedAsset[];
+                    total: number;
+                    limit?: number;
+                    offset?: number;
+                };
+                infinite: true;
+                pageSize: (params?: AssetListParams) => number;
+                nextPageParam: typeof paginatedNextPageParam;
+            };
+        };
+        mutations: {
+            create: {
+                path: string;
+                method: "POST";
+                input: (input: RegisterAssetInput) => {
+                    body: {
+                        filename: string;
+                        originalName: string;
+                        mimeType: string;
+                        size: number;
+                        url: string;
+                        folderId: string | undefined;
+                    };
+                };
+                select: (data: any) => SerializedAsset;
+                invalidates: string[];
+                refetchType: "all";
+                refresh: false;
+            };
+            delete: {
+                path: string;
+                method: "DELETE";
+                input: (id: string) => {
+                    params: {
+                        id: string;
+                    };
+                };
+                select: (data: any) => {
+                    success: boolean;
+                };
+                invalidates: string[];
+                refetchType: "all";
+                refresh: false;
+            };
+        };
+    };
+    mediaFolders: {
+        queries: {
+            list: {
+                path: string;
+                query: (parentId?: string | null) => {
+                    parentId?: undefined;
+                } | {
+                    parentId: string;
+                };
+                key: (parentId?: string | null) => string[];
+                select: (data: any) => SerializedFolder[];
+            };
+        };
+        mutations: {
+            create: {
+                path: string;
+                method: "POST";
+                input: (input: CreateMediaFolderInput) => {
+                    body: CreateMediaFolderInput;
+                };
+                select: (data: any) => SerializedFolder;
+                invalidates: string[];
+                refresh: false;
+            };
+            delete: {
+                path: string;
+                method: "DELETE";
+                input: (id: string) => {
+                    params: {
+                        id: string;
+                    };
+                };
+                select: (data: any) => {
+                    success: boolean;
+                };
+                invalidates: string[];
+                refresh: false;
+            };
+        };
+    };
+}>;
 type MediaQueryKeys = ReturnType<typeof createMediaQueryKeys>;
 
-export { createMediaQueryKeys };
-export type { MediaQueryKeys };
+export { createMediaQueryKeys, mediaResources };
+export type { CreateMediaFolderInput, MediaQueryKeys, RegisterAssetInput };

package/dist/plugins/media/query-keys.mjs

@@ -1,70 +1,98 @@
-import { mergeQueryKeys, createQueryKeys } from '@lukemorales/query-key-factory';
-import { assetListDiscriminator } from '../../packages/stack/src/plugins/media/api/query-key-defs.mjs';
+import { createResourceQueryKeys } from '@btst/stack/plugins/client';
+import { folderListDiscriminator, assetListDiscriminator } from '../../packages/stack/src/plugins/media/api/query-key-defs.mjs';
+import { ROOT_FOLDER_QUERY_VALUE } from '../../packages/stack/src/plugins/media/schemas.mjs';
 
-function isErrorResponse(response) {
-  return typeof response === "object" && response !== null && "error" in response && response.error !== null && response.error !== void 0;
+function normalizeSearch(query) {
+  const normalized = query?.trim();
+  return normalized || void 0;
 }
-function toError(error) {
-  if (error instanceof Error) return error;
-  if (typeof error === "object" && error !== null) {
-    const errorObj = error;
-    const message = (typeof errorObj.message === "string" ? errorObj.message : null) || JSON.stringify(error);
-    const err = new Error(message);
-    Object.assign(err, error);
-    return err;
-  }
-  return new Error(String(error));
+function paginatedNextPageParam(lastPage, allPages) {
+  const items = Array.isArray(lastPage.items) ? lastPage.items : [];
+  const loadedCount = allPages.reduce(
+    (sum, page) => sum + (Array.isArray(page.items) ? page.items.length : 0),
+    0
+  );
+  return loadedCount < (lastPage.total ?? 0) && items.length > 0 ? loadedCount : void 0;
 }
+const mediaResources = {
+  mediaAssets: {
+    queries: {
+      list: {
+        path: "/media/assets",
+        query: (params = {}) => ({
+          folderId: params.folderId,
+          mimeType: params.mimeType,
+          query: normalizeSearch(params.query),
+          limit: params.limit ?? 20
+        }),
+        key: (params = {}) => [assetListDiscriminator(params)],
+        select: (data) => data,
+        infinite: true,
+        pageSize: (params = {}) => params.limit ?? 20,
+        nextPageParam: paginatedNextPageParam
+      }
+    },
+    mutations: {
+      create: {
+        path: "@post/media/assets",
+        method: "POST",
+        input: (input) => ({
+          body: {
+            filename: input.filename,
+            originalName: input.filename,
+            mimeType: input.mimeType ?? "application/octet-stream",
+            size: input.size ?? 0,
+            url: input.url,
+            folderId: input.folderId
+          }
+        }),
+        select: (data) => data,
+        invalidates: ["mediaAssets.list"],
+        refetchType: "all",
+        refresh: false
+      },
+      delete: {
+        path: "@delete/media/assets/:id",
+        method: "DELETE",
+        input: (id) => ({ params: { id } }),
+        select: (data) => data,
+        invalidates: ["mediaAssets.list"],
+        refetchType: "all",
+        refresh: false
+      }
+    }
+  },
+  mediaFolders: {
+    queries: {
+      list: {
+        path: "/media/folders",
+        query: (parentId) => parentId === void 0 ? {} : { parentId: parentId ?? ROOT_FOLDER_QUERY_VALUE },
+        key: (parentId) => [folderListDiscriminator(parentId)],
+        select: (data) => data
+      }
+    },
+    mutations: {
+      create: {
+        path: "@post/media/folders",
+        method: "POST",
+        input: (input) => ({ body: input }),
+        select: (data) => data,
+        invalidates: ["mediaFolders.list"],
+        refresh: false
+      },
+      delete: {
+        path: "@delete/media/folders/:id",
+        method: "DELETE",
+        input: (id) => ({ params: { id } }),
+        select: (data) => data,
+        invalidates: ["mediaFolders.list"],
+        refresh: false
+      }
+    }
+  }
+};
 function createMediaQueryKeys(client, headers) {
-  return mergeQueryKeys(
-    createQueryKeys("mediaAssets", {
-      list: (params) => ({
-        queryKey: [assetListDiscriminator(params)],
-        queryFn: async ({ pageParam }) => {
-          const response = await client("/media/assets", {
-            method: "GET",
-            query: {
-              folderId: params?.folderId,
-              mimeType: params?.mimeType,
-              query: params?.query,
-              offset: pageParam ?? params?.offset ?? 0,
-              limit: params?.limit ?? 20
-            },
-            headers
-          });
-          if (isErrorResponse(response)) throw toError(response.error);
-          const data = response.data;
-          return data;
-        }
-      }),
-      detail: (id) => ({
-        queryKey: [id],
-        queryFn: async () => {
-          const response = await client("/media/assets", {
-            method: "GET",
-            query: { id },
-            headers
-          });
-          if (isErrorResponse(response)) throw toError(response.error);
-          return response.data;
-        }
-      })
-    }),
-    createQueryKeys("mediaFolders", {
-      list: (parentId) => ({
-        queryKey: [parentId ?? "root"],
-        queryFn: async () => {
-          const response = await client("/media/folders", {
-            method: "GET",
-            query: parentId !== void 0 ? { parentId: parentId ?? void 0 } : {},
-            headers
-          });
-          if (isErrorResponse(response)) throw toError(response.error);
-          return response.data;
-        }
-      })
-    })
-  );
+  return createResourceQueryKeys(client, mediaResources, headers);
 }
 
-export { createMediaQueryKeys };
+export { createMediaQueryKeys, mediaResources };

package/dist/plugins/open-api/api/index.d.cts

@@ -1,8 +1,9 @@
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import * as better_call from 'better-call';
-import { S as StackContext } from '../../../shared/stack.CQnwAN7x.cjs';
+import { S as StackContext } from '../../../shared/stack.CBsp9rDM.cjs';
 import '@btst/yar';
 import '@btst/db';
+import '../../../shared/stack.C4_gEENS.cjs';
 
 /**
  * Scalar API Reference themes

package/dist/plugins/open-api/api/index.d.mts

@@ -1,8 +1,9 @@
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import * as better_call from 'better-call';
-import { S as StackContext } from '../../../shared/stack.CQnwAN7x.mjs';
+import { S as StackContext } from '../../../shared/stack.BL5PvShn.mjs';
 import '@btst/yar';
 import '@btst/db';
+import '../../../shared/stack.C4_gEENS.mjs';
 
 /**
  * Scalar API Reference themes

package/dist/plugins/open-api/api/index.d.ts

@@ -1,8 +1,9 @@
 import * as _btst_stack_plugins_api from '@btst/stack/plugins/api';
 import * as better_call from 'better-call';
-import { S as StackContext } from '../../../shared/stack.CQnwAN7x.js';
+import { S as StackContext } from '../../../shared/stack.BqTR6qi2.js';
 import '@btst/yar';
 import '@btst/db';
+import '../../../shared/stack.C4_gEENS.js';
 
 /**
  * Scalar API Reference themes

package/dist/plugins/route-docs/client/index.d.cts

@@ -1,10 +1,14 @@
 import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
-import * as React from 'react';
 import * as _btst_yar from '@btst/yar';
+import * as React from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 import { QueryClient } from '@tanstack/react-query';
-import { a as SitemapEntry, b as ClientStackContext } from '../../../shared/stack.CQnwAN7x.cjs';
+import { a as SitemapEntry, b as ClientStackContext } from '../../../shared/stack.CBsp9rDM.cjs';
 import '@btst/db';
 import 'better-call';
+import '../../../shared/stack.C4_gEENS.cjs';
+
+declare function DocsPageSkeleton(): react_jsx_runtime.JSX.Element;
 
 /**
  * Represents a documented route parameter
@@ -111,32 +115,30 @@ interface RouteDocsClientConfig {
     /** Site base path for constructing URLs (e.g., "/pages") */
     siteBasePath: string;
 }
+/**
+ * Default error component - no required props, matches other plugins
+ */
+declare function DocsErrorComponent(): react_jsx_runtime.JSX.Element;
 /**
  * Route Docs client plugin
  * Provides a route that displays documentation for all client routes
  */
 declare const routeDocsClientPlugin: (config: RouteDocsClientConfig) => _btst_stack_plugins_client.ClientPlugin<Record<string, never>, {
-    docs: {
-        (inputCtx_0?: _btst_yar.InputContext<"/route-docs", _btst_yar.RouteOptions> | undefined): {
-            PageComponent?: React.ComponentType<unknown> | undefined;
-            LoadingComponent?: React.ComponentType<unknown> | undefined;
-            ErrorComponent?: React.ComponentType<unknown> | undefined;
-            loader?: (() => Promise<void>) | undefined;
-            meta?: (() => ({
-                title: string;
-                name?: undefined;
-                content?: undefined;
-            } | {
-                name: string;
-                content: string;
-                title?: undefined;
-            })[]) | undefined;
-            extra?: (() => any) | undefined;
-        };
-        options: _btst_yar.RouteOptions | undefined;
-        path: "/route-docs";
-        meta: _btst_yar.RouteMeta | undefined;
-    };
+    docs: _btst_yar.DefinedRoute<"/route-docs", {
+        readonly page: () => react_jsx_runtime.JSX.Element;
+        readonly loading: React.LazyExoticComponent<typeof DocsPageSkeleton>;
+        readonly error: typeof DocsErrorComponent;
+        readonly loader: () => Promise<void>;
+        readonly meta: () => ({
+            title: string;
+            name?: undefined;
+            content?: undefined;
+        } | {
+            name: string;
+            content: string;
+            title?: undefined;
+        })[];
+    }, _btst_yar.RouteMeta>;
 }>;
 
 /**

package/dist/plugins/route-docs/client/index.d.mts

@@ -1,10 +1,14 @@
 import * as _btst_stack_plugins_client from '@btst/stack/plugins/client';
-import * as React from 'react';
 import * as _btst_yar from '@btst/yar';
+import * as React from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 import { QueryClient } from '@tanstack/react-query';
-import { a as SitemapEntry, b as ClientStackContext } from '../../../shared/stack.CQnwAN7x.mjs';
+import { a as SitemapEntry, b as ClientStackContext } from '../../../shared/stack.BL5PvShn.mjs';
 import '@btst/db';
 import 'better-call';
+import '../../../shared/stack.C4_gEENS.mjs';
+
+declare function DocsPageSkeleton(): react_jsx_runtime.JSX.Element;
 
 /**
  * Represents a documented route parameter
@@ -111,32 +115,30 @@ interface RouteDocsClientConfig {
     /** Site base path for constructing URLs (e.g., "/pages") */
     siteBasePath: string;
 }
+/**
+ * Default error component - no required props, matches other plugins
+ */
+declare function DocsErrorComponent(): react_jsx_runtime.JSX.Element;
 /**
  * Route Docs client plugin
  * Provides a route that displays documentation for all client routes
  */
 declare const routeDocsClientPlugin: (config: RouteDocsClientConfig) => _btst_stack_plugins_client.ClientPlugin<Record<string, never>, {
-    docs: {
-        (inputCtx_0?: _btst_yar.InputContext<"/route-docs", _btst_yar.RouteOptions> | undefined): {
-            PageComponent?: React.ComponentType<unknown> | undefined;
-            LoadingComponent?: React.ComponentType<unknown> | undefined;
-            ErrorComponent?: React.ComponentType<unknown> | undefined;
-            loader?: (() => Promise<void>) | undefined;
-            meta?: (() => ({
-                title: string;
-                name?: undefined;
-                content?: undefined;
-            } | {
-                name: string;
-                content: string;
-                title?: undefined;
-            })[]) | undefined;
-            extra?: (() => any) | undefined;
-        };
-        options: _btst_yar.RouteOptions | undefined;
-        path: "/route-docs";
-        meta: _btst_yar.RouteMeta | undefined;
-    };
+    docs: _btst_yar.DefinedRoute<"/route-docs", {
+        readonly page: () => react_jsx_runtime.JSX.Element;
+        readonly loading: React.LazyExoticComponent<typeof DocsPageSkeleton>;
+        readonly error: typeof DocsErrorComponent;
+        readonly loader: () => Promise<void>;
+        readonly meta: () => ({
+            title: string;
+            name?: undefined;
+            content?: undefined;
+        } | {
+            name: string;
+            content: string;
+            title?: undefined;
+        })[];
+    }, _btst_yar.RouteMeta>;
 }>;
 
 /**