zitejs 0.9.147 → 0.9.148

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -427,44 +427,98 @@ const duplicateIdentifierErrorsIn = (source) => {
427
427
  (0, vitest_1.expect)((0, lib_js_1.findEmailIntegrationId)(undefined, undefined)).toBeUndefined();
428
428
  });
429
429
  });
430
- (0, vitest_1.describe)('generateIntegrationsIndex', () => {
431
- // Not import.meta: this file also compiles to CommonJS. Vitest runs from the repo root.
432
- const runtimePath = (0, path_1.resolve)('src/runtime/index.ts');
433
- /** Type errors in `usage` compiled beside the generated file, `zitejs/runtime` mapped to this source. */
434
- const typeErrorsIn = (generated, usage, airtable) => {
435
- const files = {
436
- '/app/.zite/integrations/index.ts': generated,
437
- ...(airtable ? { '/app/.zite/integrations/airtable.ts': airtable } : {}),
438
- '/app/src/usage.ts': usage,
439
- };
440
- const options = {
441
- strict: true,
442
- noEmit: true,
443
- target: typescript_1.default.ScriptTarget.ES2022,
444
- module: typescript_1.default.ModuleKind.ESNext,
445
- moduleResolution: typescript_1.default.ModuleResolutionKind.Bundler,
446
- skipLibCheck: true,
447
- baseUrl: '/app',
448
- paths: {
449
- 'zitejs/runtime': [runtimePath],
450
- 'zitejs/integrations': ['/app/.zite/integrations/index.ts'],
430
+ // Not import.meta: this file also compiles to CommonJS. Vitest runs from the repo root.
431
+ const runtimePath = (0, path_1.resolve)('src/runtime/index.ts');
432
+ /** Type errors in the `/app/` files, `zitejs/runtime` mapped to this source. */
433
+ const appTypeErrors = (files, paths) => {
434
+ const options = {
435
+ strict: true,
436
+ noEmit: true,
437
+ target: typescript_1.default.ScriptTarget.ES2022,
438
+ module: typescript_1.default.ModuleKind.ESNext,
439
+ moduleResolution: typescript_1.default.ModuleResolutionKind.Bundler,
440
+ skipLibCheck: true,
441
+ baseUrl: '/app',
442
+ paths: { 'zitejs/runtime': [runtimePath], ...paths },
443
+ };
444
+ const host = typescript_1.default.createCompilerHost(options);
445
+ const { getSourceFile, fileExists, readFile, directoryExists } = host;
446
+ host.fileExists = f => f in files || fileExists(f);
447
+ host.directoryExists = d => Object.keys(files).some(f => f.startsWith(`${d}/`)) ||
448
+ (directoryExists?.(d) ?? false);
449
+ host.readFile = f => files[f] ?? readFile(f);
450
+ host.getSourceFile = (f, lang, ...rest) => f in files
451
+ ? typescript_1.default.createSourceFile(f, files[f], lang)
452
+ : getSourceFile(f, lang, ...rest);
453
+ const program = typescript_1.default.createProgram(Object.keys(files), options, host);
454
+ return typescript_1.default
455
+ .getPreEmitDiagnostics(program)
456
+ .filter(d => d.file?.fileName.startsWith('/app/'))
457
+ .map(d => typescript_1.default.flattenDiagnosticMessageText(d.messageText, ' '));
458
+ };
459
+ (0, vitest_1.describe)('generateDbTs created_by and updated_by', () => {
460
+ const schema = {
461
+ tables: [
462
+ {
463
+ id: 'tbl1',
464
+ sdkName: 'tasks',
465
+ fields: [
466
+ {
467
+ id: 'fld1',
468
+ sdkName: 'title',
469
+ definition: { name: 'Title', type: 'single_line_text', template: {} },
470
+ },
471
+ {
472
+ id: 'fld2',
473
+ sdkName: 'createdBy',
474
+ definition: { name: 'Created By', type: 'created_by', template: {} },
475
+ },
476
+ {
477
+ id: 'fld3',
478
+ sdkName: 'updatedBy',
479
+ definition: { name: 'Last Modified By', type: 'updated_by', template: {} },
480
+ },
481
+ ],
451
482
  },
452
- };
453
- const host = typescript_1.default.createCompilerHost(options);
454
- const { getSourceFile, fileExists, readFile, directoryExists } = host;
455
- host.fileExists = f => f in files || fileExists(f);
456
- host.directoryExists = d => Object.keys(files).some(f => f.startsWith(`${d}/`)) ||
457
- (directoryExists?.(d) ?? false);
458
- host.readFile = f => files[f] ?? readFile(f);
459
- host.getSourceFile = (f, lang, ...rest) => f in files
460
- ? typescript_1.default.createSourceFile(f, files[f], lang)
461
- : getSourceFile(f, lang, ...rest);
462
- const program = typescript_1.default.createProgram(Object.keys(files), options, host);
463
- return typescript_1.default
464
- .getPreEmitDiagnostics(program)
465
- .filter(d => d.file?.fileName.startsWith('/app/'))
466
- .map(d => typescript_1.default.flattenDiagnosticMessageText(d.messageText, ' '));
483
+ ],
467
484
  };
485
+ const typeErrorsIn = (usage) => appTypeErrors({ '/app/.zite/db.ts': (0, lib_js_1.generateDbTs)(schema), '/app/src/usage.ts': usage }, { 'zitejs/db': ['/app/.zite/db.ts'] });
486
+ const EQUAL = 'type Equal<A, B> = (<T>() => T extends A ? 1 : 2) extends (<T>() => T extends B ? 1 : 2) ? true : false;';
487
+ // TanStack Start's serializability check rejects `unknown`, so a server
488
+ // function returning a raw row failed typecheck while created_by fell through.
489
+ (0, vitest_1.it)('reads both as a user id', () => {
490
+ (0, vitest_1.expect)(typeErrorsIn([
491
+ "import type { TasksRecordType } from 'zitejs/db';",
492
+ EQUAL,
493
+ "export const createdBy: Equal<TasksRecordType['createdBy'], string | undefined> = true;",
494
+ "export const updatedBy: Equal<TasksRecordType['updatedBy'], string | undefined> = true;",
495
+ ].join('\n'))).toEqual([]);
496
+ });
497
+ (0, vitest_1.it)('leaves both out of the input type', () => {
498
+ (0, vitest_1.expect)(typeErrorsIn([
499
+ "import type { TasksRecordInput } from 'zitejs/db';",
500
+ EQUAL,
501
+ "export const writable: Equal<keyof TasksRecordInput, 'title'> = true;",
502
+ ].join('\n'))).toEqual([]);
503
+ });
504
+ (0, vitest_1.it)('filters both by a user id', () => {
505
+ (0, vitest_1.expect)(typeErrorsIn([
506
+ "import { zite } from 'zitejs/db';",
507
+ 'export const mine = (userId: string) => [',
508
+ ' zite.tasks.findAll({ filters: { createdBy: userId } }),',
509
+ ' zite.tasks.findAll({ filters: { updatedBy: { in: [userId] } } }),',
510
+ ' zite.tasks.findOne({ filters: { createdBy: { not: null } } }),',
511
+ '];',
512
+ ].join('\n'))).toEqual([]);
513
+ (0, vitest_1.expect)(typeErrorsIn("import { zite } from 'zitejs/db';\nvoid zite.tasks.findAll({ filters: { createdBy: 42 } });")).toHaveLength(1);
514
+ });
515
+ });
516
+ (0, vitest_1.describe)('generateIntegrationsIndex', () => {
517
+ const typeErrorsIn = (generated, usage, airtable) => appTypeErrors({
518
+ '/app/.zite/integrations/index.ts': generated,
519
+ ...(airtable ? { '/app/.zite/integrations/airtable.ts': airtable } : {}),
520
+ '/app/src/usage.ts': usage,
521
+ }, { 'zitejs/integrations': ['/app/.zite/integrations/index.ts'] });
468
522
  (0, vitest_1.it)('emits the client typed by name', () => {
469
523
  (0, vitest_1.expect)((0, lib_js_1.generateIntegrationsIndex)([
470
524
  { name: 'team', serviceType: 'slack', perUser: false },
@@ -7,7 +7,7 @@ export declare const timeFormatEnum: readonly ["12h", "24h"];
7
7
  export type TimeFormat = (typeof timeFormatEnum)[number];
8
8
  export declare const durationFormatEnum: readonly ["h:mm", "h:mm:ss", "h:mm:ss.s", "h:mm:ss.ss", "h:mm:ss.sss"];
9
9
  export type DurationFormat = (typeof durationFormatEnum)[number];
10
- export declare const fieldTypeEnum: readonly ["currency", "single_line_text", "long_text", "rich_text", "number", "single_select", "multiple_select", "date", "datetime", "checkbox", "attachments", "email", "url", "phone_number", "rating", "duration", "percent", "linked_record", "lookup", "source", "formula", "autonumber", "created_at", "updated_at", "rollup", "updated_by", "user"];
10
+ export declare const fieldTypeEnum: readonly ["currency", "single_line_text", "long_text", "rich_text", "number", "single_select", "multiple_select", "date", "datetime", "checkbox", "attachments", "email", "url", "phone_number", "rating", "duration", "percent", "linked_record", "lookup", "source", "formula", "autonumber", "created_at", "updated_at", "rollup", "created_by", "updated_by", "user"];
11
11
  export type FieldType = (typeof fieldTypeEnum)[number];
12
12
  export declare const fieldTypeSchema: z.ZodEnum<{
13
13
  number: "number";
@@ -35,6 +35,7 @@ export declare const fieldTypeSchema: z.ZodEnum<{
35
35
  created_at: "created_at";
36
36
  updated_at: "updated_at";
37
37
  rollup: "rollup";
38
+ created_by: "created_by";
38
39
  updated_by: "updated_by";
39
40
  user: "user";
40
41
  }>;
@@ -240,6 +241,7 @@ export declare const rollupTemplateSchema: z.ZodObject<{
240
241
  text: "text";
241
242
  }>>;
242
243
  }, z.core.$strip>;
244
+ export declare const createdByTemplateSchema: z.ZodObject<{}, z.core.$strip>;
243
245
  export declare const updatedByTemplateSchema: z.ZodObject<{}, z.core.$strip>;
244
246
  export declare const userTemplateSchema: z.ZodObject<{
245
247
  allowMultiple: z.ZodPipe<z.ZodOptional<z.ZodNullable<z.ZodBoolean>>, z.ZodTransform<boolean, boolean | null | undefined>>;
@@ -554,6 +556,10 @@ export declare const publicFieldDefinitionSchema: z.ZodDiscriminatedUnion<[z.Zod
554
556
  text: "text";
555
557
  }>>;
556
558
  }, z.core.$strip>;
559
+ }, z.core.$strip>, z.ZodObject<{
560
+ name: z.ZodString;
561
+ type: z.ZodLiteral<"created_by">;
562
+ template: z.ZodObject<{}, z.core.$strip>;
557
563
  }, z.core.$strip>, z.ZodObject<{
558
564
  name: z.ZodString;
559
565
  type: z.ZodLiteral<"updated_by">;
@@ -661,6 +667,7 @@ export type FieldTemplateMap = {
661
667
  linked_record: z.infer<typeof linkedRecordTemplateSchema>;
662
668
  lookup: z.infer<typeof lookupTemplateSchema>;
663
669
  rollup: z.infer<typeof rollupTemplateSchema>;
670
+ created_by: z.infer<typeof createdByTemplateSchema>;
664
671
  updated_by: z.infer<typeof updatedByTemplateSchema>;
665
672
  user: z.infer<typeof userTemplateSchema>;
666
673
  source: z.infer<typeof sourceTemplateSchema>;
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.publicFieldDefinitionSchema = exports.updatedAtTemplateSchema = exports.createdAtTemplateSchema = exports.autonumberTemplateSchema = exports.formulaTemplateSchema = exports.sourceTemplateSchema = exports.userTemplateSchema = exports.updatedByTemplateSchema = exports.rollupTemplateSchema = exports.lookupTemplateSchema = exports.linkedRecordTemplateSchema = exports.percentTemplateSchema = exports.durationTemplateSchema = exports.ratingTemplateSchema = exports.phoneNumberTemplateSchema = exports.urlTemplateSchema = exports.emailTemplateSchema = exports.attachmentsTemplateSchema = exports.checkboxTemplateSchema = exports.datetimeTemplateSchema = exports.dateTemplateSchema = exports.multipleSelectTemplateSchema = exports.singleSelectTemplateSchema = exports.numberTemplateSchema = exports.richTextTemplateSchema = exports.longTextTemplateSchema = exports.singleLineTextTemplateSchema = exports.currencyTemplateSchema = exports.aiGenerationConfigSchema = exports.selectOptionSchema = exports.fieldTypeSchema = exports.fieldTypeEnum = exports.durationFormatEnum = exports.timeFormatEnum = exports.dateFormatEnum = exports.numberFormatEnum = void 0;
3
+ exports.publicFieldDefinitionSchema = exports.updatedAtTemplateSchema = exports.createdAtTemplateSchema = exports.autonumberTemplateSchema = exports.formulaTemplateSchema = exports.sourceTemplateSchema = exports.userTemplateSchema = exports.updatedByTemplateSchema = exports.createdByTemplateSchema = exports.rollupTemplateSchema = exports.lookupTemplateSchema = exports.linkedRecordTemplateSchema = exports.percentTemplateSchema = exports.durationTemplateSchema = exports.ratingTemplateSchema = exports.phoneNumberTemplateSchema = exports.urlTemplateSchema = exports.emailTemplateSchema = exports.attachmentsTemplateSchema = exports.checkboxTemplateSchema = exports.datetimeTemplateSchema = exports.dateTemplateSchema = exports.multipleSelectTemplateSchema = exports.singleSelectTemplateSchema = exports.numberTemplateSchema = exports.richTextTemplateSchema = exports.longTextTemplateSchema = exports.singleLineTextTemplateSchema = exports.currencyTemplateSchema = exports.aiGenerationConfigSchema = exports.selectOptionSchema = exports.fieldTypeSchema = exports.fieldTypeEnum = exports.durationFormatEnum = exports.timeFormatEnum = exports.dateFormatEnum = exports.numberFormatEnum = void 0;
4
4
  const zod_1 = require("zod");
5
5
  exports.numberFormatEnum = [
6
6
  "local",
@@ -45,6 +45,7 @@ exports.fieldTypeEnum = [
45
45
  "created_at",
46
46
  "updated_at",
47
47
  "rollup",
48
+ "created_by",
48
49
  "updated_by",
49
50
  "user",
50
51
  ];
@@ -183,6 +184,7 @@ exports.rollupTemplateSchema = zod_1.z.object({
183
184
  .enum(["text", "number", "date", "boolean", "array"])
184
185
  .optional(),
185
186
  });
187
+ exports.createdByTemplateSchema = zod_1.z.object({});
186
188
  exports.updatedByTemplateSchema = zod_1.z.object({});
187
189
  exports.userTemplateSchema = zod_1.z.object({
188
190
  allowMultiple: zod_1.z
@@ -329,6 +331,10 @@ exports.publicFieldDefinitionSchema = zod_1.z.discriminatedUnion("type", [
329
331
  type: zod_1.z.literal("rollup"),
330
332
  template: exports.rollupTemplateSchema,
331
333
  }),
334
+ basePublicFieldSchema.extend({
335
+ type: zod_1.z.literal("created_by"),
336
+ template: exports.createdByTemplateSchema,
337
+ }),
332
338
  basePublicFieldSchema.extend({
333
339
  type: zod_1.z.literal("updated_by"),
334
340
  template: exports.updatedByTemplateSchema,
@@ -253,6 +253,10 @@ export declare const fieldSchema: z.ZodIntersection<z.ZodObject<{
253
253
  text: "text";
254
254
  }>>;
255
255
  }, z.core.$strip>;
256
+ }, z.core.$strip>, z.ZodObject<{
257
+ name: z.ZodString;
258
+ type: z.ZodLiteral<"created_by">;
259
+ template: z.ZodObject<{}, z.core.$strip>;
256
260
  }, z.core.$strip>, z.ZodObject<{
257
261
  name: z.ZodString;
258
262
  type: z.ZodLiteral<"updated_by">;
@@ -605,6 +609,10 @@ export declare const tableSchema: z.ZodObject<{
605
609
  text: "text";
606
610
  }>>;
607
611
  }, z.core.$strip>;
612
+ }, z.core.$strip>, z.ZodObject<{
613
+ name: z.ZodString;
614
+ type: z.ZodLiteral<"created_by">;
615
+ template: z.ZodObject<{}, z.core.$strip>;
608
616
  }, z.core.$strip>, z.ZodObject<{
609
617
  name: z.ZodString;
610
618
  type: z.ZodLiteral<"updated_by">;
@@ -952,6 +960,10 @@ export declare const publicTableDefinitionSchema: z.ZodObject<{
952
960
  text: "text";
953
961
  }>>;
954
962
  }, z.core.$strip>;
963
+ }, z.core.$strip>, z.ZodObject<{
964
+ name: z.ZodString;
965
+ type: z.ZodLiteral<"created_by">;
966
+ template: z.ZodObject<{}, z.core.$strip>;
955
967
  }, z.core.$strip>, z.ZodObject<{
956
968
  name: z.ZodString;
957
969
  type: z.ZodLiteral<"updated_by">;
@@ -1301,6 +1313,10 @@ export declare const databaseSchema: z.ZodObject<{
1301
1313
  text: "text";
1302
1314
  }>>;
1303
1315
  }, z.core.$strip>;
1316
+ }, z.core.$strip>, z.ZodObject<{
1317
+ name: z.ZodString;
1318
+ type: z.ZodLiteral<"created_by">;
1319
+ template: z.ZodObject<{}, z.core.$strip>;
1304
1320
  }, z.core.$strip>, z.ZodObject<{
1305
1321
  name: z.ZodString;
1306
1322
  type: z.ZodLiteral<"updated_by">;
@@ -332,6 +332,11 @@ export interface ZiteStep {
332
332
  * In a run fired by a schedule, webhook or trigger, a step that throws is
333
333
  * tried again `retries` more times (default 3, at most 10), 30 seconds,
334
334
  * 2 minutes, then 10 minutes apart. Elsewhere its error fails the request.
335
+ * Once its tries are spent the code gets its error, and later calls of the
336
+ * run throw it there again, rebuilt as an `Error` with its `name`,
337
+ * `message` and plain fields such as `code` or `status`, so branch on
338
+ * those rather than on `instanceof`. A result over 256KB, or one JSON
339
+ * can't hold such as a cycle, fails the step without a retry.
335
340
  */
336
341
  run<T>(name: string, fn: () => Promise<T> | T, options?: ZiteStepOptions): Promise<T>;
337
342
  /**
@@ -342,7 +347,8 @@ export interface ZiteStep {
342
347
  *
343
348
  * The run continues in a later call, which runs `execute` again from the
344
349
  * top: finished steps return their saved results, and code outside a step
345
- * runs again, so keep side effects inside steps.
350
+ * runs again, so keep side effects inside steps. Call it between steps, not
351
+ * inside a step's code: a step can't pause halfway, so a sleep there throws.
346
352
  */
347
353
  sleep(name: string, duration: ZiteStepDuration): Promise<void>;
348
354
  /** Pause the run until `when`, at most 30 days ahead. See {@link ZiteStep.sleep}. */
@@ -20,10 +20,18 @@
20
20
  * "@babel/parser": "^7.26.0"
21
21
  */
22
22
  import * as esbuild from 'esbuild';
23
+ import { type SourceRoot } from '../sourceRoots.js';
23
24
  export declare const UNSUPPORTED_IN_WORKERD: Set<string>;
24
25
  export declare const BASE_BUILD_OPTIONS: esbuild.BuildOptions;
25
26
  export declare function createAliasPlugin(opts: {
26
27
  baseDir?: string;
27
28
  sdkPath?: string;
28
29
  }): esbuild.Plugin;
30
+ export interface EndpointBundleResult {
31
+ bundledEndpoints: Record<string, string>;
32
+ endpointErrors?: Record<string, string>;
33
+ bundledAuthHooks?: string;
34
+ authHooksError?: string;
35
+ }
36
+ export declare function bundleEndpoints(baseDir: string, root: SourceRoot, endpointNames: string[], logLevel: esbuild.LogLevel): Promise<EndpointBundleResult>;
29
37
  export declare function runBundle(): Promise<void>;
@@ -366,7 +366,7 @@ import endpoint from '${entryImport}';
366
366
  globalThis.__endpoint = endpoint;
367
367
  `;
368
368
  }
369
- async function bundleEndpointsImpl(baseDir, root, endpointNames) {
369
+ export async function bundleEndpoints(baseDir, root, endpointNames, logLevel) {
370
370
  const bundledEndpoints = {};
371
371
  const endpointErrors = {};
372
372
  const aliasPlugin = createAliasPlugin({ baseDir });
@@ -403,7 +403,7 @@ async function bundleEndpointsImpl(baseDir, root, endpointNames) {
403
403
  resolveDir: `${baseDir}/src`,
404
404
  loader: 'ts',
405
405
  },
406
- logLevel: 'warning',
406
+ logLevel,
407
407
  plugins: [aliasPlugin],
408
408
  });
409
409
  if (result.warnings && result.warnings.length > 0) {
@@ -473,7 +473,7 @@ globalThis.__endpoint = endpoint;
473
473
  resolveDir: `${baseDir}/src`,
474
474
  loader: 'ts',
475
475
  },
476
- logLevel: 'warning',
476
+ logLevel,
477
477
  plugins: [aliasPlugin],
478
478
  });
479
479
  if (result.outputFiles && result.outputFiles.length > 0) {
@@ -500,14 +500,12 @@ globalThis.__endpoint = endpoint;
500
500
  }
501
501
  }
502
502
  }
503
- const output = JSON.stringify({
503
+ return {
504
504
  bundledEndpoints,
505
505
  endpointErrors: Object.keys(endpointErrors).length > 0 ? endpointErrors : undefined,
506
506
  bundledAuthHooks,
507
507
  authHooksError,
508
- });
509
- fs.writeFileSync('/tmp/zitejs-bundle-result.json', output);
510
- console.log(output);
508
+ };
511
509
  }
512
510
  async function bundleOneOffScriptImpl(scriptPath, sdkPath) {
513
511
  const rawScript = fs.readFileSync(scriptPath, 'utf-8');
@@ -625,5 +623,7 @@ export async function runBundle() {
625
623
  endpointNames = listEndpointNames(root, baseDir);
626
624
  }
627
625
  // Even with no endpoints, zite.auth.ts may still need bundling.
628
- return bundleEndpointsImpl(baseDir, root, endpointNames);
626
+ const output = JSON.stringify(await bundleEndpoints(baseDir, root, endpointNames, 'warning'));
627
+ fs.writeFileSync('/tmp/zitejs-bundle-result.json', output);
628
+ console.log(output);
629
629
  }
@@ -1,7 +1,9 @@
1
1
  import { execFileSync } from 'child_process';
2
+ import * as esbuild from 'esbuild';
2
3
  import { existsSync } from 'fs';
3
- import { join } from 'path';
4
- import { listEndpointNames, listSourceDirs } from '../sourceRoots.js';
4
+ import { join, resolve } from 'path';
5
+ import { bundleEndpoints } from '../bundle/index.js';
6
+ import { listEndpointNames, listSourceDirs, } from '../sourceRoots.js';
5
7
  /**
6
8
  * An argument array, not a command string, so no shell is involved.
7
9
  *
@@ -25,28 +27,9 @@ function run(file, args, cwd) {
25
27
  return { ok: false, output: (e.stderr ?? '') + (e.stdout ?? '') };
26
28
  }
27
29
  }
28
- /**
29
- * `zitejs bundle` reports per-endpoint failures inside its JSON payload and
30
- * still exits 0, so a non-empty `endpointErrors` is the only signal there is.
31
- */
32
- function bundleFailures(output) {
33
- const line = output
34
- .trim()
35
- .split('\n')
36
- .reverse()
37
- .find(l => l.startsWith('{'));
38
- if (!line)
39
- return ['bundle produced no result'];
40
- let result;
41
- try {
42
- result = JSON.parse(line);
43
- }
44
- catch {
45
- return [`could not parse bundle output: ${line.slice(0, 200)}`];
46
- }
30
+ async function bundleFailures(root, appPath, endpointNames) {
31
+ const result = await bundleEndpoints(resolve(appPath), root, endpointNames, 'silent').finally(() => esbuild.stop());
47
32
  const failures = [];
48
- if (result.error)
49
- failures.push(result.error);
50
33
  for (const [name, err] of Object.entries(result.endpointErrors ?? {})) {
51
34
  failures.push(`${name}: ${err}`);
52
35
  }
@@ -62,7 +45,7 @@ export async function runCheck() {
62
45
  process.exit(1);
63
46
  }
64
47
  let allPassed = true;
65
- for (const { root, dir: app, path: appPath } of appDirs) {
48
+ for (const { root, path: appPath } of appDirs) {
66
49
  console.log(`\n── ${appPath} ──`);
67
50
  // Only tsconfig.app.json compiles anything. The app's tsconfig.json is a
68
51
  // solution-style config — `"files": []` plus a reference — so
@@ -89,10 +72,10 @@ export async function runCheck() {
89
72
  // Endpoints never reach vite — they are bundled separately for the lambda,
90
73
  // against a different resolver. tsc and vite both pass on an endpoint whose
91
74
  // `zitejs/*` alias has no generated file behind it; only the bundler knows.
92
- if (listEndpointNames(root, appPath).length > 0) {
75
+ const endpointNames = listEndpointNames(root, appPath);
76
+ if (endpointNames.length > 0) {
93
77
  process.stdout.write(' bundle endpoints ... ');
94
- const bundle = run('npx', ['zitejs', 'bundle', '--app', app], '.');
95
- const failures = bundle.ok ? bundleFailures(bundle.output) : [bundle.output];
78
+ const failures = await bundleFailures(root, appPath, endpointNames);
96
79
  if (failures.length === 0) {
97
80
  console.log('✓');
98
81
  }
@@ -275,6 +275,10 @@ export declare class Zite {
275
275
  sortEnabled?: boolean | undefined;
276
276
  resultType?: "number" | "boolean" | "date" | "array" | "text" | undefined;
277
277
  };
278
+ } | {
279
+ name: string;
280
+ type: "created_by";
281
+ template: globalThis.Record<string, never>;
278
282
  } | {
279
283
  name: string;
280
284
  type: "updated_by";
@@ -488,6 +492,10 @@ export declare class Zite {
488
492
  sortEnabled?: boolean | undefined;
489
493
  resultType?: "number" | "boolean" | "date" | "array" | "text" | undefined;
490
494
  };
495
+ } | {
496
+ name: string;
497
+ type: "created_by";
498
+ template: globalThis.Record<string, never>;
491
499
  } | {
492
500
  name: string;
493
501
  type: "updated_by";
@@ -711,6 +719,10 @@ export declare class Zite {
711
719
  sortEnabled?: boolean | undefined;
712
720
  resultType?: "number" | "boolean" | "date" | "array" | "text" | undefined;
713
721
  };
722
+ } | {
723
+ name: string;
724
+ type: "created_by";
725
+ template: globalThis.Record<string, never>;
714
726
  } | {
715
727
  name: string;
716
728
  type: "updated_by";
@@ -937,6 +949,10 @@ export declare class Zite {
937
949
  sortEnabled?: boolean | undefined;
938
950
  resultType?: "number" | "boolean" | "date" | "array" | "text" | undefined;
939
951
  };
952
+ } | {
953
+ name: string;
954
+ type: "created_by";
955
+ template: globalThis.Record<string, never>;
940
956
  } | {
941
957
  name: string;
942
958
  type: "updated_by";
@@ -1171,6 +1187,10 @@ export declare class Zite {
1171
1187
  sortEnabled?: boolean | undefined;
1172
1188
  resultType?: "number" | "boolean" | "date" | "array" | "text" | undefined;
1173
1189
  };
1190
+ } | {
1191
+ name: string;
1192
+ type: "created_by";
1193
+ template: globalThis.Record<string, never>;
1174
1194
  } | {
1175
1195
  name: string;
1176
1196
  type: "updated_by";
@@ -1406,6 +1426,10 @@ export declare class Zite {
1406
1426
  sortEnabled?: boolean | undefined;
1407
1427
  resultType?: "number" | "boolean" | "date" | "array" | "text" | undefined;
1408
1428
  };
1429
+ } | {
1430
+ name: string;
1431
+ type: "created_by";
1432
+ template: globalThis.Record<string, never>;
1409
1433
  } | {
1410
1434
  name: string;
1411
1435
  type: "updated_by";
@@ -85,20 +85,14 @@ export type FieldSelector<T> = Extract<keyof T, string> | (string & {});
85
85
  export interface TableFindAllOptions<T = Record<string, unknown>> {
86
86
  limit?: number;
87
87
  offset?: number;
88
- /**
89
- * IGNORED on the table path. `DatabasesFindAllParamsSchema` has no `sort`
90
- * key, so zod strips it before either dispatch, and neither destructures it.
91
- * Kept in the type because removing it would only turn a silent no-op into a
92
- * compile error for apps already passing it — the real fix is to forward it.
93
- * It DOES work on `zite.auth.findAllUsers`, which is dispatched separately.
94
- */
88
+ /** `[{ field, direction }]`, applied in order. */
95
89
  sort?: unknown[];
96
90
  filters?: RecordFilters<T>;
97
91
  /**
98
- * The nested filter format (`filters` is the legacy flat one). IGNORED here
99
- * for the same reason as `sort` — not in `DatabasesFindAllParamsSchema`, so
100
- * zod strips it — but kept so code already passing it still compiles. It IS
101
- * honored by `zite.auth.findAllUsers`.
92
+ * The nested filter format (`filters` is the legacy flat one). Ignored here:
93
+ * `DatabasesFindAllParamsSchema` has no `filter`, so zod strips it, but it's
94
+ * kept so code already passing it still compiles. `zite.auth.findAllUsers`
95
+ * honors it.
102
96
  */
103
97
  filter?: unknown;
104
98
  fields?: Array<FieldSelector<T>>;
@@ -0,0 +1,78 @@
1
+ import type { ZiteStep } from "../backend/index.js";
2
+ export declare const STEP_FAILURE_MEMO_KEY = "__ziteStepError";
3
+ export declare const STEP_FAILED_STEP_KEY = "__ziteFailedStep";
4
+ export declare const STEP_RESULT_MAX_BYTES: number;
5
+ export declare const STEP_SLEEP_MAX_MS: number;
6
+ export declare const STEP_DEFAULT_RETRIES = 3;
7
+ export declare const STEP_MAX_RETRIES = 10;
8
+ /** Why a durable call stops short. A retry outranks the other two. */
9
+ export type StepStop = {
10
+ kind: "retry";
11
+ name: string;
12
+ attempt: number;
13
+ error: unknown;
14
+ } | {
15
+ kind: "sleep";
16
+ name: string;
17
+ wakeAt: string;
18
+ } | {
19
+ kind: "step";
20
+ name: string;
21
+ };
22
+ /** A stop that isn't a failure: the run goes on at a wake time, or at once. */
23
+ export type StepSuspension = {
24
+ kind: "sleep";
25
+ name: string;
26
+ wakeAt: string;
27
+ } | {
28
+ kind: "step";
29
+ name: string;
30
+ };
31
+ /** A stop to try a step again: each failed step's next try, in the next call. */
32
+ export type StepRetry = {
33
+ step: string;
34
+ attempt: number;
35
+ attempts: Record<string, number>;
36
+ };
37
+ export type StepEventStatus = "ran" | "memoized" | "failed" | "sleeping" | "skipped";
38
+ export type StepRuntimeOptions = {
39
+ /** The run's saved steps by name, from earlier calls; filled in as steps save. */
40
+ memos: Record<string, unknown>;
41
+ /** A durable call may stop at a step for its orchestrator to call it again. */
42
+ durable: boolean;
43
+ /** Outside a durable call, what a sleep does: an editor test skips it, an app's request refuses it. */
44
+ sleeps?: "skip" | "refuse";
45
+ /** In a durable call, how long it starts new steps for. */
46
+ budgetMs?: number;
47
+ /**
48
+ * How long after the call starts `settle` waits for steps still working.
49
+ * A step past it runs again in the next call. Four minutes by default, so
50
+ * the call answers inside a five-minute request timeout.
51
+ */
52
+ deadlineMs?: number;
53
+ /** Which try each step that failed in an earlier call is on; others are on their first. */
54
+ attempts?: Record<string, number>;
55
+ /** Saves a step's result, or its final failure. Throws when it can't. */
56
+ save: (name: string, value: unknown, durationMs: number) => Promise<unknown>;
57
+ onEvent?: (name: string, status: StepEventStatus, durationMs?: number, extra?: Record<string, unknown>) => void;
58
+ /** Marks a failed save as the platform's failure rather than the app's. */
59
+ onPlatformFault?: (error: Error) => void;
60
+ now?: () => number;
61
+ };
62
+ export type StepRuntime = {
63
+ step: ZiteStep;
64
+ /** Resolves at the call's first stop. */
65
+ stopped: Promise<void>;
66
+ stop(): StepStop | undefined;
67
+ suspension(): StepSuspension | undefined;
68
+ retry(): StepRetry | undefined;
69
+ /** How many steps this call saved, sleeps included. */
70
+ saved(): number;
71
+ /**
72
+ * Waits for steps still doing work to save, including ones they start, but
73
+ * not for one stuck behind a stop, nor past the deadline.
74
+ */
75
+ settle(): Promise<void>;
76
+ };
77
+ export declare const isStepFailureMemo: (memo: unknown) => boolean;
78
+ export declare function createStepRuntime(options: StepRuntimeOptions): StepRuntime;