@palbase/backend 11.0.0 → 12.0.0

package/docs/background.md

@@ -40,22 +40,21 @@ await Queue.push("process-order", { orderId: "ord_1", amount: 1000 });
 
 ## Jobs (cron-scheduled)
 
-A job runs on a cron schedule. File lives under `jobs/`.
+A job runs on a cron schedule. File lives under `jobs/` — the job's name is
+the file name, there is no `name` option.
 
 ```ts
 // jobs/cleanup.ts
-import { defineJob, Database, Log } from "@palbase/backend";
+import { Database, Job, Log, type JobMeta } from "@palbase/backend";
 
-export default defineJob({
-  name: "cleanup-expired",
-  schedule: "0 3 * * *",       // standard cron
-  timeout: 120,                // optional, seconds
-  handler: async (meta) => {
+@Job({ schedule: "0 3 * * *", timeout: 120 }) // schedule: standard cron; timeout: optional, seconds
+export default class CleanupJob {
+  async run(meta: JobMeta) {
     const expired = await Database.findMany("sessions", { expired: true });
     for (const s of expired) await Database.delete("sessions", s.id as string);
     Log.info(`cleaned ${expired.length} sessions in ${meta.environmentId}`);
-  },
-});
+  }
+}
 ```
 
 `meta` shape: `{ env, environmentId }`. No `user` (jobs are

package/docs/events.md

@@ -39,29 +39,32 @@ Available hook builders: `auth.onUserCreated`, `auth.onSignIn`, `auth.onSignOut`
 ## Webhooks (inbound provider events)
 
 Receive and verify webhooks from third-party providers. Files live under
-`webhooks/`.
+`webhooks/` — the URL is `POST /webhooks/<file-name>` (e.g. `webhooks/stripe.ts`
+→ `POST /webhooks/stripe`); there is no `path` option.
 
 ```ts
 // webhooks/stripe.ts
-import { defineWebhook, Database, Log } from "@palbase/backend";
+import { Database, Log, On, Webhook, type WebhookMeta } from "@palbase/backend";
 
-export default defineWebhook({
-  provider: "stripe",
-  secret: { env: "STRIPE_WEBHOOK_SECRET" },   // signing secret resolved from env
-  events: {
-    "checkout.session.completed": async (event, meta) => {
-      await Database.insert("orders", { status: "paid", data: event });
-    },
-    "payment_intent.payment_failed": async (event, meta) => {
-      Log.error("payment failed");
-      await Database.insert("payment_failures", { data: event });
-    },
-  },
-});
+@Webhook({ provider: "stripe", secret: { env: "STRIPE_WEBHOOK_SECRET" } }) // signing secret resolved from env
+export default class StripeWebhook {
+  @On("checkout.session.completed")
+  async checkoutCompleted(event: unknown, meta: WebhookMeta) {
+    await Database.insert("orders", { status: "paid", data: event });
+  }
+
+  @On("payment_intent.payment_failed")
+  async paymentFailed(event: unknown, meta: WebhookMeta) {
+    Log.error("payment failed");
+    await Database.insert("payment_failures", { data: event });
+  }
+}
 ```
 
-The signing secret is resolved by the runtime from `secret: { env: "NAME" }`;
-your handlers access Environment variables via `meta.env`. The runtime verifies the
+`provider` selects a preset signature scheme; a service with no preset spells
+one out with `signature` instead — one of the two is required. The signing
+secret is resolved by the runtime from `secret: { env: "NAME" }`; your
+handlers access Environment variables via `meta.env`. The runtime verifies the
 signature before dispatching to your event handlers.
 
 `meta` shape: `{ env, requestId, environmentId }`.

package/docs/llms-full.txt

@@ -1597,22 +1597,21 @@ await Queue.push("process-order", { orderId: "ord_1", amount: 1000 });
 
 ## Jobs (cron-scheduled)
 
-A job runs on a cron schedule. File lives under `jobs/`.
+A job runs on a cron schedule. File lives under `jobs/` — the job's name is
+the file name, there is no `name` option.
 
 ```ts
 // jobs/cleanup.ts
-import { defineJob, Database, Log } from "@palbase/backend";
+import { Database, Job, Log, type JobMeta } from "@palbase/backend";
 
-export default defineJob({
-  name: "cleanup-expired",
-  schedule: "0 3 * * *",       // standard cron
-  timeout: 120,                // optional, seconds
-  handler: async (meta) => {
+@Job({ schedule: "0 3 * * *", timeout: 120 }) // schedule: standard cron; timeout: optional, seconds
+export default class CleanupJob {
+  async run(meta: JobMeta) {
     const expired = await Database.findMany("sessions", { expired: true });
     for (const s of expired) await Database.delete("sessions", s.id as string);
     Log.info(`cleaned ${expired.length} sessions in ${meta.environmentId}`);
-  },
-});
+  }
+}
 ```
 
 `meta` shape: `{ env, environmentId }`. No `user` (jobs are
@@ -1663,29 +1662,32 @@ Available hook builders: `auth.onUserCreated`, `auth.onSignIn`, `auth.onSignOut`
 ## Webhooks (inbound provider events)
 
 Receive and verify webhooks from third-party providers. Files live under
-`webhooks/`.
+`webhooks/` — the URL is `POST /webhooks/<file-name>` (e.g. `webhooks/stripe.ts`
+→ `POST /webhooks/stripe`); there is no `path` option.
 
 ```ts
 // webhooks/stripe.ts
-import { defineWebhook, Database, Log } from "@palbase/backend";
-
-export default defineWebhook({
-  provider: "stripe",
-  secret: { env: "STRIPE_WEBHOOK_SECRET" },   // signing secret resolved from env
-  events: {
-    "checkout.session.completed": async (event, meta) => {
-      await Database.insert("orders", { status: "paid", data: event });
-    },
-    "payment_intent.payment_failed": async (event, meta) => {
-      Log.error("payment failed");
-      await Database.insert("payment_failures", { data: event });
-    },
-  },
-});
+import { Database, Log, On, Webhook, type WebhookMeta } from "@palbase/backend";
+
+@Webhook({ provider: "stripe", secret: { env: "STRIPE_WEBHOOK_SECRET" } }) // signing secret resolved from env
+export default class StripeWebhook {
+  @On("checkout.session.completed")
+  async checkoutCompleted(event: unknown, meta: WebhookMeta) {
+    await Database.insert("orders", { status: "paid", data: event });
+  }
+
+  @On("payment_intent.payment_failed")
+  async paymentFailed(event: unknown, meta: WebhookMeta) {
+    Log.error("payment failed");
+    await Database.insert("payment_failures", { data: event });
+  }
+}
 ```
 
-The signing secret is resolved by the runtime from `secret: { env: "NAME" }`;
-your handlers access Environment variables via `meta.env`. The runtime verifies the
+`provider` selects a preset signature scheme; a service with no preset spells
+one out with `signature` instead — one of the two is required. The signing
+secret is resolved by the runtime from `secret: { env: "NAME" }`; your
+handlers access Environment variables via `meta.env`. The runtime verifies the
 signature before dispatching to your event handlers.
 
 `meta` shape: `{ env, requestId, environmentId }`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@palbase/backend",
-  "version": "11.0.0",
+  "version": "12.0.0",
   "description": "Palbase Backend SDK — class controllers (@Controller/@Get/@Post + @Body/@QueryParams/@Param), error classes, schema DSL",
   "license": "MIT",
   "repository": {