@palbase/backend 2.0.2 → 4.0.0

package/dist/index.js

@@ -10,25 +10,233 @@ import {
   __getRuntime,
   __requestALS,
   __runWithRuntime,
-  __setRuntime,
-  makeTypedDB,
-  typedDatabase
-} from "./chunk-L36JLUPO.js";
+  __setRuntime
+} from "./chunk-WUQO76NW.js";
 import {
+  EXTENSION_DEPENDENCIES,
+  PALBASE_EXTENSIONS,
+  PolicyBuilder,
   boolean,
   defineSchema,
   enumType,
   integer,
+  isPalbaseExtension,
   jsonb,
-  table,
+  makeTypedDB,
+  policy,
   text,
   timestamp,
   uuid
-} from "./chunk-4J3F32SH.js";
+} from "./chunk-EG7TTYHY.js";
+
+// src/db/env-gen.ts
+function baseTsType(def) {
+  switch (def.type) {
+    case "uuid":
+    case "text":
+    case "timestamp":
+      return "string";
+    case "integer":
+      return "number";
+    case "boolean":
+      return "boolean";
+    case "jsonb":
+      return "unknown";
+    case "enum": {
+      const values = def.enumValues ?? [];
+      if (values.length === 0) return "string";
+      return values.map((v) => JSON.stringify(v)).join(" | ");
+    }
+    default:
+      return "unknown";
+  }
+}
+function rowType(def) {
+  const base = baseTsType(def);
+  return def.nullable ? `${base} | null` : base;
+}
+function optionalOnInsert(def) {
+  return def.nullable === true || def.defaultRandom === true || def.defaultNow === true || def.defaultValue !== void 0;
+}
+function tableBlock(table, indent) {
+  const cols = Object.entries(table.columns);
+  const rowLines = cols.map(([col, builder]) => {
+    return `${indent}    ${col}: ${rowType(builder._def)};`;
+  });
+  const insertLines = cols.map(([col, builder]) => {
+    const def = builder._def;
+    const opt = optionalOnInsert(def) ? "?" : "";
+    return `${indent}    ${col}${opt}: ${rowType(def)};`;
+  });
+  return [
+    `${indent}${table.name}: {`,
+    `${indent}  row: {`,
+    ...rowLines,
+    `${indent}  };`,
+    `${indent}  insert: {`,
+    ...insertLines,
+    `${indent}  };`,
+    `${indent}};`
+  ].join("\n");
+}
+function makeEnvDts(schema) {
+  const tableNames = Object.keys(schema.tables);
+  const blocks = tableNames.map((name) => tableBlock(schema.tables[name], "    "));
+  const body = blocks.length > 0 ? `
+${blocks.join("\n")}
+  ` : "";
+  return `// AUTO-GENERATED by @palbase/backend \u2014 DO NOT EDIT.
+// Regenerated from db/schema.ts on every \`palbase serve\` / deploy.
+// Augments the @palbase/backend/env \`Tables\` interface so \`Database.tables.*\`
+// is typed with no import and no generic.
+
+declare module "@palbase/backend/env" {
+  interface Tables {${body}}
+}
+
+export {};
+`;
+}
+
+// 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/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/endpoint.ts
-function defineEndpoint(config) {
-  return config;
+// src/decorators/methods.ts
+function makeMethodDecorator(method) {
+  return function(subpath, options = {}) {
+    return function(target, propertyKey) {
+      recordRoute(target, String(propertyKey), method, subpath, options);
+    };
+  };
+}
+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
@@ -73,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_-]+$/;
@@ -290,6 +544,52 @@ function validateCustomWebhook(config) {
   };
 }
 
+// src/resource.ts
+var Resource = class {
+  /** The env-var names this resource needs. Optional; omit for none. */
+  static secrets;
+};
+function hasSecrets(value) {
+  if (typeof value !== "object" && typeof value !== "function") return false;
+  const secrets = value.secrets;
+  return secrets === void 0 || Array.isArray(secrets);
+}
+var registry = [];
+function __registerResource(resource) {
+  registry.push({ resource, booted: false });
+}
+function declaredSecrets(resource) {
+  const ctor = resource.constructor;
+  return hasSecrets(ctor) ? ctor.secrets ?? [] : [];
+}
+async function __runResourceBoot(envMap) {
+  for (const entry of registry) {
+    if (entry.booted) continue;
+    const secrets = declaredSecrets(entry.resource);
+    const env = {};
+    for (const name of secrets) {
+      const value = envMap[name];
+      if (value === void 0) {
+        throw new Error(
+          `Resource ${entry.resource.constructor.name} requires secret "${name}" but it is not set. Set it with \`palbase secret set ${name} ...\` (or in Studio) and redeploy.`
+        );
+      }
+      env[name] = value;
+    }
+    await entry.resource.init(env);
+    entry.booted = true;
+  }
+}
+async function __shutdownResources() {
+  for (let i = registry.length - 1; i >= 0; i -= 1) {
+    const entry = registry[i];
+    if (entry.booted && entry.resource.shutdown) {
+      await entry.resource.shutdown();
+    }
+  }
+  registry.length = 0;
+}
+
 // src/hooks.ts
 var auth = {
   onUserCreated(handler) {
@@ -328,22 +628,52 @@ 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,
+  __runResourceBoot,
   __runWithRuntime,
   __setRuntime,
+  __shutdownResources,
   auth,
   boolean,
-  defineEndpoint,
   defineJob,
   defineMiddleware,
   defineSchema,
@@ -352,13 +682,14 @@ export {
   documents,
   enumType,
   integer,
+  isPalbaseExtension,
   jsonb,
+  makeEnvDts,
   makeTypedDB,
+  policy,
   storage,
-  table,
   text,
   timestamp,
-  typedDatabase,
   uuid,
   z
 };