@runlane/lane-postgres-sqs 0.3.0 → 0.5.0

package/dist/index.cjs

@@ -1,5 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-//#region \0rolldown/runtime.js
+// \0rolldown/runtime.js
 var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
@@ -16,23 +16,26 @@ var __copyProps = (to, from, except, desc) => {
 	}
 	return to;
 };
-var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule || !__hasOwnProp.call(mod, "default") ? __defProp(target, "default", {
 	value: mod,
 	enumerable: true
 }) : target, mod));
-//#endregion
 let _runlane_contracts = require("@runlane/contracts");
 let _runlane_postgres_storage = require("@runlane/postgres-storage");
 let _runlane_transport_sqs = require("@runlane/transport-sqs");
 let _runlane_utilities = require("@runlane/utilities");
 let zod = require("zod");
 zod = __toESM(zod, 1);
-//#region src/postgres-sqs-lane.ts
+// src/postgres-sqs-lane.ts
 const postgresSqsLaneOptionsSchema = zod.strictObject({
+	runHints: zod.boolean("runHints must be a boolean.").optional(),
 	name: zod.string(_runlane_contracts.contractValidationMessages.lane.name).min(1, _runlane_contracts.contractValidationMessages.lane.name).optional(),
-	postgres: zod.unknown().refine((postgresOptions) => postgresOptions !== void 0, { message: "Postgres SQS lane postgres options are required." }),
+	postgres: zod.looseObject({ runSignalNotifications: zod.never("Use runHints on a Postgres SQS lane.").optional() }, "Postgres SQS lane postgres options are required."),
 	sqs: zod.unknown().refine((sqsOptions) => sqsOptions !== void 0, { message: "Postgres SQS lane sqs options are required." })
 });
+/**
+* Creates the first-party production lane backed by Postgres storage and SQS wakeup delivery.
+*/
 function postgresSqsLane(options) {
 	const laneOptions = (0, _runlane_utilities.parseZodOrThrow)(postgresSqsLaneOptionsSchema, options, (error) => new _runlane_contracts.RunlaneError({
 		code: _runlane_contracts.ErrorCode.ConfigurationInvalid,
@@ -40,26 +43,38 @@ function postgresSqsLane(options) {
 			fallbackMessage: "Postgres SQS lane options must be an object.",
 			fieldMessages: {
 				name: _runlane_contracts.contractValidationMessages.lane.name,
-				postgres: "Postgres SQS lane postgres options are required.",
 				sqs: "Postgres SQS lane sqs options are required."
 			},
 			rootMessage: "Postgres SQS lane options must be an object.",
 			unsupportedKeyMessage: (option) => `Postgres SQS lane option "${option}" is not supported.`
 		})
 	}));
-	const transport = (0, _runlane_transport_sqs.sqsTransport)(laneOptions.sqs);
-	const storage = (0, _runlane_postgres_storage.postgresStorage)(laneOptions.postgres);
+	const deliveryProvider = (0, _runlane_transport_sqs.createSqsDeliveryProvider)(options.sqs);
+	const postgresOptions = options.postgres;
+	const postgresConfig = (0, _runlane_postgres_storage.resolvePostgresStorageConfig)({
+		connectionString: postgresOptions.connectionString,
+		schema: postgresOptions.schema
+	});
+	const hints = laneOptions.runHints ?? _runlane_contracts.contractDefaults.realtime.runHints;
+	const storage = (0, _runlane_postgres_storage.createPostgresStorageDriver)({
+		...postgresOptions,
+		runSignalNotifications: hints,
+		workSignalNotifications: postgresOptions.workSignalNotifications ?? false
+	});
 	return (0, _runlane_contracts.createLane)({
+		cli: [(0, _runlane_postgres_storage.createPostgresCliAdapter)(postgresConfig)],
 		delivery: {
 			mode: _runlane_contracts.LaneDeliveryMode.Transport,
-			transport
+			publisher: deliveryProvider.publisher,
+			surface: deliveryProvider.surface
 		},
 		name: laneOptions.name ?? "postgres-sqs",
-		productionDurable: true,
+		operatorReads: storage,
+		runSignal: hints ? storage.runSignal : void 0,
+		queues: deliveryProvider.queues,
 		storage
 	});
 }
