qstd 0.3.86 → 0.3.87

package/dist/server/aws/apigw/domain.d.ts

@@ -0,0 +1,57 @@
+import * as _t from "./types";
+export declare const create: (props: _t.CreateProps) => _t.Client;
+export declare const createFromRequestContext: (props: _t.RequestContextProps) => _t.Client;
+/**
+ * Bind connection lookup and stale cleanup once, then reuse the returned
+ * publisher for one-to-one sends and fan-out.
+ *
+ * Create your API Gateway client and any storage clients once, then create a
+ * publisher once and pass that publisher to nested helpers. This keeps the call
+ * sites focused on targets and payloads instead of threading the same
+ * dependencies through every send.
+ *
+ * `onGone` is where app-specific cleanup belongs. For example, a DynamoDB-backed
+ * app can close over `ddb` there without making the publisher itself depend on
+ * DynamoDB types.
+ *
+ * @example
+ * const ddb = DDB.create({ tableName: "app-main" });
+ * const apigw = ApiGw.create({ endpoint: process.env.WS_ENDPOINT! });
+ *
+ * const publisher = ApiGw.createPublisher<Connection, Event>(apigw, {
+ *   getConnectionId: (connection) => connection.id,
+ *   onGone: (connection) => removeConnection(ddb, connection.id),
+ * });
+ *
+ * await publisher.send(connection, {
+ *   data: { type: "subscribed" },
+ * });
+ *
+ * await publisher.broadcast({
+ *   targets: connections,
+ *   data: { type: "refresh" },
+ * });
+ *
+ * @example
+ * type UploadSessionPublisher = ApiGw.Publisher<
+ *   UploadSessionConnection,
+ *   StreamEvent
+ * >;
+ *
+ * const publishSnapshot = async (
+ *   publisher: UploadSessionPublisher,
+ *   connection: UploadSessionConnection
+ * ) => {
+ *   const event =
+ *     connection.scope === "active"
+ *       ? await createActiveSessionsEvent(ddb)
+ *       : await createSessionEvent(ddb, connection.sessionId!);
+ *
+ *   await publisher.send(connection, { data: event });
+ * };
+ */
+export declare const createPublisher: <T, TData = unknown>(apigw: _t.Client, props: _t.CreatePublisherProps<T>) => _t.Publisher<T, TData>;
+export declare const send: (apigw: _t.Client, props: _t.SendProps) => Promise<boolean>;
+export declare const deleteConnection: (apigw: _t.Client, props: _t.DeleteConnectionProps) => Promise<import("@aws-sdk/client-apigatewaymanagementapi").DeleteConnectionCommandOutput>;
+export declare const broadcast: <T, TData = unknown>(apigw: _t.Client, props: _t.BroadcastProps<T, TData>) => Promise<_t.BroadcastResult<T>>;
+//# sourceMappingURL=domain.d.ts.map

package/dist/server/aws/apigw/domain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../../src/server/aws/apigw/domain.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,eAAO,MAAM,MAAM,GAAI,OAAO,EAAE,CAAC,WAAW,KAAG,EAAE,CAAC,MAKjD,CAAC;AAEF,eAAO,MAAM,wBAAwB,GAAI,OAAO,EAAE,CAAC,mBAAmB,cAErE,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,KAAK,GAAG,OAAO,EAChD,OAAO,EAAE,CAAC,MAAM,EAChB,OAAO,EAAE,CAAC,oBAAoB,CAAC,CAAC,CAAC,KAChC,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAoBvB,CAAC;AAEF,eAAO,MAAM,IAAI,GAAU,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,SAAS,qBAiB/D,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAC3B,OAAO,EAAE,CAAC,MAAM,EAChB,OAAO,EAAE,CAAC,qBAAqB,6FAOhC,CAAC;AAEF,eAAO,MAAM,SAAS,GAAU,CAAC,EAAE,KAAK,GAAG,OAAO,EAChD,OAAO,EAAE,CAAC,MAAM,EAChB,OAAO,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,KAAK,CAAC,mCAgEnC,CAAC"}

package/dist/server/aws/apigw/fns.d.ts

@@ -0,0 +1,6 @@
+import * as _t from "./types";
+export declare const getManagementEndpoint: (props: _t.RequestContextProps) => string;
+export declare const isGoneConnectionError: (error: unknown) => boolean;
+export declare const encodeData: (data: unknown) => _t.EncodedPayload;
+export declare const runWithConcurrency: <T>(items: readonly T[], concurrency: number, fn: (item: T) => Promise<void>) => Promise<void>;
+//# sourceMappingURL=fns.d.ts.map

package/dist/server/aws/apigw/fns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fns.d.ts","sourceRoot":"","sources":["../../../../src/server/aws/apigw/fns.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAI9B,eAAO,MAAM,qBAAqB,GAAI,OAAO,EAAE,CAAC,mBAAmB,WAgBlE,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,YAQnD,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,MAAM,OAAO,KAAG,EAAE,CAAC,cAmB7C,CAAC;AAEF,eAAO,MAAM,kBAAkB,GAAU,CAAC,EACxC,OAAO,SAAS,CAAC,EAAE,EACnB,aAAa,MAAM,EACnB,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,kBAc/B,CAAC"}

package/dist/server/aws/apigw/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./domain";
+export * from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/server/aws/apigw/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/aws/apigw/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/dist/server/aws/apigw/types.d.ts

