@btst/stack 5.0.0 → 5.1.0

package/dist/shared/{stack.mRRyZBUg.d.cts → stack.Rb87lHqK.d.cts}

@@ -50,6 +50,8 @@ interface Operation<TInputSchema extends z.ZodTypeAny = z.ZodTypeAny, TPermissio
     readonly permission: TPermission;
     readonly access: OperationAccess;
     readonly resultMode: TPassthroughResult extends true ? "passthrough" : "immutable";
+    /** Type-only result marker, preserved when an operation has a specialized call signature. */
+    readonly "~result"?: TResult;
 }
 /** Any plugin operation, for generic stack composition. */
 type AnyOperation = Operation<z.ZodTypeAny, AnyPermissionDescriptor, any, false> | Operation<z.ZodTypeAny, AnyPermissionDescriptor, any, true>;
@@ -59,9 +61,13 @@ type OperationInput<TOperation extends AnyOperation> = TOperation extends Operat
 type OperationTransportResult<TOperation extends AnyOperation> = TOperation extends Operation<any, any, infer TResult, infer TPassthroughResult> ? TPassthroughResult extends true ? TResult : DeepReadonly<TResult> : never;
 /** Infer the permission request enforced by an operation. */
 type OperationPermissionRequest<TOperation extends AnyOperation> = TOperation extends Operation<any, infer TPermission, any, any> ? PermissionRequestFor<TPermission> : never;
