@palbase/backend 18.0.0 → 20.0.0

package/dist/index.js

@@ -940,13 +940,13 @@ function buildBucketClient(http, bucketName) {
     },
     async remove(paths) {
       for (const p of paths) validateStoragePath(p);
-      const removed = [];
+      const removed2 = [];
       for (const p of paths) {
         const res = await http.request("DELETE", objectPath(p));
         if (res.error) return { data: null, error: res.error, status: res.status };
-        removed.push(toFileObject(bucketName, { path: p }));
+        removed2.push(toFileObject(bucketName, { path: p }));
       }
-      return { data: removed, error: null, status: 200 };
+      return { data: removed2, error: null, status: 200 };
     },
     async move(from, to) {
       validateStoragePath(from);
@@ -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: 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/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
@@ -2234,38 +2295,31 @@ async function __shutdownResources() {
 }
 
 // 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 };
+function removed(helper, decorator, event) {
+  throw new Error(
+    `${helper}() does not register anything and never did \u2014 nothing in the runtime or the bundler reads what it returns, so the handler you passed would never run. Declare it instead in hooks/<name>.ts:
+
+  export default class MyHooks {
+    ${decorator}("${event}")
+    async handle(event, meta) { /* \u2026 */ }
   }
+`
+  );
+}
+var auth = {
+  onUserCreated: (_h) => removed("auth.onUserCreated", "@Hook", "before.user.create"),
+  onSignIn: (_h) => removed("auth.onSignIn", "@Hook", "before.login"),
+  onSignOut: (_h) => removed("auth.onSignOut", "@On", "after.session.revoke"),
+  onPasswordReset: (_h) => removed("auth.onPasswordReset", "@Hook", "before.password.reset")
 };
 var storage = {
-  onFileUploaded(handler) {
-    return { module: "storage", event: "file.uploaded", handler };
-  },
-  onFileDeleted(handler) {
-    return { module: "storage", event: "file.deleted", handler };
-  }
+  onFileUploaded: (_h) => removed("storage.onFileUploaded", "@On", "file.uploaded"),
+  onFileDeleted: (_h) => removed("storage.onFileDeleted", "@On", "file.deleted")
 };
 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 };
-  }
+  onDocumentCreated: (_h) => removed("documents.onDocumentCreated", "@On", "document.created"),
+  onDocumentUpdated: (_h) => removed("documents.onDocumentUpdated", "@On", "document.updated"),
+  onDocumentDeleted: (_h) => removed("documents.onDocumentDeleted", "@On", "document.deleted")
 };
 
 // src/index.ts
@@ -2280,6 +2334,7 @@ export {
   DEFAULT_TEMPLATE_LOCALE,
   Database,
   Delete,
+  Deny,
   Documents,
   EGRESS_CONFIG_KIND,
   EGRESS_TIMEOUT_DEFAULT_MS,
@@ -2291,6 +2346,7 @@ export {
   Forbidden,
   Get,
   Headers,
+  Hook,
   HttpError,
   Job,
   Log,
@@ -2362,6 +2418,7 @@ export {
   extractVariables,
   flag,
   getErrorRegistry,
+  getHookConfig,
   getJobConfig,
   getRegisteredControllers,
   getRoutes,