@hitch42/applet 0.1.1-beta.18 → 0.1.1-beta.20

package/dist/applet.js

@@ -99,23 +99,23 @@ async function main() {
 	const noLogFlags = values.run === void 0 && values.filter === void 0 && values.level === void 0 && values.limit === void 0 && values.live === void 0 && values.search === void 0 && values.since === void 0;
 	const noModeFlags = values["client-only"] === void 0 && values["server-only"] === void 0;
 	if (positionals.length === 1 && positionals[0] === "bootstrap" && noModeFlags && noGitFlags && noVariableFlags && noLogFlags) {
-		await (await import("./init-DT0faD-q.js")).runBootstrap({ install: values["no-install"] !== true });
+		await (await import("./init-BKUBf6i9.js")).runBootstrap({ install: values["no-install"] !== true });
 		return;
 	}
 	if (positionals.length === 1 && positionals[0] === "generate" && values["no-install"] === void 0 && noModeFlags && noGitFlags && noVariableFlags && noLogFlags) {
-		await (await import("./generate-Df29-UJm.js")).runGenerate();
+		await (await import("./generate-COCRy1Bs.js")).runGenerate();
 		return;
 	}
 	if (positionals.length === 1 && positionals[0] === "build" && values["no-install"] === void 0 && noModeFlags && noGitFlags && noVariableFlags && noLogFlags) {
-		await (await import("./build-DpkWOvd2.js")).runBuild();
+		await (await import("./build-JtbY8q2p.js")).runBuild();
 		return;
 	}
 	if (positionals.length === 1 && positionals[0] === "deploy" && values["no-install"] === void 0 && noModeFlags && noGitFlags && noVariableFlags && noLogFlags) {
-		await (await import("./deploy-DODTE8ri.js")).runDeploy({});
+		await (await import("./deploy-BbqyK5Ik.js")).runDeploy({});
 		return;
 	}
 	if (positionals.length === 2 && positionals[0] === "init" && noModeFlags && noVariableFlags && noLogFlags) {
-		await (await import("./init-DT0faD-q.js")).runInit(positionals[1], {
+		await (await import("./init-BKUBf6i9.js")).runInit(positionals[1], {
 			commit: values["no-commit"] !== true,
 			git: values["no-git"] !== true,
 			install: values["no-install"] !== true
@@ -123,7 +123,7 @@ async function main() {
 		return;
 	}
 	if (positionals.length === 2 && positionals[0] === "new" && noGitFlags && noVariableFlags && noLogFlags) {
-		await (await import("./init-DT0faD-q.js")).runNew({
+		await (await import("./init-BKUBf6i9.js")).runNew({
 			code: positionals[1],
 			clientOnly: values["client-only"],
 			install: values["no-install"] !== true,
@@ -132,7 +132,7 @@ async function main() {
 		return;
 	}
 	if ((positionals.length === 1 || positionals.length === 2) && positionals[0] === "logs" && values["no-install"] === void 0 && noModeFlags && noGitFlags && noVariableFlags) {
-		await (await import("./logs-CEIikWzV.js")).runLogs({
+		await (await import("./logs-Cv5z1e2w.js")).runLogs({
 			code: positionals[1],
 			filter: values.filter,
 			run: values.run,
@@ -145,14 +145,14 @@ async function main() {
 		return;
 	}
 	if (positionals.length === 3 && positionals[0] === "schedules" && positionals[1] === "run" && values["no-install"] === void 0 && noModeFlags && noGitFlags && noLogFlags && values.secret === void 0) {
-		await (await import("./schedules-B7xNl9oy.js")).runSchedule({
+		await (await import("./schedules-Dajgni_z.js")).runSchedule({
 			code: positionals[2],
 			yes: values.yes
 		});
 		return;
 	}
 	if ((positionals.length === 3 || positionals.length === 4) && positionals[0] === "variables" && positionals[1] === "set" && values["no-install"] === void 0 && noModeFlags && noGitFlags && noLogFlags) {
-		await (await import("./variables-DCbLJBr0.js")).runVariablesSet({
+		await (await import("./variables-B-CLu8cY.js")).runVariablesSet({
 			key: positionals[2],
 			secret: values.secret,
 			value: positionals[3],
@@ -161,11 +161,11 @@ async function main() {
 		return;
 	}
 	if (positionals.length === 2 && positionals[0] === "variables" && positionals[1] === "list" && values["no-install"] === void 0 && noModeFlags && noGitFlags && noVariableFlags && noLogFlags) {
-		await (await import("./variables-DCbLJBr0.js")).runVariablesList();
+		await (await import("./variables-B-CLu8cY.js")).runVariablesList();
 		return;
 	}
 	if (positionals.length === 3 && positionals[0] === "variables" && positionals[1] === "delete" && values["no-install"] === void 0 && noModeFlags && noGitFlags && values.secret === void 0 && noLogFlags) {
-		await (await import("./variables-DCbLJBr0.js")).runVariablesDelete({
+		await (await import("./variables-B-CLu8cY.js")).runVariablesDelete({
 			key: positionals[2],
 			yes: values.yes
 		});

package/dist/{build-DkKTiIu7.js → build-D47vK5aa.js}

@@ -1,4 +1,4 @@
-import { i as prepareAppletProjects, r as prepareAppletProject } from "./project-CWVwic2C.js";
+import { i as prepareAppletProjects, r as prepareAppletProject } from "./project-CrxdZR0B.js";
 import { rm } from "node:fs/promises";
 import { resolve } from "node:path";
 import { spawn } from "node:child_process";

package/dist/build-JtbY8q2p.js

@@ -0,0 +1,2 @@
+import { i as runBuild } from "./build-D47vK5aa.js";
+export { runBuild };

package/dist/{ci-B5-mH-YW.js → ci-BTFTCBgy.js}

@@ -1,4 +1,5 @@
 import { c as resolveInstanceUrl } from "./store-B8N_8JIN.js";
+import { a as userAgent } from "./project-CrxdZR0B.js";
 //#region src/ci.ts
 function githubActionsContext() {
 	const env = process.env;
@@ -38,9 +39,13 @@ async function fetchWithGitHubActions(context, request) {
 async function loadGitHubActionsBuildInputs(context, requiresChangeset) {
 	const fetcher = globalThis.fetch;
 	const query = requiresChangeset === void 0 ? "" : `?changeset_id=${encodeURIComponent(requiresChangeset)}`;
+	const agent = await userAgent();
 	const response = await fetchWithGitHubActions(context, (instanceUrl, accessToken) => fetcher(`${instanceUrl}/api/ci/v1/build-inputs${query}`, {
 		method: "POST",
-		headers: { Authorization: `Bearer ${accessToken}` }
+		headers: {
+			Authorization: `Bearer ${accessToken}`,
+			"User-Agent": agent
+		}
 	}));
 	if (!response.ok) throw await hitchResponseError(response, "Failed to load the CI build inputs");
 	const body = await response.json();

package/dist/client/hitch/client.d.ts

@@ -1,2 +1,2 @@
-import { t as hitch } from "../../hitch-client--qZVa2KM.js";
+import { t as hitch } from "../../hitch-client-DtyTZzP5.js";
 export { hitch };

package/dist/client/hitch.d.ts

@@ -1,3 +1,3 @@
-import { t as hitch } from "../hitch-client--qZVa2KM.js";
+import { t as hitch } from "../hitch-client-DtyTZzP5.js";
 import { i as createPhone, n as Phone, r as PhoneState, t as usePhone } from "../use-phone-M7c_HsB7.js";
 export { type Phone, type PhoneState, createPhone, hitch, usePhone };

package/dist/create-C2UrZYSK.d.ts

@@ -0,0 +1,72 @@
+import { AnyContractRouter } from "@orpc/contract";
+import { ClientPromiseResult } from "@orpc/client";
+//#region src/hitch/batch.d.ts
+type BatchVerb = "create" | "update" | "delete" | "updateWhere";
+type BatchTxRecords<Records> = { [Code in keyof Records]: { [Verb in keyof Records[Code] & BatchVerb]: Records[Code][Verb] extends ((...args: infer Args) => unknown) ? (input: Verb extends "create" ? Args[0] extends {
+  body: infer Body;
+} ? Omit<Args[0], "body"> & {
+  body: Exclude<Body, readonly unknown[]>;
+} : Args[0] : Args[0]) => void : never; }; };
+type BatchTx<T> = T extends {
+  records: infer Records;
+} ? BatchTxRecords<Records> : never;
+type BatchRecorderOptions = {
+  dryRun?: boolean;
+  idempotencyKey?: string;
+};
+type BatchRecorderCall<T, Batch> = Batch extends ((...args: infer _Args) => infer Result) ? (record: (tx: BatchTx<T>) => void | Promise<void>, options?: BatchRecorderOptions) => Result : never;
+type WithBatchRecorder<T> = T extends {
+  records: unknown;
+  batch: infer Batch;
+} ? Omit<T, "batch"> & {
+  /**
+   * Record record writes inside `record` and send them as one atomic batch.
+   *
+   * The callback receives a `tx` whose `create` / `update` / `updateWhere` /
+   * `delete` calls are buffered, not sent immediately; the whole batch runs
+   * in a single transaction when the callback resolves.
+   *
+   * @remarks A batch may contain at most **100** requests. More than that is
+   * rejected with a `400` before any write runs.
+   */
+  batch: BatchRecorderCall<T, Batch> & Batch;
+} : T;
+//#endregion
+//#region src/hitch/create.d.ts
+type Many<T> = Extract<T, readonly unknown[]>;
+type One<T> = Exclude<T, readonly unknown[]>;
+type SplitCreate<F> = F extends ((input: infer Input extends {
+  body: unknown;
+}, ...rest: infer Rest) => ClientPromiseResult<infer Output, infer TError>) ? [Many<Input["body"]>] extends [never] ? F : {
+  (input: Omit<Input, "body"> & {
+    body: Many<Input["body"]>;
+  }, ...rest: Rest): ClientPromiseResult<Many<Output>, TError>;
+  (input: Omit<Input, "body"> & {
+    body: One<Input["body"]>;
+  }, ...rest: Rest): ClientPromiseResult<One<Output>, TError>;
+} : F extends {
+  call: infer Call;
+} ? Omit<F, "call"> & {
+  call: SplitCreate<Call>;
+} : F;
+type WithRecordCreates<T> = T extends {
+  records: infer Records;
+} ? Omit<T, "records"> & {
+  records: { [Code in keyof Records]: { [Verb in keyof Records[Code]]: Verb extends "create" ? SplitCreate<Records[Code][Verb]> : Records[Code][Verb]; }; };
+} : T;
+type WithSingleRecordCreates<T> = T extends {
+  records: infer Records;
+} ? Omit<T, "records"> & {
+  records: { [Code in keyof Records]: { [Verb in keyof Records[Code]]: Verb extends "create" ? SplitCreate<Records[Code][Verb]> extends ((...args: infer Args) => infer Result) ? (...args: Args) => Result : Records[Code][Verb] : Records[Code][Verb]; }; };
+} : T;
+type WithRecordCreateCalls<Utils, Client> = Utils extends {
+  records: infer Records;
+} ? Client extends {
+  records: infer Clients;
+} ? Omit<Utils, "records"> & {
+  records: { [Code in keyof Records]: { [Verb in keyof Records[Code]]: Verb extends "create" ? Code extends keyof Clients ? Verb extends keyof Clients[Code] ? Omit<Records[Code][Verb], "call"> & {
+    call: SplitCreate<Clients[Code][Verb]>;
+  } : Records[Code][Verb] : Records[Code][Verb] : Records[Code][Verb]; }; };
+} : Utils : Utils;
+//#endregion
+export { WithBatchRecorder as i, WithRecordCreates as n, WithSingleRecordCreates as r, WithRecordCreateCalls as t };

package/dist/{deploy-DODTE8ri.js → deploy-BbqyK5Ik.js}

@@ -1,7 +1,7 @@
 import { n as readWorkspaceConfig } from "./workspace-8yqXsvce.js";
 import { t as fetchWithOrgAuth } from "./auth-D3CrCtZq.js";
-import { a as loadGitHubActionsSources, n as githubActionsContext, r as hitchResponseError, t as fetchWithGitHubActions } from "./ci-B5-mH-YW.js";
-import { n as buildPreparedApplet, r as prepareWorkspaceBuild, t as buildApplet } from "./build-DkKTiIu7.js";
+import { a as loadGitHubActionsSources, n as githubActionsContext, r as hitchResponseError, t as fetchWithGitHubActions } from "./ci-BTFTCBgy.js";
+import { n as buildPreparedApplet, r as prepareWorkspaceBuild, t as buildApplet } from "./build-D47vK5aa.js";
 import { createRequire } from "node:module";
 import { createHash } from "node:crypto";
 import { existsSync } from "node:fs";

package/dist/{generate-8yyxKRSz.js → generate-BLD0DoCk.js}

@@ -1,8 +1,8 @@
 import { a as organizationInstanceUrl, c as resolveInstanceUrl } from "./store-B8N_8JIN.js";
 import { t as fetchWithOrgAuth } from "./auth-D3CrCtZq.js";
-import { t as loadAppletConfig } from "./load-config-BYrBjPlr.js";
-import { i as loadGitHubActionsBuildInputs, n as githubActionsContext } from "./ci-B5-mH-YW.js";
-import { r as prepareAppletProject } from "./project-CWVwic2C.js";
+import { t as loadAppletConfig } from "./load-config-DGALUExv.js";
+import { a as userAgent, r as prepareAppletProject } from "./project-CrxdZR0B.js";
+import { i as loadGitHubActionsBuildInputs, n as githubActionsContext, r as hitchResponseError } from "./ci-BTFTCBgy.js";
 import { createRequire } from "node:module";
 import { isContractProcedure, minifyContractRouter } from "@orpc/contract";
 import { randomUUID } from "node:crypto";
@@ -58,6 +58,20 @@ export default createWorkerEntry(server, { code: ${JSON.stringify(appletCode)} }
 `);
 }
 //#endregion
+//#region src/typegen/create-schema.ts
+function isObject$3(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isComponentRef(value) {
+	return isObject$3(value) && typeof value.$ref === "string" && /^#\/components\/schemas\/[^/]+$/.test(value.$ref);
+}
+function singleCreateSchema(value) {
+	if (isComponentRef(value)) return value;
+	if (!isObject$3(value) || !Array.isArray(value.oneOf) || value.oneOf.length !== 2) return void 0;
+	const [single, array] = value.oneOf;
+	return isComponentRef(single) && isObject$3(array) && array.type === "array" && isComponentRef(array.items) && array.items.$ref === single.$ref ? single : void 0;
+}
+//#endregion
 //#region src/typegen/operations.ts
 const RECORD_ROUTE = /^\/v1\/([^/]+)(?:\/(\{id\}(?:\/history)?|query|update|aggregate))?$/;
 const COMPONENT_REF_PREFIX$1 = "#/components/schemas/";
@@ -195,9 +209,15 @@ function prepareRecordSpec(spec, manifest) {
 				const content = isObject$2(response?.content) ? response.content : void 0;
 				const mediaType = isObject$2(content?.["application/json"]) ? content["application/json"] : void 0;
 				const schema = isObject$2(mediaType) ? mediaType.schema : void 0;
-				const ref = isObject$2(schema) ? schema.$ref : void 0;
+				const ref = record.verb === "create" ? singleCreateSchema(schema)?.$ref : isObject$2(schema) ? schema.$ref : void 0;
 				if (typeof ref !== "string" || !ref.startsWith(COMPONENT_REF_PREFIX$1) || ref.slice(21).length === 0 || ref.slice(21).includes("/")) throw new Error(`object "${record.objectCode}": paths.${path}.${method}.responses.${status}.content.application/json.schema expected a component schema $ref, found ${describeValue$1(schema, true)}`);
 			}
+			if (record.verb === "create") {
+				const request = isObject$2(operation.requestBody) ? operation.requestBody : void 0;
+				const content = isObject$2(request?.content) ? request.content : void 0;
+				const body = isObject$2(content?.["application/json"]) ? content["application/json"] : void 0;
+				if (singleCreateSchema(body?.schema) === void 0) throw new Error(`object "${record.objectCode}": paths.${path}.${method}.requestBody.content.application/json.schema expected a component schema $ref or single/array oneOf, found ${describeValue$1(body?.schema, true)}`);
+			}
 			const prepared = withRecordOperationId(path, method, operation);
 			return prepared ? [[method, prepared]] : [];
 		});
@@ -262,7 +282,7 @@ function describeValue(value, objectDescription = "an object") {
 	return `${typeof value} ${JSON.stringify(value)}`;
 }
 function componentName(value, path, objectCode) {
-	const ref = isObject$1(value) ? value.$ref : void 0;
+	const ref = singleCreateSchema(value)?.$ref;
 	if (typeof ref !== "string" || !ref.startsWith(COMPONENT_REF_PREFIX)) throw new Error(`object "${objectCode}": ${path} expected a component schema $ref, found ${describeValue(value, "an object without a $ref")}`);
 	const name = ref.slice(21);
 	if (name.length === 0 || name.includes("/")) throw new Error(`object "${objectCode}": ${path} expected a direct component schema $ref, found ${JSON.stringify(ref)}`);
@@ -427,8 +447,12 @@ async function responseJson(response) {
 async function loadAuthenticatedSpec(manifest) {
 	const github = githubActionsContext();
 	if (github !== void 0) return (await loadGitHubActionsBuildInputs(github, manifest.requiresChangeset)).openapi;
-	const response = await fetchWithOrgAuth(manifest.org, (instanceUrl, accessToken) => globalThis.fetch(`${instanceUrl}/api/v1/openapi.json${manifest.requiresChangeset === void 0 ? "" : `?changeset_id=${encodeURIComponent(manifest.requiresChangeset)}`}`, { headers: { Authorization: `Bearer ${accessToken}` } }));
-	if (!response.ok) throw new Error(`Failed to load the organization's OpenAPI spec (${response.status}).`);
+	const agent = await userAgent();
+	const response = await fetchWithOrgAuth(manifest.org, (instanceUrl, accessToken) => globalThis.fetch(`${instanceUrl}/api/v1/openapi.json${manifest.requiresChangeset === void 0 ? "" : `?changeset_id=${encodeURIComponent(manifest.requiresChangeset)}`}`, { headers: {
+		Authorization: `Bearer ${accessToken}`,
+		"User-Agent": agent
+	} }));
+	if (!response.ok) throw await hitchResponseError(response, "Failed to load the organization's OpenAPI spec");
 	return responseJson(response);
 }
 async function loadThemeStylesheet(orgCode) {

package/dist/generate-COCRy1Bs.js

@@ -0,0 +1,2 @@
+import { r as runGenerate } from "./generate-BLD0DoCk.js";
+export { runGenerate };

package/dist/{hitch-client--qZVa2KM.d.ts → hitch-client-DtyTZzP5.d.ts}

@@ -1,15 +1,16 @@
 import { l as RegisteredContract, u as RegisteredManifest } from "./manifest-BBHD_EY9.js";
 import { t as NarrowContract } from "./contract-CJv-n1l3.js";
-import { t as WithBatchRecorder } from "./batch-Qa4B4-Yp.js";
+import { i as WithBatchRecorder, n as WithRecordCreates, r as WithSingleRecordCreates, t as WithRecordCreateCalls } from "./create-C2UrZYSK.js";
 import { o as WithFilesUpload } from "./upload-D_kkmne_.js";
 import { t as ExactRouterUtils } from "./query-utils-zz9pVjgp.js";
 import { ContractRouterClient } from "@orpc/contract";
 //#region src/author/hitch-client.d.ts
 type AuthorContract = NarrowContract<RegisteredContract, RegisteredManifest>;
 type BaseHitchClient = ContractRouterClient<AuthorContract>;
-type AuthorHitchClient = WithBatchRecorder<BaseHitchClient>;
-type BaseHitchUtils = ExactRouterUtils<BaseHitchClient>;
-type AuthorHitchUtils = AuthorHitchClient extends {
+type AuthorHitchClient = WithRecordCreates<WithBatchRecorder<BaseHitchClient>>;
+type BaseHitchUtils = ExactRouterUtils<WithSingleRecordCreates<BaseHitchClient>>;
+type AuthorHitchUtils = WithRecordCreateCalls<BatchHitchUtils, BaseHitchClient>;
+type BatchHitchUtils = AuthorHitchClient extends {
   batch: infer Batch;
 } ? BaseHitchUtils extends {
   batch: infer BatchUtils;

package/dist/{init-DT0faD-q.js → init-BKUBf6i9.js}

@@ -1,8 +1,8 @@
 import { c as resolveInstanceUrl, s as resolveAuthForOrg } from "./store-B8N_8JIN.js";
 import { n as readWorkspaceConfig } from "./workspace-8yqXsvce.js";
-import { r as runGenerate } from "./generate-8yyxKRSz.js";
-import { n as loadAppletSourceDefinition, o as APPLET_CODE_PATTERN, s as ORG_CODE_PATTERN } from "./load-config-BYrBjPlr.js";
-import { a as writeAppletSupport, n as loadCliManifest, o as writeWorkspaceSupport, t as assertWorkspaceCli } from "./project-CWVwic2C.js";
+import { r as runGenerate } from "./generate-BLD0DoCk.js";
+import { c as ORG_CODE_PATTERN, n as loadAppletSourceDefinition, s as APPLET_CODE_PATTERN } from "./load-config-DGALUExv.js";
+import { n as loadCliManifest, o as writeAppletSupport, s as writeWorkspaceSupport, t as assertWorkspaceCli } from "./project-CrxdZR0B.js";
 import { access, cp, mkdir, readdir, writeFile } from "node:fs/promises";
 import { relative, resolve } from "node:path";
 import { spawn } from "node:child_process";

package/dist/{load-config-BYrBjPlr.js → load-config-DGALUExv.js}

@@ -135,6 +135,9 @@ z.strictObject({
 	variables: appletManifestShape.variables,
 	objects: appletManifestShape.objects
 }).superRefine(checkDuplicateCodes).superRefine(checkPublicFields);
+function appletMountPath({ code, public: isPublic }) {
+	return isPublic ? `pages/${code}` : code;
+}
 const packageVersionsSchema = z.record(z.string().min(1), z.string().min(1)).readonly();
 const RESERVED_APPLET_PACKAGES = /* @__PURE__ */ new Set([
 	"@fontsource-variable/geist-mono",
@@ -247,4 +250,4 @@ async function loadAppletConfig(root) {
 	};
 }
 //#endregion
-export { appletSourceDefinitionSchema as a, appletManifestSchema as i, loadAppletSourceDefinition as n, APPLET_CODE_PATTERN as o, resolveWorkspaceOrg as r, ORG_CODE_PATTERN as s, loadAppletConfig as t };
+export { appletMountPath as a, ORG_CODE_PATTERN as c, appletManifestSchema as i, loadAppletSourceDefinition as n, appletSourceDefinitionSchema as o, resolveWorkspaceOrg as r, APPLET_CODE_PATTERN as s, loadAppletConfig as t };

package/dist/{logs-CEIikWzV.js → logs-Cv5z1e2w.js}

@@ -1,6 +1,6 @@
 import { n as readWorkspaceConfig } from "./workspace-8yqXsvce.js";
 import { t as fetchWithOrgAuth } from "./auth-D3CrCtZq.js";
-import { o as APPLET_CODE_PATTERN, r as resolveWorkspaceOrg, t as loadAppletConfig } from "./load-config-BYrBjPlr.js";
+import { r as resolveWorkspaceOrg, s as APPLET_CODE_PATTERN, t as loadAppletConfig } from "./load-config-DGALUExv.js";
 import { z } from "zod";
 //#region src/logs.ts
 const LOG_LEVELS = [

package/dist/{project-CWVwic2C.js → project-CrxdZR0B.js}

@@ -1,6 +1,6 @@
 import { a as organizationInstanceUrl, n as DEFAULT_INSTANCE_URL } from "./store-B8N_8JIN.js";
 import { n as readWorkspaceConfig } from "./workspace-8yqXsvce.js";
-import { n as loadAppletSourceDefinition } from "./load-config-BYrBjPlr.js";
+import { a as appletMountPath, n as loadAppletSourceDefinition } from "./load-config-DGALUExv.js";
 import { z } from "zod";
 import { existsSync } from "node:fs";
 import { cp, mkdir, readFile, readdir, rm, symlink, writeFile } from "node:fs/promises";
@@ -115,19 +115,26 @@ const cliManifestSchema = z.object({
 		typescript: cliManifestValueSchema
 	})
 });
-async function loadCliManifest(options) {
+async function loadPackageManifest() {
 	const result = cliManifestSchema.safeParse(JSON.parse(await readFile(new URL("../package.json", import.meta.url), "utf8")));
 	if (!result.success) {
 		const issue = result.error.issues.at(0);
 		if (issue === void 0) throw new Error("Invalid CLI package manifest.");
 		throw new Error(`Invalid CLI package manifest field "${issue.path.join(".")}": ${issue.message}.`);
 	}
-	const catalogEntry = [...Object.entries(result.data.dependencies).map(([name, value]) => [`dependencies.${name}`, value]), ...Object.entries(result.data.peerDependencies).map(([name, value]) => [`peerDependencies.${name}`, value])].find(([, value]) => value.startsWith("catalog:"));
+	return result.data;
+}
+async function userAgent() {
+	return `hitch-applet-sdk/${(await loadPackageManifest()).version}`;
+}
+async function loadCliManifest(options) {
+	const cli = await loadPackageManifest();
+	const catalogEntry = [...Object.entries(cli.dependencies).map(([name, value]) => [`dependencies.${name}`, value]), ...Object.entries(cli.peerDependencies).map(([name, value]) => [`peerDependencies.${name}`, value])].find(([, value]) => value.startsWith("catalog:"));
 	if (catalogEntry !== void 0) {
 		if (options?.allowDevelopment === true) return void 0;
 		throw new Error(`Invalid CLI package manifest field "${catalogEntry[0]}": "catalog:" identifies an unpublished development build. Run the published @hitch42/applet CLI instead.`);
 	}
-	return result.data;
+	return cli;
 }
 function assertWorkspaceCli(config, cli) {
 	const runningCli = `${cli.name}@${cli.version}`;
@@ -497,7 +504,7 @@ export default defineConfig({
 				children: [{
 					type: "physical",
 					directory: ".",
-					pathPrefix: definition.code
+					pathPrefix: appletMountPath(definition)
 				}]
 			}
 		}, null, 2)}\n`) : rm(resolve(root, "tsr.config.json"), { force: true }),
@@ -562,4 +569,4 @@ async function prepareAppletProject(appletRoot = process.cwd()) {
 	return workspaceRoot;
 }
 //#endregion
-export { writeAppletSupport as a, prepareAppletProjects as i, loadCliManifest as n, writeWorkspaceSupport as o, prepareAppletProject as r, assertWorkspaceCli as t };
+export { userAgent as a, prepareAppletProjects as i, loadCliManifest as n, writeAppletSupport as o, prepareAppletProject as r, writeWorkspaceSupport as s, assertWorkspaceCli as t };

package/dist/{schedules-B7xNl9oy.js → schedules-Dajgni_z.js}

@@ -1,4 +1,4 @@
-import { t as loadAppletConfig } from "./load-config-BYrBjPlr.js";
+import { t as loadAppletConfig } from "./load-config-DGALUExv.js";
 import { t as question } from "./prompt-ChS-grYO.js";
 import { RPCLink } from "@orpc/client/fetch";
 import { readFile } from "node:fs/promises";

package/dist/server.d.ts

@@ -1,7 +1,7 @@
 import { a as createWorkflow, i as WorkflowStep, n as WorkflowDefinition, r as WorkflowDuration } from "./workflow-DurM6Fwx.js";
 import { l as RegisteredContract, m as RegisteredWorkflows, p as RegisteredVariables, u as RegisteredManifest } from "./manifest-BBHD_EY9.js";
 import { t as NarrowContract } from "./contract-CJv-n1l3.js";
-import { t as WithBatchRecorder } from "./batch-Qa4B4-Yp.js";
+import { i as WithBatchRecorder, n as WithRecordCreates } from "./create-C2UrZYSK.js";
 import { o as WithFilesUpload } from "./upload-D_kkmne_.js";
 import { ContractRouterClient } from "@orpc/contract";
 //#region src/server/workflows-client.d.ts
@@ -43,7 +43,7 @@ declare const log: {
 //#endregion
 //#region src/author/server.d.ts
 type AuthorContract = NarrowContract<RegisteredContract, RegisteredManifest>;
-type AuthorHitchClient = WithBatchRecorder<ContractRouterClient<AuthorContract>>;
+type AuthorHitchClient = WithRecordCreates<WithBatchRecorder<ContractRouterClient<AuthorContract>>>;
 type AuthorHitch = WithFilesUpload<AuthorHitchClient> & (RegisteredManifest extends {
   public: true;
 } ? {} : {

package/dist/{variables-DCbLJBr0.js → variables-B-CLu8cY.js}

@@ -1,5 +1,5 @@
 import { t as fetchWithOrgAuth } from "./auth-D3CrCtZq.js";
-import { t as loadAppletConfig } from "./load-config-BYrBjPlr.js";
+import { t as loadAppletConfig } from "./load-config-DGALUExv.js";
 import { t as question } from "./prompt-ChS-grYO.js";
 import { z } from "zod";
 //#region src/variables.ts

package/dist/vite.js

@@ -3,8 +3,8 @@ import { a as openQueryCacheDatabase } from "./query-cache-CXmAyLv3.js";
 import { d as HITCH_SESSION_HEADER, f as HITCH_USER_HEADER } from "./headers-CeRX-Xji.js";
 import { a as workflowOutcomeSchema, n as runWorkflowJournal } from "./workflow-engine-BOTzURKM.js";
 import { a as organizationInstanceUrl, c as resolveInstanceUrl, o as rejectEnvironmentKey, r as bearerToken, s as resolveAuthForOrg } from "./store-B8N_8JIN.js";
-import { a as writeRegisterDeclaration, c as writeAppletRoot, d as writeServerEntry, i as syncContract, l as writeClientEntry, n as routesModuleSource, u as writeManifestGen } from "./generate-8yyxKRSz.js";
-import { a as appletSourceDefinitionSchema, i as appletManifestSchema, o as APPLET_CODE_PATTERN, r as resolveWorkspaceOrg } from "./load-config-BYrBjPlr.js";
+import { a as writeRegisterDeclaration, c as writeAppletRoot, d as writeServerEntry, i as syncContract, l as writeClientEntry, n as routesModuleSource, u as writeManifestGen } from "./generate-BLD0DoCk.js";
+import { a as appletMountPath, i as appletManifestSchema, o as appletSourceDefinitionSchema, r as resolveWorkspaceOrg, s as APPLET_CODE_PATTERN } from "./load-config-DGALUExv.js";
 import { z } from "zod";
 import { randomUUID } from "node:crypto";
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
@@ -572,6 +572,7 @@ function applet(sourceDefinition) {
 	}
 	const { dependencies: _dependencies, devDependencies: _devDependencies, ...definition } = parsedSourceDefinition.data;
 	const parsedDefinition = { data: definition };
+	const mountPath = appletMountPath(definition);
 	let appletConfig;
 	let buildRootOutDir;
 	let clearedOutDir = false;
@@ -589,7 +590,7 @@ function applet(sourceDefinition) {
 		children: [{
 			type: "physical",
 			directory: ".",
-			pathPrefix: parsedDefinition.data.code
+			pathPrefix: mountPath
 		}]
 	};
 	const resolveAppletConfig = (root) => {
@@ -738,7 +739,7 @@ function applet(sourceDefinition) {
 				if (colocated.length > 0) throw new Error(`Applet tests run only from the test folder. Move ${colocated.map((path) => `src/${path}`).join(", ")} to test/.`);
 			}
 			return {
-				base: `/${manifest.code}/`,
+				base: `/${mountPath}/`,
 				test: { include: ["test/**/*.test.{ts,tsx}"] },
 				resolve: { alias: {
 					"clsx/lite": "cn/lite",
@@ -776,7 +777,7 @@ function applet(sourceDefinition) {
 				invoke: async (workflow, body) => {
 					const address = server.httpServer?.address();
 					if (address === null || address === void 0 || typeof address === "string") throw new Error("The dev server has no port.");
-					const response = await fetch(`http://localhost:${address.port}/${manifest.code}/api/__hitch/workflows/${encodeURIComponent(workflow)}`, {
+					const response = await fetch(`http://localhost:${address.port}/${mountPath}/api/__hitch/workflows/${encodeURIComponent(workflow)}`, {
 						method: "POST",
 						headers: { "content-type": "application/json" },
 						body: JSON.stringify(body)
@@ -818,7 +819,7 @@ function applet(sourceDefinition) {
 				process.off("exit", removeDevServerFile);
 				removeDevServerFile();
 			});
-			const mount = `/${manifest.code}`;
+			const mount = `/${mountPath}`;
 			const apiPrefix = `${mount}/api`;
 			server.middlewares.use((request, response, next) => {
 				if (request.url === mount || request.url?.startsWith(`${mount}?`)) request.url = `${mount}/${request.url.slice(mount.length)}`;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hitch42/applet",
-  "version": "0.1.1-beta.18",
+  "version": "0.1.1-beta.20",
   "license": "MIT",
   "bin": {
     "applet": "./dist/applet.js"

package/scaffold/.agents/skills/hitch-applets/SKILL.md

@@ -11,7 +11,7 @@ Treat each applet as an isolated microfrontend. Keep it separate from the data s
 
 ## Public applets
 
-Set `public: true` for an applet that anonymous visitors can use. It runs as the applet identity. Its manifest grants cap its access.
+Set `public: true` for an applet that anonymous visitors can use. It is served at `https://{org}.hitch42.app/pages/{code}`. It runs as the applet identity. Its manifest grants cap its access.
 
 A public applet cannot use schedules, email, telephony, workflows, or `@hitch42/applet/client/hitch`. Client code calls its server procedures with `api` from `@hitch42/applet/client`.
 

package/scaffold/.agents/skills/hitch-applets/references/records.md

@@ -14,7 +14,7 @@ Use the generated Hitch contract as the typed data plane.
 ## Use record verbs
 
 - `list` sends `GET /v1/<objectCode>` and lists records with query parameters.
-- `create` sends `POST /v1/<objectCode>` and creates one record.
+- `create` sends `POST /v1/<objectCode>` and creates one record or an array of records.
 - `get` sends `GET /v1/<objectCode>/{id}` and gets one record.
 - `history` sends `GET /v1/<objectCode>/{id}/history` and gets record changes.
 - `update` sends `PATCH /v1/<objectCode>/{id}` and updates one record.
@@ -74,6 +74,21 @@ const deal = await hitch.records.deals.get({
 - Do not use `.queryOptions(...)` or `.mutationOptions(...)` on the server.
 - Use the server SDK for imperative data access, secrets, or external services.
 
+## Create records
+
+Pass one object in `body` to create one record. The call returns one record.
+Use server SDK `create(...)` or client `create.call(...)` with an array to create up to 1000 records. The call returns an array in the same order.
+
+```ts
+const deals = await hitch.records.deals.create({
+  body: [{ name: "First deal" }, { name: "Second deal" }],
+});
+```
+
+The call creates all records or none. If one record fails, the error gives its index in `entry_index`.
+The first record has index 0. An empty array returns an empty array and requires the create grant.
+`mutationOptions` creates one record. Batch recorder calls accept one record per create call.
+
 ## Read history
 
 ```ts

package/dist/batch-Qa4B4-Yp.d.ts

@@ -1,30 +0,0 @@
-import { AnyContractRouter } from "@orpc/contract";
-//#region src/hitch/batch.d.ts
-type BatchVerb = "create" | "update" | "delete" | "updateWhere";
-type BatchTxRecords<Records> = { [Code in keyof Records]: { [Verb in keyof Records[Code] & BatchVerb]: Records[Code][Verb] extends ((...args: infer Args) => unknown) ? (input: Args[0]) => void : never; }; };
-type BatchTx<T> = T extends {
-  records: infer Records;
-} ? BatchTxRecords<Records> : never;
-type BatchRecorderOptions = {
-  dryRun?: boolean;
-  idempotencyKey?: string;
-};
-type BatchRecorderCall<T, Batch> = Batch extends ((...args: infer _Args) => infer Result) ? (record: (tx: BatchTx<T>) => void | Promise<void>, options?: BatchRecorderOptions) => Result : never;
-type WithBatchRecorder<T> = T extends {
-  records: unknown;
-  batch: infer Batch;
-} ? Omit<T, "batch"> & {
-  /**
-   * Record record writes inside `record` and send them as one atomic batch.
-   *
-   * The callback receives a `tx` whose `create` / `update` / `updateWhere` /
-   * `delete` calls are buffered, not sent immediately; the whole batch runs
-   * in a single transaction when the callback resolves.
-   *
-   * @remarks A batch may contain at most **100** requests. More than that is
-   * rejected with a `400` before any write runs.
-   */
-  batch: BatchRecorderCall<T, Batch> & Batch;
-} : T;
-//#endregion
-export { WithBatchRecorder as t };

package/dist/build-DpkWOvd2.js

@@ -1,2 +0,0 @@
-import { i as runBuild } from "./build-DkKTiIu7.js";
-export { runBuild };

package/dist/generate-Df29-UJm.js

@@ -1,2 +0,0 @@
-import { r as runGenerate } from "./generate-8yyxKRSz.js";
-export { runGenerate };