@walkeros/server-source-gcp 0.0.0-next-20251219153324

package/README.md

@@ -0,0 +1,233 @@
+# @walkeros/server-source-gcp
+
+Google Cloud Platform server sources for walkerOS - lightweight, single-purpose
+runtime adapters for GCP services.
+
+## Installation
+
+```bash
+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
+and forwards them to the walkerOS collector.
+
+### Basic Usage
+
+```typescript
+import {
+  sourceCloudFunction,
+  type SourceCloudFunction,
+} from '@walkeros/server-source-gcp';
+import { startFlow } from '@walkeros/collector';
+import { http } from '@google-cloud/functions-framework';
+
+// 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;
+}
+
+// Register with Cloud Functions framework
+setup().then((h) => http('walkerHandler', h));
+```
+
+## Bundler Integration
+
+Use with minimal config:
+
+```json
+{
+  "sources": {
+    "api": { "type": "cloudfunction", "cors": true }
+  }
+}
+```
+
+Bundler auto-generates deployable exports.
+
+### Configuration Options
+
+```typescript
+interface Settings {
+  cors?: boolean | CorsOptions; // Enable CORS (default: true)
+  batch?: boolean; // Enable batch processing (default: true)
+  maxBatchSize?: number; // Max events per batch (default: 100)
+  timeout?: number; // Request timeout (default: 30000ms)
+}
+
+interface CorsOptions {
+  origin?: string | string[]; // Allowed origins
+  methods?: string[]; // Allowed methods
+  headers?: string[]; // Allowed headers
+  credentials?: boolean; // Allow credentials
+  maxAge?: number; // Preflight cache time
+}
+```
+
+### Request Format
+
+**Single Event:**
+
+```json
+{
+  "event": "page view",
+  "data": {
+    "title": "Home Page",
+    "path": "/"
+  },
+  "context": {
+    "stage": ["prod", 1]
+  }
+}
+```
+
+**Batch Events:**
+
+```json
+{
+  "events": [
+    {
+      "event": "page view",
+      "data": { "title": "Page 1" }
+    },
+    {
+      "event": "button click",
+      "data": { "id": "btn1" }
+    }
+  ]
+}
+```
+
+### Response Format
+
+**Success:**
+
+```json
+{
+  "success": true,
+  "id": "event-id-123"
+}
+```
+
+**Batch Success:**
+
+```json
+{
+  "success": true,
+  "processed": 2,
+  "errors": []
+}
+```
+
+**Error:**
+
+```json
+{
+  "success": false,
+  "error": "Invalid event format"
+}
+```
+
+### Deployment
+
+The source is designed to work with the walkerOS deployment system:
+
+```json
+{
+  "providers": [
+    {
+      "name": "api-endpoint",
+      "type": "gcp-functions",
+      "artifact": {
+        "source": "bundler",
+        "bundle": "api-collector"
+      },
+      "settings": {
+        "functionName": "walker-collector",
+        "runtime": "nodejs18",
+        "memory": 256
+      }
+    }
+  ]
+}
+```
+
+### Testing
+
+The source uses environment injection for testability:
+
+```typescript
+import { sourceCloudFunction } from '@walkeros/server-source-gcp';
+
+const mockElb = jest.fn().mockResolvedValue({
+  ok: true,
+  event: { id: 'test-id' },
+});
+
+const source = await sourceCloudFunction(
+  { settings: { cors: false } },
+  { elb: mockElb },
+);
+
+// Test the handler
+const mockReq = { method: 'POST', body: { event: 'test' } };
+const mockRes = { status: jest.fn().mockReturnThis(), json: jest.fn() };
+
+await source.push(mockReq, mockRes);
+
+expect(mockElb).toHaveBeenCalledWith('test', {});
+expect(mockRes.status).toHaveBeenCalledWith(200);
+```
+
+## Architecture
+
+This source follows the walkerOS patterns:
+
+- **Stateless**: No collector references, communicates via elb function
+- **Environment Injection**: All dependencies provided through environment
+- **Lean Implementation**: Minimal required fields, focused on HTTP handling
+- **Standard Interface**: The `push` function IS the Cloud Function handler
+- **Plug-and-Play**: Direct assignment: `http('handler', source.push)`
+
+The source's `push` function accepts HTTP requests, transforms them into walker
+events, and forwards them to the collector for processing by destinations.

package/dist/index.d.mts

@@ -0,0 +1,164 @@
+import { Source, WalkerOS } from '@walkeros/core';
+import * as _walkeros_core_dev from '@walkeros/core/dev';
+import { z } from '@walkeros/core/dev';
+
+/**
+ * HTTP methods enum
+ */
+declare const HttpMethod: z.ZodEnum<{
+    GET: "GET";
+    POST: "POST";
+    PUT: "PUT";
+    PATCH: "PATCH";
+    DELETE: "DELETE";
+    OPTIONS: "OPTIONS";
+    HEAD: "HEAD";
+}>;
+/**
+ * CORS origin configuration
+ * Accepts:
+ * - '*' for all origins
+ * - Single URL string
+ * - Array of URL strings
+ */
+declare const CorsOrigin: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>;
+/**
+ * CORS options schema
+ * Configuration for Cross-Origin Resource Sharing
+ */
+declare const CorsOptionsSchema: z.ZodObject<{
+    origin: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>>;
+    methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        GET: "GET";
+        POST: "POST";
+        PUT: "PUT";
+        PATCH: "PATCH";
+        DELETE: "DELETE";
+        OPTIONS: "OPTIONS";
+        HEAD: "HEAD";
+    }>>>;
+    headers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    credentials: z.ZodOptional<z.ZodBoolean>;
+    maxAge: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type CorsOptions$1 = z.infer<typeof CorsOptionsSchema>;
+
+/**
+ * GCP CloudFunction source settings schema
+ */
+declare const SettingsSchema: z.ZodObject<{
+    cors: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+        origin: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>>;
+        methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PUT: "PUT";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+            OPTIONS: "OPTIONS";
+            HEAD: "HEAD";
+        }>>>;
+        headers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        credentials: z.ZodOptional<z.ZodBoolean>;
+        maxAge: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type Settings$1 = z.infer<typeof SettingsSchema>;
+
+declare const settings: _walkeros_core_dev.JSONSchema;
+
+declare const index$1_CorsOptionsSchema: typeof CorsOptionsSchema;
+declare const index$1_CorsOrigin: typeof CorsOrigin;
+declare const index$1_HttpMethod: typeof HttpMethod;
+declare const index$1_SettingsSchema: typeof SettingsSchema;
+declare const index$1_settings: typeof settings;
+declare namespace index$1 {
+  export { type CorsOptions$1 as CorsOptions, index$1_CorsOptionsSchema as CorsOptionsSchema, index$1_CorsOrigin as CorsOrigin, index$1_HttpMethod as HttpMethod, type Settings$1 as Settings, index$1_SettingsSchema as SettingsSchema, index$1_settings as settings };
+}
+
+interface Request {
+    method: string;
+    body?: unknown;
+    headers: Record<string, string | string[]>;
+    get(name: string): string | undefined;
+}
+interface Response {
+    status(code: number): Response;
+    json(body: unknown): Response;
+    send(body?: unknown): Response;
+    set(key: string, value: string): Response;
+}
+type Settings = z.infer<typeof SettingsSchema>;
+type CorsOptions = z.infer<typeof CorsOptionsSchema>;
+type InitSettings = Partial<Settings>;
+interface Mapping {
+}
+type Push = (req: Request, res: Response) => Promise<void>;
+interface Env extends Source.Env {
+    req?: Request;
+    res?: Response;
+}
+type Types = Source.Types<Settings, Mapping, Push, Env, InitSettings>;
+interface CloudFunctionSource extends Omit<Source.Instance<Types>, 'push'> {
+    push: Push;
+}
+type Config = Source.Config<Types>;
+type PartialConfig = Source.PartialConfig<Types>;
+interface EventRequest {
+    event: string;
+    data?: WalkerOS.AnyObject;
+    context?: WalkerOS.AnyObject;
+    user?: WalkerOS.AnyObject;
+    globals?: WalkerOS.AnyObject;
+    consent?: WalkerOS.AnyObject;
+}
+interface EventResponse {
+    success: boolean;
+    id?: string;
+    error?: string;
+}
+type RequestBody = EventRequest;
+type ResponseBody = EventResponse;
+
+type types_CloudFunctionSource = CloudFunctionSource;
+type types_Config = Config;
+type types_CorsOptions = CorsOptions;
+type types_Env = Env;
+type types_EventRequest = EventRequest;
+type types_EventResponse = EventResponse;
+type types_InitSettings = InitSettings;
+type types_Mapping = Mapping;
+type types_PartialConfig = PartialConfig;
+type types_Push = Push;
+type types_Request = Request;
+type types_RequestBody = RequestBody;
+type types_Response = Response;
+type types_ResponseBody = ResponseBody;
+type types_Settings = Settings;
+type types_Types = Types;
+declare namespace types {
+  export type { types_CloudFunctionSource as CloudFunctionSource, types_Config as Config, types_CorsOptions as CorsOptions, types_Env as Env, types_EventRequest as EventRequest, types_EventResponse as EventResponse, types_InitSettings as InitSettings, types_Mapping as Mapping, types_PartialConfig as PartialConfig, types_Push as Push, types_Request as Request, types_RequestBody as RequestBody, types_Response as Response, types_ResponseBody as ResponseBody, types_Settings as Settings, types_Types as Types };
+}
+
+/**
+ * Standard mock environment for testing cloud function source
+ *
+ * Use this for testing HTTP event ingestion and request/response handling
+ * without requiring a real GCP Cloud Function environment.
+ */
+declare const push: Env;
+
+declare const env_push: typeof push;
+declare namespace env {
+  export { env_push as push };
+}
+
+declare const index_env: typeof env;
+declare namespace index {
+  export { index_env as env };
+}
+
+declare const sourceCloudFunction: (config: Partial<Source.Config<Types>> | undefined, env: Env) => Promise<CloudFunctionSource>;
+
+export { types as SourceCloudFunction, index as examples, index$1 as schemas, sourceCloudFunction };

package/dist/index.d.ts

@@ -0,0 +1,164 @@
+import { Source, WalkerOS } from '@walkeros/core';
+import * as _walkeros_core_dev from '@walkeros/core/dev';
+import { z } from '@walkeros/core/dev';
+
+/**
+ * HTTP methods enum
+ */
+declare const HttpMethod: z.ZodEnum<{
+    GET: "GET";
+    POST: "POST";
+    PUT: "PUT";
+    PATCH: "PATCH";
+    DELETE: "DELETE";
+    OPTIONS: "OPTIONS";
+    HEAD: "HEAD";
+}>;
+/**
+ * CORS origin configuration
+ * Accepts:
+ * - '*' for all origins
+ * - Single URL string
+ * - Array of URL strings
+ */
+declare const CorsOrigin: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>;
+/**
+ * CORS options schema
+ * Configuration for Cross-Origin Resource Sharing
+ */
+declare const CorsOptionsSchema: z.ZodObject<{
+    origin: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>>;
+    methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        GET: "GET";
+        POST: "POST";
+        PUT: "PUT";
+        PATCH: "PATCH";
+        DELETE: "DELETE";
+        OPTIONS: "OPTIONS";
+        HEAD: "HEAD";
+    }>>>;
+    headers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    credentials: z.ZodOptional<z.ZodBoolean>;
+    maxAge: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type CorsOptions$1 = z.infer<typeof CorsOptionsSchema>;
+
+/**
+ * GCP CloudFunction source settings schema
+ */
+declare const SettingsSchema: z.ZodObject<{
+    cors: z.ZodOptional<z.ZodUnion<readonly [z.ZodBoolean, z.ZodObject<{
+        origin: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodLiteral<"*">]>>;
+        methods: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+            GET: "GET";
+            POST: "POST";
+            PUT: "PUT";
+            PATCH: "PATCH";
+            DELETE: "DELETE";
+            OPTIONS: "OPTIONS";
+            HEAD: "HEAD";
+        }>>>;
+        headers: z.ZodOptional<z.ZodArray<z.ZodString>>;
+        credentials: z.ZodOptional<z.ZodBoolean>;
+        maxAge: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>]>>;
+    timeout: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+type Settings$1 = z.infer<typeof SettingsSchema>;
+
+declare const settings: _walkeros_core_dev.JSONSchema;
+
+declare const index$1_CorsOptionsSchema: typeof CorsOptionsSchema;
+declare const index$1_CorsOrigin: typeof CorsOrigin;
+declare const index$1_HttpMethod: typeof HttpMethod;
+declare const index$1_SettingsSchema: typeof SettingsSchema;
+declare const index$1_settings: typeof settings;
+declare namespace index$1 {
+  export { type CorsOptions$1 as CorsOptions, index$1_CorsOptionsSchema as CorsOptionsSchema, index$1_CorsOrigin as CorsOrigin, index$1_HttpMethod as HttpMethod, type Settings$1 as Settings, index$1_SettingsSchema as SettingsSchema, index$1_settings as settings };
+}
+
+interface Request {
+    method: string;
+    body?: unknown;
+    headers: Record<string, string | string[]>;
+    get(name: string): string | undefined;
+}
+interface Response {
+    status(code: number): Response;
+    json(body: unknown): Response;
+    send(body?: unknown): Response;
+    set(key: string, value: string): Response;
+}
+type Settings = z.infer<typeof SettingsSchema>;
+type CorsOptions = z.infer<typeof CorsOptionsSchema>;
+type InitSettings = Partial<Settings>;
+interface Mapping {
+}
+type Push = (req: Request, res: Response) => Promise<void>;
+interface Env extends Source.Env {
+    req?: Request;
+    res?: Response;
+}
+type Types = Source.Types<Settings, Mapping, Push, Env, InitSettings>;
+interface CloudFunctionSource extends Omit<Source.Instance<Types>, 'push'> {
+    push: Push;
+}
+type Config = Source.Config<Types>;
+type PartialConfig = Source.PartialConfig<Types>;
+interface EventRequest {
+    event: string;
+    data?: WalkerOS.AnyObject;
+    context?: WalkerOS.AnyObject;
+    user?: WalkerOS.AnyObject;
+    globals?: WalkerOS.AnyObject;
+    consent?: WalkerOS.AnyObject;
+}
+interface EventResponse {
+    success: boolean;
+    id?: string;
+    error?: string;
+}
+type RequestBody = EventRequest;
+type ResponseBody = EventResponse;
+
+type types_CloudFunctionSource = CloudFunctionSource;
+type types_Config = Config;
+type types_CorsOptions = CorsOptions;
+type types_Env = Env;
+type types_EventRequest = EventRequest;
+type types_EventResponse = EventResponse;
+type types_InitSettings = InitSettings;
+type types_Mapping = Mapping;
+type types_PartialConfig = PartialConfig;
+type types_Push = Push;
+type types_Request = Request;
+type types_RequestBody = RequestBody;
+type types_Response = Response;
+type types_ResponseBody = ResponseBody;
+type types_Settings = Settings;
+type types_Types = Types;
+declare namespace types {
+  export type { types_CloudFunctionSource as CloudFunctionSource, types_Config as Config, types_CorsOptions as CorsOptions, types_Env as Env, types_EventRequest as EventRequest, types_EventResponse as EventResponse, types_InitSettings as InitSettings, types_Mapping as Mapping, types_PartialConfig as PartialConfig, types_Push as Push, types_Request as Request, types_RequestBody as RequestBody, types_Response as Response, types_ResponseBody as ResponseBody, types_Settings as Settings, types_Types as Types };
+}
+
+/**
+ * Standard mock environment for testing cloud function source
+ *
+ * Use this for testing HTTP event ingestion and request/response handling
+ * without requiring a real GCP Cloud Function environment.
+ */
+declare const push: Env;
+
+declare const env_push: typeof push;
+declare namespace env {
+  export { env_push as push };
+}
+
+declare const index_env: typeof env;
+declare namespace index {
+  export { index_env as env };
+}
+
+declare const sourceCloudFunction: (config: Partial<Source.Config<Types>> | undefined, env: Env) => Promise<CloudFunctionSource>;
+
+export { types as SourceCloudFunction, index as examples, index$1 as schemas, sourceCloudFunction };

package/dist/index.js

@@ -0,0 +1 @@
+"use strict";var mod,__defProp=Object.defineProperty,__getOwnPropDesc=Object.getOwnPropertyDescriptor,__getOwnPropNames=Object.getOwnPropertyNames,__hasOwnProp=Object.prototype.hasOwnProperty,__export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:!0})},index_exports={};__export(index_exports,{SourceCloudFunction:()=>types_exports,examples:()=>examples_exports,schemas:()=>schemas_exports,sourceCloudFunction:()=>cloudfunction_default}),module.exports=(mod=index_exports,((to,from,except,desc)=>{if(from&&"object"==typeof from||"function"==typeof from)for(let key of __getOwnPropNames(from))__hasOwnProp.call(to,key)||key===except||__defProp(to,key,{get:()=>from[key],enumerable:!(desc=__getOwnPropDesc(from,key))||desc.enumerable});return to})(__defProp({},"__esModule",{value:!0}),mod));var types_exports={},schemas_exports={};__export(schemas_exports,{CorsOptionsSchema:()=>CorsOptionsSchema,CorsOrigin:()=>CorsOrigin,HttpMethod:()=>HttpMethod,SettingsSchema:()=>SettingsSchema,settings:()=>settings});var import_dev3=require("@walkeros/core/dev"),import_dev2=require("@walkeros/core/dev"),import_dev=require("@walkeros/core/dev"),HttpMethod=import_dev.z.enum(["GET","POST","PUT","PATCH","DELETE","OPTIONS","HEAD"]),CorsOrigin=import_dev.z.union([import_dev.z.string(),import_dev.z.array(import_dev.z.string()),import_dev.z.literal("*")]),CorsOptionsSchema=import_dev.z.object({origin:CorsOrigin.describe("Allowed origins (* for all, URL string, or array of URLs)").optional(),methods:import_dev.z.array(HttpMethod).describe("Allowed HTTP methods").optional(),headers:import_dev.z.array(import_dev.z.string()).describe("Allowed request headers").optional(),credentials:import_dev.z.boolean().describe("Allow credentials (cookies, authorization headers)").optional(),maxAge:import_dev.z.number().int().positive().describe("Preflight cache duration in seconds").optional()}),SettingsSchema=import_dev2.z.object({cors:import_dev2.z.union([import_dev2.z.boolean(),CorsOptionsSchema]).describe("CORS configuration: false = disabled, true = allow all origins, object = custom configuration").optional(),timeout:import_dev2.z.number().int().positive().max(54e4).describe("Request timeout in milliseconds (max: 540000 for GCP)").optional()}),settings=(0,import_dev3.zodToSchema)(SettingsSchema),examples_exports={};__export(examples_exports,{env:()=>env_exports});var env_exports={};__export(env_exports,{push:()=>push});var createMockElbFn=()=>()=>Promise.resolve({ok:!0,successful:[],queued:[],failed:[]}),noopFn=()=>{},noopLogger={error:noopFn,info:noopFn,debug:noopFn,throw:message=>{throw"string"==typeof message?new Error(message):message},scope:()=>noopLogger},push={get push(){return createMockElbFn()},get command(){return createMockElbFn()},get elb(){return createMockElbFn()},logger:noopLogger},DEFAULT_SETTINGS={cors:!0,timeout:3e4},sourceCloudFunction=async(config={},env)=>{const{push:envPush}=env,settings2={...DEFAULT_SETTINGS,...config.settings||{}};return{type:"cloudfunction",config:{...config,settings:settings2},push:async(req,res)=>{try{if(function(res,corsOptions){if(corsOptions)if(!0===corsOptions)res.set("Access-Control-Allow-Origin","*"),res.set("Access-Control-Allow-Methods","POST, OPTIONS"),res.set("Access-Control-Allow-Headers","Content-Type, Authorization"),res.set("Access-Control-Max-Age","3600");else{if(corsOptions.origin){const origin=Array.isArray(corsOptions.origin)?corsOptions.origin.join(", "):corsOptions.origin;res.set("Access-Control-Allow-Origin",origin)}corsOptions.methods&&res.set("Access-Control-Allow-Methods",corsOptions.methods.join(", ")),corsOptions.headers&&res.set("Access-Control-Allow-Headers",corsOptions.headers.join(", ")),corsOptions.credentials&&res.set("Access-Control-Allow-Credentials","true"),void 0!==corsOptions.maxAge&&res.set("Access-Control-Max-Age",corsOptions.maxAge.toString())}}(res,settings2.cors||!1),"OPTIONS"===req.method)return void res.status(204).send();if("POST"!==req.method)return void res.status(405).json({success:!1,error:"Method not allowed. Use POST."});if(!req.body)return void res.status(400).json({success:!1,error:"Request body is required"});const body=req.body;if(function(body){return"event"in body&&"string"==typeof body.event}(body)){const result=await async function(eventReq,push2){var _a;try{const result=await push2({name:eventReq.event,data:eventReq.data||{},context:eventReq.context,user:eventReq.user,globals:eventReq.globals,consent:eventReq.consent});return{id:null==(_a=null==result?void 0:result.event)?void 0:_a.id}}catch(error){return{error:error instanceof Error?error.message:"Unknown error"}}}(body,envPush);result.error?res.status(400).json({success:!1,error:result.error}):res.status(200).json({success:!0,id:result.id})}else res.status(400).json({success:!1,error:"Invalid request format. Expected event object."})}catch(error){res.status(500).json({success:!1,error:error instanceof Error?error.message:"Internal server error"})}}}},cloudfunction_default=sourceCloudFunction;//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/cloudfunction/utils.ts","../src/cloudfunction/push.ts","../src/cloudfunction/types.ts","../src/cloudfunction/schemas/index.ts","../src/cloudfunction/schemas/settings.ts","../src/cloudfunction/schemas/primitives.ts","../src/cloudfunction/examples/index.ts","../src/cloudfunction/examples/env.ts","../src/cloudfunction/index.ts"],"sourcesContent":["export * from './cloudfunction';\nexport { default as sourceCloudFunction } from './cloudfunction';\n","import type { RequestBody, EventRequest, CorsOptions, Response } from './types';\n\nexport function isEventRequest(body: RequestBody): body is EventRequest {\n  return 'event' in body && typeof body.event === 'string';\n}\n\nexport function setCorsHeaders(\n  res: Response,\n  corsOptions: boolean | CorsOptions,\n): void {\n  if (!corsOptions) return;\n\n  if (corsOptions === true) {\n    res.set('Access-Control-Allow-Origin', '*');\n    res.set('Access-Control-Allow-Methods', 'POST, OPTIONS');\n    res.set('Access-Control-Allow-Headers', 'Content-Type, Authorization');\n    res.set('Access-Control-Max-Age', '3600');\n  } else {\n    if (corsOptions.origin) {\n      const origin = Array.isArray(corsOptions.origin)\n        ? corsOptions.origin.join(', ')\n        : corsOptions.origin;\n      res.set('Access-Control-Allow-Origin', origin);\n    }\n    if (corsOptions.methods) {\n      res.set('Access-Control-Allow-Methods', corsOptions.methods.join(', '));\n    }\n    if (corsOptions.headers) {\n      res.set('Access-Control-Allow-Headers', corsOptions.headers.join(', '));\n    }\n    if (corsOptions.credentials) {\n      res.set('Access-Control-Allow-Credentials', 'true');\n    }\n    if (corsOptions.maxAge !== undefined) {\n      res.set('Access-Control-Max-Age', corsOptions.maxAge.toString());\n    }\n  }\n}\n","import type { Collector, WalkerOS } from '@walkeros/core';\nimport type { EventRequest } from './types';\n\nexport async function processEvent(\n  eventReq: EventRequest,\n  push: Collector.PushFn,\n): Promise<{ id?: string; error?: string }> {\n  try {\n    const result = await push({\n      name: eventReq.event,\n      data: (eventReq.data || {}) as WalkerOS.Properties,\n      context: eventReq.context as WalkerOS.OrderedProperties | undefined,\n      user: eventReq.user as WalkerOS.User | undefined,\n      globals: eventReq.globals as WalkerOS.Properties | undefined,\n      consent: eventReq.consent as WalkerOS.Consent | undefined,\n    });\n\n    return { id: result?.event?.id };\n  } catch (error) {\n    return { error: error instanceof Error ? error.message : 'Unknown error' };\n  }\n}\n","import type { WalkerOS, Source as CoreSource } from '@walkeros/core';\nimport type { SettingsSchema, CorsOptionsSchema } from './schemas';\nimport { z } from '@walkeros/core/dev';\n\n// Minimal request/response interfaces\nexport interface Request {\n  method: string;\n  body?: unknown;\n  headers: Record<string, string | string[]>;\n  get(name: string): string | undefined;\n}\n\nexport interface Response {\n  status(code: number): Response;\n  json(body: unknown): Response;\n  send(body?: unknown): Response;\n  set(key: string, value: string): Response;\n}\n\n// Types inferred from Zod schemas\nexport type Settings = z.infer<typeof SettingsSchema>;\nexport type CorsOptions = z.infer<typeof CorsOptionsSchema>;\n\n// InitSettings: user input (all optional)\nexport type InitSettings = Partial<Settings>;\n\nexport interface Mapping {\n  // Custom source event mapping properties\n}\n\n// CloudFunction-specific push type\nexport type Push = (req: Request, res: Response) => Promise<void>;\n\nexport interface Env extends CoreSource.Env {\n  req?: Request;\n  res?: Response;\n}\n\n// Type bundle (must be after Settings, Mapping, Push, Env are defined)\nexport type Types = CoreSource.Types<\n  Settings,\n  Mapping,\n  Push,\n  Env,\n  InitSettings\n>;\n\nexport interface CloudFunctionSource\n  extends Omit<CoreSource.Instance<Types>, 'push'> {\n  push: Push;\n}\n\n// Convenience Config type\nexport type Config = CoreSource.Config<Types>;\nexport type PartialConfig = CoreSource.PartialConfig<Types>;\n\n// Cloud function source doesn't follow standard Source.Init pattern due to HTTP handler interface\n\nexport interface EventRequest {\n  event: string;\n  data?: WalkerOS.AnyObject;\n  context?: WalkerOS.AnyObject;\n  user?: WalkerOS.AnyObject;\n  globals?: WalkerOS.AnyObject;\n  consent?: WalkerOS.AnyObject;\n}\n\nexport interface EventResponse {\n  success: boolean;\n  id?: string;\n  error?: string;\n}\n\nexport type RequestBody = EventRequest;\nexport type ResponseBody = EventResponse;\n","import { zodToSchema } from '@walkeros/core/dev';\nimport { SettingsSchema } from './settings';\n\n// Export primitives\nexport * from './primitives';\n\n// Export Zod schemas and types\nexport { SettingsSchema, type Settings } from './settings';\n\n// JSON Schema exports (for website PropertyTable and documentation tools)\nexport const settings = zodToSchema(SettingsSchema);\n","import { z } from '@walkeros/core/dev';\nimport { CorsOptionsSchema } from './primitives';\n\n/**\n * GCP CloudFunction source settings schema\n */\nexport const SettingsSchema = z.object({\n  cors: z\n    .union([z.boolean(), CorsOptionsSchema])\n    .describe(\n      'CORS configuration: false = disabled, true = allow all origins, object = custom configuration',\n    )\n    .optional(),\n\n  timeout: z\n    .number()\n    .int()\n    .positive()\n    .max(540000) // GCP Cloud Functions max timeout: 9 minutes\n    .describe('Request timeout in milliseconds (max: 540000 for GCP)')\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\n/**\n * HTTP methods enum\n */\nexport const HttpMethod = z.enum([\n  'GET',\n  'POST',\n  'PUT',\n  'PATCH',\n  'DELETE',\n  'OPTIONS',\n  'HEAD',\n]);\n\n/**\n * CORS origin configuration\n * Accepts:\n * - '*' for all origins\n * - Single URL string\n * - Array of URL strings\n */\nexport const CorsOrigin = z.union([\n  z.string(),\n  z.array(z.string()),\n  z.literal('*'),\n]);\n\n/**\n * CORS options schema\n * Configuration for Cross-Origin Resource Sharing\n */\nexport const CorsOptionsSchema = z.object({\n  origin: CorsOrigin.describe(\n    'Allowed origins (* for all, URL string, or array of URLs)',\n  ).optional(),\n\n  methods: z.array(HttpMethod).describe('Allowed HTTP methods').optional(),\n\n  headers: z.array(z.string()).describe('Allowed request headers').optional(),\n\n  credentials: z\n    .boolean()\n    .describe('Allow credentials (cookies, authorization headers)')\n    .optional(),\n\n  maxAge: z\n    .number()\n    .int()\n    .positive()\n    .describe('Preflight cache duration in seconds')\n    .optional(),\n});\n\nexport type CorsOptions = z.infer<typeof CorsOptionsSchema>;\n","export * as env from './env';\n","import type { Env } from '../types';\nimport type { Elb, Logger } from '@walkeros/core';\n\n/**\n * Example environment configurations for GCP Cloud Function source\n *\n * These environments provide standardized mock structures for testing\n * HTTP request handling without requiring actual cloud function deployment.\n */\n\n// Create a properly typed elb/push/command function that returns a promise with PushResult\nconst createMockElbFn = (): Elb.Fn => {\n  const fn = (() =>\n    Promise.resolve({\n      ok: true,\n      successful: [],\n      queued: [],\n      failed: [],\n    })) as Elb.Fn;\n  return fn;\n};\n\n// Simple no-op logger for demo purposes\nconst noopFn = () => {};\nconst noopLogger: Logger.Instance = {\n  error: noopFn,\n  info: noopFn,\n  debug: noopFn,\n  throw: (message: string | Error) => {\n    throw typeof message === 'string' ? new Error(message) : message;\n  },\n  scope: () => noopLogger,\n};\n\n/**\n * Standard mock environment for testing cloud function source\n *\n * Use this for testing HTTP event ingestion and request/response handling\n * without requiring a real GCP Cloud Function environment.\n */\nexport const push: Env = {\n  get push() {\n    return createMockElbFn();\n  },\n  get command() {\n    return createMockElbFn();\n  },\n  get elb() {\n    return createMockElbFn();\n  },\n  logger: noopLogger,\n};\n","import type {\n  Env,\n  CloudFunctionSource,\n  Settings,\n  EventResponse,\n  RequestBody,\n  Request,\n  Response,\n  Mapping,\n  Types,\n} from './types';\nimport type { Source } from '@walkeros/core';\nimport { isEventRequest, setCorsHeaders } from './utils';\nimport { processEvent } from './push';\n\nexport * as SourceCloudFunction from './types';\nexport * as schemas from './schemas';\n\n// Export examples\nexport * as examples from './examples';\n\nconst DEFAULT_SETTINGS: Settings = {\n  cors: true,\n  timeout: 30000,\n};\n\nexport const sourceCloudFunction = async (\n  config: Partial<Source.Config<Types>> = {},\n  env: Env,\n): Promise<CloudFunctionSource> => {\n  const { push: envPush } = env;\n\n  const settings: Settings = {\n    ...DEFAULT_SETTINGS,\n    ...(config.settings || {}),\n  };\n\n  const fullConfig: Source.Config<Types> = {\n    ...config,\n    settings,\n  };\n\n  const push = async (req: Request, res: Response): Promise<void> => {\n    try {\n      setCorsHeaders(res, settings.cors || false);\n\n      if (req.method === 'OPTIONS') {\n        res.status(204).send();\n        return;\n      }\n\n      if (req.method !== 'POST') {\n        res.status(405).json({\n          success: false,\n          error: 'Method not allowed. Use POST.',\n        });\n        return;\n      }\n\n      if (!req.body) {\n        res.status(400).json({\n          success: false,\n          error: 'Request body is required',\n        });\n        return;\n      }\n\n      const body = req.body as RequestBody;\n\n      if (isEventRequest(body)) {\n        const result = await processEvent(body, envPush);\n\n        if (result.error) {\n          res.status(400).json({\n            success: false,\n            error: result.error,\n          } as EventResponse);\n        } else {\n          res.status(200).json({\n            success: true,\n            id: result.id,\n          } as EventResponse);\n        }\n      } else {\n        res.status(400).json({\n          success: false,\n          error: 'Invalid request format. Expected event object.',\n        });\n      }\n    } catch (error) {\n      res.status(500).json({\n        success: false,\n        error: error instanceof Error ? error.message : 'Internal server error',\n      });\n    }\n  };\n\n  return {\n    type: 'cloudfunction',\n    config: fullConfig,\n    push,\n  };\n};\n\nexport default sourceCloudFunction;\n"],"mappings":"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","names":["push","import_dev","import_dev","settings","push"]}

package/dist/index.mjs

@@ -0,0 +1 @@
+var __defProp=Object.defineProperty,__export=(target,all)=>{for(var name in all)__defProp(target,name,{get:all[name],enumerable:!0})};var types_exports={},schemas_exports={};__export(schemas_exports,{CorsOptionsSchema:()=>CorsOptionsSchema,CorsOrigin:()=>CorsOrigin,HttpMethod:()=>HttpMethod,SettingsSchema:()=>SettingsSchema,settings:()=>settings});import{zodToSchema}from"@walkeros/core/dev";import{z as z2}from"@walkeros/core/dev";import{z}from"@walkeros/core/dev";var HttpMethod=z.enum(["GET","POST","PUT","PATCH","DELETE","OPTIONS","HEAD"]),CorsOrigin=z.union([z.string(),z.array(z.string()),z.literal("*")]),CorsOptionsSchema=z.object({origin:CorsOrigin.describe("Allowed origins (* for all, URL string, or array of URLs)").optional(),methods:z.array(HttpMethod).describe("Allowed HTTP methods").optional(),headers:z.array(z.string()).describe("Allowed request headers").optional(),credentials:z.boolean().describe("Allow credentials (cookies, authorization headers)").optional(),maxAge:z.number().int().positive().describe("Preflight cache duration in seconds").optional()}),SettingsSchema=z2.object({cors:z2.union([z2.boolean(),CorsOptionsSchema]).describe("CORS configuration: false = disabled, true = allow all origins, object = custom configuration").optional(),timeout:z2.number().int().positive().max(54e4).describe("Request timeout in milliseconds (max: 540000 for GCP)").optional()}),settings=zodToSchema(SettingsSchema),examples_exports={};__export(examples_exports,{env:()=>env_exports});var env_exports={};__export(env_exports,{push:()=>push});var createMockElbFn=()=>()=>Promise.resolve({ok:!0,successful:[],queued:[],failed:[]}),noopFn=()=>{},noopLogger={error:noopFn,info:noopFn,debug:noopFn,throw:message=>{throw"string"==typeof message?new Error(message):message},scope:()=>noopLogger},push={get push(){return createMockElbFn()},get command(){return createMockElbFn()},get elb(){return createMockElbFn()},logger:noopLogger},DEFAULT_SETTINGS={cors:!0,timeout:3e4},cloudfunction_default=async(config={},env)=>{const{push:envPush}=env,settings2={...DEFAULT_SETTINGS,...config.settings||{}};return{type:"cloudfunction",config:{...config,settings:settings2},push:async(req,res)=>{try{if(function(res,corsOptions){if(corsOptions)if(!0===corsOptions)res.set("Access-Control-Allow-Origin","*"),res.set("Access-Control-Allow-Methods","POST, OPTIONS"),res.set("Access-Control-Allow-Headers","Content-Type, Authorization"),res.set("Access-Control-Max-Age","3600");else{if(corsOptions.origin){const origin=Array.isArray(corsOptions.origin)?corsOptions.origin.join(", "):corsOptions.origin;res.set("Access-Control-Allow-Origin",origin)}corsOptions.methods&&res.set("Access-Control-Allow-Methods",corsOptions.methods.join(", ")),corsOptions.headers&&res.set("Access-Control-Allow-Headers",corsOptions.headers.join(", ")),corsOptions.credentials&&res.set("Access-Control-Allow-Credentials","true"),void 0!==corsOptions.maxAge&&res.set("Access-Control-Max-Age",corsOptions.maxAge.toString())}}(res,settings2.cors||!1),"OPTIONS"===req.method)return void res.status(204).send();if("POST"!==req.method)return void res.status(405).json({success:!1,error:"Method not allowed. Use POST."});if(!req.body)return void res.status(400).json({success:!1,error:"Request body is required"});const body=req.body;if(function(body){return"event"in body&&"string"==typeof body.event}(body)){const result=await async function(eventReq,push2){var _a;try{const result=await push2({name:eventReq.event,data:eventReq.data||{},context:eventReq.context,user:eventReq.user,globals:eventReq.globals,consent:eventReq.consent});return{id:null==(_a=null==result?void 0:result.event)?void 0:_a.id}}catch(error){return{error:error instanceof Error?error.message:"Unknown error"}}}(body,envPush);result.error?res.status(400).json({success:!1,error:result.error}):res.status(200).json({success:!0,id:result.id})}else res.status(400).json({success:!1,error:"Invalid request format. Expected event object."})}catch(error){res.status(500).json({success:!1,error:error instanceof Error?error.message:"Internal server error"})}}}};export{types_exports as SourceCloudFunction,examples_exports as examples,schemas_exports as schemas,cloudfunction_default as sourceCloudFunction};//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cloudfunction/utils.ts","../src/cloudfunction/push.ts","../src/cloudfunction/types.ts","../src/cloudfunction/schemas/index.ts","../src/cloudfunction/schemas/settings.ts","../src/cloudfunction/schemas/primitives.ts","../src/cloudfunction/examples/index.ts","../src/cloudfunction/examples/env.ts","../src/cloudfunction/index.ts"],"sourcesContent":["import type { RequestBody, EventRequest, CorsOptions, Response } from './types';\n\nexport function isEventRequest(body: RequestBody): body is EventRequest {\n  return 'event' in body && typeof body.event === 'string';\n}\n\nexport function setCorsHeaders(\n  res: Response,\n  corsOptions: boolean | CorsOptions,\n): void {\n  if (!corsOptions) return;\n\n  if (corsOptions === true) {\n    res.set('Access-Control-Allow-Origin', '*');\n    res.set('Access-Control-Allow-Methods', 'POST, OPTIONS');\n    res.set('Access-Control-Allow-Headers', 'Content-Type, Authorization');\n    res.set('Access-Control-Max-Age', '3600');\n  } else {\n    if (corsOptions.origin) {\n      const origin = Array.isArray(corsOptions.origin)\n        ? corsOptions.origin.join(', ')\n        : corsOptions.origin;\n      res.set('Access-Control-Allow-Origin', origin);\n    }\n    if (corsOptions.methods) {\n      res.set('Access-Control-Allow-Methods', corsOptions.methods.join(', '));\n    }\n    if (corsOptions.headers) {\n      res.set('Access-Control-Allow-Headers', corsOptions.headers.join(', '));\n    }\n    if (corsOptions.credentials) {\n      res.set('Access-Control-Allow-Credentials', 'true');\n    }\n    if (corsOptions.maxAge !== undefined) {\n      res.set('Access-Control-Max-Age', corsOptions.maxAge.toString());\n    }\n  }\n}\n","import type { Collector, WalkerOS } from '@walkeros/core';\nimport type { EventRequest } from './types';\n\nexport async function processEvent(\n  eventReq: EventRequest,\n  push: Collector.PushFn,\n): Promise<{ id?: string; error?: string }> {\n  try {\n    const result = await push({\n      name: eventReq.event,\n      data: (eventReq.data || {}) as WalkerOS.Properties,\n      context: eventReq.context as WalkerOS.OrderedProperties | undefined,\n      user: eventReq.user as WalkerOS.User | undefined,\n      globals: eventReq.globals as WalkerOS.Properties | undefined,\n      consent: eventReq.consent as WalkerOS.Consent | undefined,\n    });\n\n    return { id: result?.event?.id };\n  } catch (error) {\n    return { error: error instanceof Error ? error.message : 'Unknown error' };\n  }\n}\n","import type { WalkerOS, Source as CoreSource } from '@walkeros/core';\nimport type { SettingsSchema, CorsOptionsSchema } from './schemas';\nimport { z } from '@walkeros/core/dev';\n\n// Minimal request/response interfaces\nexport interface Request {\n  method: string;\n  body?: unknown;\n  headers: Record<string, string | string[]>;\n  get(name: string): string | undefined;\n}\n\nexport interface Response {\n  status(code: number): Response;\n  json(body: unknown): Response;\n  send(body?: unknown): Response;\n  set(key: string, value: string): Response;\n}\n\n// Types inferred from Zod schemas\nexport type Settings = z.infer<typeof SettingsSchema>;\nexport type CorsOptions = z.infer<typeof CorsOptionsSchema>;\n\n// InitSettings: user input (all optional)\nexport type InitSettings = Partial<Settings>;\n\nexport interface Mapping {\n  // Custom source event mapping properties\n}\n\n// CloudFunction-specific push type\nexport type Push = (req: Request, res: Response) => Promise<void>;\n\nexport interface Env extends CoreSource.Env {\n  req?: Request;\n  res?: Response;\n}\n\n// Type bundle (must be after Settings, Mapping, Push, Env are defined)\nexport type Types = CoreSource.Types<\n  Settings,\n  Mapping,\n  Push,\n  Env,\n  InitSettings\n>;\n\nexport interface CloudFunctionSource\n  extends Omit<CoreSource.Instance<Types>, 'push'> {\n  push: Push;\n}\n\n// Convenience Config type\nexport type Config = CoreSource.Config<Types>;\nexport type PartialConfig = CoreSource.PartialConfig<Types>;\n\n// Cloud function source doesn't follow standard Source.Init pattern due to HTTP handler interface\n\nexport interface EventRequest {\n  event: string;\n  data?: WalkerOS.AnyObject;\n  context?: WalkerOS.AnyObject;\n  user?: WalkerOS.AnyObject;\n  globals?: WalkerOS.AnyObject;\n  consent?: WalkerOS.AnyObject;\n}\n\nexport interface EventResponse {\n  success: boolean;\n  id?: string;\n  error?: string;\n}\n\nexport type RequestBody = EventRequest;\nexport type ResponseBody = EventResponse;\n","import { zodToSchema } from '@walkeros/core/dev';\nimport { SettingsSchema } from './settings';\n\n// Export primitives\nexport * from './primitives';\n\n// Export Zod schemas and types\nexport { SettingsSchema, type Settings } from './settings';\n\n// JSON Schema exports (for website PropertyTable and documentation tools)\nexport const settings = zodToSchema(SettingsSchema);\n","import { z } from '@walkeros/core/dev';\nimport { CorsOptionsSchema } from './primitives';\n\n/**\n * GCP CloudFunction source settings schema\n */\nexport const SettingsSchema = z.object({\n  cors: z\n    .union([z.boolean(), CorsOptionsSchema])\n    .describe(\n      'CORS configuration: false = disabled, true = allow all origins, object = custom configuration',\n    )\n    .optional(),\n\n  timeout: z\n    .number()\n    .int()\n    .positive()\n    .max(540000) // GCP Cloud Functions max timeout: 9 minutes\n    .describe('Request timeout in milliseconds (max: 540000 for GCP)')\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n","import { z } from '@walkeros/core/dev';\n\n/**\n * HTTP methods enum\n */\nexport const HttpMethod = z.enum([\n  'GET',\n  'POST',\n  'PUT',\n  'PATCH',\n  'DELETE',\n  'OPTIONS',\n  'HEAD',\n]);\n\n/**\n * CORS origin configuration\n * Accepts:\n * - '*' for all origins\n * - Single URL string\n * - Array of URL strings\n */\nexport const CorsOrigin = z.union([\n  z.string(),\n  z.array(z.string()),\n  z.literal('*'),\n]);\n\n/**\n * CORS options schema\n * Configuration for Cross-Origin Resource Sharing\n */\nexport const CorsOptionsSchema = z.object({\n  origin: CorsOrigin.describe(\n    'Allowed origins (* for all, URL string, or array of URLs)',\n  ).optional(),\n\n  methods: z.array(HttpMethod).describe('Allowed HTTP methods').optional(),\n\n  headers: z.array(z.string()).describe('Allowed request headers').optional(),\n\n  credentials: z\n    .boolean()\n    .describe('Allow credentials (cookies, authorization headers)')\n    .optional(),\n\n  maxAge: z\n    .number()\n    .int()\n    .positive()\n    .describe('Preflight cache duration in seconds')\n    .optional(),\n});\n\nexport type CorsOptions = z.infer<typeof CorsOptionsSchema>;\n","export * as env from './env';\n","import type { Env } from '../types';\nimport type { Elb, Logger } from '@walkeros/core';\n\n/**\n * Example environment configurations for GCP Cloud Function source\n *\n * These environments provide standardized mock structures for testing\n * HTTP request handling without requiring actual cloud function deployment.\n */\n\n// Create a properly typed elb/push/command function that returns a promise with PushResult\nconst createMockElbFn = (): Elb.Fn => {\n  const fn = (() =>\n    Promise.resolve({\n      ok: true,\n      successful: [],\n      queued: [],\n      failed: [],\n    })) as Elb.Fn;\n  return fn;\n};\n\n// Simple no-op logger for demo purposes\nconst noopFn = () => {};\nconst noopLogger: Logger.Instance = {\n  error: noopFn,\n  info: noopFn,\n  debug: noopFn,\n  throw: (message: string | Error) => {\n    throw typeof message === 'string' ? new Error(message) : message;\n  },\n  scope: () => noopLogger,\n};\n\n/**\n * Standard mock environment for testing cloud function source\n *\n * Use this for testing HTTP event ingestion and request/response handling\n * without requiring a real GCP Cloud Function environment.\n */\nexport const push: Env = {\n  get push() {\n    return createMockElbFn();\n  },\n  get command() {\n    return createMockElbFn();\n  },\n  get elb() {\n    return createMockElbFn();\n  },\n  logger: noopLogger,\n};\n","import type {\n  Env,\n  CloudFunctionSource,\n  Settings,\n  EventResponse,\n  RequestBody,\n  Request,\n  Response,\n  Mapping,\n  Types,\n} from './types';\nimport type { Source } from '@walkeros/core';\nimport { isEventRequest, setCorsHeaders } from './utils';\nimport { processEvent } from './push';\n\nexport * as SourceCloudFunction from './types';\nexport * as schemas from './schemas';\n\n// Export examples\nexport * as examples from './examples';\n\nconst DEFAULT_SETTINGS: Settings = {\n  cors: true,\n  timeout: 30000,\n};\n\nexport const sourceCloudFunction = async (\n  config: Partial<Source.Config<Types>> = {},\n  env: Env,\n): Promise<CloudFunctionSource> => {\n  const { push: envPush } = env;\n\n  const settings: Settings = {\n    ...DEFAULT_SETTINGS,\n    ...(config.settings || {}),\n  };\n\n  const fullConfig: Source.Config<Types> = {\n    ...config,\n    settings,\n  };\n\n  const push = async (req: Request, res: Response): Promise<void> => {\n    try {\n      setCorsHeaders(res, settings.cors || false);\n\n      if (req.method === 'OPTIONS') {\n        res.status(204).send();\n        return;\n      }\n\n      if (req.method !== 'POST') {\n        res.status(405).json({\n          success: false,\n          error: 'Method not allowed. Use POST.',\n        });\n        return;\n      }\n\n      if (!req.body) {\n        res.status(400).json({\n          success: false,\n          error: 'Request body is required',\n        });\n        return;\n      }\n\n      const body = req.body as RequestBody;\n\n      if (isEventRequest(body)) {\n        const result = await processEvent(body, envPush);\n\n        if (result.error) {\n          res.status(400).json({\n            success: false,\n            error: result.error,\n          } as EventResponse);\n        } else {\n          res.status(200).json({\n            success: true,\n            id: result.id,\n          } as EventResponse);\n        }\n      } else {\n        res.status(400).json({\n          success: false,\n          error: 'Invalid request format. Expected event object.',\n        });\n      }\n    } catch (error) {\n      res.status(500).json({\n        success: false,\n        error: error instanceof Error ? error.message : 'Internal server error',\n      });\n    }\n  };\n\n  return {\n    type: 'cloudfunction',\n    config: fullConfig,\n    push,\n  };\n};\n\nexport default sourceCloudFunction;\n"],"mappings":"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","names":["push","z","z","settings","push"]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@walkeros/server-source-gcp",
+  "description": "Google Cloud Platform server sources for walkerOS (Cloud Functions)",
+  "version": "0.0.0-next-20251219153324",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist/**"
+  ],
+  "scripts": {
+    "build": "tsup --silent",
+    "clean": "rm -rf .turbo && rm -rf node_modules && rm -rf dist",
+    "dev": "jest --watchAll --colors",
+    "lint": "tsc && eslint \"**/*.ts*\"",
+    "test": "jest",
+    "update": "npx npm-check-updates -u && npm update"
+  },
+  "dependencies": {
+    "@walkeros/core": "0.0.0-next-20251219153324"
+  },
+  "peerDependencies": {
+    "@google-cloud/functions-framework": "^3.0.0"
+  },
+  "devDependencies": {},
+  "repository": {
+    "url": "git+https://github.com/elbwalker/walkerOS.git",
+    "directory": "packages/server/sources/gcp"
+  },
+  "author": "elbwalker <hello@elbwalker.com>",
+  "homepage": "https://github.com/elbwalker/walkerOS#readme",
+  "bugs": {
+    "url": "https://github.com/elbwalker/walkerOS/issues"
+  },
+  "keywords": [
+    "walker",
+    "walkerOS",
+    "source",
+    "server",
+    "gcp",
+    "cloud functions"
+  ],
+  "funding": [
+    {
+      "type": "GitHub Sponsors",
+      "url": "https://github.com/sponsors/elbwalker"
+    }
+  ]
+}