@palbase/backend 18.0.1 → 21.0.0

package/dist/index.js

@@ -1217,7 +1217,7 @@ function makeEnvDts(schema) {
 ${blocks.join("\n")}
   ` : "";
   return `// AUTO-GENERATED by @palbase/backend \u2014 DO NOT EDIT.
-// Regenerated from db/schema.ts on every \`palbase db types\` / deploy.
+// Regenerated from db/schema.ts by \`palbase build\` and by every deploy.
 // Augments the @palbase/backend/env \`Tables\` interface so \`Database.tables.*\`
 // is typed with no import and no generic.
 
@@ -1883,95 +1883,6 @@ var Patch = makeMethodDecorator("PATCH");
 var Delete = makeMethodDecorator("DELETE");
 var Query = makeMethodDecorator("QUERY");
 
-// src/decorators/upload.ts
-function Upload(subpath, config) {
-  const { auth: auth2, rateLimit, ...uploadConfig } = config;
-  validateUploadConfigShape(uploadConfig);
-  const options = {
-    uploadConfig,
-    ...auth2 !== void 0 ? { auth: auth2 } : {},
-    ...rateLimit !== void 0 ? { rateLimit } : {}
-  };
-  return function(target, propertyKey) {
-    recordRoute(target, String(propertyKey), "POST", subpath, options);
-  };
-}
-function UploadedObject() {
-  return function(target, propertyKey, parameterIndex) {
-    recordParam(target, String(propertyKey), {
-      index: parameterIndex,
-      kind: "uploadedObject"
-    });
-  };
-}
-function validateUploadConfigShape(c) {
-  if (c === null || typeof c !== "object") {
-    throw new Error("@Upload config must be an object { bucket, pathTemplate, ... }");
-  }
-  if (typeof c.bucket !== "string" || c.bucket.length === 0) {
-    throw new Error("@Upload config.bucket must be a non-empty bucket name");
-  }
-  if (typeof c.pathTemplate !== "string" || c.pathTemplate.length === 0) {
-    throw new Error("@Upload config.pathTemplate must be a non-empty key template");
-  }
-}
-function validateUploadAgainstStorage(uploadConfig, storage2, routeLabel) {
-  const def = storage2.buckets[uploadConfig.bucket];
-  if (def === void 0) {
-    const known = Object.keys(storage2.buckets);
-    throw new Error(
-      `@Upload route ${routeLabel} targets bucket "${uploadConfig.bucket}" which is not declared in defineStorage(...). ` + (known.length ? `Known buckets: ${known.join(", ")}.` : "No buckets are declared.")
-    );
-  }
-}
-
-// src/decorators/params.ts
-function makeParamDecorator(kind, extra) {
-  return function(target, propertyKey, parameterIndex) {
-    recordParam(target, String(propertyKey), {
-      index: parameterIndex,
-      kind,
-      ...extra?.schema !== void 0 ? { schema: extra.schema } : {},
-      ...extra?.name !== void 0 ? { name: extra.name } : {}
-    });
-  };
-}
-function Body(schema) {
-  return makeParamDecorator("body", { schema });
-}
-function QueryParams(schema) {
-  return makeParamDecorator("query", { schema });
-}
-function Headers(schema) {
-  return makeParamDecorator("headers", schema !== void 0 ? { schema } : void 0);
-}
-function Param(name) {
-  return makeParamDecorator("param", { name });
-}
-function User() {
-  return makeParamDecorator("user");
-}
-function OptionalUser() {
-  return makeParamDecorator("optionalUser");
-}
-function Client() {
-  return makeParamDecorator("client");
-}
-function RequestId() {
-  return makeParamDecorator("requestId");
-}
-function TraceId() {
-  return makeParamDecorator("traceId");
-}
-function Req() {
-  return makeParamDecorator("req");
-}
-
-// src/middleware.ts
-function defineMiddleware(fn) {
-  return fn;
-}
-
 // src/decorators/webhook.ts
 var WEBHOOK_META = /* @__PURE__ */ Symbol.for("palbase.backend.webhookMeta");
 var WEBHOOK_EVENTS = /* @__PURE__ */ Symbol.for("palbase.backend.webhookEvents");
@@ -2069,6 +1980,147 @@ function getWebhookConfig(ctor) {
   };
 }
 
