@walkeros/server-source-aws 4.7.0-next-1790245733116 → 4.7.0

package/CHANGELOG.md

@@ -1,23 +1,47 @@
 # @walkeros/server-source-aws
 
-## 4.7.0-next-1790245733116
+## 4.7.0
 
-### Patch Changes
+### Minor Changes
 
-- Updated dependencies [57788bc]
+- 64b06de: Packages with several exports, such as the GCP and AWS sources and
+  destinations, now publish a settings schema per export. `walkeros validate`
+  and MCP `package_get` use the schema of the export a step imports. Pub/Sub,
+  BigQuery, SNS and SQS steps pinned to this release or later are checked
+  instead of skipped; older pins still report a skip.
+
+### Patch Changes
+
+- 74821ed: Simulate records every vendor call through one recorder, `observeEnv`
+  from `@walkeros/core`, and runs offline: BigQuery, Data Manager and the
+  Sheets, GCS and S3 stores reach the network through `env`. Client and `Env`
+  types of BigQuery, Firehose, PostHog, SQS and Pub/Sub are structural.
+  `@walkeros/cli` exports `resolveExportName` and `selectDevExamples` and drops
+  `findExample` and `compareOutput`.
+- 74821ed: Simulate starts only the simulated step, and a simulated transformer
+  continues through its `next`. Source simulations list the commands a source
+  issues as `elb` calls; `--page-url` sets the web page. Express flows need no
+  port. Packages with several exports use per-export examples and mocks, and a
+  destination without a mock env is refused instead of calling the vendor.
+- Updated dependencies [74821ed]
 - Updated dependencies [06b498a]
-- Updated dependencies [f5a1cfd]
-- Updated dependencies [ef02916]
+- Updated dependencies [74821ed]
+- Updated dependencies [64b06de]
+- Updated dependencies [4b4937f]
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
 - Updated dependencies [06b498a]
-- Updated dependencies [ef02916]
-- Updated dependencies [2aebc53]
-- Updated dependencies [f5a1cfd]
-- Updated dependencies [f5a1cfd]
-- Updated dependencies [2aebc53]
-- Updated dependencies [8f8aea6]
-- Updated dependencies [2aebc53]
-- Updated dependencies [2aebc53]
-  - @walkeros/core@4.7.0-next-1790245733116
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
+- Updated dependencies [e860006]
+- Updated dependencies [74821ed]
+- Updated dependencies [74821ed]
+- Updated dependencies [4f89234]
+  - @walkeros/core@4.7.0
 
 ## 4.6.1
 

package/dist/dev.d.mts

@@ -2,7 +2,7 @@ import * as _walkeros_core_dev from '@walkeros/core/dev';
 import { z } from '@walkeros/core/dev';
 import { Source, Flow, Trigger } from '@walkeros/core';
 import { APIGatewayProxyEvent, APIGatewayProxyEventV2, Context, APIGatewayProxyResult } from 'aws-lambda';
