zitejs 0.9.101 → 0.9.103

package/dist/cjs/sync/lib.d.ts

@@ -16,6 +16,16 @@ export type ZiteSchema = {
 };
 export declare function toPascalCase(name: string): string;
 export declare function toCamelCase(name: string): string;
+/**
+ * camelCase for a FRESH sdkName, reading acronym runs as words: "VIP" ->
+ * "vip", "APIKey" -> "apiKey" (plain toCamelCase yields "vIP" / "aPIKey").
+ *
+ * Deliberately not folded into toCamelCase: that also derives endpoint
+ * identifiers from existing filenames on every generate, where normalizing
+ * would rename a working app's `api.sendSMS`. This is only for names being
+ * chosen for the first time — generateSchema preserves existing sdkNames.
+ */
+export declare function toSdkName(name: string): string;
 /**
  * Build a ZiteSchema from a Database API response.
  *

package/dist/cjs/sync/lib.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.toPascalCase = toPascalCase;
 exports.toCamelCase = toCamelCase;
+exports.toSdkName = toSdkName;
 exports.generateSchema = generateSchema;
 exports.generateDbTs = generateDbTs;
 exports.generateApiTs = generateApiTs;
@@ -151,7 +152,9 @@ const DATE_FORMAT_EXAMPLES = {
 };
 const withDateFormatExample = (format) => {
     const example = DATE_FORMAT_EXAMPLES[format];
-    return example ? `"${format}" format (e.g. ${example})` : `"${format}" format`;
+    return example
+        ? `"${format}" format (e.g. ${example})`
+        : `"${format}" format`;
 };
 function toPascalCase(name) {
     const pascal = name
@@ -168,6 +171,21 @@ function toCamelCase(name) {
     const pascal = toPascalCase(name);
     return pascal.charAt(0).toLowerCase() + pascal.slice(1);
 }
+/**
+ * camelCase for a FRESH sdkName, reading acronym runs as words: "VIP" ->
+ * "vip", "APIKey" -> "apiKey" (plain toCamelCase yields "vIP" / "aPIKey").
+ *
+ * Deliberately not folded into toCamelCase: that also derives endpoint
+ * identifiers from existing filenames on every generate, where normalizing
+ * would rename a working app's `api.sendSMS`. This is only for names being
+ * chosen for the first time — generateSchema preserves existing sdkNames.
+ */
+function toSdkName(name) {
+    const deAcronymed = name
+        .replace(/([A-Z]+)([A-Z][a-z])/g, (_, run, next) => run.charAt(0) + run.slice(1).toLowerCase() + next)
+        .replace(/([A-Z])([A-Z]+)/g, (_, first, rest) => first + rest.toLowerCase());
+    return toCamelCase(deAcronymed);
+}
 /**
  * Existing sdkNames are preserved across syncs so user code keeps compiling,
  * but schemas written before the sanitizer stripped trailing symbols can carry
@@ -196,7 +214,9 @@ function tsTypeForSchemaField(def, variant = "read") {
                 .map((o) => `"${o.label.replace(/"/g, '\\"')}"`)
                 .join(" | ");
             const union = `${literals} | string`;
-            const read = def.type === "multiple_select" ? `(${union})[] | null` : `${union} | null`;
+            const read = def.type === "multiple_select"
+                ? `(${union})[] | null`
+                : `${union} | null`;
             if (variant === "write") {
                 return def.type === "multiple_select"
                     ? `${union} | (${union})[] | null`
@@ -334,13 +354,13 @@ function generateSchema(database, existingSchema) {
             const { id: _id, order: _order, ...definition } = field;
             fields.push({
                 id: field.id,
-                sdkName: keepValidSdkName(existing?.sdkName) ?? toCamelCase(field.name),
+                sdkName: keepValidSdkName(existing?.sdkName) ?? toSdkName(field.name),
                 definition,
             });
         }
         tables.push({
             id: table.id,
-            sdkName: keepValidSdkName(existingTable?.sdkName) ?? toCamelCase(table.name),
+            sdkName: keepValidSdkName(existingTable?.sdkName) ?? toSdkName(table.name),
             primaryFieldId: table.primaryFieldId,
             fields,
         });
@@ -447,7 +467,7 @@ function generateDbTs(schema) {
     lines.push("//   .findAll({ filters?, sort?, offset?, limit?, fields? }) → { records: T[], hasMore: boolean }");
     lines.push("//     filters: { fieldName: value } for equality, or { fieldName: { <op>: value } }");
     lines.push("//     operators: contains, not, in, notIn, lt, lte, gt, gte");
-    lines.push('//       `not: null` means "is set". An empty `in: []` matches nothing; an', '//       empty `notIn: []` applies no filter.');
+    lines.push('//       `not: null` means "is set". An empty `in: []` matches nothing; an', "//       empty `notIn: []` applies no filter.");
     lines.push("//     sort is currently IGNORED here — it is stripped before the request.", "//       (it does work on zite.auth.findAllUsers). Order in SQL instead.");
     lines.push("//     limit defaults to 500, max 2000; offset is a row count (a number)");
     lines.push("//   .findOne({ id?, filters?, fields? }) → T | undefined");
@@ -620,12 +640,52 @@ function inspectEndpointFile(source) {
  * words are legal object keys.
  */
 const RESERVED_IDENTIFIERS = new Set([
-    "await", "break", "case", "catch", "class", "const", "continue", "debugger",
-    "default", "delete", "do", "else", "enum", "export", "extends", "false",
-    "finally", "for", "function", "if", "implements", "import", "in",
-    "instanceof", "interface", "let", "new", "null", "package", "private",
-    "protected", "public", "return", "static", "super", "switch", "this",
-    "throw", "true", "try", "typeof", "var", "void", "while", "with", "yield",
+    "await",
+    "break",
+    "case",
+    "catch",
+    "class",
+    "const",
+    "continue",
+    "debugger",
+    "default",
+    "delete",
+    "do",
+    "else",
+    "enum",
+    "export",
+    "extends",
+    "false",
+    "finally",
+    "for",
+    "function",
+    "if",
+    "implements",
+    "import",
+    "in",
+    "instanceof",
+    "interface",
+    "let",
+    "new",
+    "null",
+    "package",
+    "private",
+    "protected",
+    "public",
+    "return",
+    "static",
+    "super",
+    "switch",
+    "this",
+    "throw",
+    "true",
+    "try",
+    "typeof",
+    "var",
+    "void",
+    "while",
+    "with",
+    "yield",
 ]);
 const toSafeIdentifier = (camelName) => RESERVED_IDENTIFIERS.has(camelName) ? `_${camelName}` : camelName;
 function generateApiTs(endpointFiles) {
@@ -955,7 +1015,7 @@ function generateAirtableTs(lock) {
         '//   each carries its current user-facing name in quotes (// "Task Name"), which is',
         "//   the source of truth for what it means.",
         "//   Values are RAW; format them for display using each field's comment.",
-        "//   Fields marked \"Links to X\" hold Airtable record ids (rec...) from",
+        '//   Fields marked "Links to X" hold Airtable record ids (rec...) from',
         "//   findOne/findAll — never invent one.",
         "//   Read-only fields are absent from the *RecordInput types: Airtable rejects a",
         "//   write to a computed one (formula, rollup, lookup, autonumber, the created/",
@@ -1066,11 +1126,31 @@ function generateBackendWrapperTs(envVarNames = []) {
         " * compile and throw. `Omit` keeps any index signature merged in by",
         " * `.zite/user-extensions.d.ts`, so a migrated user-sync app still reads its",
         " * synced columns off this.",
+        " *",
+        " * The `Pick` intersection is not redundant. On an app that DOES merge in",
+        " * `[key: string]: any`, `keyof User` widens to `string`, `Exclude` then",
+        " * removes nothing, and the `Omit` collapses to a bare index signature —",
+        " * which would silently degrade `user.id` from `string` to `any`. The `Pick`",
+        " * names those members explicitly, so they survive the collapse.",
+        " *",
+        " * Only `id` and `email` are pinned that way, deliberately. On a user-sync",
+        " * app `context.user` IS the synced row (`buildUserContext` returns it",
+        " * whole), and only those two are guaranteed by the runtime: the id is the",
+        " * record id and the email is merged in explicitly. `firstName`/`lastName`",
+        " * come from whatever the app mapped those columns to, so pinning them to",
+        " * `string` would reject a legitimate read on a table that types them",
+        " * differently. Non-widened apps get both from the `Omit` regardless.",
+        " *",
+        " * On such an app `user.createdAt` still compiles, as `any`. That is",
+        " * deliberate: a synced user table may legitimately have its own",
+        " * `createdAt` column, and typing it `never` to close the hole would break",
+        " * exactly the legacy apps `user-extensions.d.ts` exists to keep compiling.",
         " */",
         "export type ZiteEndpointUser = Omit<",
         "  User,",
         "  'name' | 'emailVerified' | 'image' | 'createdAt' | 'updatedAt'",
-        ">;",
+        "> &",
+        "  Pick<User, 'id' | 'email'>;",
         "",
         'export interface ZiteRequestContext extends Omit<_ZiteRequestContext, "user"> {',
         "  user: ZiteEndpointUser;",

package/dist/esm/sync/lib.d.ts

@@ -16,6 +16,16 @@ export type ZiteSchema = {
 };
 export declare function toPascalCase(name: string): string;
 export declare function toCamelCase(name: string): string;
+/**
+ * camelCase for a FRESH sdkName, reading acronym runs as words: "VIP" ->
+ * "vip", "APIKey" -> "apiKey" (plain toCamelCase yields "vIP" / "aPIKey").
+ *
+ * Deliberately not folded into toCamelCase: that also derives endpoint
+ * identifiers from existing filenames on every generate, where normalizing
+ * would rename a working app's `api.sendSMS`. This is only for names being
+ * chosen for the first time — generateSchema preserves existing sdkNames.
+ */
+export declare function toSdkName(name: string): string;
 /**
  * Build a ZiteSchema from a Database API response.
  *

package/dist/esm/sync/lib.js

@@ -141,7 +141,9 @@ const DATE_FORMAT_EXAMPLES = {
 };
 const withDateFormatExample = (format) => {
     const example = DATE_FORMAT_EXAMPLES[format];
-    return example ? `"${format}" format (e.g. ${example})` : `"${format}" format`;
+    return example
+        ? `"${format}" format (e.g. ${example})`
+        : `"${format}" format`;
 };
 export function toPascalCase(name) {
     const pascal = name
@@ -158,6 +160,21 @@ export function toCamelCase(name) {
     const pascal = toPascalCase(name);
     return pascal.charAt(0).toLowerCase() + pascal.slice(1);
 }
+/**
+ * camelCase for a FRESH sdkName, reading acronym runs as words: "VIP" ->
+ * "vip", "APIKey" -> "apiKey" (plain toCamelCase yields "vIP" / "aPIKey").
+ *
+ * Deliberately not folded into toCamelCase: that also derives endpoint
+ * identifiers from existing filenames on every generate, where normalizing
+ * would rename a working app's `api.sendSMS`. This is only for names being
+ * chosen for the first time — generateSchema preserves existing sdkNames.
+ */
+export function toSdkName(name) {
+    const deAcronymed = name
+        .replace(/([A-Z]+)([A-Z][a-z])/g, (_, run, next) => run.charAt(0) + run.slice(1).toLowerCase() + next)
+        .replace(/([A-Z])([A-Z]+)/g, (_, first, rest) => first + rest.toLowerCase());
+    return toCamelCase(deAcronymed);
+}
 /**
  * Existing sdkNames are preserved across syncs so user code keeps compiling,
  * but schemas written before the sanitizer stripped trailing symbols can carry
@@ -186,7 +203,9 @@ function tsTypeForSchemaField(def, variant = "read") {
                 .map((o) => `"${o.label.replace(/"/g, '\\"')}"`)
                 .join(" | ");
             const union = `${literals} | string`;
-            const read = def.type === "multiple_select" ? `(${union})[] | null` : `${union} | null`;
+            const read = def.type === "multiple_select"
+                ? `(${union})[] | null`
+                : `${union} | null`;
             if (variant === "write") {
                 return def.type === "multiple_select"
                     ? `${union} | (${union})[] | null`
@@ -324,13 +343,13 @@ export function generateSchema(database, existingSchema) {
             const { id: _id, order: _order, ...definition } = field;
             fields.push({
                 id: field.id,
-                sdkName: keepValidSdkName(existing?.sdkName) ?? toCamelCase(field.name),
+                sdkName: keepValidSdkName(existing?.sdkName) ?? toSdkName(field.name),
                 definition,
             });
         }
         tables.push({
             id: table.id,
-            sdkName: keepValidSdkName(existingTable?.sdkName) ?? toCamelCase(table.name),
+            sdkName: keepValidSdkName(existingTable?.sdkName) ?? toSdkName(table.name),
             primaryFieldId: table.primaryFieldId,
             fields,
         });
@@ -437,7 +456,7 @@ export function generateDbTs(schema) {
     lines.push("//   .findAll({ filters?, sort?, offset?, limit?, fields? }) → { records: T[], hasMore: boolean }");
     lines.push("//     filters: { fieldName: value } for equality, or { fieldName: { <op>: value } }");
     lines.push("//     operators: contains, not, in, notIn, lt, lte, gt, gte");
-    lines.push('//       `not: null` means "is set". An empty `in: []` matches nothing; an', '//       empty `notIn: []` applies no filter.');
+    lines.push('//       `not: null` means "is set". An empty `in: []` matches nothing; an', "//       empty `notIn: []` applies no filter.");
     lines.push("//     sort is currently IGNORED here — it is stripped before the request.", "//       (it does work on zite.auth.findAllUsers). Order in SQL instead.");
     lines.push("//     limit defaults to 500, max 2000; offset is a row count (a number)");
     lines.push("//   .findOne({ id?, filters?, fields? }) → T | undefined");
@@ -610,12 +629,52 @@ function inspectEndpointFile(source) {
  * words are legal object keys.
  */
 const RESERVED_IDENTIFIERS = new Set([
-    "await", "break", "case", "catch", "class", "const", "continue", "debugger",
-    "default", "delete", "do", "else", "enum", "export", "extends", "false",
-    "finally", "for", "function", "if", "implements", "import", "in",
-    "instanceof", "interface", "let", "new", "null", "package", "private",
-    "protected", "public", "return", "static", "super", "switch", "this",
-    "throw", "true", "try", "typeof", "var", "void", "while", "with", "yield",
+    "await",
+    "break",
+    "case",
+    "catch",
+    "class",
+    "const",
+    "continue",
+    "debugger",
+    "default",
+    "delete",
+    "do",
+    "else",
+    "enum",
+    "export",
+    "extends",
+    "false",
+    "finally",
+    "for",
+    "function",
+    "if",
+    "implements",
+    "import",
+    "in",
+    "instanceof",
+    "interface",
+    "let",
+    "new",
+    "null",
+    "package",
+    "private",
+    "protected",
+    "public",
+    "return",
+    "static",
+    "super",
+    "switch",
+    "this",
+    "throw",
+    "true",
+    "try",
+    "typeof",
+    "var",
+    "void",
+    "while",
+    "with",
+    "yield",
 ]);
 const toSafeIdentifier = (camelName) => RESERVED_IDENTIFIERS.has(camelName) ? `_${camelName}` : camelName;
 export function generateApiTs(endpointFiles) {
@@ -945,7 +1004,7 @@ export function generateAirtableTs(lock) {
         '//   each carries its current user-facing name in quotes (// "Task Name"), which is',
         "//   the source of truth for what it means.",
         "//   Values are RAW; format them for display using each field's comment.",
-        "//   Fields marked \"Links to X\" hold Airtable record ids (rec...) from",
+        '//   Fields marked "Links to X" hold Airtable record ids (rec...) from',
         "//   findOne/findAll — never invent one.",
         "//   Read-only fields are absent from the *RecordInput types: Airtable rejects a",
         "//   write to a computed one (formula, rollup, lookup, autonumber, the created/",
@@ -1056,11 +1115,31 @@ export function generateBackendWrapperTs(envVarNames = []) {
         " * compile and throw. `Omit` keeps any index signature merged in by",
         " * `.zite/user-extensions.d.ts`, so a migrated user-sync app still reads its",
         " * synced columns off this.",
+        " *",
+        " * The `Pick` intersection is not redundant. On an app that DOES merge in",
+        " * `[key: string]: any`, `keyof User` widens to `string`, `Exclude` then",
+        " * removes nothing, and the `Omit` collapses to a bare index signature —",
+        " * which would silently degrade `user.id` from `string` to `any`. The `Pick`",
+        " * names those members explicitly, so they survive the collapse.",
+        " *",
+        " * Only `id` and `email` are pinned that way, deliberately. On a user-sync",
+        " * app `context.user` IS the synced row (`buildUserContext` returns it",
+        " * whole), and only those two are guaranteed by the runtime: the id is the",
+        " * record id and the email is merged in explicitly. `firstName`/`lastName`",
+        " * come from whatever the app mapped those columns to, so pinning them to",
+        " * `string` would reject a legitimate read on a table that types them",
+        " * differently. Non-widened apps get both from the `Omit` regardless.",
+        " *",
+        " * On such an app `user.createdAt` still compiles, as `any`. That is",
+        " * deliberate: a synced user table may legitimately have its own",
+        " * `createdAt` column, and typing it `never` to close the hole would break",
+        " * exactly the legacy apps `user-extensions.d.ts` exists to keep compiling.",
         " */",
         "export type ZiteEndpointUser = Omit<",
         "  User,",
         "  'name' | 'emailVerified' | 'image' | 'createdAt' | 'updatedAt'",
-        ">;",
+        "> &",
+        "  Pick<User, 'id' | 'email'>;",
         "",
         'export interface ZiteRequestContext extends Omit<_ZiteRequestContext, "user"> {',
         "  user: ZiteEndpointUser;",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zitejs",
-  "version": "0.9.101",
+  "version": "0.9.103",
   "description": "The Zite framework — build apps on Zite Database",
   "type": "module",
   "main": "./dist/cjs/index.js",

package/dist/cjs/api/index.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createCaller = void 0;
-var index_js_1 = require("../caller/index.js");
-Object.defineProperty(exports, "createCaller", { enumerable: true, get: function () { return index_js_1.createCaller; } });

package/dist/cjs/db/index.js

@@ -1,5 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createTableClient = void 0;
-var index_js_1 = require("../runtime/index.js");
-Object.defineProperty(exports, "createTableClient", { enumerable: true, get: function () { return index_js_1.createTableClient; } });

package/dist/esm/api/index.d.ts

@@ -1,2 +0,0 @@
-export { createCaller } from '../caller/index.js';
-export type { EndpointConfig } from '../caller/index.js';

package/dist/esm/api/index.js

@@ -1 +0,0 @@
-export { createCaller } from '../caller/index.js';

package/dist/esm/db/index.d.ts

@@ -1,2 +0,0 @@
-export { createTableClient } from '../runtime/index.js';
-export type { TableClient } from '../runtime/index.js';

package/dist/esm/db/index.js

@@ -1 +0,0 @@
-export { createTableClient } from '../runtime/index.js';