@@ -0,0 +1,113 @@
+import type { ApiGatewayManagementApiClient, DeleteConnectionCommandOutput } from "@aws-sdk/client-apigatewaymanagementapi";
+import type { APIGatewayProxyEvent } from "aws-lambda";
+export type RawClient = Pick<ApiGatewayManagementApiClient, "send">;
+export type Client = {
+    client: RawClient;
+    endpoint: string;
+};
+export type CreateProps = {
+    endpoint: string;
+};
+export type RequestContextProps = Pick<APIGatewayProxyEvent["requestContext"], "domainName" | "stage"> & {
+    protocol?: "http" | "https";
+    basePath?: string;
+};
+export type EncodedPayload = string | Uint8Array;
+export type SendProps = {
+    onGone?: (connectionId: string) => Promise<void> | void;
+    connectionId: string;
+    data: unknown;
+};
+export type DeleteConnectionProps = {
+    connectionId: string;
+};
+export type DeleteConnectionResult = DeleteConnectionCommandOutput;
+export type BroadcastStale<T> = {
+    connectionId: string;
+    target: T;
+};
+export type BroadcastFailure<T> = {
+    connectionId: string;
+    error: unknown;
+    target: T;
+};
+export type BroadcastResult<T> = {
+    failed: BroadcastFailure<T>[];
+    stale: BroadcastStale<T>[];
+    sent: number;
+};
+type Awaitable<T> = T | PromiseLike<T>;
+type BroadcastSharedProps<T> = {
+    getConnectionId: (target: T) => string;
+    onGone?: (target: T) => Promise<void> | void;
+    targets: readonly T[];
+    concurrency?: number;
+};
+export type BroadcastConstantDataProps<T> = BroadcastSharedProps<T> & {
+    getCacheKey?: never;
+    getData?: never;
+    data: unknown;
+};
+export type BroadcastDynamicDataProps<T, TData = unknown> = BroadcastSharedProps<T> & {
+    getData: (target: T) => Awaitable<TData>;
+    getCacheKey?: (target: T) => string | number | null | undefined;
+    data?: never;
+};
+export type BroadcastProps<T, TData = unknown> = BroadcastConstantDataProps<T> | BroadcastDynamicDataProps<T, TData>;
+/**
+ * Configuration for a bound websocket publisher.
+ *
+ * `qstd` intentionally asks only for connection lookup and stale-target cleanup.
+ * Any storage details, such as DynamoDB removal, live in the `onGone` closure so
+ * the publisher can stay generic across apps and persistence layers.
+ */
+export type CreatePublisherProps<T> = {
+    /** Extract the API Gateway connection ID from your app's target shape. */
+    getConnectionId: (target: T) => string;
+    /** Optional stale-target cleanup hook, eg remove a dead connection from DDB. */
+    onGone?: (target: T) => Promise<void> | void;
+};
+export type PublisherSendProps<TData = unknown> = {
+    data: TData;
+};
+type PublisherBroadcastSharedProps<T> = {
+    targets: readonly T[];
+    concurrency?: number;
+};
+export type PublisherBroadcastConstantDataProps<T, TData = unknown> = PublisherBroadcastSharedProps<T> & {
+    getCacheKey?: never;
+    getData?: never;
+    data: TData;
+};
+export type PublisherBroadcastDynamicDataProps<T, TData = unknown> = PublisherBroadcastSharedProps<T> & {
+    getData: (target: T) => Awaitable<TData>;
+    getCacheKey?: (target: T) => string | number | null | undefined;
+    data?: never;
+};
+export type PublisherBroadcastProps<T, TData = unknown> = PublisherBroadcastConstantDataProps<T, TData> | PublisherBroadcastDynamicDataProps<T, TData>;
+/**
+ * Bound websocket publisher created once per invocation and passed to helpers.
+ *
+ * The type only needs to describe the target shape and payload shape. Any DDB,
+ * SQL, or cache clients used for stale cleanup stay hidden inside the closure
+ * captured by `createPublisher()`.
+ *
+ * @example
+ * type Connection = { id: string; roomId: string };
+ * type Event = { type: "message"; roomId: string; text: string };
+ *
+ * const publisher = ApiGw.createPublisher<Connection, Event>(apigw, {
+ *   getConnectionId: (connection) => connection.id,
+ *   onGone: (connection) => removeConnection(ddb, connection.id),
+ * });
+ *
+ * await publisher.send(connection, {
+ *   data: { type: "message", roomId: "abc", text: "hello" },
+ * });
+ */
+export type Publisher<T, TData = unknown> = {
+    send: (target: T, props: PublisherSendProps<TData>) => Promise<boolean>;
+    broadcast: (props: PublisherBroadcastProps<T, TData>) => Promise<BroadcastResult<T>>;
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/server/aws/apigw/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/server/aws/apigw/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,6BAA6B,EAC7B,6BAA6B,EAC9B,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;AAEpE,MAAM,MAAM,MAAM,GAAG;IACnB,MAAM,EAAE,SAAS,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG,IAAI,CACpC,oBAAoB,CAAC,gBAAgB,CAAC,EACtC,YAAY,GAAG,OAAO,CACvB,GAAG;IACF,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,UAAU,CAAC;AAEjD,MAAM,MAAM,SAAS,GAAG;IACtB,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,YAAY,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,6BAA6B,CAAC;AAEnE,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,CAAC,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,CAAC,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI;IAC/B,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9B,KAAK,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,KAAK,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;AAEvC,KAAK,oBAAoB,CAAC,CAAC,IAAI;IAC7B,eAAe,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC;IACvC,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7C,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,0BAA0B,CAAC,CAAC,IAAI,oBAAoB,CAAC,CAAC,CAAC,GAAG;IACpE,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,IAAI,EAAE,OAAO,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,yBAAyB,CACnC,CAAC,EACD,KAAK,GAAG,OAAO,IACb,oBAAoB,CAAC,CAAC,CAAC,GAAG;IAC5B,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC,CAAC;IACzC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAChE,IAAI,CAAC,EAAE,KAAK,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,IACzC,0BAA0B,CAAC,CAAC,CAAC,GAC7B,yBAAyB,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAExC;;;;;;GAMG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI;IACpC,0EAA0E;IAC1E,eAAe,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,CAAC;IACvC,gFAAgF;IAChF,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC9C,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,KAAK,GAAG,OAAO,IAAI;IAChD,IAAI,EAAE,KAAK,CAAC;CACb,CAAC;AAEF,KAAK,6BAA6B,CAAC,CAAC,IAAI;IACtC,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,mCAAmC,CAC7C,CAAC,EACD,KAAK,GAAG,OAAO,IACb,6BAA6B,CAAC,CAAC,CAAC,GAAG;IACrC,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,IAAI,EAAE,KAAK,CAAC;CACb,CAAC;AAEF,MAAM,MAAM,kCAAkC,CAC5C,CAAC,EACD,KAAK,GAAG,OAAO,IACb,6BAA6B,CAAC,CAAC,CAAC,GAAG;IACrC,OAAO,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC,CAAC;IACzC,WAAW,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAChE,IAAI,CAAC,EAAE,KAAK,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,uBAAuB,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,IAClD,mCAAmC,CAAC,CAAC,EAAE,KAAK,CAAC,GAC7C,kCAAkC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAEjD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,IAAI;IAC1C,IAAI,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACxE,SAAS,EAAE,CAAC,KAAK,EAAE,uBAAuB,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,OAAO,CAC9D,eAAe,CAAC,CAAC,CAAC,CACnB,CAAC;CACH,CAAC"}

package/dist/server/aws/lambda/domain.d.ts

@@ -6,13 +6,13 @@ import * as _t from "./types";
  * @param fn
  * @returns
  */
-export declare const createRestHandler: (fn: (event: import("aws-lambda").APIGatewayProxyEventV2) => Promise<_t.ApigwResult> | _t.ApigwResult) => (event: import("aws-lambda").APIGatewayProxyEventV2) => Promise<_t.Response | _t.ApigwResult>;
+export declare const createRestHandler: _t.RestHandlerFactory;
 /**
  * Same as rest handler but just receives a websocket event.
  * @param fn
  * @returns
  */
-export declare const createWebsocketHandler: (fn: (event: import("aws-lambda").APIGatewayProxyEvent) => Promise<_t.ApigwResult> | _t.ApigwResult) => (event: import("aws-lambda").APIGatewayProxyEvent) => Promise<_t.Response | _t.ApigwResult>;
+export declare const createWebsocketHandler: _t.WebsocketHandlerFactory;
 /**
  * Creates a batch failures tracker for SQS handlers.
  * Provides a simple `add(id)` method instead of pushing objects.
@@ -62,5 +62,5 @@ export declare const withBatchFailures: () => {
  * });
  * ```
  */
-export declare const createSqsHandler: (fn: _t.SqsHandlerFn) => _t.SqsHandlerFn;
+export declare const createSqsHandler: _t.SqsHandlerFactory;
 //# sourceMappingURL=domain.d.ts.map

package/dist/server/aws/lambda/domain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../../src/server/aws/lambda/domain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAG9B;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,6GA0EkC,kDAAO,0CA1EE,CAAC;AAE1E;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,2GAmE6B,gDAAO,0CAlEzB,CAAC;AAE/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,iBAAiB;IAG1B,0GAA0G;0BACpF,MAAM;IAG5B,0CAA0C;;CAG7C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,gBAAgB,GAC1B,IAAI,EAAE,CAAC,YAAY,KAAG,EAAE,CAAC,YAazB,CAAC"}
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../../src/server/aws/lambda/domain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAG9B;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,EAAE,CAAC,kBACO,CAAC;AAE3C;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,EAAE,CAAC,uBACM,CAAC;AAE/C;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,iBAAiB;IAG1B,0GAA0G;0BACpF,MAAM;IAG5B,0CAA0C;;CAG7C,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,eAAO,MAAM,gBAAgB,EAAE,EAAE,CAAC,iBAc/B,CAAC"}

package/dist/server/aws/lambda/fns.d.ts

@@ -30,5 +30,5 @@ responseBody?: T, opts?: _t.ResponseOptions) => _t.Response;
  * handle things like HTTP errors and Arktype validation errors,
  * @returns
  */
