@tailorkit/app 0.1.0-beta.35 → 0.1.0-beta.38

package/README.md

@@ -1,12 +1,10 @@
-# TailorKit App
+# TailorKit app SDK
 
-The SDK for building TailorKit extensions.
-
-Apps require Preact 11. Install `preact@^11` alongside the SDK.
+Use `@tailorkit/app` to build TailorKit extensions. Apps require Preact 11; install `preact@^11` alongside the SDK.
 
 ## File routing
 
-New apps register views from `src/slots` automatically. Only files ending in `.view.tsx` are views, so supporting components can live beside them.
+The builder registers views from `src/slots` automatically. Only files ending in `.view.tsx` register views, so supporting components can live beside them:
 
 ```text
 src/
@@ -22,10 +20,13 @@ src/
       customer-card.tsx
 ```
 
-The slot directory is its literal host slot name, including dots in names such as `panel.links`. Dots in a view filename separate route segments: `customers.details.view.tsx` registers `/customers/details`. Subdirectories also separate segments. `customer-card.tsx` is an ordinary component and is ignored unless imported. Duplicate view paths in a slot fail the build.
+The slot directory is its literal host slot name, including dots in names such as `panel.links`. Dots in a view filename separate route segments: `customers.details.view.tsx` registers `/customers/details`. Subdirectories also separate segments. `customer-card.tsx` is an ordinary component and is ignored unless imported.
+
+Duplicate view paths in a slot fail the build.
+
+For example, `src/slots/panel/customers.details.view.tsx` registers `/customers/details`:
 
 ```tsx
-// src/slots/panel/customers.details.view.tsx
 import { defineView } from "tailorkit/client";
 
 import CustomerCard from "./customer-card";
@@ -33,10 +34,9 @@ import CustomerCard from "./customer-card";
 export default defineView({ component: CustomerCard });
 ```
 
-The builder supplies the slot and route before compiling. An explicit `view` must match the file path and gives precise host context typing:
+The builder supplies the slot and route before compiling. In `src/slots/panel/index.view.tsx`, an explicit `view` gives typed host context and must match `/`:
 
 ```tsx
-// src/slots/panel/index.view.tsx
 import { defineView } from "tailorkit/client";
 
 const view = defineView({ view: "/", component: Home });
@@ -49,7 +49,11 @@ function Home() {
 export default view;
 ```
 
-`index.view.tsx` maps to `/`. A final `index` segment is omitted, so `customers/index.view.tsx` and `customers.index.view.tsx` both map to `/customers`. Other segments stay literal: `index.details.view.tsx` maps to `/index/details`. An explicit `view` or `slot` must be a matching string literal; mismatches fail the build. Use named properties in the inline `defineView` options so the build can check them. Multi-instance views provide `instances: { dataSchema, resolve }`; resolvers are extracted into the private server bundle. Host slot/view support and multiplicity are validated when publishing. An explicit slot also retains the source-level TypeScript checks for that slot's supported views and instances.
+`index.view.tsx` maps to `/`. A final `index` segment is omitted, so `customers/index.view.tsx` and `customers.index.view.tsx` both map to `/customers`. Other segments stay literal: `index.details.view.tsx` maps to `/index/details`.
+
+An explicit `view` or `slot` must be a matching string literal; mismatches fail the build. Use named properties in the inline `defineView` options so the build can check them.
+
+For multi-instance views, provide `instances: { dataSchema, resolve }`. The builder extracts resolvers into the private server bundle. Host slot/view support and multiplicity are validated when publishing. An explicit slot also retains the source-level TypeScript checks for that slot's supported views and instances.
 
 ## Roots and layouts
 
@@ -71,7 +75,11 @@ export default defineRoute({ shellComponent: Shell });
 
 Each slot can also have a `root.tsx` exporting `defineRoute({ shellComponent })`. It wraps every view in that slot, inside the app shell. A shell can render its `children` prop instead of `<Route />`.
 