+// src/decorators/hook.ts
+var Deny = class extends Error {
+  constructor(reason) {
+    super(reason);
+    this.name = "Deny";
+  }
+};
+var HOOK_BLOCKING = /* @__PURE__ */ Symbol.for("palbase.backend.hookBlocking");
+function Hook(event) {
+  return function(target, fnName) {
+    const carrier = target.constructor;
+    const existing = carrier[HOOK_BLOCKING];
+    const entries = existing ? [...existing] : [];
+    entries.push({ event, fnName: String(fnName) });
+    Object.defineProperty(carrier, HOOK_BLOCKING, {
+      value: entries,
+      enumerable: false,
+      configurable: true,
+      writable: false
+    });
+  };
+}
+function bind(instance, entries, kind) {
+  const out = /* @__PURE__ */ Object.create(null);
+  for (const entry of entries) {
+    if (Object.prototype.hasOwnProperty.call(out, entry.event)) {
+      throw new Error(`${kind}("${entry.event}") declared twice on the same hook class`);
+    }
+    const fn = instance[entry.fnName];
+    if (typeof fn !== "function") {
+      throw new Error(`${kind}("${entry.event}") names no method "${entry.fnName}" on the class`);
+    }
+    out[entry.event] = (event, meta) => fn.call(instance, event, meta);
+  }
+  return out;
+}
+function getHookConfig(ctor) {
+  const carrier = ctor;
+  const blockingEntries = carrier[HOOK_BLOCKING] ?? [];
+  const listenerEntries = carrier[WEBHOOK_EVENTS] ?? [];
+  if (blockingEntries.length === 0 && listenerEntries.length === 0) {
+    throw new Error(
+      `${ctor.name ?? "a hook class"} carries no handler \u2014 a hook file must declare at least one @Hook (blocking) or @On (listener) method`
+    );
+  }
+  const instance = new ctor();
+  return {
+    blocking: bind(instance, blockingEntries, "@Hook"),
+    listeners: bind(instance, listenerEntries, "@On")
+  };
+}
+
+// src/decorators/upload.ts
+function Upload(subpath, config) {
+  const { auth, rateLimit, ...uploadConfig } = config;
+  validateUploadConfigShape(uploadConfig);
+  const options = {
+    uploadConfig,
+    ...auth !== void 0 ? { auth } : {},
+    ...rateLimit !== void 0 ? { rateLimit } : {}
+  };
+  return function(target, propertyKey) {
+    recordRoute(target, String(propertyKey), "POST", subpath, options);
+  };
+}
+function UploadedObject() {
+  return function(target, propertyKey, parameterIndex) {
+    recordParam(target, String(propertyKey), {
+      index: parameterIndex,
+      kind: "uploadedObject"
+    });
+  };
+}
+function validateUploadConfigShape(c) {
+  if (c === null || typeof c !== "object") {
+    throw new Error("@Upload config must be an object { bucket, pathTemplate, ... }");
+  }
+  if (typeof c.bucket !== "string" || c.bucket.length === 0) {
+    throw new Error("@Upload config.bucket must be a non-empty bucket name");
+  }
+  if (typeof c.pathTemplate !== "string" || c.pathTemplate.length === 0) {
+    throw new Error("@Upload config.pathTemplate must be a non-empty key template");
+  }
+}
+function validateUploadAgainstStorage(uploadConfig, storage, routeLabel) {
+  const def = storage.buckets[uploadConfig.bucket];
+  if (def === void 0) {
+    const known = Object.keys(storage.buckets);
+    throw new Error(
+      `@Upload route ${routeLabel} targets bucket "${uploadConfig.bucket}" which is not declared in defineStorage(...). ` + (known.length ? `Known buckets: ${known.join(", ")}.` : "No buckets are declared.")
+    );
+  }
+}
+
+// src/decorators/params.ts
+function makeParamDecorator(kind, extra) {
+  return function(target, propertyKey, parameterIndex) {
+    recordParam(target, String(propertyKey), {
+      index: parameterIndex,
+      kind,
+      ...extra?.schema !== void 0 ? { schema: extra.schema } : {},
+      ...extra?.name !== void 0 ? { name: extra.name } : {}
+    });
+  };
+}
+function Body(schema) {
+  return makeParamDecorator("body", { schema });
+}
+function QueryParams(schema) {
+  return makeParamDecorator("query", { schema });
+}
+function Headers(schema) {
+  return makeParamDecorator("headers", schema !== void 0 ? { schema } : void 0);
+}
+function Param(name) {
+  return makeParamDecorator("param", { name });
+}
+function User() {
+  return makeParamDecorator("user");
+}
+function OptionalUser() {
+  return makeParamDecorator("optionalUser");
+}
+function Client() {
+  return makeParamDecorator("client");
+}
+function RequestId() {
+  return makeParamDecorator("requestId");
+}
+function TraceId() {
+  return makeParamDecorator("traceId");
+}
+function Req() {
+  return makeParamDecorator("req");
+}
+
+// src/middleware.ts
+function defineMiddleware(fn) {
+  return fn;
+}
+
 // src/job.ts
 function validateCronExpression(expression) {
   const trimmed = expression.trim();
@@ -2139,6 +2191,8 @@ function validateCronField(field, name, min, max) {
 // src/decorators/job.ts
 var DEFAULT_TIMEOUT_SECONDS = 30;
 var MAX_TIMEOUT_SECONDS = 300;
+var DEFAULT_RETRY = 5;
+var MAX_RETRY = 10;
 var JOB_META = /* @__PURE__ */ Symbol.for("palbase.backend.jobMeta");
 function Job(options) {
   return function(ctor) {
@@ -2179,12 +2233,19 @@ function getJobConfig(ctor) {
   if (timeout > MAX_TIMEOUT_SECONDS) {
     throw new Error(`@Job \`timeout\` exceeds the ${MAX_TIMEOUT_SECONDS}s sandbox ceiling`);
   }
+  const retry = meta.retry ?? DEFAULT_RETRY;
+  if (!Number.isInteger(retry) || retry < 0) {
+    throw new Error("@Job `retry` must be a whole number of attempts, zero or more");
+  }
+  if (retry > MAX_RETRY) {
+    throw new Error(`@Job \`retry\` exceeds the ceiling of ${MAX_RETRY}`);
+  }
   const instance = new ctor();
   if (typeof instance.run !== "function") {
     throw new Error("@Job class must declare an async run() method");
   }
   const run = instance.run.bind(instance);
-  return { schedule: meta.schedule, timeout, handler: run };
+  return { schedule: meta.schedule, timeout, retry, handler: run };
 }
 
 // src/resource.ts
@@ -2233,41 +2294,6 @@ async function __shutdownResources() {
   registry.length = 0;
 }
 
-// src/hooks.ts
-var auth = {
-  onUserCreated(handler) {
-    return { module: "auth", event: "user.created", handler };
-  },
-  onSignIn(handler) {
-    return { module: "auth", event: "user.sign_in", handler };
-  },
-  onSignOut(handler) {
-    return { module: "auth", event: "user.sign_out", handler };
-  },
-  onPasswordReset(handler) {
-    return { module: "auth", event: "user.password_reset", handler };
-  }
-};
-var storage = {
-  onFileUploaded(handler) {
-    return { module: "storage", event: "file.uploaded", handler };
-  },
-  onFileDeleted(handler) {
-    return { module: "storage", event: "file.deleted", handler };
-  }
-};
-var documents = {
-  onDocumentCreated(handler) {
-    return { module: "documents", event: "document.created", handler };
-  },
-  onDocumentUpdated(handler) {
-    return { module: "documents", event: "document.updated", handler };
-  },
-  onDocumentDeleted(handler) {
-    return { module: "documents", event: "document.deleted", handler };
-  }
-};
-
 // src/index.ts
 import { z } from "zod";
 export {
@@ -2280,6 +2306,7 @@ export {
   DEFAULT_TEMPLATE_LOCALE,
   Database,
   Delete,
+  Deny,
   Documents,
   EGRESS_CONFIG_KIND,
   EGRESS_TIMEOUT_DEFAULT_MS,
@@ -2291,6 +2318,7 @@ export {
   Forbidden,
   Get,
   Headers,
+  Hook,
   HttpError,
   Job,
   Log,
@@ -2340,7 +2368,6 @@ export {
   __runWithRuntime,
   __setRuntime,
   __shutdownResources,
-  auth,
   bigint,
   boolean,
   bucket,
@@ -2356,12 +2383,12 @@ export {
   defineSecrets,
   defineStorage,
   defineTestUsers,
-  documents,
   entitlementFor,
   enumType,
   extractVariables,
   flag,
   getErrorRegistry,
+  getHookConfig,
   getJobConfig,
   getRegisteredControllers,
   getRoutes,
@@ -2383,7 +2410,6 @@ export {
   reservedSecretKey,
   secret,
   spendFor,
-  storage,
   testUser,
   text,
   timestamp,