-//#endregion
 exports.postgresSqsLane = postgresSqsLane;
 
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.cjs","names":["z","contractValidationMessages","RunlaneError","ErrorCode","LaneDeliveryMode"],"sources":["../src/postgres-sqs-lane.ts"],"sourcesContent":["import {\n  contractValidationMessages,\n  createLane,\n  ErrorCode,\n  LaneDeliveryMode,\n  RunlaneError,\n  type Lane,\n} from '@runlane/contracts'\nimport { postgresStorage, type PostgresStorageOptions } from '@runlane/postgres-storage'\nimport { sqsTransport, type SqsTransportOptions } from '@runlane/transport-sqs'\nimport { getZodIssueMessage, parseZodOrThrow } from '@runlane/utilities'\nimport * as z from 'zod'\n\nenum PostgresSqsLaneValidationMessage {\n  OptionsObject = 'Postgres SQS lane options must be an object.',\n  PostgresRequired = 'Postgres SQS lane postgres options are required.',\n  SqsRequired = 'Postgres SQS lane sqs options are required.',\n}\n\nconst postgresSqsLaneOptionsSchema = z.strictObject({\n  name: z.string(contractValidationMessages.lane.name).min(1, contractValidationMessages.lane.name).optional(),\n  postgres: z.unknown().refine((postgresOptions) => postgresOptions !== undefined, {\n    message: PostgresSqsLaneValidationMessage.PostgresRequired,\n  }),\n  sqs: z.unknown().refine((sqsOptions) => sqsOptions !== undefined, {\n    message: PostgresSqsLaneValidationMessage.SqsRequired,\n  }),\n})\n\n/**\n * Construction options for the first-party production Postgres/SQS lane.\n *\n * Postgres and SQS nested options are validated by their owning adapter packages.\n */\nexport type PostgresSqsLaneOptions = Omit<z.output<typeof postgresSqsLaneOptionsSchema>, 'postgres' | 'sqs'> & {\n  readonly postgres: PostgresStorageOptions\n  readonly sqs: SqsTransportOptions\n}\n\n/**\n * Creates the first-party production lane backed by Postgres storage and SQS wakeup delivery.\n */\nexport function postgresSqsLane(options: PostgresSqsLaneOptions): Lane\nexport function postgresSqsLane(options: unknown): Lane {\n  const laneOptions = parseZodOrThrow(\n    postgresSqsLaneOptionsSchema,\n    options,\n    (error) =>\n      new RunlaneError({\n        code: ErrorCode.ConfigurationInvalid,\n        message: getZodIssueMessage(error.issues[0], {\n          fallbackMessage: PostgresSqsLaneValidationMessage.OptionsObject,\n          fieldMessages: {\n            name: contractValidationMessages.lane.name,\n            postgres: PostgresSqsLaneValidationMessage.PostgresRequired,\n            sqs: PostgresSqsLaneValidationMessage.SqsRequired,\n          },\n          rootMessage: PostgresSqsLaneValidationMessage.OptionsObject,\n          unsupportedKeyMessage: (option) => `Postgres SQS lane option \"${option}\" is not supported.`,\n        }),\n      }),\n  )\n  const transport = sqsTransport(laneOptions.sqs as SqsTransportOptions)\n  const storage = postgresStorage(laneOptions.postgres as PostgresStorageOptions)\n\n  return createLane({\n    delivery: { mode: LaneDeliveryMode.Transport, transport },\n    name: laneOptions.name ?? 'postgres-sqs',\n    productionDurable: true,\n    storage,\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAmBA,MAAM,+BAA+BA,IAAE,aAAa;CAClD,MAAMA,IAAE,OAAOC,mBAAAA,2BAA2B,KAAK,IAAI,EAAE,IAAI,GAAGA,mBAAAA,2BAA2B,KAAK,IAAI,EAAE,SAAS;CAC3G,UAAUD,IAAE,QAAQ,EAAE,QAAQ,oBAAoB,oBAAoB,KAAA,GAAW,EAC/E,SAAA,mDACF,CAAC;CACD,KAAKA,IAAE,QAAQ,EAAE,QAAQ,eAAe,eAAe,KAAA,GAAW,EAChE,SAAA,8CACF,CAAC;AACH,CAAC;AAgBD,SAAgB,gBAAgB,SAAwB;CACtD,MAAM,eAAA,GAAA,mBAAA,iBACJ,8BACA,UACC,UACC,IAAIE,mBAAAA,aAAa;EACf,MAAMC,mBAAAA,UAAU;EAChB,UAAA,GAAA,mBAAA,oBAA4B,MAAM,OAAO,IAAI;GAC3C,iBAAA;GACA,eAAe;IACb,MAAMF,mBAAAA,2BAA2B,KAAK;IACtC,UAAA;IACA,KAAA;GACF;GACA,aAAA;GACA,wBAAwB,WAAW,6BAA6B,OAAO;EACzE,CAAC;CACH,CAAC,CACL;CACA,MAAM,aAAA,GAAA,uBAAA,cAAyB,YAAY,GAA0B;CACrE,MAAM,WAAA,GAAA,0BAAA,iBAA0B,YAAY,QAAkC;CAE9E,QAAA,GAAA,mBAAA,YAAkB;EAChB,UAAU;GAAE,MAAMG,mBAAAA,iBAAiB;GAAW;EAAU;EACxD,MAAM,YAAY,QAAQ;EAC1B,mBAAmB;EACnB;CACF,CAAC;AACH"}
+{"version":3,"file":"index.cjs","names":["z","contractValidationMessages","parseZodOrThrow","RunlaneError","ErrorCode","getZodIssueMessage","createSqsDeliveryProvider","resolvePostgresStorageConfig","contractDefaults","createPostgresStorageDriver","createLane","createPostgresCliAdapter","LaneDeliveryMode"],"sources":["../src/postgres-sqs-lane.ts"],"sourcesContent":["import {\n  contractDefaults,\n  contractValidationMessages,\n  createLane,\n  ErrorCode,\n  LaneDeliveryMode,\n  RunlaneError,\n  type TransportLane,\n} from '@runlane/contracts'\nimport {\n  createPostgresCliAdapter,\n  createPostgresStorageDriver,\n  resolvePostgresStorageConfig,\n  type PostgresStorageDriverOptions,\n} from '@runlane/postgres-storage'\nimport { createSqsDeliveryProvider, type SqsLambdaHandler, type SqsTransportOptions } from '@runlane/transport-sqs'\nimport { getZodIssueMessage, parseZodOrThrow } from '@runlane/utilities'\nimport * as z from 'zod'\n\nenum PostgresSqsLaneValidationMessage {\n  OptionsObject = 'Postgres SQS lane options must be an object.',\n  PostgresRequired = 'Postgres SQS lane postgres options are required.',\n  SqsRequired = 'Postgres SQS lane sqs options are required.',\n}\n\nconst postgresSqsLaneOptionsSchema = z.strictObject({\n  runHints: z.boolean('runHints must be a boolean.').optional(),\n  name: z.string(contractValidationMessages.lane.name).min(1, contractValidationMessages.lane.name).optional(),\n  postgres: z.looseObject(\n    { runSignalNotifications: z.never('Use runHints on a Postgres SQS lane.').optional() },\n    PostgresSqsLaneValidationMessage.PostgresRequired,\n  ),\n  sqs: z.unknown().refine((sqsOptions) => sqsOptions !== undefined, {\n    message: PostgresSqsLaneValidationMessage.SqsRequired,\n  }),\n})\n\n/**\n * Construction options for the first-party production Postgres/SQS lane.\n *\n * runHints defaults to true; set false for serverless consumers to avoid a dedicated connection.\n * Postgres and SQS nested options are validated by their owning adapter packages.\n */\nexport type PostgresSqsLaneOptions = Omit<z.output<typeof postgresSqsLaneOptionsSchema>, 'postgres' | 'sqs'> & {\n  readonly postgres: Omit<PostgresStorageDriverOptions, 'runSignalNotifications'>\n  readonly sqs: SqsTransportOptions\n}\n\n/**\n * Creates the first-party production lane backed by Postgres storage and SQS wakeup delivery.\n */\nexport function postgresSqsLane(options: PostgresSqsLaneOptions): TransportLane<SqsLambdaHandler> {\n  const laneOptions = parseZodOrThrow(\n    postgresSqsLaneOptionsSchema,\n    options,\n    (error) =>\n      new RunlaneError({\n        code: ErrorCode.ConfigurationInvalid,\n        message: getZodIssueMessage(error.issues[0], {\n          fallbackMessage: PostgresSqsLaneValidationMessage.OptionsObject,\n          fieldMessages: {\n            name: contractValidationMessages.lane.name,\n            sqs: PostgresSqsLaneValidationMessage.SqsRequired,\n          },\n          rootMessage: PostgresSqsLaneValidationMessage.OptionsObject,\n          unsupportedKeyMessage: (option) => `Postgres SQS lane option \"${option}\" is not supported.`,\n        }),\n      }),\n  )\n  const deliveryProvider = createSqsDeliveryProvider(options.sqs)\n  const postgresOptions = options.postgres\n  const postgresConfig = resolvePostgresStorageConfig({\n    connectionString: postgresOptions.connectionString,\n    schema: postgresOptions.schema,\n  })\n  // Nothing on this lane listens for PostgreSQL work signals; SQS carries every wakeup.\n  const hints = laneOptions.runHints ?? contractDefaults.realtime.runHints\n  const storage = createPostgresStorageDriver({\n    ...postgresOptions,\n    runSignalNotifications: hints,\n    workSignalNotifications: postgresOptions.workSignalNotifications ?? false,\n  })\n\n  return createLane({\n    cli: [createPostgresCliAdapter(postgresConfig)],\n    delivery: {\n      mode: LaneDeliveryMode.Transport,\n      publisher: deliveryProvider.publisher,\n      surface: deliveryProvider.surface,\n    },\n    name: laneOptions.name ?? 'postgres-sqs',\n    operatorReads: storage,\n    runSignal: hints ? storage.runSignal : undefined,\n    queues: deliveryProvider.queues,\n    storage,\n  })\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,MAAM,+BAA+BA,IAAE,aAAa;CAClD,UAAUA,IAAE,QAAQ,6BAA6B,CAAC,CAAC,SAAS;CAC5D,MAAMA,IAAE,OAAOC,mBAAAA,2BAA2B,KAAK,IAAI,CAAC,CAAC,IAAI,GAAGA,mBAAAA,2BAA2B,KAAK,IAAI,CAAC,CAAC,SAAS;CAC3G,UAAUD,IAAE,YACV,EAAE,wBAAwBA,IAAE,MAAM,sCAAsC,CAAC,CAAC,SAAS,EAAE,GAAA,kDAEvF;CACA,KAAKA,IAAE,QAAQ,CAAC,CAAC,QAAQ,eAAe,eAAe,KAAA,GAAW,EAChE,SAAA,8CACF,CAAC;AACH,CAAC;;;;AAgBD,SAAgB,gBAAgB,SAAkE;CAChG,MAAM,eAAA,GAAcE,mBAAAA,gBAAAA,CAClB,8BACA,UACC,UACC,IAAIC,mBAAAA,aAAa;EACf,MAAMC,mBAAAA,UAAU;EAChB,UAAA,GAASC,mBAAAA,mBAAAA,CAAmB,MAAM,OAAO,IAAI;GAC3C,iBAAA;GACA,eAAe;IACb,MAAMJ,mBAAAA,2BAA2B,KAAK;IACtC,KAAA;GACF;GACA,aAAA;GACA,wBAAwB,WAAW,6BAA6B,OAAO;EACzE,CAAC;CACH,CAAC,CACL;CACA,MAAM,oBAAA,GAAmBK,uBAAAA,0BAAAA,CAA0B,QAAQ,GAAG;CAC9D,MAAM,kBAAkB,QAAQ;CAChC,MAAM,kBAAA,GAAiBC,0BAAAA,6BAAAA,CAA6B;EAClD,kBAAkB,gBAAgB;EAClC,QAAQ,gBAAgB;CAC1B,CAAC;CAED,MAAM,QAAQ,YAAY,YAAYC,mBAAAA,iBAAiB,SAAS;CAChE,MAAM,WAAA,GAAUC,0BAAAA,4BAAAA,CAA4B;EAC1C,GAAG;EACH,wBAAwB;EACxB,yBAAyB,gBAAgB,2BAA2B;CACtE,CAAC;CAED,QAAA,GAAOC,mBAAAA,WAAAA,CAAW;EAChB,KAAK,EAAA,GAACC,0BAAAA,yBAAAA,CAAyB,cAAc,CAAC;EAC9C,UAAU;GACR,MAAMC,mBAAAA,iBAAiB;GACvB,WAAW,iBAAiB;GAC5B,SAAS,iBAAiB;EAC5B;EACA,MAAM,YAAY,QAAQ;EAC1B,eAAe;EACf,WAAW,QAAQ,QAAQ,YAAY,KAAA;EACvC,QAAQ,iBAAiB;EACzB;CACF,CAAC;AACH"}

package/dist/index.d.cts

@@ -1,27 +1,28 @@
-import { Lane } from "@runlane/contracts";
-import { PostgresStorageOptions } from "@runlane/postgres-storage";
-import { SqsTransportOptions } from "@runlane/transport-sqs";
+import { TransportLane } from "@runlane/contracts";
+import { PostgresStorageDriverOptions } from "@runlane/postgres-storage";
+import { SqsLambdaHandler, SqsTransportOptions } from "@runlane/transport-sqs";
 import * as z from "zod";
-
-//#region src/postgres-sqs-lane.d.ts
 declare const postgresSqsLaneOptionsSchema: z.ZodObject<{
+  runHints: z.ZodOptional<z.ZodBoolean>;
   name: z.ZodOptional<z.ZodString>;
-  postgres: z.ZodUnknown & z.ZodType<{} | null, unknown, z.core.$ZodTypeInternals<{} | null, unknown>>;
+  postgres: z.ZodObject<{
+    runSignalNotifications: z.ZodOptional<z.ZodNever>;
+  }, z.core.$loose>;
   sqs: z.ZodUnknown & z.ZodType<{} | null, unknown, z.core.$ZodTypeInternals<{} | null, unknown>>;
 }, z.core.$strict>;
 /**
  * Construction options for the first-party production Postgres/SQS lane.
  *
+ * runHints defaults to true; set false for serverless consumers to avoid a dedicated connection.
  * Postgres and SQS nested options are validated by their owning adapter packages.
  */
 type PostgresSqsLaneOptions = Omit<z.output<typeof postgresSqsLaneOptionsSchema>, 'postgres' | 'sqs'> & {
-  readonly postgres: PostgresStorageOptions;
+  readonly postgres: Omit<PostgresStorageDriverOptions, 'runSignalNotifications'>;
   readonly sqs: SqsTransportOptions;
 };
 /**
  * Creates the first-party production lane backed by Postgres storage and SQS wakeup delivery.
  */
-declare function postgresSqsLane(options: PostgresSqsLaneOptions): Lane;
-//#endregion
-export { type PostgresSqsLaneOptions, postgresSqsLane };
+export declare function postgresSqsLane(options: PostgresSqsLaneOptions): TransportLane<SqsLambdaHandler>;
+export type { PostgresSqsLaneOptions };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.cts","names":[],"sources":["../src/postgres-sqs-lane.ts"],"mappings":";;;;;;cAmBM,4BAAA,EAA4B,CAAA,CAAA,SAAA;;;;;;;;;;KAetB,sBAAA,GAAyB,IAAA,CAAK,CAAA,CAAE,MAAA,QAAc,4BAAA;EAAA,SAC/C,QAAA,EAAU,sBAAA;EAAA,SACV,GAAA,EAAK,mBAAA;AAAA;;;;iBAMA,eAAA,CAAgB,OAAA,EAAS,sBAAA,GAAyB,IAAI"}
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/postgres-sqs-lane.ts"],"mappings":";;;;cAyBM,8BAA4B,EAAA;;;;;;;GAUhC,EAAA,KAAA;;;;;;;KAQU,yBAAyB,KAAK,EAAE,cAAc;WAC/C,UAAU,KAAK;WACf,KAAK;;;;;wBAMA,gBAAgB,SAAS,yBAAyB,cAAc"}

package/dist/index.d.mts

@@ -1,27 +1,28 @@
-import { Lane } from "@runlane/contracts";
-import { PostgresStorageOptions } from "@runlane/postgres-storage";
-import { SqsTransportOptions } from "@runlane/transport-sqs";
+import { TransportLane } from "@runlane/contracts";
+import { PostgresStorageDriverOptions } from "@runlane/postgres-storage";
+import { SqsLambdaHandler, SqsTransportOptions } from "@runlane/transport-sqs";
 import * as z from "zod";
-
-//#region src/postgres-sqs-lane.d.ts
 declare const postgresSqsLaneOptionsSchema: z.ZodObject<{
+  runHints: z.ZodOptional<z.ZodBoolean>;
   name: z.ZodOptional<z.ZodString>;
-  postgres: z.ZodUnknown & z.ZodType<{} | null, unknown, z.core.$ZodTypeInternals<{} | null, unknown>>;
+  postgres: z.ZodObject<{
+    runSignalNotifications: z.ZodOptional<z.ZodNever>;
+  }, z.core.$loose>;
   sqs: z.ZodUnknown & z.ZodType<{} | null, unknown, z.core.$ZodTypeInternals<{} | null, unknown>>;
 }, z.core.$strict>;
 /**
  * Construction options for the first-party production Postgres/SQS lane.
  *
+ * runHints defaults to true; set false for serverless consumers to avoid a dedicated connection.
  * Postgres and SQS nested options are validated by their owning adapter packages.
  */
 type PostgresSqsLaneOptions = Omit<z.output<typeof postgresSqsLaneOptionsSchema>, 'postgres' | 'sqs'> & {
-  readonly postgres: PostgresStorageOptions;
+  readonly postgres: Omit<PostgresStorageDriverOptions, 'runSignalNotifications'>;
   readonly sqs: SqsTransportOptions;
 };
 /**
  * Creates the first-party production lane backed by Postgres storage and SQS wakeup delivery.
  */
-declare function postgresSqsLane(options: PostgresSqsLaneOptions): Lane;
-//#endregion
-export { type PostgresSqsLaneOptions, postgresSqsLane };
+export declare function postgresSqsLane(options: PostgresSqsLaneOptions): TransportLane<SqsLambdaHandler>;
+export type { PostgresSqsLaneOptions };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/postgres-sqs-lane.ts"],"mappings":";;;;;;cAmBM,4BAAA,EAA4B,CAAA,CAAA,SAAA;;;;;;;;;;KAetB,sBAAA,GAAyB,IAAA,CAAK,CAAA,CAAE,MAAA,QAAc,4BAAA;EAAA,SAC/C,QAAA,EAAU,sBAAA;EAAA,SACV,GAAA,EAAK,mBAAA;AAAA;;;;iBAMA,eAAA,CAAgB,OAAA,EAAS,sBAAA,GAAyB,IAAI"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/postgres-sqs-lane.ts"],"mappings":";;;;cAyBM,8BAA4B,EAAA;;;;;;;GAUhC,EAAA,KAAA;;;;;;;KAQU,yBAAyB,KAAK,EAAE,cAAc;WAC/C,UAAU,KAAK;WACf,KAAK;;;;;wBAMA,gBAAgB,SAAS,yBAAyB,cAAc"}

package/dist/index.mjs

@@ -1,14 +1,18 @@
-import { ErrorCode, LaneDeliveryMode, RunlaneError, contractValidationMessages, createLane } from "@runlane/contracts";
-import { postgresStorage } from "@runlane/postgres-storage";
-import { sqsTransport } from "@runlane/transport-sqs";
+import { ErrorCode, LaneDeliveryMode, RunlaneError, contractDefaults, contractValidationMessages, createLane } from "@runlane/contracts";
+import { createPostgresCliAdapter, createPostgresStorageDriver, resolvePostgresStorageConfig } from "@runlane/postgres-storage";
+import { createSqsDeliveryProvider } from "@runlane/transport-sqs";
 import { getZodIssueMessage, parseZodOrThrow } from "@runlane/utilities";
 import * as z from "zod";
-//#region src/postgres-sqs-lane.ts
+// src/postgres-sqs-lane.ts
 const postgresSqsLaneOptionsSchema = z.strictObject({
+	runHints: z.boolean("runHints must be a boolean.").optional(),
 	name: z.string(contractValidationMessages.lane.name).min(1, contractValidationMessages.lane.name).optional(),
-	postgres: z.unknown().refine((postgresOptions) => postgresOptions !== void 0, { message: "Postgres SQS lane postgres options are required." }),
+	postgres: z.looseObject({ runSignalNotifications: z.never("Use runHints on a Postgres SQS lane.").optional() }, "Postgres SQS lane postgres options are required."),
 	sqs: z.unknown().refine((sqsOptions) => sqsOptions !== void 0, { message: "Postgres SQS lane sqs options are required." })
 });
+/**
+* Creates the first-party production lane backed by Postgres storage and SQS wakeup delivery.
+*/
 function postgresSqsLane(options) {
 	const laneOptions = parseZodOrThrow(postgresSqsLaneOptionsSchema, options, (error) => new RunlaneError({
 		code: ErrorCode.ConfigurationInvalid,
@@ -16,26 +20,38 @@ function postgresSqsLane(options) {
 			fallbackMessage: "Postgres SQS lane options must be an object.",
 			fieldMessages: {
 				name: contractValidationMessages.lane.name,
-				postgres: "Postgres SQS lane postgres options are required.",
 				sqs: "Postgres SQS lane sqs options are required."
 			},
 			rootMessage: "Postgres SQS lane options must be an object.",
 			unsupportedKeyMessage: (option) => `Postgres SQS lane option "${option}" is not supported.`
 		})
 	}));
-	const transport = sqsTransport(laneOptions.sqs);
-	const storage = postgresStorage(laneOptions.postgres);
+	const deliveryProvider = createSqsDeliveryProvider(options.sqs);
+	const postgresOptions = options.postgres;
+	const postgresConfig = resolvePostgresStorageConfig({
+		connectionString: postgresOptions.connectionString,
+		schema: postgresOptions.schema
+	});
+	const hints = laneOptions.runHints ?? contractDefaults.realtime.runHints;
+	const storage = createPostgresStorageDriver({
+		...postgresOptions,
+		runSignalNotifications: hints,
+		workSignalNotifications: postgresOptions.workSignalNotifications ?? false
+	});
 	return createLane({
+		cli: [createPostgresCliAdapter(postgresConfig)],
 		delivery: {
 			mode: LaneDeliveryMode.Transport,
-			transport
+			publisher: deliveryProvider.publisher,
+			surface: deliveryProvider.surface
 		},
 		name: laneOptions.name ?? "postgres-sqs",
-		productionDurable: true,
+		operatorReads: storage,
+		runSignal: hints ? storage.runSignal : void 0,
+		queues: deliveryProvider.queues,
 		storage
 	});
 }
-//#endregion
 export { postgresSqsLane };
 
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../src/postgres-sqs-lane.ts"],"sourcesContent":["import {\n  contractValidationMessages,\n  createLane,\n  ErrorCode,\n  LaneDeliveryMode,\n  RunlaneError,\n  type Lane,\n} from '@runlane/contracts'\nimport { postgresStorage, type PostgresStorageOptions } from '@runlane/postgres-storage'\nimport { sqsTransport, type SqsTransportOptions } from '@runlane/transport-sqs'\nimport { getZodIssueMessage, parseZodOrThrow } from '@runlane/utilities'\nimport * as z from 'zod'\n\nenum PostgresSqsLaneValidationMessage {\n  OptionsObject = 'Postgres SQS lane options must be an object.',\n  PostgresRequired = 'Postgres SQS lane postgres options are required.',\n  SqsRequired = 'Postgres SQS lane sqs options are required.',\n}\n\nconst postgresSqsLaneOptionsSchema = z.strictObject({\n  name: z.string(contractValidationMessages.lane.name).min(1, contractValidationMessages.lane.name).optional(),\n  postgres: z.unknown().refine((postgresOptions) => postgresOptions !== undefined, {\n    message: PostgresSqsLaneValidationMessage.PostgresRequired,\n  }),\n  sqs: z.unknown().refine((sqsOptions) => sqsOptions !== undefined, {\n    message: PostgresSqsLaneValidationMessage.SqsRequired,\n  }),\n})\n\n/**\n * Construction options for the first-party production Postgres/SQS lane.\n *\n * Postgres and SQS nested options are validated by their owning adapter packages.\n */\nexport type PostgresSqsLaneOptions = Omit<z.output<typeof postgresSqsLaneOptionsSchema>, 'postgres' | 'sqs'> & {\n  readonly postgres: PostgresStorageOptions\n  readonly sqs: SqsTransportOptions\n}\n\n/**\n * Creates the first-party production lane backed by Postgres storage and SQS wakeup delivery.\n */\nexport function postgresSqsLane(options: PostgresSqsLaneOptions): Lane\nexport function postgresSqsLane(options: unknown): Lane {\n  const laneOptions = parseZodOrThrow(\n    postgresSqsLaneOptionsSchema,\n    options,\n    (error) =>\n      new RunlaneError({\n        code: ErrorCode.ConfigurationInvalid,\n        message: getZodIssueMessage(error.issues[0], {\n          fallbackMessage: PostgresSqsLaneValidationMessage.OptionsObject,\n          fieldMessages: {\n            name: contractValidationMessages.lane.name,\n            postgres: PostgresSqsLaneValidationMessage.PostgresRequired,\n            sqs: PostgresSqsLaneValidationMessage.SqsRequired,\n          },\n          rootMessage: PostgresSqsLaneValidationMessage.OptionsObject,\n          unsupportedKeyMessage: (option) => `Postgres SQS lane option \"${option}\" is not supported.`,\n        }),\n      }),\n  )\n  const transport = sqsTransport(laneOptions.sqs as SqsTransportOptions)\n  const storage = postgresStorage(laneOptions.postgres as PostgresStorageOptions)\n\n  return createLane({\n    delivery: { mode: LaneDeliveryMode.Transport, transport },\n    name: laneOptions.name ?? 'postgres-sqs',\n    productionDurable: true,\n    storage,\n  })\n}\n"],"mappings":";;;;;;AAmBA,MAAM,+BAA+B,EAAE,aAAa;CAClD,MAAM,EAAE,OAAO,2BAA2B,KAAK,IAAI,EAAE,IAAI,GAAG,2BAA2B,KAAK,IAAI,EAAE,SAAS;CAC3G,UAAU,EAAE,QAAQ,EAAE,QAAQ,oBAAoB,oBAAoB,KAAA,GAAW,EAC/E,SAAA,mDACF,CAAC;CACD,KAAK,EAAE,QAAQ,EAAE,QAAQ,eAAe,eAAe,KAAA,GAAW,EAChE,SAAA,8CACF,CAAC;AACH,CAAC;AAgBD,SAAgB,gBAAgB,SAAwB;CACtD,MAAM,cAAc,gBAClB,8BACA,UACC,UACC,IAAI,aAAa;EACf,MAAM,UAAU;EAChB,SAAS,mBAAmB,MAAM,OAAO,IAAI;GAC3C,iBAAA;GACA,eAAe;IACb,MAAM,2BAA2B,KAAK;IACtC,UAAA;IACA,KAAA;GACF;GACA,aAAA;GACA,wBAAwB,WAAW,6BAA6B,OAAO;EACzE,CAAC;CACH,CAAC,CACL;CACA,MAAM,YAAY,aAAa,YAAY,GAA0B;CACrE,MAAM,UAAU,gBAAgB,YAAY,QAAkC;CAE9E,OAAO,WAAW;EAChB,UAAU;GAAE,MAAM,iBAAiB;GAAW;EAAU;EACxD,MAAM,YAAY,QAAQ;EAC1B,mBAAmB;EACnB;CACF,CAAC;AACH"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/postgres-sqs-lane.ts"],"sourcesContent":["import {\n  contractDefaults,\n  contractValidationMessages,\n  createLane,\n  ErrorCode,\n  LaneDeliveryMode,\n  RunlaneError,\n  type TransportLane,\n} from '@runlane/contracts'\nimport {\n  createPostgresCliAdapter,\n  createPostgresStorageDriver,\n  resolvePostgresStorageConfig,\n  type PostgresStorageDriverOptions,\n} from '@runlane/postgres-storage'\nimport { createSqsDeliveryProvider, type SqsLambdaHandler, type SqsTransportOptions } from '@runlane/transport-sqs'\nimport { getZodIssueMessage, parseZodOrThrow } from '@runlane/utilities'\nimport * as z from 'zod'\n\nenum PostgresSqsLaneValidationMessage {\n  OptionsObject = 'Postgres SQS lane options must be an object.',\n  PostgresRequired = 'Postgres SQS lane postgres options are required.',\n  SqsRequired = 'Postgres SQS lane sqs options are required.',\n}\n\nconst postgresSqsLaneOptionsSchema = z.strictObject({\n  runHints: z.boolean('runHints must be a boolean.').optional(),\n  name: z.string(contractValidationMessages.lane.name).min(1, contractValidationMessages.lane.name).optional(),\n  postgres: z.looseObject(\n    { runSignalNotifications: z.never('Use runHints on a Postgres SQS lane.').optional() },\n    PostgresSqsLaneValidationMessage.PostgresRequired,\n  ),\n  sqs: z.unknown().refine((sqsOptions) => sqsOptions !== undefined, {\n    message: PostgresSqsLaneValidationMessage.SqsRequired,\n  }),\n})\n\n/**\n * Construction options for the first-party production Postgres/SQS lane.\n *\n * runHints defaults to true; set false for serverless consumers to avoid a dedicated connection.\n * Postgres and SQS nested options are validated by their owning adapter packages.\n */\nexport type PostgresSqsLaneOptions = Omit<z.output<typeof postgresSqsLaneOptionsSchema>, 'postgres' | 'sqs'> & {\n  readonly postgres: Omit<PostgresStorageDriverOptions, 'runSignalNotifications'>\n  readonly sqs: SqsTransportOptions\n}\n\n/**\n * Creates the first-party production lane backed by Postgres storage and SQS wakeup delivery.\n */\nexport function postgresSqsLane(options: PostgresSqsLaneOptions): TransportLane<SqsLambdaHandler> {\n  const laneOptions = parseZodOrThrow(\n    postgresSqsLaneOptionsSchema,\n    options,\n    (error) =>\n      new RunlaneError({\n        code: ErrorCode.ConfigurationInvalid,\n        message: getZodIssueMessage(error.issues[0], {\n          fallbackMessage: PostgresSqsLaneValidationMessage.OptionsObject,\n          fieldMessages: {\n            name: contractValidationMessages.lane.name,\n            sqs: PostgresSqsLaneValidationMessage.SqsRequired,\n          },\n          rootMessage: PostgresSqsLaneValidationMessage.OptionsObject,\n          unsupportedKeyMessage: (option) => `Postgres SQS lane option \"${option}\" is not supported.`,\n        }),\n      }),\n  )\n  const deliveryProvider = createSqsDeliveryProvider(options.sqs)\n  const postgresOptions = options.postgres\n  const postgresConfig = resolvePostgresStorageConfig({\n    connectionString: postgresOptions.connectionString,\n    schema: postgresOptions.schema,\n  })\n  // Nothing on this lane listens for PostgreSQL work signals; SQS carries every wakeup.\n  const hints = laneOptions.runHints ?? contractDefaults.realtime.runHints\n  const storage = createPostgresStorageDriver({\n    ...postgresOptions,\n    runSignalNotifications: hints,\n    workSignalNotifications: postgresOptions.workSignalNotifications ?? false,\n  })\n\n  return createLane({\n    cli: [createPostgresCliAdapter(postgresConfig)],\n    delivery: {\n      mode: LaneDeliveryMode.Transport,\n      publisher: deliveryProvider.publisher,\n      surface: deliveryProvider.surface,\n    },\n    name: laneOptions.name ?? 'postgres-sqs',\n    operatorReads: storage,\n    runSignal: hints ? storage.runSignal : undefined,\n    queues: deliveryProvider.queues,\n    storage,\n  })\n}\n"],"mappings":";;;;;;AAyBA,MAAM,+BAA+B,EAAE,aAAa;CAClD,UAAU,EAAE,QAAQ,6BAA6B,CAAC,CAAC,SAAS;CAC5D,MAAM,EAAE,OAAO,2BAA2B,KAAK,IAAI,CAAC,CAAC,IAAI,GAAG,2BAA2B,KAAK,IAAI,CAAC,CAAC,SAAS;CAC3G,UAAU,EAAE,YACV,EAAE,wBAAwB,EAAE,MAAM,sCAAsC,CAAC,CAAC,SAAS,EAAE,GAAA,kDAEvF;CACA,KAAK,EAAE,QAAQ,CAAC,CAAC,QAAQ,eAAe,eAAe,KAAA,GAAW,EAChE,SAAA,8CACF,CAAC;AACH,CAAC;;;;AAgBD,SAAgB,gBAAgB,SAAkE;CAChG,MAAM,cAAc,gBAClB,8BACA,UACC,UACC,IAAI,aAAa;EACf,MAAM,UAAU;EAChB,SAAS,mBAAmB,MAAM,OAAO,IAAI;GAC3C,iBAAA;GACA,eAAe;IACb,MAAM,2BAA2B,KAAK;IACtC,KAAA;GACF;GACA,aAAA;GACA,wBAAwB,WAAW,6BAA6B,OAAO;EACzE,CAAC;CACH,CAAC,CACL;CACA,MAAM,mBAAmB,0BAA0B,QAAQ,GAAG;CAC9D,MAAM,kBAAkB,QAAQ;CAChC,MAAM,iBAAiB,6BAA6B;EAClD,kBAAkB,gBAAgB;EAClC,QAAQ,gBAAgB;CAC1B,CAAC;CAED,MAAM,QAAQ,YAAY,YAAY,iBAAiB,SAAS;CAChE,MAAM,UAAU,4BAA4B;EAC1C,GAAG;EACH,wBAAwB;EACxB,yBAAyB,gBAAgB,2BAA2B;CACtE,CAAC;CAED,OAAO,WAAW;EAChB,KAAK,CAAC,yBAAyB,cAAc,CAAC;EAC9C,UAAU;GACR,MAAM,iBAAiB;GACvB,WAAW,iBAAiB;GAC5B,SAAS,iBAAiB;EAC5B;EACA,MAAM,YAAY,QAAQ;EAC1B,eAAe;EACf,WAAW,QAAQ,QAAQ,YAAY,KAAA;EACvC,QAAQ,iBAAiB;EACzB;CACF,CAAC;AACH"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runlane/lane-postgres-sqs",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Production-ready Runlane lane composing PostgreSQL storage with Amazon SQS transport.",
   "type": "module",
   "sideEffects": false,