-export declare const createHandlerFactory: <T extends _t.ApigwEvent | _t.WebsocketEvent>() => (fn: (event: T) => Promise<_t.ApigwResult> | _t.ApigwResult) => (event: T) => Promise<_t.Response | _t.ApigwResult>;
+export declare const createHandlerFactory: <T extends _t.ApigwEvent | _t.WebsocketEvent>() => _t.HandlerFactory<T>;
 //# sourceMappingURL=fns.d.ts.map

package/dist/server/aws/lambda/fns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fns.d.ts","sourceRoot":"","sources":["../../../../src/server/aws/lambda/fns.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,OAAO,EAAE,UAAU,EAAE,CAAC,eAAe,KAAG,MAK3E,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,OAAM,EAAE,CAAC,eAAoB;;;;;;CAU7D,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,GAAG,OAAO;AAClC,qCAAqC;AACrC,eAAe,CAAC,EAChB,OAAO,EAAE,CAAC,eAAe,KACxB,EAAE,CAAC,QAWL,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC9B,CAAC,SAAS,EAAE,CAAC,UAAU,GAAG,EAAE,CAAC,cAAc,QAC3C,IAAI,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,WAAW,MACpD,OAAO,CAAC,0CAsBd,CAAC"}
+{"version":3,"file":"fns.d.ts","sourceRoot":"","sources":["../../../../src/server/aws/lambda/fns.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,MAAM,OAAO,EAAE,UAAU,EAAE,CAAC,eAAe,KAAG,MAK3E,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,OAAM,EAAE,CAAC,eAAoB;;;;;;CAU7D,CAAC;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,QAAQ,GAAI,CAAC,GAAG,OAAO;AAClC,qCAAqC;AACrC,eAAe,CAAC,EAChB,OAAO,EAAE,CAAC,eAAe,KACxB,EAAE,CAAC,QAWL,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,GAC9B,CAAC,SAAS,EAAE,CAAC,UAAU,GAAG,EAAE,CAAC,cAAc,OAAK,EAAE,CAAC,cAAc,CAAC,CAAC,CAwBnE,CAAC"}

package/dist/server/aws/lambda/index.d.ts

@@ -1,4 +1,5 @@
 export { HttpError } from "./literals";
 export { response } from "./fns";
 export * from "./domain";
+export * from "./types";
 //# sourceMappingURL=index.d.ts.map

package/dist/server/aws/lambda/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/aws/lambda/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/server/aws/lambda/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AACjC,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC"}

package/dist/server/aws/lambda/types.d.ts

@@ -26,10 +26,21 @@ export type Response = {
 export type WebsocketEvent = APIGatewayProxyEvent;
 export type ApigwEvent = APIGatewayProxyEventV2;
 export type ApigwResult = APIGatewayProxyResultV2;
+export type HandlerResult = Response | ApigwResult;
+export type HandlerFn<T extends ApigwEvent | WebsocketEvent> = (event: T) => Promise<ApigwResult> | ApigwResult;
+export type Handler<T extends ApigwEvent | WebsocketEvent> = (event: T) => Promise<HandlerResult>;
+export type HandlerFactory<T extends ApigwEvent | WebsocketEvent> = (fn: HandlerFn<T>) => Handler<T>;
+export type RestHandlerFn = HandlerFn<ApigwEvent>;
+export type RestHandler = Handler<ApigwEvent>;
+export type RestHandlerFactory = HandlerFactory<ApigwEvent>;
+export type WebsocketHandlerFn = HandlerFn<WebsocketEvent>;
+export type WebsocketHandler = Handler<WebsocketEvent>;
+export type WebsocketHandlerFactory = HandlerFactory<WebsocketEvent>;
 export type SqsEvent = SQSEvent;
 export type SqsContext = Context;
 export type SQSHandler = AwsSqsHandler;
 export type SqsCallback = Callback<SQSBatchResponse | void>;
+export type SqsHandlerFactory = (fn: SqsHandlerFn) => SqsHandlerFn;
 export type ResponseOptions = {
     /**
      * `200` - **Ok**: request succeeded and there is a response payload.

package/dist/server/aws/lambda/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/server/aws/lambda/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACtB,uBAAuB,EACvB,UAAU,IAAI,aAAa,EAC3B,mBAAmB,EACnB,gBAAgB,EAChB,QAAQ,EACR,OAAO,EACP,QAAQ,EACT,MAAM,YAAY,CAAC;AAEpB,yDAAyD;AACzD,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAEhD,+DAA+D;AAC/D,MAAM,MAAM,mBAAmB,GAAG,mBAAmB,CAAC;AAEtD;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC;IACtD,iBAAiB,EAAE,mBAAmB,EAAE,CAAC;CAC1C,CAAC,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE;QACP,cAAc,EAAE,MAAM,CAAC;QACvB,6BAA6B,EAAE,MAAM,CAAC;QACtC,8BAA8B,EAAE,MAAM,CAAC;QACvC,8BAA8B,EAAE,MAAM,CAAC;QACvC,kCAAkC,EAAE,MAAM,GAAG,OAAO,CAAC;KACtD,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAC/B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,oBAAoB,CAAC;AAElD,MAAM,MAAM,UAAU,GAAG,sBAAsB,CAAC;AAChD,MAAM,MAAM,WAAW,GAAG,uBAAuB,CAAC;AAElD,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAChC,MAAM,MAAM,UAAU,GAAG,OAAO,CAAC;AACjC,MAAM,MAAM,UAAU,GAAG,aAAa,CAAC;AAEvC,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,gBAAgB,GAAG,IAAI,CAAC,CAAC;AAE5D,MAAM,MAAM,eAAe,GAAG;IAC5B;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,MAAM,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACzE,iBAAiB,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IAE9C,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IAE/B,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;SAGK;IACL,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,uGAAuG;IACvG,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/server/aws/lambda/types.ts"],"names":[],"mappings":"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"}

package/dist/server/index.cjs

@@ -4,6 +4,7 @@ var dateFns = require('date-fns');
 var awaitSpawn = require('await-spawn');
 var fs = require('fs');
 var arktype = require('arktype');
+var clientApigatewaymanagementapi = require('@aws-sdk/client-apigatewaymanagementapi');
 var libDynamodb = require('@aws-sdk/lib-dynamodb');
 var clientDynamodb = require('@aws-sdk/client-dynamodb');
 var signale = require('signale');
@@ -1348,6 +1349,176 @@ var createSqsHandler = (fn) => async (event) => {
   return result;
 };
 
+// src/server/aws/apigw/index.ts
+var apigw_exports = {};
+__export(apigw_exports, {
+  broadcast: () => broadcast,
+  create: () => create2,
+  createFromRequestContext: () => createFromRequestContext,
+  createPublisher: () => createPublisher,
+  deleteConnection: () => deleteConnection,
+  send: () => send
+});
+
+// src/server/aws/apigw/fns.ts
+var normalizePath = (path) => path.replace(/^\/+|\/+$/g, "");
+var getManagementEndpoint = (props) => {
+  const domainName = props.domainName;
+  if (!domainName) {
+    throw new Error("Missing websocket domain name");
+  }
+  const rawPath = props.basePath ?? props.stage;
+  if (rawPath == null) {
+    throw new Error("Missing websocket stage or base path");
+  }
+  const protocol = props.protocol ?? "https";
+  const path = normalizePath(rawPath);
+  return path ? `${protocol}://${domainName}/${path}` : `${protocol}://${domainName}`;
+};
+var isGoneConnectionError = (error2) => {
+  return !!(error2 && typeof error2 === "object" && "$metadata" in error2 && error2.$metadata?.httpStatusCode === 410);
+};
+var encodeData = (data) => {
+  if (typeof data === "string") {
+    return data;
+  }
+  if (data instanceof Uint8Array) {
+    return data;
+  }
+  if (data instanceof ArrayBuffer) {
+    return new Uint8Array(data);
+  }
+  if (ArrayBuffer.isView(data)) {
+    return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+  }
+  const encoded = JSON.stringify(data);
+  if (encoded === void 0) {
+    throw new Error("Websocket payload must be JSON serializable");
+  }
+  return encoded;
+};
+var runWithConcurrency = async (items, concurrency, fn) => {
+  const limit = Math.max(1, concurrency);
+  let nextIndex = 0;
+  await Promise.all(
+    Array.from({ length: Math.min(limit, items.length) }, async () => {
+      while (nextIndex < items.length) {
+        const currentIndex = nextIndex;
+        nextIndex += 1;
+        await fn(items[currentIndex]);
+      }
+    })
+  );
+};
+
+// src/server/aws/apigw/domain.ts
+var create2 = (props) => {
+  const client = new clientApigatewaymanagementapi.ApiGatewayManagementApiClient({
+    endpoint: props.endpoint
+  });
+  return { client, endpoint: props.endpoint };
+};
+var createFromRequestContext = (props) => {
+  return create2({ endpoint: getManagementEndpoint(props) });
+};
+var createPublisher = (apigw, props) => {
+  const getConnectionId = props.getConnectionId;
+  const onGone = props.onGone;
+  return {
+    send: (target, sendProps) => {
+      return send(apigw, {
+        connectionId: getConnectionId(target),
+        data: sendProps.data,
+        onGone: onGone ? () => onGone(target) : void 0
+      });
+    },
+    broadcast: (broadcastProps) => {
+      return broadcast(apigw, {
+        ...broadcastProps,
+        getConnectionId,
+        onGone
+      });
+    }
+  };
+};
+var send = async (apigw, props) => {
+  try {
+    await apigw.client.send(
+      new clientApigatewaymanagementapi.PostToConnectionCommand({
+        ConnectionId: props.connectionId,
+        Data: encodeData(props.data)
+      })
+    );
+  } catch (error2) {
+    if (isGoneConnectionError(error2)) {
+      await props.onGone?.(props.connectionId);
+      return false;
+    }
+    throw error2;
+  }
+  return true;
+};
+var deleteConnection = (apigw, props) => {
+  return apigw.client.send(
+    new clientApigatewaymanagementapi.DeleteConnectionCommand({
+      ConnectionId: props.connectionId
+    })
+  );
+};
+var broadcast = async (apigw, props) => {
+  const result = {
+    failed: [],
+    stale: [],
+    sent: 0
+  };
+  const sharedData = "data" in props ? encodeData(props.data) : null;
+  const getData = "getData" in props ? props.getData : null;
+  const getCacheKey = "getCacheKey" in props ? props.getCacheKey : void 0;
+  const onGone = props.onGone;
+  const cache = /* @__PURE__ */ new Map();
+  const resolveData = async (target) => {
+    if (sharedData !== null) {
+      return sharedData;
+    }
+    if (!getData) {
+      throw new Error("Missing websocket broadcast payload builder");
+    }
+    const cacheKey = getCacheKey?.(target);
+    if (cacheKey == null) {
+      return encodeData(await getData(target));
+    }
+    const existing = cache.get(cacheKey);
+    if (existing) {
+      return existing;
+    }
+    const promise = Promise.resolve(getData(target)).then(encodeData);
+    cache.set(cacheKey, promise);
+    return promise;
+  };
+  await runWithConcurrency(
+    props.targets,
+    props.concurrency ?? 25,
+    async (target) => {
+      const connectionId = props.getConnectionId(target);
+      try {
+        const delivered = await send(apigw, {
+          connectionId,
+          data: await resolveData(target),
+          onGone: onGone ? () => onGone(target) : void 0
+        });
+        if (!delivered) {
+          result.stale.push({ connectionId, target });
+          return;
+        }
+        result.sent += 1;
+      } catch (error2) {
+        result.failed.push({ connectionId, error: error2, target });
+      }
+    }
+  );
+  return result;
+};
+
 // src/server/aws/ddb/index.ts
 var ddb_exports = {};
 __export(ddb_exports, {
@@ -1355,7 +1526,7 @@ __export(ddb_exports, {
   batchGet: () => batchGet,
   batchWrite: () => batchWrite,
   copyTable: () => copyTable,
-  create: () => create2,
+  create: () => create3,
   deleteTable: () => deleteTable,
   find: () => find,
   lsi1: () => lsi1,
@@ -1639,7 +1810,7 @@ var buildUpdateExpression = (ops, names, values) => {
 };
 
 // src/server/aws/ddb/domain.ts
-var create2 = (props) => {
+var create3 = (props) => {
   const tableName = props?.tableName;
   const credentials = props?.credentials;
   const client = libDynamodb.DynamoDBDocumentClient.from(
@@ -2521,11 +2692,11 @@ var copyTable = async (props) => {
 // src/server/aws/sns/index.ts
 var sns_exports = {};
 __export(sns_exports, {
-  create: () => create3,
+  create: () => create4,
   publish: () => publish,
   publishError: () => publishError
 });
-var create3 = (props) => {
+var create4 = (props) => {
   const client = new clientSns.SNSClient({});
   return { client, topicArn: props?.topicArn };
 };
@@ -2560,8 +2731,8 @@ var publishError = (sns, props) => {
 // src/server/aws/sqs/index.ts
 var sqs_exports = {};
 __export(sqs_exports, {
-  create: () => create4,
-  send: () => send
+  create: () => create5,
+  send: () => send2
 });
 
 // src/server/aws/sqs/fns.ts
@@ -2575,12 +2746,12 @@ var getQueueUrlOrThrow = (...candidates) => {
 };
 
 // src/server/aws/sqs/domain.ts
-var create4 = (props) => {
+var create5 = (props) => {
   const client = new clientSqs.SQSClient({});
   const queueUrl = props?.queueUrl;
   return { client, queueUrl };
 };
-var send = (sqs, props) => sqs.client.send(
+var send2 = (sqs, props) => sqs.client.send(
   new clientSqs.SendMessageCommand({
     MessageBody: JSON.stringify(props.body),
     MessageGroupId: props.messageGroupId,
@@ -2591,16 +2762,16 @@ var send = (sqs, props) => sqs.client.send(
 // src/server/aws/ses/index.ts
 var ses_exports = {};
 __export(ses_exports, {
-  create: () => create5,
-  send: () => send2
+  create: () => create6,
+  send: () => send3
 });
 
 // src/server/aws/ses/fns.ts
 var stripHtml = (html) => html.replace(/<style[^>]*>[\s\S]*?<\/style>/gi, "").replace(/<script[^>]*>[\s\S]*?<\/script>/gi, "").replace(/<[^>]+>/g, " ").replace(/&nbsp;/g, " ").replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/\s+/g, " ").trim();
 
 // src/server/aws/ses/index.ts
-var create5 = () => new clientSes.SESClient({ apiVersion: "2010-12-01" });
-var send2 = (ses, email) => {
+var create6 = () => new clientSes.SESClient({ apiVersion: "2010-12-01" });
+var send3 = (ses, email) => {
   const Source = `"${email.fromName}" <${email.from}>`;
   console.log(`[ses] Sending email to ${email.to} from ${email.from}`);
   const Destination = { ToAddresses: [email.to] };
@@ -2625,7 +2796,7 @@ var s3_exports = {};
 __export(s3_exports, {
   bucketExists: () => bucketExists,
   copyFile: () => copyFile,
-  create: () => create6,
+  create: () => create7,
   createBucket: () => createBucket,
   createSignedUrl: () => createSignedUrl,
   deleteBucket: () => deleteBucket,
@@ -2652,7 +2823,7 @@ var getBucketNameOrThrow = (...candidates) => {
 };
 
 // src/server/aws/s3/domain.ts
-var create6 = (props = {}) => {
+var create7 = (props = {}) => {
   const { cdn } = props;
   const client = new clientS3.S3Client({});
   const bucketName = getBucketNameOrThrow(props.bucketName);
@@ -2908,6 +3079,7 @@ var recordsFromSqs = (body) => {
 };
 
 exports.Api = api_exports;
+exports.ApiGw = apigw_exports;
 exports.DDB = ddb_exports;
 exports.Dict = dict_exports;
 exports.File = file_exports;

package/dist/server/index.d.ts

@@ -12,6 +12,7 @@ export * as LexoRank from "../shared/lexorank";
 export * as Os from "./os";
 export * as File from "./file";
 export * as Lambda from "./aws/lambda";
+export * as ApiGw from "./aws/apigw";
 export * as DDB from "./aws/ddb";
 export * as SNS from "./aws/sns";
 export * as SQS from "./aws/sqs";

package/dist/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,KAAK,MAAM,iBAAiB,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,QAAQ,MAAM,oBAAoB,CAAC;AAG/C,OAAO,KAAK,EAAE,MAAM,MAAM,CAAC;AAC3B,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,GAAG,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,GAAG,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,GAAG,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,GAAG,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,KAAK,MAAM,iBAAiB,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,OAAO,KAAK,MAAM,MAAM,kBAAkB,CAAC;AAC3C,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,GAAG,MAAM,eAAe,CAAC;AACrC,OAAO,KAAK,QAAQ,MAAM,oBAAoB,CAAC;AAG/C,OAAO,KAAK,EAAE,MAAM,MAAM,CAAC;AAC3B,OAAO,KAAK,IAAI,MAAM,QAAQ,CAAC;AAC/B,OAAO,KAAK,MAAM,MAAM,cAAc,CAAC;AACvC,OAAO,KAAK,KAAK,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,GAAG,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,GAAG,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,GAAG,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,GAAG,MAAM,WAAW,CAAC;AACjC,OAAO,KAAK,EAAE,MAAM,UAAU,CAAC"}

package/dist/server/index.js

@@ -2,6 +2,7 @@ import { parse, format, formatISO, formatDistanceToNow, isSameYear, isSameMonth,
 import awaitSpawn from 'await-spawn';
 import { promises } from 'fs';
 import { ArkErrors } from 'arktype';
+import { ApiGatewayManagementApiClient, PostToConnectionCommand, DeleteConnectionCommand } from '@aws-sdk/client-apigatewaymanagementapi';
 import { DynamoDBDocumentClient, ScanCommand, QueryCommand, DeleteCommand, PutCommand, UpdateCommand, BatchGetCommand, TransactWriteCommand, BatchWriteCommand } from '@aws-sdk/lib-dynamodb';
 import { ReturnValue, DynamoDBClient, DeleteTableCommand, DescribeTableCommand, DynamoDBServiceException, CreateTableCommand, DescribeContinuousBackupsCommand, UpdateContinuousBackupsCommand, waitUntilTableExists } from '@aws-sdk/client-dynamodb';
 import signale from 'signale';
@@ -1340,6 +1341,176 @@ var createSqsHandler = (fn) => async (event) => {
   return result;
 };
 
+// src/server/aws/apigw/index.ts
+var apigw_exports = {};
+__export(apigw_exports, {
+  broadcast: () => broadcast,
+  create: () => create2,
+  createFromRequestContext: () => createFromRequestContext,
+  createPublisher: () => createPublisher,
+  deleteConnection: () => deleteConnection,
+  send: () => send
+});
+
+// src/server/aws/apigw/fns.ts
+var normalizePath = (path) => path.replace(/^\/+|\/+$/g, "");
+var getManagementEndpoint = (props) => {
+  const domainName = props.domainName;
+  if (!domainName) {
+    throw new Error("Missing websocket domain name");
+  }
+  const rawPath = props.basePath ?? props.stage;
+  if (rawPath == null) {
+    throw new Error("Missing websocket stage or base path");
+  }
+  const protocol = props.protocol ?? "https";
+  const path = normalizePath(rawPath);
+  return path ? `${protocol}://${domainName}/${path}` : `${protocol}://${domainName}`;
+};
+var isGoneConnectionError = (error2) => {
+  return !!(error2 && typeof error2 === "object" && "$metadata" in error2 && error2.$metadata?.httpStatusCode === 410);
+};
+var encodeData = (data) => {
+  if (typeof data === "string") {
+    return data;
+  }
+  if (data instanceof Uint8Array) {
+    return data;
+  }
+  if (data instanceof ArrayBuffer) {
+    return new Uint8Array(data);
+  }
+  if (ArrayBuffer.isView(data)) {
+    return new Uint8Array(data.buffer, data.byteOffset, data.byteLength);
+  }
+  const encoded = JSON.stringify(data);
+  if (encoded === void 0) {
+    throw new Error("Websocket payload must be JSON serializable");
+  }
+  return encoded;
+};
+var runWithConcurrency = async (items, concurrency, fn) => {
+  const limit = Math.max(1, concurrency);
+  let nextIndex = 0;
+  await Promise.all(
+    Array.from({ length: Math.min(limit, items.length) }, async () => {
+      while (nextIndex < items.length) {
+        const currentIndex = nextIndex;
+        nextIndex += 1;
+        await fn(items[currentIndex]);
+      }
+    })
+  );
+};
+
+// src/server/aws/apigw/domain.ts
+var create2 = (props) => {
+  const client = new ApiGatewayManagementApiClient({
+    endpoint: props.endpoint
+  });
+  return { client, endpoint: props.endpoint };
+};
+var createFromRequestContext = (props) => {
+  return create2({ endpoint: getManagementEndpoint(props) });
+};
+var createPublisher = (apigw, props) => {
+  const getConnectionId = props.getConnectionId;
+  const onGone = props.onGone;
+  return {
+    send: (target, sendProps) => {
+      return send(apigw, {
+        connectionId: getConnectionId(target),
+        data: sendProps.data,
+        onGone: onGone ? () => onGone(target) : void 0
+      });
+    },
+    broadcast: (broadcastProps) => {
+      return broadcast(apigw, {
+        ...broadcastProps,
+        getConnectionId,
+        onGone
+      });
+    }
+  };
+};
+var send = async (apigw, props) => {
+  try {
+    await apigw.client.send(
+      new PostToConnectionCommand({
+        ConnectionId: props.connectionId,
+        Data: encodeData(props.data)
+      })
+    );
+  } catch (error2) {
+    if (isGoneConnectionError(error2)) {
+      await props.onGone?.(props.connectionId);
+      return false;
+    }
+    throw error2;
+  }
+  return true;
+};
+var deleteConnection = (apigw, props) => {
+  return apigw.client.send(
+    new DeleteConnectionCommand({
+      ConnectionId: props.connectionId
+    })
+  );
+};
+var broadcast = async (apigw, props) => {
+  const result = {
+    failed: [],
+    stale: [],
+    sent: 0
+  };
+  const sharedData = "data" in props ? encodeData(props.data) : null;
+  const getData = "getData" in props ? props.getData : null;
+  const getCacheKey = "getCacheKey" in props ? props.getCacheKey : void 0;
+  const onGone = props.onGone;
+  const cache = /* @__PURE__ */ new Map();
+  const resolveData = async (target) => {
+    if (sharedData !== null) {
+      return sharedData;
+    }
+    if (!getData) {
+      throw new Error("Missing websocket broadcast payload builder");
+    }
+    const cacheKey = getCacheKey?.(target);
+    if (cacheKey == null) {
+      return encodeData(await getData(target));
+    }
+    const existing = cache.get(cacheKey);
+    if (existing) {
+      return existing;
+    }
+    const promise = Promise.resolve(getData(target)).then(encodeData);
+    cache.set(cacheKey, promise);
+    return promise;
+  };
+  await runWithConcurrency(
+    props.targets,
+    props.concurrency ?? 25,
+    async (target) => {
+      const connectionId = props.getConnectionId(target);
+      try {
+        const delivered = await send(apigw, {
+          connectionId,
+          data: await resolveData(target),
+          onGone: onGone ? () => onGone(target) : void 0
+        });
+        if (!delivered) {
+          result.stale.push({ connectionId, target });
+          return;
+        }
+        result.sent += 1;
+      } catch (error2) {
+        result.failed.push({ connectionId, error: error2, target });
+      }
+    }
+  );
+  return result;
+};
+
 // src/server/aws/ddb/index.ts
 var ddb_exports = {};
 __export(ddb_exports, {
@@ -1347,7 +1518,7 @@ __export(ddb_exports, {
   batchGet: () => batchGet,
   batchWrite: () => batchWrite,
   copyTable: () => copyTable,
-  create: () => create2,
+  create: () => create3,
   deleteTable: () => deleteTable,
   find: () => find,
   lsi1: () => lsi1,
@@ -1631,7 +1802,7 @@ var buildUpdateExpression = (ops, names, values) => {
 };
 
 // src/server/aws/ddb/domain.ts
-var create2 = (props) => {
+var create3 = (props) => {
   const tableName = props?.tableName;
   const credentials = props?.credentials;
   const client = DynamoDBDocumentClient.from(
@@ -2513,11 +2684,11 @@ var copyTable = async (props) => {
 // src/server/aws/sns/index.ts
 var sns_exports = {};
 __export(sns_exports, {
-  create: () => create3,
+  create: () => create4,
   publish: () => publish,
   publishError: () => publishError
 });
-var create3 = (props) => {
+var create4 = (props) => {
   const client = new SNSClient({});
   return { client, topicArn: props?.topicArn };
 };
@@ -2552,8 +2723,8 @@ var publishError = (sns, props) => {
 // src/server/aws/sqs/index.ts
 var sqs_exports = {};
 __export(sqs_exports, {
-  create: () => create4,
-  send: () => send
+  create: () => create5,
+  send: () => send2
 });
 
 // src/server/aws/sqs/fns.ts
@@ -2567,12 +2738,12 @@ var getQueueUrlOrThrow = (...candidates) => {
 };
 
 // src/server/aws/sqs/domain.ts
-var create4 = (props) => {
+var create5 = (props) => {
   const client = new SQSClient({});
   const queueUrl = props?.queueUrl;
   return { client, queueUrl };
 };
-var send = (sqs, props) => sqs.client.send(
+var send2 = (sqs, props) => sqs.client.send(
   new SendMessageCommand({
     MessageBody: JSON.stringify(props.body),
     MessageGroupId: props.messageGroupId,
@@ -2583,16 +2754,16 @@ var send = (sqs, props) => sqs.client.send(
 // src/server/aws/ses/index.ts
 var ses_exports = {};
 __export(ses_exports, {
-  create: () => create5,
-  send: () => send2
+  create: () => create6,
+  send: () => send3
 });
 
 // src/server/aws/ses/fns.ts
 var stripHtml = (html) => html.replace(/<style[^>]*>[\s\S]*?<\/style>/gi, "").replace(/<script[^>]*>[\s\S]*?<\/script>/gi, "").replace(/<[^>]+>/g, " ").replace(/&nbsp;/g, " ").replace(/&amp;/g, "&").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/\s+/g, " ").trim();
 
 // src/server/aws/ses/index.ts
-var create5 = () => new SESClient({ apiVersion: "2010-12-01" });
-var send2 = (ses, email) => {
+var create6 = () => new SESClient({ apiVersion: "2010-12-01" });
+var send3 = (ses, email) => {
   const Source = `"${email.fromName}" <${email.from}>`;
   console.log(`[ses] Sending email to ${email.to} from ${email.from}`);
   const Destination = { ToAddresses: [email.to] };
@@ -2617,7 +2788,7 @@ var s3_exports = {};
 __export(s3_exports, {
   bucketExists: () => bucketExists,
   copyFile: () => copyFile,
-  create: () => create6,
+  create: () => create7,
   createBucket: () => createBucket,
   createSignedUrl: () => createSignedUrl,
   deleteBucket: () => deleteBucket,
@@ -2644,7 +2815,7 @@ var getBucketNameOrThrow = (...candidates) => {
 };
 
 // src/server/aws/s3/domain.ts
-var create6 = (props = {}) => {
+var create7 = (props = {}) => {
   const { cdn } = props;
   const client = new S3Client({});
   const bucketName = getBucketNameOrThrow(props.bucketName);
@@ -2899,4 +3070,4 @@ var recordsFromSqs = (body) => {
   }
 };
 
-export { api_exports as Api, ddb_exports as DDB, dict_exports as Dict, file_exports as File, flow_exports as Flow, int_exports as Int, lambda_exports as Lambda, lexorank_exports as LexoRank, list_exports as List, log_exports as Log, money_exports as Money, os_exports as Os, random_exports as Random, s3_exports as S3, ses_exports as SES, sns_exports as SNS, sqs_exports as SQS, str_exports as Str, time_exports as Time };
+export { api_exports as Api, apigw_exports as ApiGw, ddb_exports as DDB, dict_exports as Dict, file_exports as File, flow_exports as Flow, int_exports as Int, lambda_exports as Lambda, lexorank_exports as LexoRank, list_exports as List, log_exports as Log, money_exports as Money, os_exports as Os, random_exports as Random, s3_exports as S3, ses_exports as SES, sns_exports as SNS, sqs_exports as SQS, str_exports as Str, time_exports as Time };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "qstd",
-  "version": "0.3.86",
+  "version": "0.3.87",
   "description": "Standard Block component and utilities library with Panda CSS",
   "author": "malin1",
   "license": "MIT",
@@ -66,6 +66,7 @@
     "react-dom": "^18.0.0 || ^19.0.0"
   },
   "dependencies": {
+    "@aws-sdk/client-apigatewaymanagementapi": "latest",
     "@aws-sdk/client-dynamodb": "latest",
     "@aws-sdk/client-s3": "latest",
     "@aws-sdk/client-ses": "latest",