+/** Input-dependent callable typing; runtime execution still uses the operation definition. */
+interface OperationCallSignature<TCall extends (...args: any[]) => Promise<unknown>> {
+    readonly "~call": TCall;
+}
 /** Convert operation definitions into their bound callable application API. */
 type OperationApi<TOperations extends OperationRecord> = {
-    [TKey in keyof TOperations]: (input: OperationInput<TOperations[TKey]>) => Promise<OperationTransportResult<TOperations[TKey]>>;
+    [TKey in keyof TOperations]: TOperations[TKey] extends OperationCallSignature<infer TCall> ? TCall : (input: OperationInput<TOperations[TKey]>) => Promise<OperationTransportResult<TOperations[TKey]>>;
 };
 /** One request-bound operation plus its endpoint-binding helper. */
 type RouteOperation<TOperation extends AnyOperation> = {
@@ -609,5 +615,5 @@ type SitemapEntry = {
 };
 type Sitemap = Array<SitemapEntry>;
 
-export { OperationHttpError as i, defineOperation as n, definePassthroughOperation as o };
-export type { AnyOperation as A, BackendPlugin as B, ClientPlugin as C, DeepReadonly as D, ClientPluginEndpointOverride as E, ClientPluginEndpointOverrides as F, ClientProviderApi as G, ClientProviderPluginRuntime as H, InfrastructureRouteDeclaration as I, ClientProviderProjection as J, ClientStack as K, ClientStackContext as L, ResolvedClientApi as M, ResolvedClientStackConfig as N, OperationRecord as O, PluginOverrides as P, SitemapEntry as Q, RequiredClientPluginOverrides as R, StackContext as S, InferredPluginOverrides as T, RegisteredClientPlugins as U, PrefixedPluginRoutes as V, BackendStackConfig as W, CompatibleStackAuth as X, BackendStack as Y, PluginRaw as Z, PluginOperations as _, ComposedEndpointInventoryEntry as a, InfrastructureRouteInventory as b, Operation as c, OperationAccess as d, OperationApi as e, OperationContext as f, OperationData as g, OperationErrorContext as h, OperationPermissionRequest as j, OperationResultMode as k, RouteOperation as l, RouteOperationApi as m, ClientPluginDefinition as p, ClientPluginRegistration as q, ResolvedClientPluginRuntime as r, Sitemap as s, PluginRoutes as t, ClientStackConfig as u, ResolvedClientStack as v, ClientApiConfig as w, ClientApiEndpointOverride as x, ClientLocation as y, ClientLocationOverride as z };
+export { OperationHttpError as j, defineOperation as o, definePassthroughOperation as p };
+export type { PluginOperations as $, AnyOperation as A, BackendPlugin as B, ClientPlugin as C, DeepReadonly as D, ClientLocationOverride as E, ClientPluginEndpointOverride as F, ClientPluginEndpointOverrides as G, ClientProviderApi as H, InfrastructureRouteDeclaration as I, ClientProviderPluginRuntime as J, ClientProviderProjection as K, ClientStack as L, ClientStackContext as M, ResolvedClientApi as N, OperationRecord as O, PluginOverrides as P, ResolvedClientStackConfig as Q, RequiredClientPluginOverrides as R, StackContext as S, SitemapEntry as T, InferredPluginOverrides as U, RegisteredClientPlugins as V, PrefixedPluginRoutes as W, BackendStackConfig as X, CompatibleStackAuth as Y, BackendStack as Z, PluginRaw as _, ComposedEndpointInventoryEntry as a, InfrastructureRouteInventory as b, Operation as c, OperationAccess as d, OperationApi as e, OperationCallSignature as f, OperationContext as g, OperationData as h, OperationErrorContext as i, OperationPermissionRequest as k, OperationResultMode as l, RouteOperation as m, RouteOperationApi as n, ClientPluginDefinition as q, ClientPluginRegistration as r, ResolvedClientPluginRuntime as s, Sitemap as t, PluginRoutes as u, ClientStackConfig as v, ResolvedClientStack as w, ClientApiConfig as x, ClientApiEndpointOverride as y, ClientLocation as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btst/stack",
-  "version": "5.0.0",
+  "version": "5.1.0",
   "description": "A composable, plugin-based library for building full-stack applications.",
   "repository": {
     "type": "git",

package/src/__tests__/cms-query-keys.test.ts

@@ -54,6 +54,63 @@ describe("cms query keys match SSG prefetch keys", () => {
 		]);
 	});
 
+	it("normalizes equivalent selections across read identities and preserves prefetch parity", () => {
+		const fields = ["title", "name.with.dot", "title"];
+		const keys = [
+			(selection?: readonly string[]) =>
+				queries.cmsContent.options({
+					typeSlug: "post",
+					view: "content",
+					fields: selection,
+				}).queryKey,
+			(selection?: readonly string[]) =>
+				queries.cmsContent.list({
+					typeSlug: "post",
+					view: "content",
+					fields: selection,
+				}).queryKey,
+			(selection?: readonly string[]) =>
+				queries.cmsContent.detail("post", "id", {
+					view: "content",
+					fields: selection,
+				}).queryKey,
+			(selection?: readonly string[]) =>
+				queries.cmsContent.bySlug("post", "slug", {
+					view: "content",
+					fields: selection,
+				}).queryKey,
+			(selection?: readonly string[]) =>
+				queries.cmsContent.byRelation({
+					typeSlug: "post",
+					field: "authorId",
+					targetId: "author",
+					view: "content",
+					fields: selection,
+				}).queryKey,
+			(selection?: readonly string[]) =>
+				queries.cmsTypes.inverseRelationItems({
+					slug: "author",
+					sourceType: "post",
+					itemId: "author",
+					fieldName: "authorId",
+					view: "content",
+					fields: selection,
+				}).queryKey,
+		];
+		for (const key of keys) {
+			expect(key(fields)).toEqual(key(["name.with.dot", "title"]));
+			expect(key(fields)).not.toEqual(key(["title"]));
+			expect(key(fields)).not.toEqual(key());
+		}
+		expect(fields).toEqual(["title", "name.with.dot", "title"]);
+		expect(keys[1]!(fields)).toEqual(
+			CMS_QUERY_KEYS.contentList({ typeSlug: "post", view: "content", fields }),
+		);
+		expect(keys[2]!(fields)).toEqual(
+			CMS_QUERY_KEYS.contentDetail("post", "id", { view: "content", fields }),
+		);
+	});
+
 	it("exposes the same _def prefixes as the previous factory", () => {
 		expect([...queries.cmsTypes._def]).toEqual(["cmsTypes"]);
 		expect([...queries.cmsTypes.list._def]).toEqual(["cmsTypes", "list"]);

package/src/plugins/api/index.ts

@@ -51,6 +51,7 @@ export {
 	type Operation,
 	type OperationAccess,
 	type OperationApi,
+	type OperationCallSignature,
 	type OperationContext,
 	type OperationData,
 	type OperationErrorContext,

package/src/plugins/api/operation.ts

@@ -201,6 +201,8 @@ export interface Operation<
 	readonly resultMode: TPassthroughResult extends true
 		? "passthrough"
 		: "immutable";
+	/** Type-only result marker, preserved when an operation has a specialized call signature. */
+	readonly "~result"?: TResult;
 }
 
 /** Any plugin operation, for generic stack composition. */
@@ -237,11 +239,22 @@ export type OperationPermissionRequest<TOperation extends AnyOperation> =
 export type OperationPermissionId<TOperation extends AnyOperation> =
 	OperationPermissionRequest<TOperation>["id"];
 
+/** Input-dependent callable typing; runtime execution still uses the operation definition. */
+export interface OperationCallSignature<
+	TCall extends (...args: any[]) => Promise<unknown>,
+> {
+	readonly "~call": TCall;
+}
+
 /** Convert operation definitions into their bound callable application API. */
 export type OperationApi<TOperations extends OperationRecord> = {
-	[TKey in keyof TOperations]: (
-		input: OperationInput<TOperations[TKey]>,
-	) => Promise<OperationTransportResult<TOperations[TKey]>>;
+	[TKey in keyof TOperations]: TOperations[TKey] extends OperationCallSignature<
+		infer TCall
+	>
+		? TCall
+		: (
+				input: OperationInput<TOperations[TKey]>,
+			) => Promise<OperationTransportResult<TOperations[TKey]>>;
 };
 
 /** One request-bound operation plus its endpoint-binding helper. */