@tailorkit/app 0.1.0-beta.19 → 0.1.0-beta.20

package/README.md

@@ -94,7 +94,7 @@ Auth signing and verification use Effect v4. `issueAppTokenEffect`, `appTokenVer
 
 Add `server: {}` to `tailorkit.config.ts` to build the backend from `src/server.ts`. The client builds from `src/client.ts` by default. `client.entry` and `server.entry` override these source entry points while output filenames stay the same. `tailorkit build` emits `.tailorkit/client/client.js` and `.tailorkit/server/server.js`, and copies committed Drizzle migration files into `.tailorkit/migrations/`. Intermediate server entries are created under the output root’s `tmp/` directory and removed after builds or when the watcher closes; `server/` contains the upload artifact. The server exports the application definition and embedded migrations; Cloudflare bootstrap code belongs to the runtime worker. The builder writes no backend reference source files. The browser builder rejects server implementation imports. `build.outDir` and `--out-dir` change the common output root for all artifacts; preview serves only its `client/` directory.
 
-`tailorkit deploy` uploads the client and private server artifact through existing platform-issued blob upload URLs. Apps need no Cloudflare credentials. R2 stores them under separate `client/` and `server/` prefixes; only client assets are public. Client-only apps continue to build without a server artifact. Watch mode watches both builds.
+`tailorkit deploy` gzips the client and private server artifacts before uploading them through platform-issued blob upload URLs. Checksums and content lengths describe the compressed bytes stored in R2. The runtime verifies and decompresses server code before loading it; client delivery serves gzip to browsers that accept it. The platform checks that decoded client bundles fit within 3 MiB before publication, and decoded delivery streams enforce the same limit. Existing uncompressed deployments remain supported. Apps need no Cloudflare credentials. R2 stores them under separate `client/` and `server/` prefixes; only client assets are public. Client-only apps continue to build without a server artifact. Watch mode watches both builds.
 
 The legacy `app-storage` SDK, `storage` config and storage CLI commands have been removed. Use `server` config and this SDK. The host session endpoint `/backend/session` uses the existing host `authenticate` callback. The platform verifies scope access and resolves the installation and runtime URL automatically; no extra host backend configuration is required.
 

package/dist/builder.js

@@ -563,7 +563,7 @@ async function extractInstances(filename, source, root, includedNames) {
     if (statement.type !== "ImportDeclaration" || !clientImports.has(String(statement.source.value)))
       continue;
     for (const s of statement.specifiers) {
-      if (s.type === "ImportSpecifier" && s.imported.type === "Identifier" && s.imported.name === "createView")
+      if (s.type === "ImportSpecifier" && s.imported.type === "Identifier" && s.imported.name === "defineView")
         aliases.add(s.local.name);
     }
   }
@@ -571,7 +571,7 @@ async function extractInstances(filename, source, root, includedNames) {
   walk(program, (node, ancestors) => {
     if (node.type !== "CallExpression" || node.callee.type !== "Identifier" || !aliases.has(node.callee.name))
       return;
-    const options = node.arguments[1];
+    const options = node.arguments[0];
     if (options?.type !== "ObjectExpression") return;
     const instances = property(options, "instances");
     if (!instances) return;
@@ -579,10 +579,10 @@ async function extractInstances(filename, source, root, includedNames) {
       throw new Error(`${filename}: ${message}`);
     };
     if (ancestors.some(isFunction))
-      fail("createView with instances must be declared at module scope.");
+      fail("defineView with instances must be declared at module scope.");
     const owner = ancestors.findLast((n) => n.type === "VariableDeclarator");
     const viewName = owner?.type === "VariableDeclarator" && owner.id.type === "Identifier" ? owner.id.name : "default";
-    const view = node.arguments[0];
+    const view = property(options, "view")?.value;
     if (view?.type !== "Literal" || typeof view.value !== "string")
       fail("Instance view paths must be string literals.");
     if (instances.value.type !== "ObjectExpression")

package/dist/{chunk-43L6XVW6.js → chunk-RHCGWGSG.js}

@@ -7,7 +7,8 @@ import {
 import { createContext, h, render } from "preact";
 import { useContext } from "preact/hooks";
 var preactVersion = "10.29.8";
-var createView = (path, options) => {
+var defineView = (options) => {
+  const path = options.view;
   const Context2 = createContext(
     null
   );
@@ -33,6 +34,7 @@ var createView = (path, options) => {
   return {
     component: View,
     path,
+    slot: options.slot,
     ...instances?.resolver ? { instances: { resolver: instances.resolver } } : {},
     useContext: () => {
       const context = useContext(Context2);
@@ -51,14 +53,25 @@ var createView = (path, options) => {
     }
   };
 };
-var defineClient = (client) => ({
-  ...client,
-  $meta: { preactVersion },
-  $runtime: {
-    h,
-    render: (vnode, parent) => render(vnode && client.component ? h(client.component, { children: vnode }) : vnode, parent)
+var defineClient = (client) => {
+  for (const [slot, views] of Object.entries(client.slots)) {
+    for (const [path, view] of Object.entries(views ?? {})) {
+      if (view !== false && view.slot !== slot)
+        throw new Error(`View "${path}" was created for slot "${view.slot}", not "${slot}".`);
+    }
   }
-});
+  return {
+    ...client,
+    $meta: { preactVersion },
+    $runtime: {
+      h,
+      render: (vnode, parent) => render(
+        vnode && client.component ? h(client.component, { children: vnode }) : vnode,
+        parent
+      )
+    }
+  };
+};
 var componentTagPrefix = "tailorkit-";
 var toComponentTagName = (name) => `${componentTagPrefix}${name.replaceAll(/([a-z0-9])([A-Z])/gu, "$1-$2").replaceAll(/[\s_]+/gu, "-").toLowerCase()}`;
 var toCallbackEventName = (name) => `tailorkitcallback${name.replaceAll(/[^A-Za-z0-9_$]/gu, "").toLowerCase()}`;
@@ -618,7 +631,7 @@ function useAction(ref, options = {}) {
 }
 
 export {
-  createView,
+  defineView,
   defineClient,
   createRemoteComponent,
   createSessionProvider,

package/dist/client.js

@@ -4,13 +4,13 @@ import {
   createClient,
   createRemoteComponent,
   createSessionProvider,
-  createView,
   defineClient,
+  defineView,
   reference,
   useAction,
   useMutation,
   useQuery
-} from "./chunk-43L6XVW6.js";
+} from "./chunk-RHCGWGSG.js";
 import {
   AppError,
   appError
@@ -23,8 +23,8 @@ export {
   createClient,
   createRemoteComponent,
   createSessionProvider,
-  createView,
   defineClient,
+  defineView,
   reference,
   useAction,
   useMutation,

package/dist/index.js

@@ -4,13 +4,13 @@ import {
   createClient,
   createRemoteComponent,
   createSessionProvider,
-  createView,
   defineClient,
+  defineView,
   reference,
   useAction,
   useMutation,
   useQuery
-} from "./chunk-43L6XVW6.js";
+} from "./chunk-RHCGWGSG.js";
 import {
   action,
   and,
@@ -55,9 +55,9 @@ export {
   createClient,
   createRemoteComponent,
   createSessionProvider,
-  createView,
   defineClient,
   defineServer,
+  defineView,
   desc,
   eq,
   gt,

package/dist/views.d.ts

@@ -49,9 +49,10 @@ export type ViewRuntimeProps<TPath extends AppViewPath, TData = unknown> = {
     status: "error";
     instance?: never;
 };
-export interface ViewDefinition<TPath extends AppViewPath = AppViewPath, TData = unknown> {
+export interface ViewDefinition<TPath extends AppViewPath = AppViewPath, TData = unknown, TSlot extends SlotName = SlotName> {
     component: View<ViewRuntimeProps<TPath>>;
     path: TPath;
+    slot: TSlot;
     useContext: () => ViewContext<TPath>;
     /** The selected instance, with data inferred from instances.dataSchema. */
     useInstance: () => ViewInstance<TData>;
@@ -60,12 +61,6 @@ export interface ViewDefinition<TPath extends AppViewPath = AppViewPath, TData =
         resolver: string;
     };
 }
-type RegisteredViews = {
-    [TPath in AppViewPath]: ViewDefinition<TPath>;
-};
-type ViewDefinitions = Partial<{
-    [P in AppViewPath]: RegisteredViews[P] | false;
-}>;
 type InvalidViewPath<TViews> = Exclude<keyof TViews & string, AppViewPath>;
 type RequireViewPaths<TViews> = InvalidViewPath<TViews> extends never ? unknown : {
     readonly __tailorkit_error__: `View paths must be declared by the host. Invalid view: ${InvalidViewPath<TViews>}`;
@@ -74,11 +69,24 @@ type ViewKeyPathMismatch<TViews> = {
     [TPath in keyof TViews & string]: TViews[TPath] extends false ? never : TViews[TPath] extends ViewDefinition<infer TViewPath> ? TViewPath extends TPath ? never : TPath : TPath;
 }[keyof TViews & string];
 type RequireMatchingViewKeys<TViews> = ViewKeyPathMismatch<TViews> extends never ? unknown : {
-    readonly __tailorkit_error__: `View key must match createView path. Invalid view: ${ViewKeyPathMismatch<TViews>}`;
+    readonly __tailorkit_error__: `View key must match defineView path. Invalid view: ${ViewKeyPathMismatch<TViews>}`;
+};
+export type SlotView<TSlot extends SlotName> = TailorKitSlots[TSlot] extends {
+    views: infer TViews;
+} ? Extract<TViews, AppViewPath> : never;
+type SlotInstanceDefinition<TSlot extends SlotName> = TailorKitSlots[TSlot] extends {
+    multiple: true;
+} ? {
+    instances: {
+        resolver: string;
+    };
+} : {
+    instances?: never;
 };
-export type SlotView<TSlot extends SlotName> = Extract<TailorKitSlots[TSlot], AppViewPath>;
 type SlotDefinitions = {
-    [V in SlotName]?: Pick<ViewDefinitions, SlotView<V>>;
+    [V in SlotName]?: Partial<{
+        [P in SlotView<V>]: (ViewDefinition<P, unknown, V> & SlotInstanceDefinition<V>) | false;
+    }>;
 };
 type RequireSlotViews<V, S> = V extends SlotName ? Exclude<keyof S, SlotView<V>> extends never ? unknown : {
     readonly __tailorkit_error__: "View is not supported by this slot";
@@ -101,10 +109,22 @@ export type TailorKitClientWithMeta<TViews extends SlotDefinitions = SlotDefinit
     $meta: TailorKitClientMeta;
     $runtime: TailorKitClientRuntime;
 };
-export declare const createView: <const TPath extends AppViewPath, TSchema extends z.ZodType>(path: TPath, options: {
-    component: View<Record<string, never>>;
-    instances?: ViewInstances<TPath, TSchema>;
-}) => ViewDefinition<TPath, z.output<TSchema>>;
+type ViewOptions<TPath extends AppViewPath, TSlot extends SlotName, TSchema extends z.ZodType> = {
+    [S in TSlot]: {
+        slot: S;
+        view: TPath;
+        component: View<Record<string, never>>;
+    } & (TPath extends SlotView<S> ? unknown : {
+        readonly __tailorkit_error__: "View is not supported by this slot";
+    }) & (TailorKitSlots[S] extends {
+        multiple: true;
+    } ? {
+        instances: ViewInstances<TPath, TSchema>;
+    } : {
+        instances?: never;
+    });
+}[TSlot];
+export declare const defineView: <const TPath extends AppViewPath, const TSlot extends SlotName, TSchema extends z.ZodType>(options: ViewOptions<TPath, TSlot, TSchema>) => ViewDefinition<TPath, z.output<TSchema>, TSlot> & SlotInstanceDefinition<TSlot>;
 export declare const defineClient: <const TSlots extends SlotDefinitions>(client: TailorKitClient<TSlots> & {
     slots: { [V in keyof TSlots]: TSlots[V] & RequireViewPaths<TSlots[V]> & RequireMatchingViewKeys<TSlots[V]> & RequireSlotViews<V, TSlots[V]>; };
 } & (Exclude<keyof TSlots, SlotName> extends never ? unknown : {

package/package.json

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