sst-http 2.0.0-beta.10 → 2.0.0-beta.16

package/README.md

@@ -174,7 +174,8 @@ export default $config({
     } = await import("sst-http/infra");
 
     const manifest = loadRoutesManifest("routes.manifest.json");
-    const { api, registerRoute, ensureJwtAuthorizer } = httpApiAdapter({ apiName: "Api" });
+    const api = new sst.aws.ApiGatewayV2("Api");
+    const { registerRoute, ensureJwtAuthorizer } = httpApiAdapter({ api });
 
     const handler = new sst.aws.Function("Handler", {
       handler: "src/server.handler",
@@ -185,7 +186,7 @@ export default $config({
 
     wireApiFromManifest(manifest, {
       handler,
-      firebaseProjectId: process.env.FIREBASE_PROJECT_ID!,
+      firebaseProjectId: process.env.FIREBASE_PROJECT_ID,
       registerRoute,
       ensureJwtAuthorizer,
     });
@@ -195,6 +196,15 @@ export default $config({
 });
 ```
 
+**Note:** `firebaseProjectId` and `ensureJwtAuthorizer` are optional and only required when your manifest contains routes with `@FirebaseAuth()`. For event-only handlers (no HTTP routes), you can omit `registerRoute` and `ensureJwtAuthorizer`:
+
+```ts
+wireApiFromManifest(manifest, {
+  handler,
+  registerRoute: (_method, _path, _config) => {},
+});
+```
+
 When the manifest contains events (from `@On()` decorators), handlers are automatically subscribed to the default EventBridge bus. Swap in `restApiAdapter` if you prefer API Gateway REST APIs—the wiring contract is identical.
 
 ## Publishing

package/dist/infra.cjs

@@ -78,6 +78,7 @@ function resolveHandlerInput(handler) {
 
 // src/bus/infra.ts
 var MAX_SUBSCRIBER_NAME_LENGTH = 60;
+var bus;
 function wireEventsFromManifest(events, opts) {
   if (!events || events.length === 0) {
     return;
@@ -90,17 +91,17 @@ function wireEventsFromManifest(events, opts) {
     if (seen.has(key)) {
       continue;
     }
+    if (!bus) bus = aws2.Bus.get("default", "default");
     seen.add(key);
-    const bus = aws2.Bus.get("default", "default");
     const subscriberName = buildSubscriberName(event.event);
     subscribeToBus(bus, subscriberName, subscriber, event.event);
   }
 }
-function subscribeToBus(bus, subscriberName, subscriber, eventName) {
-  if (typeof bus.subscribe !== "function") {
+function subscribeToBus(bus2, subscriberName, subscriber, eventName) {
+  if (typeof bus2.subscribe !== "function") {
     throw new Error("Bus instance does not support subscribe().");
   }
-  bus.subscribe(subscriberName, subscriber, {
+  bus2.subscribe(subscriberName, subscriber, {
     pattern: {
       detailType: [eventName]
     }
@@ -137,8 +138,7 @@ function wireRoutesFromManifest(manifest, opts) {
   }
 }
 function httpApiAdapter(args) {
-  const aws2 = args?.api ? void 0 : ensureSstAws(args);
-  const api = args?.api ?? new aws2.ApiGatewayV2(args?.apiName ?? "HttpApi", args?.apiArgs);
+  const api = args.api;
   const ensureJwtAuthorizer = createHttpAuthorizerManager(api);
   const registerRoute = createRouteRegistrar(api, "ApiGatewayV2");
   return {
@@ -148,8 +148,7 @@ function httpApiAdapter(args) {
   };
 }
 function restApiAdapter(args) {
-  const aws2 = args?.api ? void 0 : ensureSstAws(args);
-  const api = args?.api ?? new aws2.ApiGateway(args?.apiName ?? "RestApi", args?.apiArgs);
+  const api = args.api;
   const ensureJwtAuthorizer = createRestAuthorizerManager(api);
   const registerRoute = createRouteRegistrar(api, "ApiGateway");
   return {
@@ -165,6 +164,9 @@ function ensureFirebaseAuthorizer(firebaseRouteCount, opts) {
   if (!opts.firebaseProjectId) {
     throw new Error("firebaseProjectId is required when using @FirebaseAuth()");
   }
+  if (!opts.ensureJwtAuthorizer) {
+    throw new Error("ensureJwtAuthorizer is required when using @FirebaseAuth()");
+  }
   const issuer = `https://securetoken.google.com/${opts.firebaseProjectId}`;
   return opts.ensureJwtAuthorizer("firebase", {
     issuer,

package/dist/infra.d.cts

@@ -2,12 +2,6 @@ import { b as HttpMethod, f as RoutesManifest } from './types-o33yWNSY.cjs';
 export { h as RoutesManifestAuth, i as RoutesManifestEvent, g as RoutesManifestRoute } from './types-o33yWNSY.cjs';
 import 'aws-lambda';
 
-type AwsSource = {
-    sst?: {
-        aws?: unknown;
-    };
-};
-
 type RegisterRouteConfig = {
     handler: unknown;
     protected: boolean;
@@ -23,17 +17,15 @@ type EnsureJwtAuthorizer = (name: string, cfg: {
     issuer: string;
     audiences: string[];
 }) => unknown;
-type AdapterArgs = AwsSource & {
-    api?: unknown;
-    apiName?: string;
-    apiArgs?: unknown;
+type AdapterArgs = {
+    api: unknown;
 };
-declare function httpApiAdapter(args?: AdapterArgs): {
+declare function httpApiAdapter(args: AdapterArgs): {
     api: unknown;
     registerRoute: RegisterRoute;
     ensureJwtAuthorizer: EnsureJwtAuthorizer;
 };
-declare function restApiAdapter(args?: AdapterArgs): {
+declare function restApiAdapter(args: AdapterArgs): {
     api: unknown;
     registerRoute: RegisterRoute;
     ensureJwtAuthorizer: EnsureJwtAuthorizer;
@@ -41,9 +33,9 @@ declare function restApiAdapter(args?: AdapterArgs): {
 
 declare function wireApiFromManifest(manifest: RoutesManifest, opts: {
     handler: unknown;
-    firebaseProjectId: string;
+    firebaseProjectId?: string;
     registerRoute: RegisterRoute;
-    ensureJwtAuthorizer: EnsureJwtAuthorizer;
+    ensureJwtAuthorizer?: EnsureJwtAuthorizer;
 }): void;
 declare function loadRoutesManifest(filePath: string): RoutesManifest;
 declare function setHandlerBus(handler: unknown): void;

package/dist/infra.d.ts

@@ -2,12 +2,6 @@ import { b as HttpMethod, f as RoutesManifest } from './types-o33yWNSY.js';
 export { h as RoutesManifestAuth, i as RoutesManifestEvent, g as RoutesManifestRoute } from './types-o33yWNSY.js';
 import 'aws-lambda';
 
-type AwsSource = {
-    sst?: {
-        aws?: unknown;
-    };
-};
-
 type RegisterRouteConfig = {
     handler: unknown;
     protected: boolean;
@@ -23,17 +17,15 @@ type EnsureJwtAuthorizer = (name: string, cfg: {
     issuer: string;
     audiences: string[];
 }) => unknown;
-type AdapterArgs = AwsSource & {
-    api?: unknown;
-    apiName?: string;
-    apiArgs?: unknown;
+type AdapterArgs = {
+    api: unknown;
 };
-declare function httpApiAdapter(args?: AdapterArgs): {
+declare function httpApiAdapter(args: AdapterArgs): {
     api: unknown;
     registerRoute: RegisterRoute;
     ensureJwtAuthorizer: EnsureJwtAuthorizer;
 };
-declare function restApiAdapter(args?: AdapterArgs): {
+declare function restApiAdapter(args: AdapterArgs): {
     api: unknown;
     registerRoute: RegisterRoute;
     ensureJwtAuthorizer: EnsureJwtAuthorizer;
@@ -41,9 +33,9 @@ declare function restApiAdapter(args?: AdapterArgs): {
 
 declare function wireApiFromManifest(manifest: RoutesManifest, opts: {
     handler: unknown;
-    firebaseProjectId: string;
+    firebaseProjectId?: string;
     registerRoute: RegisterRoute;
-    ensureJwtAuthorizer: EnsureJwtAuthorizer;
+    ensureJwtAuthorizer?: EnsureJwtAuthorizer;
 }): void;
 declare function loadRoutesManifest(filePath: string): RoutesManifest;
 declare function setHandlerBus(handler: unknown): void;

package/dist/infra.js

@@ -54,6 +54,7 @@ function resolveHandlerInput(handler) {
 
 // src/bus/infra.ts
 var MAX_SUBSCRIBER_NAME_LENGTH = 60;
+var bus;
 function wireEventsFromManifest(events, opts) {
   if (!events || events.length === 0) {
     return;
@@ -66,17 +67,17 @@ function wireEventsFromManifest(events, opts) {
     if (seen.has(key)) {
       continue;
     }
+    if (!bus) bus = aws2.Bus.get("default", "default");
     seen.add(key);
-    const bus = aws2.Bus.get("default", "default");
     const subscriberName = buildSubscriberName(event.event);
     subscribeToBus(bus, subscriberName, subscriber, event.event);
   }
 }
-function subscribeToBus(bus, subscriberName, subscriber, eventName) {
-  if (typeof bus.subscribe !== "function") {
+function subscribeToBus(bus2, subscriberName, subscriber, eventName) {
+  if (typeof bus2.subscribe !== "function") {
     throw new Error("Bus instance does not support subscribe().");
   }
-  bus.subscribe(subscriberName, subscriber, {
+  bus2.subscribe(subscriberName, subscriber, {
     pattern: {
       detailType: [eventName]
     }
@@ -107,8 +108,7 @@ function wireRoutesFromManifest(manifest, opts) {
   }
 }
 function httpApiAdapter(args) {
-  const aws2 = args?.api ? void 0 : ensureSstAws(args);
-  const api = args?.api ?? new aws2.ApiGatewayV2(args?.apiName ?? "HttpApi", args?.apiArgs);
+  const api = args.api;
   const ensureJwtAuthorizer = createHttpAuthorizerManager(api);
   const registerRoute = createRouteRegistrar(api, "ApiGatewayV2");
   return {
@@ -118,8 +118,7 @@ function httpApiAdapter(args) {
   };
 }
 function restApiAdapter(args) {
-  const aws2 = args?.api ? void 0 : ensureSstAws(args);
-  const api = args?.api ?? new aws2.ApiGateway(args?.apiName ?? "RestApi", args?.apiArgs);
+  const api = args.api;
   const ensureJwtAuthorizer = createRestAuthorizerManager(api);
   const registerRoute = createRouteRegistrar(api, "ApiGateway");
   return {
@@ -135,6 +134,9 @@ function ensureFirebaseAuthorizer(firebaseRouteCount, opts) {
   if (!opts.firebaseProjectId) {
     throw new Error("firebaseProjectId is required when using @FirebaseAuth()");
   }
+  if (!opts.ensureJwtAuthorizer) {
+    throw new Error("ensureJwtAuthorizer is required when using @FirebaseAuth()");
+  }
   const issuer = `https://securetoken.google.com/${opts.firebaseProjectId}`;
   return opts.ensureJwtAuthorizer("firebase", {
     issuer,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sst-http",
-  "version": "2.0.0-beta.10",
+  "version": "2.0.0-beta.16",
   "description": "Decorator-based routing for SST v3 with a single Lambda and Firebase JWT authorizer.",
   "license": "MIT",
   "author": "",