zitejs 0.9.69 → 0.9.71

package/dist/cjs/api/index.js

@@ -0,0 +1,5 @@
+"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

@@ -0,0 +1,5 @@
+"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/cjs/runtime/index.d.ts

@@ -73,7 +73,7 @@ export interface AirtableTableClient<T> {
     }): Promise<T | undefined>;
     create(params: {
         record: Partial<T>;
-    }): Promise<T | undefined>;
+    }): Promise<T>;
     bulkCreate(params: {
         records: Partial<T>[];
     }): Promise<T[]>;
@@ -82,8 +82,8 @@ export interface AirtableTableClient<T> {
         record: Partial<T>;
     }): Promise<{
         id: string;
-        fields: T;
-    } | undefined>;
+        fields: Partial<T>;
+    }>;
     delete(params: {
         id: string;
     }): Promise<DeleteResult>;

package/dist/cjs/sync/lib.js

@@ -26,8 +26,8 @@ const FIELD_TYPE_MAP = {
     single_select: "string",
     multiple_select: "string[]",
     checkbox: "boolean",
-    date: "string",
-    datetime: "string",
+    date: "string | null",
+    datetime: "string | null",
     attachments: "Array<{ url: string; name?: string }>",
     linked_record: "string | string[]",
     lookup: "unknown",
@@ -54,14 +54,31 @@ const DURATION_FORMAT_EXAMPLES = {
     "h:mm:ss.sss": "1:23:03.000",
 };
 function toPascalCase(name) {
-    return name
+    const pascal = name
         .replace(/[^a-zA-Z0-9]+(.)/g, (_, c) => c.toUpperCase())
-        .replace(/^(.)/, (_, c) => c.toUpperCase());
+        .replace(/^(.)/, (_, c) => c.toUpperCase())
+        // Drop leftover non-alphanumerics (e.g. a trailing ">" from "</p>") so the
+        // sdkName is always a valid identifier in .zite/db.ts.
+        .replace(/[^a-zA-Z0-9]+/g, "");
+    if (!pascal)
+        return "_";
+    return /^[0-9]/.test(pascal) ? `_${pascal}` : pascal; // can't start with a digit
 }
 function toCamelCase(name) {
     const pascal = toPascalCase(name);
     return pascal.charAt(0).toLowerCase() + pascal.slice(1);
 }
+/**
+ * Existing sdkNames are preserved across syncs so user code keeps compiling,
+ * but schemas written before the sanitizer stripped trailing symbols can carry
+ * invalid identifiers (e.g. "timeSeconds)"). Keep an existing name only when
+ * it's a valid identifier; otherwise fall through to recomputing it.
+ */
+function keepValidSdkName(sdkName) {
+    if (!sdkName)
+        return undefined;
+    return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(sdkName) ? sdkName : undefined;
+}
 function tsTypeForSchemaField(def) {
     if (def.type === "single_select" || def.type === "multiple_select") {
         const options = def.template
@@ -104,11 +121,11 @@ function fieldJsdoc(schemaField, table) {
     if (def.type === "date") {
         const tpl = def.template;
         if (tpl.dateFormat)
-            parts.push(`Date-only field (YYYY-MM-DD string), display as "${tpl.dateFormat}" format`);
+            parts.push(`Date-only field (YYYY-MM-DD string), null when unset, display as "${tpl.dateFormat}" format`);
     }
     if (def.type === "datetime") {
         const tpl = def.template;
-        const timeParts = ["Date+time field (ISO 8601 timestamp)"];
+        const timeParts = ["Date+time field (ISO 8601 timestamp), null when unset"];
         if (tpl.dateFormat)
             timeParts.push(`date: ${tpl.dateFormat}`);
         if (tpl.timeFormat)
@@ -192,13 +209,13 @@ function generateSchema(database, existingSchema) {
             const { id: _id, order: _order, ...definition } = field;
             fields.push({
                 id: field.id,
-                sdkName: existing?.sdkName ?? toCamelCase(field.name),
+                sdkName: keepValidSdkName(existing?.sdkName) ?? toCamelCase(field.name),
                 definition,
             });
         }
         tables.push({
             id: table.id,
-            sdkName: existingTable?.sdkName ?? toCamelCase(table.name),
+            sdkName: keepValidSdkName(existingTable?.sdkName) ?? toCamelCase(table.name),
             primaryFieldId: table.primaryFieldId,
             fields,
         });
@@ -303,7 +320,9 @@ function generateDbTs(schema) {
     lines.push("// The tsconfig aliases resolve zitejs/* imports to the correct .zite/ files.");
     lines.push("//");
     lines.push("// Table client methods (all take a single params object):");
-    lines.push("//   .findAll({ filters?, offset?, limit?, fields? }) → { records: T[], hasMore: boolean }");
+    lines.push("//   .findAll({ filters?, sort?, offset?, limit?, fields? }) → { records: T[], hasMore: boolean }");
+    lines.push("//     filters: { fieldName: value } for equality, { fieldName: { contains|gt|lt|gte|lte: value } } for operators");
+    lines.push("//     sort: [{ field: 'fieldName', direction: 'asc' | 'desc' }]");
     lines.push("//   .findOne({ id?, filters?, fields? }) → T | undefined");
     lines.push("//   .create({ record }) → T");
     lines.push("//   .update({ id, record }) → { id: string, fields: Partial<T> }");

package/dist/cjs/types/fields.js

@@ -134,7 +134,8 @@ exports.ratingTemplateSchema = zod_1.z.object({
 });
 exports.durationTemplateSchema = zod_1.z.object({
     format: zod_1.z.enum(exports.durationFormatEnum),
-    defaultValue: zod_1.z.number().int().min(0).optional(),
+    // Stored as seconds in a DECIMAL column; may be fractional.
+    defaultValue: zod_1.z.number().min(0).optional(),
 });
 exports.percentTemplateSchema = zod_1.z.object({
     decimalPlaces: zod_1.z.number().min(0),

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

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

package/dist/esm/api/index.js

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

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

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

package/dist/esm/db/index.js

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

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

@@ -73,7 +73,7 @@ export interface AirtableTableClient<T> {
     }): Promise<T | undefined>;
     create(params: {
         record: Partial<T>;
-    }): Promise<T | undefined>;
+    }): Promise<T>;
     bulkCreate(params: {
         records: Partial<T>[];
     }): Promise<T[]>;
@@ -82,8 +82,8 @@ export interface AirtableTableClient<T> {
         record: Partial<T>;
     }): Promise<{
         id: string;
-        fields: T;
-    } | undefined>;
+        fields: Partial<T>;
+    }>;
     delete(params: {
         id: string;
     }): Promise<DeleteResult>;

package/dist/esm/sync/lib.js

@@ -14,8 +14,8 @@ const FIELD_TYPE_MAP = {
     single_select: "string",
     multiple_select: "string[]",
     checkbox: "boolean",
-    date: "string",
-    datetime: "string",
+    date: "string | null",
+    datetime: "string | null",
     attachments: "Array<{ url: string; name?: string }>",
     linked_record: "string | string[]",
     lookup: "unknown",
@@ -42,14 +42,31 @@ const DURATION_FORMAT_EXAMPLES = {
     "h:mm:ss.sss": "1:23:03.000",
 };
 export function toPascalCase(name) {
-    return name
+    const pascal = name
         .replace(/[^a-zA-Z0-9]+(.)/g, (_, c) => c.toUpperCase())
-        .replace(/^(.)/, (_, c) => c.toUpperCase());
+        .replace(/^(.)/, (_, c) => c.toUpperCase())
+        // Drop leftover non-alphanumerics (e.g. a trailing ">" from "</p>") so the
+        // sdkName is always a valid identifier in .zite/db.ts.
+        .replace(/[^a-zA-Z0-9]+/g, "");
+    if (!pascal)
+        return "_";
+    return /^[0-9]/.test(pascal) ? `_${pascal}` : pascal; // can't start with a digit
 }
 export function toCamelCase(name) {
     const pascal = toPascalCase(name);
     return pascal.charAt(0).toLowerCase() + pascal.slice(1);
 }
+/**
+ * Existing sdkNames are preserved across syncs so user code keeps compiling,
+ * but schemas written before the sanitizer stripped trailing symbols can carry
+ * invalid identifiers (e.g. "timeSeconds)"). Keep an existing name only when
+ * it's a valid identifier; otherwise fall through to recomputing it.
+ */
+function keepValidSdkName(sdkName) {
+    if (!sdkName)
+        return undefined;
+    return /^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(sdkName) ? sdkName : undefined;
+}
 function tsTypeForSchemaField(def) {
     if (def.type === "single_select" || def.type === "multiple_select") {
         const options = def.template
@@ -92,11 +109,11 @@ function fieldJsdoc(schemaField, table) {
     if (def.type === "date") {
         const tpl = def.template;
         if (tpl.dateFormat)
-            parts.push(`Date-only field (YYYY-MM-DD string), display as "${tpl.dateFormat}" format`);
+            parts.push(`Date-only field (YYYY-MM-DD string), null when unset, display as "${tpl.dateFormat}" format`);
     }
     if (def.type === "datetime") {
         const tpl = def.template;
-        const timeParts = ["Date+time field (ISO 8601 timestamp)"];
+        const timeParts = ["Date+time field (ISO 8601 timestamp), null when unset"];
         if (tpl.dateFormat)
             timeParts.push(`date: ${tpl.dateFormat}`);
         if (tpl.timeFormat)
@@ -180,13 +197,13 @@ export function generateSchema(database, existingSchema) {
             const { id: _id, order: _order, ...definition } = field;
             fields.push({
                 id: field.id,
-                sdkName: existing?.sdkName ?? toCamelCase(field.name),
+                sdkName: keepValidSdkName(existing?.sdkName) ?? toCamelCase(field.name),
                 definition,
             });
         }
         tables.push({
             id: table.id,
-            sdkName: existingTable?.sdkName ?? toCamelCase(table.name),
+            sdkName: keepValidSdkName(existingTable?.sdkName) ?? toCamelCase(table.name),
             primaryFieldId: table.primaryFieldId,
             fields,
         });
@@ -291,7 +308,9 @@ export function generateDbTs(schema) {
     lines.push("// The tsconfig aliases resolve zitejs/* imports to the correct .zite/ files.");
     lines.push("//");
     lines.push("// Table client methods (all take a single params object):");
-    lines.push("//   .findAll({ filters?, offset?, limit?, fields? }) → { records: T[], hasMore: boolean }");
+    lines.push("//   .findAll({ filters?, sort?, offset?, limit?, fields? }) → { records: T[], hasMore: boolean }");
+    lines.push("//     filters: { fieldName: value } for equality, { fieldName: { contains|gt|lt|gte|lte: value } } for operators");
+    lines.push("//     sort: [{ field: 'fieldName', direction: 'asc' | 'desc' }]");
     lines.push("//   .findOne({ id?, filters?, fields? }) → T | undefined");
     lines.push("//   .create({ record }) → T");
     lines.push("//   .update({ id, record }) → { id: string, fields: Partial<T> }");

package/dist/esm/types/fields.js

@@ -131,7 +131,8 @@ export const ratingTemplateSchema = z.object({
 });
 export const durationTemplateSchema = z.object({
     format: z.enum(durationFormatEnum),
-    defaultValue: z.number().int().min(0).optional(),
+    // Stored as seconds in a DECIMAL column; may be fractional.
+    defaultValue: z.number().min(0).optional(),
 });
 export const percentTemplateSchema = z.object({
     decimalPlaces: z.number().min(0),

package/package.json

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