@palbase/backend 3.0.0 → 4.0.0

package/dist/index.js

@@ -11,18 +11,23 @@ import {
   __requestALS,
   __runWithRuntime,
   __setRuntime
-} from "./chunk-PHAFZGHN.js";
+} from "./chunk-WUQO76NW.js";
 import {
+  EXTENSION_DEPENDENCIES,
+  PALBASE_EXTENSIONS,
+  PolicyBuilder,
   boolean,
   defineSchema,
   enumType,
   integer,
+  isPalbaseExtension,
   jsonb,
   makeTypedDB,
+  policy,
   text,
   timestamp,
   uuid
-} from "./chunk-B7EUJP5W.js";
+} from "./chunk-EG7TTYHY.js";
 
 // src/db/env-gen.ts
 function baseTsType(def) {
@@ -93,26 +98,145 @@ export {};
 `;
 }
 
-// src/handler.ts
-function defineHandler(config) {
-  return { __palbase: "handler", ...config };
+// src/decorators/controller.ts
+var CONTROLLER_META = /* @__PURE__ */ Symbol.for("palbase.backend.controllerMeta");
+function Controller(basePath, options = {}) {
+  return function(ctor) {
+    const carrier = ctor;
+    const meta = {
+      __palbase: "controller",
+      basePath,
+      ...options.auth !== void 0 ? { defaultAuth: options.auth } : {}
+    };
+    Object.defineProperty(carrier, CONTROLLER_META, {
+      value: meta,
+      enumerable: false,
+      configurable: true,
+      writable: false
+    });
+    Object.defineProperty(carrier, "__palbase", {
+      value: "controller",
+      enumerable: false,
+      configurable: true,
+      writable: false
+    });
+    return ctor;
+  };
 }
 
-// src/controller.ts
-function makeRoute(method) {
-  return function(path, handler) {
-    return { __palbase: "route", method, path, handler };
+// src/decorators/registry.ts
+var ROUTES = /* @__PURE__ */ Symbol.for("palbase.backend.routes");
+var PARAM_BUFFER = /* @__PURE__ */ Symbol.for("palbase.backend.paramBuffer");
+function carrierOf(target) {
+  const ctor = typeof target === "function" ? target : target.constructor ?? target;
+  return ctor;
+}
+function ownRoutes(carrier) {
+  if (!Object.prototype.hasOwnProperty.call(carrier, ROUTES)) {
+    carrier[ROUTES] = [];
+  }
+  return carrier[ROUTES];
+}
+function ownParamBuffer(carrier) {
+  if (!Object.prototype.hasOwnProperty.call(carrier, PARAM_BUFFER)) {
+    carrier[PARAM_BUFFER] = {};
+  }
+  return carrier[PARAM_BUFFER];
+}
+function recordRoute(target, fnName, method, subpath, options) {
+  const carrier = carrierOf(target);
+  const routes = ownRoutes(carrier);
+  const buffer = ownParamBuffer(carrier);
+  const params = (buffer[fnName] ?? []).slice().sort((a, b) => a.index - b.index);
+  routes.push({ method, subpath, fnName, options, params });
+}
+function recordParam(target, fnName, meta) {
+  const carrier = carrierOf(target);
+  const buffer = ownParamBuffer(carrier);
+  (buffer[fnName] ??= []).push(meta);
+  const routes = carrier[ROUTES];
+  if (routes) {
+    const route = routes.find((r) => r.fnName === fnName);
+    if (route) {
+      route.params.push(meta);
+      route.params.sort((a, b) => a.index - b.index);
+    }
+  }
+}
+var RETURN_BUFFER = /* @__PURE__ */ Symbol.for("palbase.backend.returnBuffer");
+function recordReturn(target, fnName, schema) {
+  const carrier = carrierOf(target);
+  const routes = carrier[ROUTES];
+  const route = routes?.find((r) => r.fnName === fnName);
+  if (route) {
+    route.returnSchema = schema;
+    return;
+  }
+  if (!Object.prototype.hasOwnProperty.call(carrier, RETURN_BUFFER)) {
+    carrier[RETURN_BUFFER] = {};
+  }
+  carrier[RETURN_BUFFER][fnName] = schema;
+}
+
+// src/decorators/methods.ts
+function makeMethodDecorator(method) {
+  return function(subpath, options = {}) {
+    return function(target, propertyKey) {
+      recordRoute(target, String(propertyKey), method, subpath, options);
+    };
   };
 }
-var route = {
-  get: makeRoute("GET"),
-  post: makeRoute("POST"),
-  put: makeRoute("PUT"),
-  patch: makeRoute("PATCH"),
-  delete: makeRoute("DELETE")
-};
-function defineController(basePath, routes) {
-  return { __palbase: "controller", basePath, routes };
+var Get = makeMethodDecorator("GET");
+var Post = makeMethodDecorator("POST");
+var Put = makeMethodDecorator("PUT");
+var Patch = makeMethodDecorator("PATCH");
+var Delete = makeMethodDecorator("DELETE");
+function Returns(schema) {
+  return function(target, propertyKey) {
+    recordReturn(target, String(propertyKey), schema);
+  };
+}
+
+// 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 Query(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
@@ -157,6 +281,52 @@ var HttpError = class extends Error {
     return result;
   }
 };
+var PalError = class extends HttpError {
+  constructor(status, code, description, data) {
+    super(status, code, description, data);
+    this.name = "PalError";
+  }
+};
+var NamedHttpError = class extends HttpError {
+  constructor(status, defaultCode, name, message, code, data) {
+    super(status, code ?? defaultCode, message ?? defaultMessage(name), data);
+    this.name = name;
+  }
+};
+function defaultMessage(name) {
+  const spaced = name.replace(/([a-z0-9])([A-Z])/g, "$1 $2");
+  return spaced.charAt(0).toUpperCase() + spaced.slice(1).toLowerCase();
+}
+var BadRequest = class extends NamedHttpError {
+  constructor(message, code, data) {
+    super(400, "bad_request", "BadRequest", message, code, data);
+  }
+};
+var Unauthorized = class extends NamedHttpError {
+  constructor(message, code, data) {
+    super(401, "unauthorized", "Unauthorized", message, code, data);
+  }
+};
+var Forbidden = class extends NamedHttpError {
+  constructor(message, code, data) {
+    super(403, "forbidden", "Forbidden", message, code, data);
+  }
+};
+var NotFound = class extends NamedHttpError {
+  constructor(message, code, data) {
+    super(404, "not_found", "NotFound", message, code, data);
+  }
+};
+var Conflict = class extends NamedHttpError {
+  constructor(message, code, data) {
+    super(409, "conflict", "Conflict", message, code, data);
+  }
+};
+var TooManyRequests = class extends NamedHttpError {
+  constructor(message, code, data) {
+    super(429, "too_many_requests", "TooManyRequests", message, code, data);
+  }
+};
 
 // src/worker.ts
 var VALID_WORKER_NAME = /^[a-zA-Z0-9_-]+$/;
@@ -458,16 +628,43 @@ var documents = {
 // src/index.ts
 import { z } from "zod";
 export {
+  BadRequest,
+  Body,
   Cache,
+  Client,
+  Conflict,
+  Controller,
   Database,
+  Delete,
   Documents,
+  EXTENSION_DEPENDENCIES,
   Flags,
+  Forbidden,
+  Get,
+  Headers,
   HttpError,
   Log,
+  NotFound,
   Notifications,
+  OptionalUser,
+  PALBASE_EXTENSIONS,
+  PalError,
+  Param,
+  Patch,
+  PolicyBuilder,
+  Post,
+  Put,
+  Query,
   Queue,
+  Req,
+  RequestId,
   Resource,
+  Returns,
   Storage,
+  TooManyRequests,
+  TraceId,
+  Unauthorized,
+  User,
   __getRuntime,
   __registerResource,
   __requestALS,
@@ -477,8 +674,6 @@ export {
   __shutdownResources,
   auth,
   boolean,
-  defineController,
-  defineHandler,
   defineJob,
   defineMiddleware,
   defineSchema,
@@ -487,10 +682,11 @@ export {
   documents,
   enumType,
   integer,
+  isPalbaseExtension,
   jsonb,
   makeEnvDts,
   makeTypedDB,
-  route,
+  policy,
   storage,
   text,
   timestamp,