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

package/dist/index.d.mts

@@ -1,6 +1,6 @@
 import { Source, WalkerOS, Credential, ServiceAccount, SetupFn as SetupFn$1 } from '@walkeros/core';
 import { z } from '@walkeros/core/dev';
-import { PubSub, Subscription } from '@google-cloud/pubsub';
+import { SubscriptionOptions, Message, ClientConfig, TopicMetadata, CreateSubscriptionOptions, protos, PubSub, Subscription } from '@google-cloud/pubsub';
 
 /**
  * CORS options schema
@@ -147,8 +147,41 @@ declare module '@walkeros/core' {
         };
     }
 }
+/** The part of a Pub/Sub subscription the pull source drives. */
+interface PullSubscription {
+    on(event: 'message', listener: (message: Message) => void): unknown;
+    on(event: 'error', listener: (error: Error) => void): unknown;
+    close(): Promise<void>;
+}
+/**
+ * The part of a Pub/Sub client the pull source calls at runtime. `PubSub` from
+ * `@google-cloud/pubsub` satisfies it, and so does an injected mock (tests,
+ * simulate) without a cast. Setup needs a `PubSubAdminClient`.
+ */
+interface PubSubPullClient {
+    subscription(name: string, options?: SubscriptionOptions): PullSubscription;
+    close(): Promise<void>;
+}
+/**
+ * The part of a Pub/Sub client `walkeros setup` calls (topic and subscription
+ * provisioning, drift check). `PubSub` from `@google-cloud/pubsub` satisfies
+ * it, from any copy of the SDK; a pull-only client does not.
+ */
+interface PubSubAdminClient {
+    topic(name: string): {
+        exists(): Promise<[boolean, ...unknown[]]>;
+    };
+    createTopic(metadata: TopicMetadata): Promise<unknown>;
+    createSubscription(topic: string, name: string, options?: CreateSubscriptionOptions): Promise<unknown>;
+    subscription(name: string): {
+        getMetadata(): Promise<[
+            protos.google.pubsub.v1.ISubscription,
+            ...unknown[]
+        ]>;
+    };
+}
 interface Settings$1 {
-    client: PubSub;
+    client: PubSubPullClient;
     projectId: string;
     subscription: string;
     topic?: string;
@@ -163,13 +196,13 @@ interface Settings$1 {
     ackDeadline?: number;
     shutdownTimeoutMs?: number;
     onPushError?: 'nack' | 'ack';
-    subscriptionHandle?: Subscription;
+    subscriptionHandle?: PullSubscription;
 }
 interface InitSettings$1 {
     projectId: string;
     subscription: string;
     topic?: string;
-    client?: PubSub;
+    client?: PubSubPullClient;
     /** @deprecated Use `config.credentials` instead. Kept for back-compat. */
     credentials?: string | ServiceAccountCredentials;
     apiEndpoint?: string;
@@ -205,7 +238,7 @@ interface SyntheticPushResult {
 }
 type Push$1 = (content?: SyntheticMessage) => Promise<SyntheticPushResult | void>;
 interface Env$1 extends Source.Env {
-    PubSub?: typeof PubSub;
+    PubSub?: new (options?: ClientConfig) => PubSubPullClient;
 }
 /**
  * Provisioning options for `walkeros setup source.<id>`.
@@ -257,6 +290,9 @@ type SetupFn = SetupFn$1<Config$1, Env$1>;
 
 type types$1_Decoder = Decoder;
 declare const types$1_PubSub: typeof PubSub;
+type types$1_PubSubAdminClient = PubSubAdminClient;
+type types$1_PubSubPullClient = PubSubPullClient;
+type types$1_PullSubscription = PullSubscription;
 type types$1_ServiceAccountCredentials = ServiceAccountCredentials;
 type types$1_Setup = Setup;
 type types$1_SetupFn = SetupFn;
@@ -264,7 +300,7 @@ declare const types$1_Subscription: typeof Subscription;
 type types$1_SyntheticMessage = SyntheticMessage;
 type types$1_SyntheticPushResult = SyntheticPushResult;
 declare namespace types$1 {
-  export { type Config$1 as Config, type types$1_Decoder as Decoder, type Env$1 as Env, type InitSettings$1 as InitSettings, type Mapping$1 as Mapping, type PartialConfig$1 as PartialConfig, types$1_PubSub as PubSub, type Push$1 as Push, type types$1_ServiceAccountCredentials as ServiceAccountCredentials, type Settings$1 as Settings, type types$1_Setup as Setup, type types$1_SetupFn as SetupFn, types$1_Subscription as Subscription, type types$1_SyntheticMessage as SyntheticMessage, type types$1_SyntheticPushResult as SyntheticPushResult, type Types$1 as Types };
+  export { type Config$1 as Config, type types$1_Decoder as Decoder, type Env$1 as Env, type InitSettings$1 as InitSettings, type Mapping$1 as Mapping, type PartialConfig$1 as PartialConfig, types$1_PubSub as PubSub, type types$1_PubSubAdminClient as PubSubAdminClient, type types$1_PubSubPullClient as PubSubPullClient, type types$1_PullSubscription as PullSubscription, type Push$1 as Push, type types$1_ServiceAccountCredentials as ServiceAccountCredentials, type Settings$1 as Settings, type types$1_Setup as Setup, type types$1_SetupFn as SetupFn, types$1_Subscription as Subscription, type types$1_SyntheticMessage as SyntheticMessage, type types$1_SyntheticPushResult as SyntheticPushResult, type Types$1 as Types };
 }
 
 /**

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Source, WalkerOS, Credential, ServiceAccount, SetupFn as SetupFn$1 } from '@walkeros/core';
 import { z } from '@walkeros/core/dev';
-import { PubSub, Subscription } from '@google-cloud/pubsub';
+import { SubscriptionOptions, Message, ClientConfig, TopicMetadata, CreateSubscriptionOptions, protos, PubSub, Subscription } from '@google-cloud/pubsub';
 
 /**
  * CORS options schema
@@ -147,8 +147,41 @@ declare module '@walkeros/core' {
         };
     }
 }
+/** The part of a Pub/Sub subscription the pull source drives. */
+interface PullSubscription {
+    on(event: 'message', listener: (message: Message) => void): unknown;
+    on(event: 'error', listener: (error: Error) => void): unknown;
+    close(): Promise<void>;
+}
+/**
+ * The part of a Pub/Sub client the pull source calls at runtime. `PubSub` from
+ * `@google-cloud/pubsub` satisfies it, and so does an injected mock (tests,
+ * simulate) without a cast. Setup needs a `PubSubAdminClient`.
+ */
+interface PubSubPullClient {
+    subscription(name: string, options?: SubscriptionOptions): PullSubscription;
+    close(): Promise<void>;
+}
+/**
+ * The part of a Pub/Sub client `walkeros setup` calls (topic and subscription
+ * provisioning, drift check). `PubSub` from `@google-cloud/pubsub` satisfies
+ * it, from any copy of the SDK; a pull-only client does not.
+ */
+interface PubSubAdminClient {
+    topic(name: string): {
+        exists(): Promise<[boolean, ...unknown[]]>;
+    };
+    createTopic(metadata: TopicMetadata): Promise<unknown>;
+    createSubscription(topic: string, name: string, options?: CreateSubscriptionOptions): Promise<unknown>;
+    subscription(name: string): {
+        getMetadata(): Promise<[
+            protos.google.pubsub.v1.ISubscription,
+            ...unknown[]
+        ]>;
+    };
+}
 interface Settings$1 {
-    client: PubSub;
+    client: PubSubPullClient;
     projectId: string;
     subscription: string;
     topic?: string;
@@ -163,13 +196,13 @@ interface Settings$1 {
     ackDeadline?: number;
     shutdownTimeoutMs?: number;
     onPushError?: 'nack' | 'ack';
-    subscriptionHandle?: Subscription;
+    subscriptionHandle?: PullSubscription;
 }
 interface InitSettings$1 {
     projectId: string;
     subscription: string;
     topic?: string;
-    client?: PubSub;
+    client?: PubSubPullClient;
     /** @deprecated Use `config.credentials` instead. Kept for back-compat. */
     credentials?: string | ServiceAccountCredentials;
     apiEndpoint?: string;
@@ -205,7 +238,7 @@ interface SyntheticPushResult {
 }
 type Push$1 = (content?: SyntheticMessage) => Promise<SyntheticPushResult | void>;
 interface Env$1 extends Source.Env {
-    PubSub?: typeof PubSub;
+    PubSub?: new (options?: ClientConfig) => PubSubPullClient;
 }
 /**
  * Provisioning options for `walkeros setup source.<id>`.
@@ -257,6 +290,9 @@ type SetupFn = SetupFn$1<Config$1, Env$1>;
 
 type types$1_Decoder = Decoder;
 declare const types$1_PubSub: typeof PubSub;
+type types$1_PubSubAdminClient = PubSubAdminClient;
+type types$1_PubSubPullClient = PubSubPullClient;
+type types$1_PullSubscription = PullSubscription;
 type types$1_ServiceAccountCredentials = ServiceAccountCredentials;
 type types$1_Setup = Setup;
 type types$1_SetupFn = SetupFn;
@@ -264,7 +300,7 @@ declare const types$1_Subscription: typeof Subscription;
 type types$1_SyntheticMessage = SyntheticMessage;
 type types$1_SyntheticPushResult = SyntheticPushResult;
 declare namespace types$1 {
-  export { type Config$1 as Config, type types$1_Decoder as Decoder, type Env$1 as Env, type InitSettings$1 as InitSettings, type Mapping$1 as Mapping, type PartialConfig$1 as PartialConfig, types$1_PubSub as PubSub, type Push$1 as Push, type types$1_ServiceAccountCredentials as ServiceAccountCredentials, type Settings$1 as Settings, type types$1_Setup as Setup, type types$1_SetupFn as SetupFn, types$1_Subscription as Subscription, type types$1_SyntheticMessage as SyntheticMessage, type types$1_SyntheticPushResult as SyntheticPushResult, type Types$1 as Types };
+  export { type Config$1 as Config, type types$1_Decoder as Decoder, type Env$1 as Env, type InitSettings$1 as InitSettings, type Mapping$1 as Mapping, type PartialConfig$1 as PartialConfig, types$1_PubSub as PubSub, type types$1_PubSubAdminClient as PubSubAdminClient, type types$1_PubSubPullClient as PubSubPullClient, type types$1_PullSubscription as PullSubscription, type Push$1 as Push, type types$1_ServiceAccountCredentials as ServiceAccountCredentials, type Settings$1 as Settings, type types$1_Setup as Setup, type types$1_SetupFn as SetupFn, types$1_Subscription as Subscription, type types$1_SyntheticMessage as SyntheticMessage, type types$1_SyntheticPushResult as SyntheticPushResult, type Types$1 as Types };
 }
 
 /**