-`layout.tsx` wraps its directory path: at the slot root it wraps the entire slot; `members/layout.tsx` wraps `/members` and its descendants. `customers.layout.tsx` wraps `/customers` and its descendants, with matching at segment boundaries. Unlike view paths, layout paths retain a final `index` segment: `index.layout.tsx` maps to `/index`, and `members/index.layout.tsx` maps to `/members/index`. Layouts do not register views themselves. A layout default-exports an ordinary component (or a `defineRoute({ shellComponent })` definition):
+`layout.tsx` wraps its directory path: at the slot root it wraps the entire slot; `members/layout.tsx` wraps `/members` and its descendants. `customers.layout.tsx` wraps `/customers` and its descendants, with matching at segment boundaries.
+
+Unlike view paths, layout paths retain a final `index` segment: `index.layout.tsx` maps to `/index`, and `members/index.layout.tsx` maps to `/members/index`. Layouts do not register views themselves.
+
+Export a component as the layout’s default export, or use a `defineRoute({ shellComponent })` definition:
 
 ```tsx
 import { Route } from "tailorkit/client";

package/dist/{chunk-PJBDA2RU.js → chunk-5B5RGL5W.js}

@@ -269,12 +269,7 @@ var createClient = (options = {}) => {
               },
               headers: { authorization: `Bearer ${session.token}` },
               origin: url.origin,
-              // SAFETY: URL.pathname always starts with a slash for this HTTP session URL, satisfying the transport's absolute route-path type.
-              url: (
-                /* oxlint-disable typescript/no-unsafe-type-assertion -- URL.pathname always starts with a slash for this HTTP session URL, satisfying the transport's absolute route-path type. */
-                url.pathname
-              )
-              /* oxlint-enable typescript/no-unsafe-type-assertion */
+              url: `/${url.pathname.slice(1)}`
             })
           );
           if (kind === "mutations") {
@@ -344,7 +339,7 @@ var createClient = (options = {}) => {
     query: async (ref, ...[args]) => await /* oxlint-disable typescript/no-unsafe-type-assertion -- The query reference owns its output type, and the server validates that registered query before the shared transport returns its erased result. */
     call("queries", { args, name: ref.name }),
     /* oxlint-enable typescript/no-unsafe-type-assertion */
-    subscribe: (ref, args, next, settings = {}) => {
+    subscribe: (ref, args, onValue, settings = {}) => {
       if (closed) {
         throw new AppError("UNAVAILABLE", "App client closed");
       }
@@ -365,7 +360,7 @@ var createClient = (options = {}) => {
               if (controller.signal.aborted || closed) {
                 break;
               }
-              next(
+              onValue(
                 /* oxlint-disable typescript/no-unsafe-type-assertion -- This subscription was opened with ref.name and args; its listener receives only results from that same registered query, whose output generic is erased by the transport. */
                 value
                 /* oxlint-enable typescript/no-unsafe-type-assertion */

package/dist/{chunk-2JZOHWYW.js → chunk-Q6X2VQKX.js}

@@ -1,7 +1,7 @@
 import {
   createClient,
   reference
-} from "./chunk-PJBDA2RU.js";
+} from "./chunk-5B5RGL5W.js";
 import {
   AppError,
   appError
@@ -194,11 +194,7 @@ var QueryStore = class {
           return;
         }
         publish({
-          data: (
-            /* oxlint-disable typescript/no-unsafe-type-assertion -- The entry is created and updated by this query reference's typed subscription; the shared cache erases its output generic. */
-            this.state.get().get(key)?.data
-          ),
-          /* oxlint-enable typescript/no-unsafe-type-assertion */
+          data: this.state.get().get(key)?.data,
           error,
           status: "error"
         });
@@ -404,10 +400,9 @@ var useCall = (kind, ref, options) => {
     (...args) => {
       void (async () => {
         try {
-          return await runAsync(...args);
+          await runAsync(...args);
         } catch {
         }
-        return void 0;
       })();
     },
     [runAsync]
@@ -480,7 +475,8 @@ var createFileClient = (options) => {
     ...layout,
     shell: shellComponent(layout, false)
   }));
-  const definitions = /* @__PURE__ */ Object.create(null);
+  const definitions = {};
+  Object.setPrototypeOf(definitions, null);
   for (const module of options.views) {
     const view = (
       /* oxlint-disable typescript/no-unsafe-type-assertion -- The generated module registry owns these component and view declarations; the runtime adapter preserves their exported implementations. */
@@ -513,7 +509,8 @@ var createFileClient = (options) => {
     }
     slot[view.path] = view;
   }
-  const slots = /* @__PURE__ */ Object.create(null);
+  const slots = {};
+  Object.setPrototypeOf(slots, null);
   for (const [slot, views] of Object.entries(definitions)) {
     const slotLayouts = layouts.filter((layout) => layout.slot === slot).toSorted(
       (a, b) => a.path.split("/").filter(Boolean).length - b.path.split("/").filter(Boolean).length

package/dist/client-connection.js

@@ -3,7 +3,7 @@ import {
   createSessionProvider,
   parseSession,
   reference
-} from "./chunk-PJBDA2RU.js";
+} from "./chunk-5B5RGL5W.js";
 import {
   AppError
 } from "./chunk-7ZQPXG7O.js";

package/dist/client.js

@@ -9,13 +9,13 @@ import {
   useAction,
   useMutation,
   useQuery
-} from "./chunk-2JZOHWYW.js";
+} from "./chunk-Q6X2VQKX.js";
 import {
   createApi,
   createClient,
   createSessionProvider,
   reference
-} from "./chunk-PJBDA2RU.js";
+} from "./chunk-5B5RGL5W.js";
 import {
   AppError,
   appError

package/dist/index.js

@@ -9,13 +9,13 @@ import {
   useAction,
   useMutation,
   useQuery
-} from "./chunk-2JZOHWYW.js";
+} from "./chunk-Q6X2VQKX.js";
 import {
   createApi,
   createClient,
   createSessionProvider,
   reference
-} from "./chunk-PJBDA2RU.js";
+} from "./chunk-5B5RGL5W.js";
 import {
   action,
   and,

package/dist/server/builder.d.ts

@@ -2,7 +2,7 @@ import type { AnyRelations, EmptyRelations } from "drizzle-orm/relations";
 import { z } from "zod";
 import type { DatabaseDefinition } from "#database/definition";
 import type { MutationDatabase, QueryDatabase } from "#database/types";
-import type { ActionContext, FunctionKind, Functions, Identity } from "./functions";
+import type { ActionContext, EmptyFunctions, FunctionKind, Functions, Identity } from "./functions";
 type HandlerContext<K extends FunctionKind, A extends z.ZodType, F extends Functions, D extends AnyRelations> = {
     input: z.output<A>;
 } & (K extends "action" ? ActionContext<F> : {
@@ -24,7 +24,7 @@ type BuiltFunction<K extends FunctionKind, A extends z.ZodType, R, O, F extends
     readonly functions: F;
 } : unknown);
 /** Immutable builders preserve the validated input and wire output types at every step. */
-declare class FunctionBuilder<K extends FunctionKind, A extends z.ZodType, R extends z.ZodType | undefined = undefined, F extends Functions = Record<never, never>, D extends AnyRelations = EmptyRelations> {
+declare class FunctionBuilder<K extends FunctionKind, A extends z.ZodType, R extends z.ZodType | undefined = undefined, F extends Functions = EmptyFunctions, D extends AnyRelations = EmptyRelations> {
     private readonly kind;
     private readonly args;
     private readonly result;

package/dist/server/functions.d.ts

@@ -3,6 +3,7 @@ import type { z } from "zod";
 import type { TailorKitServerTools } from "#client/tools";
 import type { DatabaseDefinition } from "#database/definition";
 import type { QueryDatabase, MutationDatabase } from "#database/types";
+export type EmptyFunctions = Record<never, never>;
 export interface Identity {
     readonly subjectId?: string;
     readonly scope: {
@@ -36,7 +37,7 @@ export type FunctionCalls<F, K extends "query" | "mutation"> = {
         requestId?: string;
     }]) => Promise<FunctionResult<F[N]>> : (...args: undefined extends z.input<A> ? [args?: z.input<A>] : [args: z.input<A>]) => Promise<FunctionResult<F[N]>> : F[N] extends Functions ? FunctionCalls<F[N], K> : never;
 };
-export interface ActionContext<F extends Functions = Record<never, never>> {
+export interface ActionContext<F extends Functions = EmptyFunctions> {
     readonly identity: Identity;
     readonly tools: TailorKitServerTools;
     readonly requestId: string;
@@ -45,7 +46,7 @@ export interface ActionContext<F extends Functions = Record<never, never>> {
     readonly queries: FunctionCalls<F, "query">;
     readonly mutations: FunctionCalls<F, "mutation">;
 }
-export interface FunctionDefinition<K extends FunctionKind, A extends z.ZodType, O, F extends Functions = Record<never, never>, D extends AnyRelations = EmptyRelations> {
+export interface FunctionDefinition<K extends FunctionKind, A extends z.ZodType, O, F extends Functions = EmptyFunctions, D extends AnyRelations = EmptyRelations> {
     readonly kind: K;
     readonly args: A;
     readonly database?: K extends "action" ? never : DatabaseDefinition<D>;
@@ -57,25 +58,25 @@ export interface FunctionDefinition<K extends FunctionKind, A extends z.ZodType,
         identity: Identity;
     })) => K extends "action" ? O | Promise<O> : O;
 }
-export declare const query: <A extends z.ZodType, O, const D extends AnyRelations = EmptyRelations>(definition: Omit<FunctionDefinition<"query", A, O, Record<never, never>, D>, "kind"> & {
-    handler: FunctionDefinition<"query", A, O, Record<never, never>, D>["handler"] & ([O] extends [never] ? unknown : O extends PromiseLike<unknown> ? never : unknown);
+export declare const query: <A extends z.ZodType, O, const D extends AnyRelations = EmptyRelations>(definition: Omit<FunctionDefinition<"query", A, O, EmptyFunctions, D>, "kind"> & {
+    handler: FunctionDefinition<"query", A, O, EmptyFunctions, D>["handler"] & ([O] extends [never] ? unknown : O extends PromiseLike<unknown> ? never : unknown);
 }) => Readonly<{
     args: A;
     database?: DatabaseDefinition<D> | undefined;
     result?: z.ZodType<O, unknown, z.core.$ZodTypeInternals<O, unknown>> | undefined;
-    handler: FunctionDefinition<"query", A, O, Record<never, never>, D>["handler"] & ([O] extends [never] ? unknown : O extends PromiseLike<unknown> ? never : unknown);
+    handler: FunctionDefinition<"query", A, O, EmptyFunctions, D>["handler"] & ([O] extends [never] ? unknown : O extends PromiseLike<unknown> ? never : unknown);
     kind: "query";
 }>;
-export declare const mutation: <A extends z.ZodType, O, const D extends AnyRelations = EmptyRelations>(definition: Omit<FunctionDefinition<"mutation", A, O, Record<never, never>, D>, "kind"> & {
-    handler: FunctionDefinition<"mutation", A, O, Record<never, never>, D>["handler"] & ([O] extends [never] ? unknown : O extends PromiseLike<unknown> ? never : unknown);
+export declare const mutation: <A extends z.ZodType, O, const D extends AnyRelations = EmptyRelations>(definition: Omit<FunctionDefinition<"mutation", A, O, EmptyFunctions, D>, "kind"> & {
+    handler: FunctionDefinition<"mutation", A, O, EmptyFunctions, D>["handler"] & ([O] extends [never] ? unknown : O extends PromiseLike<unknown> ? never : unknown);
 }) => Readonly<{
     args: A;
     database?: DatabaseDefinition<D> | undefined;
     result?: z.ZodType<O, unknown, z.core.$ZodTypeInternals<O, unknown>> | undefined;
-    handler: FunctionDefinition<"mutation", A, O, Record<never, never>, D>["handler"] & ([O] extends [never] ? unknown : O extends PromiseLike<unknown> ? never : unknown);
+    handler: FunctionDefinition<"mutation", A, O, EmptyFunctions, D>["handler"] & ([O] extends [never] ? unknown : O extends PromiseLike<unknown> ? never : unknown);
     kind: "mutation";
 }>;
-export declare const action: <A extends z.ZodType, O, const F extends Functions = Record<never, never>>(definition: Omit<FunctionDefinition<"action", A, O, F>, "kind"> & {
+export declare const action: <A extends z.ZodType, O, const F extends Functions = EmptyFunctions>(definition: Omit<FunctionDefinition<"action", A, O, F>, "kind"> & {
     functions?: F;
 }) => Readonly<{
     args: A;

package/dist/server.d.ts

@@ -4,7 +4,7 @@ export type { DatabaseDefinition } from "./database/definition";
 export { fn } from "./server/builder";
 export { withInstanceResolvers } from "./server/instances";
 export type { QueryDatabase, MutationDatabase } from "./database/types";
-export type { Identity, FunctionDefinition, AppDefinition, ActionContext, FunctionKind, } from "./server/functions";
+export type { EmptyFunctions, Identity, FunctionDefinition, AppDefinition, ActionContext, FunctionKind, } from "./server/functions";
 export { table, text, integer, real, boolean, eq, ne, gt, gte, lt, lte, and, or, asc, desc, count, isNull, isNotNull, inArray, } from "./database/schema";
 export { AppError } from "./errors";
 export type { ErrorCode } from "./errors";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tailorkit/app",
-  "version": "0.1.0-beta.35",
+  "version": "0.1.0-beta.38",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",