-import { SQSClient, ReceiveMessageCommand, DeleteMessageCommand, CreateQueueCommand, GetQueueUrlCommand, GetQueueAttributesCommand } from '@aws-sdk/client-sqs';
+import { SQSClientConfig, GetQueueUrlCommand, GetQueueUrlCommandOutput, GetQueueAttributesCommand, GetQueueAttributesCommandOutput, ReceiveMessageCommand, ReceiveMessageCommandOutput, DeleteMessageCommand, DeleteMessageCommandOutput, CreateQueueCommand, CreateQueueCommandOutput } from '@aws-sdk/client-sqs';
 import { SNSClient, SubscribeCommand } from '@aws-sdk/client-sns';
 
 /**
@@ -74,19 +74,6 @@ type Settings = z.infer<typeof SettingsSchema>;
 
 declare const settings$1: _walkeros_core_dev.JSONSchema;
 
-declare const settings: _walkeros_core_dev.JSONSchema;
-declare const setup: _walkeros_core_dev.JSONSchema;
-
-type schemas_CorsOptions = CorsOptions;
-declare const schemas_CorsOptionsSchema: typeof CorsOptionsSchema;
-declare const schemas_CorsOrigin: typeof CorsOrigin;
-declare const schemas_HttpMethod: typeof HttpMethod;
-type schemas_Settings = Settings;
-declare const schemas_SettingsSchema: typeof SettingsSchema;
-declare namespace schemas {
-  export { type schemas_CorsOptions as CorsOptions, schemas_CorsOptionsSchema as CorsOptionsSchema, schemas_CorsOrigin as CorsOrigin, schemas_HttpMethod as HttpMethod, type schemas_Settings as Settings, schemas_SettingsSchema as SettingsSchema, settings$1 as settings, settings as sqsSettings, setup as sqsSetup };
-}
-
 declare module '@walkeros/core' {
     interface SourceMap {
         lambda: {
@@ -159,11 +146,24 @@ declare function trigger(source: {
     push: (event: LambdaEvent, context: LambdaContext) => Promise<LambdaResult>;
 }): (content: Content$1) => Promise<LambdaResult>;
 
-declare const index$1_trigger: typeof trigger;
-declare namespace index$1 {
-  export { createTrigger$1 as createTrigger, env$1 as env, step$1 as step, index$1_trigger as trigger };
+declare const lambdaExamplesNs_trigger: typeof trigger;
+declare namespace lambdaExamplesNs {
+  export { createTrigger$1 as createTrigger, env$1 as env, step$1 as step, lambdaExamplesNs_trigger as trigger };
 }
 
+/**
+ * The part of an AWS SDK v3 SQS client this source calls: `send` with the
+ * commands it builds, and an optional `destroy`. `SQSClient` satisfies it, and
+ * so does an injected mock (tests, simulate) without a cast.
+ */
+interface SqsClient {
+    send(command: GetQueueUrlCommand): Promise<GetQueueUrlCommandOutput>;
+    send(command: GetQueueAttributesCommand): Promise<GetQueueAttributesCommandOutput>;
+    send(command: ReceiveMessageCommand): Promise<ReceiveMessageCommandOutput>;
+    send(command: DeleteMessageCommand): Promise<DeleteMessageCommandOutput>;
+    send(command: CreateQueueCommand): Promise<CreateQueueCommandOutput>;
+    destroy?(): void;
+}
 declare module '@walkeros/core' {
     interface SourceMap {
         sqs: {
@@ -174,30 +174,32 @@ declare module '@walkeros/core' {
 }
 interface Env extends Source.Env {
     AWS?: {
-        SQSClient: typeof SQSClient;
-        ReceiveMessageCommand: typeof ReceiveMessageCommand;
-        DeleteMessageCommand: typeof DeleteMessageCommand;
-        CreateQueueCommand: typeof CreateQueueCommand;
-        GetQueueUrlCommand: typeof GetQueueUrlCommand;
-        GetQueueAttributesCommand: typeof GetQueueAttributesCommand;
+        SQSClient: new (config: SQSClientConfig) => SqsClient;
+        ReceiveMessageCommand?: typeof ReceiveMessageCommand;
+        DeleteMessageCommand?: typeof DeleteMessageCommand;
+        CreateQueueCommand?: typeof CreateQueueCommand;
+        GetQueueUrlCommand?: typeof GetQueueUrlCommand;
+        GetQueueAttributesCommand?: typeof GetQueueAttributesCommand;
         SNSClient?: typeof SNSClient;
         SubscribeCommand?: typeof SubscribeCommand;
     };
 }
 
+/** Standard mock environment, with the structural client for simulate. */
+declare const push: Env;
 /**
- * Standard mock environment for the SQS source.
- *
- * AWS SDK constructors are intentionally absent: the canonical pattern is
- * module-level `jest.mock('@aws-sdk/client-sqs')` and -sns, not env-injection.
+ * The same environment without the client, for unit tests that substitute the
+ * SDK module-wide with `jest.mock`.
  */
-declare const push: Env;
+declare const moduleMockEnv: Env;
+/** Every request (queue lookup, receive, delete) goes through `send`. */
 declare const simulation: string[];
 
+declare const env_moduleMockEnv: typeof moduleMockEnv;
 declare const env_push: typeof push;
 declare const env_simulation: typeof simulation;
 declare namespace env {
-  export { env_push as push, env_simulation as simulation };
+  export { env_moduleMockEnv as moduleMockEnv, env_push as push, env_simulation as simulation };
 }
 
 declare const pageView: Flow.StepExample;
@@ -246,13 +248,42 @@ type Result = Array<[string, ...unknown[]]>;
  */
 declare const createTrigger: Trigger.CreateFn<Content, Result>;
 
-type index_Content = Content;
-type index_Result = Result;
-declare const index_createTrigger: typeof createTrigger;
-declare const index_env: typeof env;
-declare const index_step: typeof step;
-declare namespace index {
-  export { type index_Content as Content, type index_Result as Result, index_createTrigger as createTrigger, index_env as env, index_step as step };
+type sqsExamplesNs_Content = Content;
+type sqsExamplesNs_Result = Result;
+declare const sqsExamplesNs_createTrigger: typeof createTrigger;
+declare const sqsExamplesNs_env: typeof env;
+declare const sqsExamplesNs_step: typeof step;
+declare namespace sqsExamplesNs {
+  export { type sqsExamplesNs_Content as Content, type sqsExamplesNs_Result as Result, sqsExamplesNs_createTrigger as createTrigger, sqsExamplesNs_env as env, sqsExamplesNs_step as step };
 }
 
-export { index$1 as examples, schemas, index as sqsExamples };
+declare const settings: _walkeros_core_dev.JSONSchema;
+declare const setup: _walkeros_core_dev.JSONSchema;
+
+type schemas_CorsOptions = CorsOptions;
+declare const schemas_CorsOptionsSchema: typeof CorsOptionsSchema;
+declare const schemas_CorsOrigin: typeof CorsOrigin;
+declare const schemas_HttpMethod: typeof HttpMethod;
+type schemas_Settings = Settings;
+declare const schemas_SettingsSchema: typeof SettingsSchema;
+declare namespace schemas {
+  export { type schemas_CorsOptions as CorsOptions, schemas_CorsOptionsSchema as CorsOptionsSchema, schemas_CorsOrigin as CorsOrigin, schemas_HttpMethod as HttpMethod, type schemas_Settings as Settings, schemas_SettingsSchema as SettingsSchema, settings$1 as settings, settings as sqsSettings, setup as sqsSetup };
+}
+
+/** Dev examples per export, keyed by the export names in package.json. */
+declare const exportExamples: {
+    sourceLambda: typeof lambdaExamplesNs;
+    sourceSqs: typeof sqsExamplesNs;
+};
+/** Schemas per export, keyed by the export names in package.json. */
+declare const exportSchemas: {
+    sourceLambda: {
+        settings: _walkeros_core_dev.JSONSchema;
+    };
+    sourceSqs: {
+        settings: _walkeros_core_dev.JSONSchema;
+        setup: _walkeros_core_dev.JSONSchema;
+    };
+};
+
+export { lambdaExamplesNs as examples, exportExamples, exportSchemas, schemas, sqsExamplesNs as sqsExamples };

package/dist/dev.d.ts

@@ -2,7 +2,7 @@ import * as _walkeros_core_dev from '@walkeros/core/dev';
 import { z } from '@walkeros/core/dev';
 import { Source, Flow, Trigger } from '@walkeros/core';
 import { APIGatewayProxyEvent, APIGatewayProxyEventV2, Context, APIGatewayProxyResult } from 'aws-lambda';
-import { SQSClient, ReceiveMessageCommand, DeleteMessageCommand, CreateQueueCommand, GetQueueUrlCommand, GetQueueAttributesCommand } from '@aws-sdk/client-sqs';
+import { SQSClientConfig, GetQueueUrlCommand, GetQueueUrlCommandOutput, GetQueueAttributesCommand, GetQueueAttributesCommandOutput, ReceiveMessageCommand, ReceiveMessageCommandOutput, DeleteMessageCommand, DeleteMessageCommandOutput, CreateQueueCommand, CreateQueueCommandOutput } from '@aws-sdk/client-sqs';
 import { SNSClient, SubscribeCommand } from '@aws-sdk/client-sns';
 
 /**
@@ -74,19 +74,6 @@ type Settings = z.infer<typeof SettingsSchema>;
 
 declare const settings$1: _walkeros_core_dev.JSONSchema;
 
-declare const settings: _walkeros_core_dev.JSONSchema;
-declare const setup: _walkeros_core_dev.JSONSchema;
-
-type schemas_CorsOptions = CorsOptions;
-declare const schemas_CorsOptionsSchema: typeof CorsOptionsSchema;
-declare const schemas_CorsOrigin: typeof CorsOrigin;
-declare const schemas_HttpMethod: typeof HttpMethod;
-type schemas_Settings = Settings;
-declare const schemas_SettingsSchema: typeof SettingsSchema;
-declare namespace schemas {
-  export { type schemas_CorsOptions as CorsOptions, schemas_CorsOptionsSchema as CorsOptionsSchema, schemas_CorsOrigin as CorsOrigin, schemas_HttpMethod as HttpMethod, type schemas_Settings as Settings, schemas_SettingsSchema as SettingsSchema, settings$1 as settings, settings as sqsSettings, setup as sqsSetup };
-}
-
 declare module '@walkeros/core' {
     interface SourceMap {
         lambda: {
@@ -159,11 +146,24 @@ declare function trigger(source: {
     push: (event: LambdaEvent, context: LambdaContext) => Promise<LambdaResult>;
 }): (content: Content$1) => Promise<LambdaResult>;
 
-declare const index$1_trigger: typeof trigger;
-declare namespace index$1 {
-  export { createTrigger$1 as createTrigger, env$1 as env, step$1 as step, index$1_trigger as trigger };
+declare const lambdaExamplesNs_trigger: typeof trigger;
+declare namespace lambdaExamplesNs {
+  export { createTrigger$1 as createTrigger, env$1 as env, step$1 as step, lambdaExamplesNs_trigger as trigger };
 }
 
+/**
+ * The part of an AWS SDK v3 SQS client this source calls: `send` with the
+ * commands it builds, and an optional `destroy`. `SQSClient` satisfies it, and
+ * so does an injected mock (tests, simulate) without a cast.
+ */
+interface SqsClient {
+    send(command: GetQueueUrlCommand): Promise<GetQueueUrlCommandOutput>;
+    send(command: GetQueueAttributesCommand): Promise<GetQueueAttributesCommandOutput>;
+    send(command: ReceiveMessageCommand): Promise<ReceiveMessageCommandOutput>;
+    send(command: DeleteMessageCommand): Promise<DeleteMessageCommandOutput>;
+    send(command: CreateQueueCommand): Promise<CreateQueueCommandOutput>;
+    destroy?(): void;
+}
 declare module '@walkeros/core' {
     interface SourceMap {
         sqs: {
@@ -174,30 +174,32 @@ declare module '@walkeros/core' {
 }
 interface Env extends Source.Env {
     AWS?: {
-        SQSClient: typeof SQSClient;
-        ReceiveMessageCommand: typeof ReceiveMessageCommand;
-        DeleteMessageCommand: typeof DeleteMessageCommand;
-        CreateQueueCommand: typeof CreateQueueCommand;
-        GetQueueUrlCommand: typeof GetQueueUrlCommand;
-        GetQueueAttributesCommand: typeof GetQueueAttributesCommand;
+        SQSClient: new (config: SQSClientConfig) => SqsClient;
+        ReceiveMessageCommand?: typeof ReceiveMessageCommand;
+        DeleteMessageCommand?: typeof DeleteMessageCommand;
+        CreateQueueCommand?: typeof CreateQueueCommand;
+        GetQueueUrlCommand?: typeof GetQueueUrlCommand;
+        GetQueueAttributesCommand?: typeof GetQueueAttributesCommand;
         SNSClient?: typeof SNSClient;
         SubscribeCommand?: typeof SubscribeCommand;
     };
 }
 
+/** Standard mock environment, with the structural client for simulate. */
+declare const push: Env;
 /**
- * Standard mock environment for the SQS source.
- *
- * AWS SDK constructors are intentionally absent: the canonical pattern is
- * module-level `jest.mock('@aws-sdk/client-sqs')` and -sns, not env-injection.
+ * The same environment without the client, for unit tests that substitute the
+ * SDK module-wide with `jest.mock`.
  */
-declare const push: Env;
+declare const moduleMockEnv: Env;
+/** Every request (queue lookup, receive, delete) goes through `send`. */
 declare const simulation: string[];
 
+declare const env_moduleMockEnv: typeof moduleMockEnv;
 declare const env_push: typeof push;
 declare const env_simulation: typeof simulation;
 declare namespace env {
-  export { env_push as push, env_simulation as simulation };
+  export { env_moduleMockEnv as moduleMockEnv, env_push as push, env_simulation as simulation };
 }
 
 declare const pageView: Flow.StepExample;
@@ -246,13 +248,42 @@ type Result = Array<[string, ...unknown[]]>;
  */
 declare const createTrigger: Trigger.CreateFn<Content, Result>;
 
-type index_Content = Content;
-type index_Result = Result;
-declare const index_createTrigger: typeof createTrigger;
-declare const index_env: typeof env;
-declare const index_step: typeof step;
-declare namespace index {
-  export { type index_Content as Content, type index_Result as Result, index_createTrigger as createTrigger, index_env as env, index_step as step };
+type sqsExamplesNs_Content = Content;
+type sqsExamplesNs_Result = Result;
+declare const sqsExamplesNs_createTrigger: typeof createTrigger;
+declare const sqsExamplesNs_env: typeof env;
+declare const sqsExamplesNs_step: typeof step;
+declare namespace sqsExamplesNs {
+  export { type sqsExamplesNs_Content as Content, type sqsExamplesNs_Result as Result, sqsExamplesNs_createTrigger as createTrigger, sqsExamplesNs_env as env, sqsExamplesNs_step as step };
 }
 
-export { index$1 as examples, schemas, index as sqsExamples };
+declare const settings: _walkeros_core_dev.JSONSchema;
+declare const setup: _walkeros_core_dev.JSONSchema;
+
+type schemas_CorsOptions = CorsOptions;
+declare const schemas_CorsOptionsSchema: typeof CorsOptionsSchema;
+declare const schemas_CorsOrigin: typeof CorsOrigin;
+declare const schemas_HttpMethod: typeof HttpMethod;
+type schemas_Settings = Settings;
+declare const schemas_SettingsSchema: typeof SettingsSchema;
+declare namespace schemas {
+  export { type schemas_CorsOptions as CorsOptions, schemas_CorsOptionsSchema as CorsOptionsSchema, schemas_CorsOrigin as CorsOrigin, schemas_HttpMethod as HttpMethod, type schemas_Settings as Settings, schemas_SettingsSchema as SettingsSchema, settings$1 as settings, settings as sqsSettings, setup as sqsSetup };
+}
+
+/** Dev examples per export, keyed by the export names in package.json. */
+declare const exportExamples: {
+    sourceLambda: typeof lambdaExamplesNs;
+    sourceSqs: typeof sqsExamplesNs;
+};
+/** Schemas per export, keyed by the export names in package.json. */
+declare const exportSchemas: {
+    sourceLambda: {
+        settings: _walkeros_core_dev.JSONSchema;
+    };
+    sourceSqs: {
+        settings: _walkeros_core_dev.JSONSchema;
+        setup: _walkeros_core_dev.JSONSchema;
+    };
+};
+
+export { lambdaExamplesNs as examples, exportExamples, exportSchemas, schemas, sqsExamplesNs as sqsExamples };