@@ -48,11 +48,11 @@
     "access": "public"
   },
   "dependencies": {
-    "zod": "^4.3.6",
-    "@runlane/contracts": "0.3.0",
-    "@runlane/postgres-storage": "0.3.0",
-    "@runlane/transport-sqs": "0.3.0",
-    "@runlane/utilities": "0.3.0"
+    "zod": "^4.5.4",
+    "@runlane/contracts": "0.5.0",
+    "@runlane/postgres-storage": "0.5.0",
+    "@runlane/transport-sqs": "0.5.0",
+    "@runlane/utilities": "0.5.0"
   },
   "devDependencies": {
     "@aws-sdk/client-sqs": "^3.1045.0",
@@ -60,17 +60,20 @@
     "pg": "^8.20.0",
     "tsx": "^4.21.0",
     "@repo/eslint": "0.0.0",
-    "@repo/postgres-test-runner": "0.0.3",
     "@repo/tsdown": "0.0.0",
     "@repo/typescript": "0.0.0",
     "@repo/vitest": "0.0.0",
-    "@runlane/core": "0.3.0",
-    "@runlane/testing": "0.3.0"
+    "@runlane/core": "0.5.0",
+    "@runlane/lane-postgres-polling": "0.5.0",
+    "@runlane/testing": "0.5.0"
   },
   "scripts": {
+    "bench:counters": "tsx --tsconfig ../../tooling/typescript/workspace-source.json scripts/fixed-workload-counters.ts",
     "build": "tsdown",
     "clean": "rimraf dist",
     "lint": "eslint --max-warnings 0",
+    "stress": "tsx --tsconfig ../../tooling/typescript/workspace-source.json scripts/run-stress.ts",
+    "stress:local": "tsx --tsconfig ../../tooling/typescript/workspace-source.json scripts/stress-local.ts",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "test:postgres:local": "tsx --tsconfig ../../tooling/typescript/workspace-source.json scripts/test-postgres-local.ts",