@walkeros/server-source-gcp 0.4.2 → 0.5.0

package/README.md

@@ -9,6 +9,25 @@ runtime adapters for GCP services.
 npm install @walkeros/server-source-gcp @google-cloud/functions-framework
 ```
 
+## Usage
+
+```typescript
+import {
+  sourceCloudFunction,
+  type SourceCloudFunction,
+} from '@walkeros/server-source-gcp';
+import { startFlow } from '@walkeros/collector';
+import { http } from '@google-cloud/functions-framework';
+
+const { elb } = await startFlow<SourceCloudFunction.Push>({
+  sources: { api: { code: sourceCloudFunction } },
+});
+
+http('walkerHandler', elb);
+```
+
+---
+
 ## Cloud Functions Source
 
 The Cloud Functions source provides an HTTP handler that receives walker events
@@ -17,17 +36,39 @@ and forwards them to the walkerOS collector.
 ### Basic Usage
 
 ```typescript
-import { sourceCloudFunction } from '@walkeros/server-source-gcp';
+import {
+  sourceCloudFunction,
+  type SourceCloudFunction,
+} from '@walkeros/server-source-gcp';
+import { startFlow } from '@walkeros/collector';
 import { http } from '@google-cloud/functions-framework';
 
-// Create source with collector
-const source = await sourceCloudFunction(
-  { settings: { cors: true, batch: true } },
-  { elb: collector.push },
-);
+// Handler singleton - reused across warm invocations
+let handler: SourceCloudFunction.Push;
+
+async function setup() {
+  if (handler) return handler;
+
+  const { elb } = await startFlow<SourceCloudFunction.Push>({
+    sources: {
+      api: {
+        code: sourceCloudFunction,
+        config: {
+          settings: { cors: true },
+        },
+      },
+    },
+    destinations: {
+      // Your destinations
+    },
+  });
+
+  handler = elb;
+  return handler;
+}
 
-// Plug-and-play: source.push IS the Cloud Function handler
-http('walkerHandler', source.push);
+// Register with Cloud Functions framework
+setup().then((h) => http('walkerHandler', h));
 ```
 
 ## Bundler Integration

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@walkeros/server-source-gcp",
   "description": "Google Cloud Platform server sources for walkerOS (Cloud Functions)",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "license": "MIT",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -18,7 +18,7 @@
     "update": "npx npm-check-updates -u && npm update"
   },
   "dependencies": {
-    "@walkeros/core": "0.4.2"
+    "@walkeros/core": "0.5.0"
   },
   "peerDependencies": {
     "@google-cloud/functions-framework": "^3.0.0"