@walkeros/server-core 0.0.0-next-20251219153324

package/README.md

@@ -0,0 +1,279 @@
+<p align="left">
+  <a href="https://www.walkeros.io">
+    <img title="elbwalker" src="https://www.walkeros.io/img/elbwalker_logo.png" width="256px"/>
+  </a>
+</p>
+
+# Server Core Utilities for walkerOS
+
+[Source Code](https://github.com/elbwalker/walkerOS/tree/main/packages/server/core)
+&bull; [NPM Package](https://www.npmjs.com/package/@walkeros/server-core)
+
+Server core utilities are Node.js-specific functions designed for server-side
+walkerOS implementations. These utilities handle server communication,
+cryptographic hashing, and other backend operations.
+
+## Installation
+
+Import server utilities from the `@walkeros/server-core` package:
+
+```ts
+import { sendServer, getHashServer } from '@walkeros/server-core';
+```
+
+## Server Communication
+
+### sendServer
+
+`sendServer(url: string, data?: SendDataValue, options?: SendServerOptions): Promise<SendResponse>`
+sends HTTP requests using Node.js built-in modules (`http`/`https`).
+
+```js
+// Simple POST request
+const response = await sendServer('https://api.example.com/events', {
+  name: 'page view',
+  data: { url: '/home' },
+});
+
+// With custom options
+const response = await sendServer(url, data, {
+  method: 'PUT',
+  headers: {
+    Authorization: 'Bearer token',
+    'Content-Type': 'application/json',
+  },
+  timeout: 10000, // 10 seconds
+});
+
+if (response.ok) {
+  console.log('Data sent successfully:', response.data);
+} else {
+  console.error('Send failed:', response.error);
+}
+```
+
+#### SendServerOptions
+
+```ts
+interface SendServerOptions {
+  headers?: Record<string, string>; // Custom HTTP headers
+  method?: string; // HTTP method (default: 'POST')
+  timeout?: number; // Request timeout in milliseconds (default: 5000)
+}
+```
+
+#### SendResponse
+
+```ts
+interface SendResponse {
+  ok: boolean; // Indicates if the request was successful (2xx status)
+  data?: unknown; // Parsed response data (if available)
+  error?: string; // Error message (if request failed)
+}
+```
+
+## Cryptographic Operations
+
+### getHashServer
+
+`getHashServer(str: string, length?: number): Promise<string>` generates SHA-256
+hashes using Node.js crypto module.
+
+```js
+// Generate full SHA-256 hash
+const fullHash = await getHashServer('user123@example.com');
+// Returns full 64-character hash
+
+// Generate shortened hash for anonymization
+const userFingerprint = await getHashServer(
+  userAgent + language + ipAddress + date.getDate(),
+  16,
+);
+// Returns 16-character hash like '47e0bdd10f04ef13'
+
+// User identification while preserving privacy
+const anonymousId = await getHashServer(`${userEmail}${deviceId}${salt}`, 12);
+```
+
+This function is commonly used for:
+
+- **User Anonymization**: Creating privacy-safe user identifiers
+- **Fingerprinting**: Generating device/session fingerprints
+- **Data Deduplication**: Creating consistent identifiers
+- **Privacy Compliance**: Hashing PII for GDPR/CCPA compliance
+
+## Usage Examples
+
+### Event Processing Pipeline
+
+```js
+import { sendServer, getHashServer } from '@walkeros/server-core';
+
+async function processUserEvent(event, userInfo) {
+  // Anonymize user identification
+  const anonymousUserId = await getHashServer(
+    `${userInfo.email}${userInfo.deviceId}`,
+    16,
+  );
+
+  // Prepare event with anonymized data
+  const processedEvent = {
+    ...event,
+    user: {
+      ...event.user,
+      id: anonymousUserId,
+    },
+  };
+
+  // Send to analytics service
+  const result = await sendServer(
+    'https://analytics.example.com/collect',
+    processedEvent,
+    {
+      headers: {
+        'X-API-Key': process.env.ANALYTICS_API_KEY,
+      },
+      timeout: 8000,
+    },
+  );
+
+  return result;
+}
+```
+
+### Privacy-Safe Session Tracking
+
+```js
+async function createSessionId(request) {
+  const fingerprint = [
+    request.headers['user-agent'],
+    request.ip.replace(/\.\d+$/, '.0'), // Anonymize IP
+    new Date().toDateString(), // Daily rotation
+  ].join('|');
+
+  return await getHashServer(fingerprint, 20);
+}
+```
+
+## Error Handling
+
+Server utilities include comprehensive error handling:
+
+```js
+try {
+  const response = await sendServer(url, data, { timeout: 5000 });
+
+  if (response.ok) {
+    // Success - response.data contains the result
+    console.log('Success:', response.data);
+  } else {
+    // Request completed but with error status
+    console.warn('Request failed:', response.error);
+  }
+} catch (error) {
+  // Network error, timeout, or other exception
+  console.error('Network error:', error.message);
+}
+```
+
+## Performance Considerations
+
+### Timeout Configuration
+
+Configure appropriate timeouts based on your use case:
+
+```js
+// Fast analytics endpoint
+await sendServer(url, data, { timeout: 2000 });
+
+// Critical business data
+await sendServer(url, data, { timeout: 15000 });
+```
+
+### Batch Processing
+
+For high-volume scenarios, consider batching:
+
+```js
+const events = [
+  /* ... multiple events ... */
+];
+
+const response = await sendServer(
+  '/api/events/batch',
+  {
+    events,
+    timestamp: Date.now(),
+  },
+  {
+    timeout: 10000,
+  },
+);
+```
+
+### Connection Reuse
+
+The underlying Node.js HTTP agent automatically reuses connections for better
+performance with multiple requests to the same host.
+
+## Security Notes
+
+- **HTTPS Only**: Use HTTPS URLs in production for encrypted transmission
+- **API Keys**: Store sensitive credentials in environment variables
+- **Timeout Limits**: Set reasonable timeouts to prevent hanging requests
+- **Hash Salting**: Use application-specific salts when hashing sensitive data
+
+```js
+// Good security practices
+const apiKey = process.env.ANALYTICS_API_KEY;
+const saltedHash = await getHashServer(`${userData}${process.env.HASH_SALT}`);
+
+await sendServer('https://secure-api.example.com/events', data, {
+  headers: {
+    Authorization: `Bearer ${apiKey}`,
+    'Content-Type': 'application/json',
+  },
+  timeout: 5000,
+});
+```
+
+## Integration with Core
+
+Server utilities work seamlessly with
+[Core Utilities](https://www.walkeros.io/docs/core):
+
+```js
+import { getMappingValue, anonymizeIP } from '@walkeros/core';
+import { sendServer, getHashServer } from '@walkeros/server-core';
+
+async function processServerSideEvent(rawEvent, clientIP) {
+  // Use core utilities for data processing
+  const processedData = await getMappingValue(rawEvent, mappingConfig);
+  const safeIP = anonymizeIP(clientIP);
+
+  // Use server utilities for transmission
+  const sessionId = await getHashServer(`${safeIP}${userAgent}`, 16);
+
+  return await sendServer(endpoint, {
+    ...processedData,
+    sessionId,
+    ip: safeIP,
+  });
+}
+```
+
+---
+
+For platform-agnostic utilities, see
+[Core Utilities](https://www.walkeros.io/docs/core).
+
+## Contribute
+
+Feel free to contribute by submitting an
+[issue](https://github.com/elbwalker/walkerOS/issues), starting a
+[discussion](https://github.com/elbwalker/walkerOS/discussions), or getting in
+[contact](https://calendly.com/elb-alexander/30min).
+
+## License
+
+This project is licensed under the MIT License.

package/dist/index.d.mts

@@ -0,0 +1,86 @@
+import { SendHeaders, SendDataValue, SendResponse, Destination as Destination$1, Source as Source$1, Elb } from '@walkeros/core';
+
+interface SendServerOptions {
+    headers?: SendHeaders;
+    method?: string;
+    timeout?: number;
+}
+declare function sendServer(url: string, data?: SendDataValue, options?: SendServerOptions): Promise<SendResponse>;
+
+declare function getHashServer(str: string, length?: number): Promise<string>;
+
+type TypesGeneric$1 = Destination$1.TypesGeneric;
+interface Destination<T extends TypesGeneric$1 = Destination$1.Types> extends Destination$1.Instance<T> {
+}
+type Init$1 = Destination$1.Init;
+type Config$1<T extends TypesGeneric$1 = Destination$1.Types> = Destination$1.Config<T>;
+type PartialConfig$1<T extends TypesGeneric$1 = Destination$1.Types> = Destination$1.PartialConfig<T>;
+type InitFn<T extends TypesGeneric$1 = Destination$1.Types> = Destination$1.InitFn<T>;
+type PushFn<T extends TypesGeneric$1 = Destination$1.Types> = Destination$1.PushFn<T>;
+type PushEvent<Mapping = unknown> = Destination$1.PushEvent<Mapping>;
+type PushEvents<Mapping = unknown> = Destination$1.PushEvents<Mapping>;
+/**
+ * Server-specific environment requirements interface
+ *
+ * Extends the core Env interface for server-side destinations.
+ * Used for dependency injection of SDK classes and external APIs.
+ */
+interface Env$1 extends Destination$1.Env {
+}
+
+type destination_Destination<T extends TypesGeneric$1 = Destination$1.Types> = Destination<T>;
+type destination_InitFn<T extends TypesGeneric$1 = Destination$1.Types> = InitFn<T>;
+type destination_PushEvent<Mapping = unknown> = PushEvent<Mapping>;
+type destination_PushEvents<Mapping = unknown> = PushEvents<Mapping>;
+type destination_PushFn<T extends TypesGeneric$1 = Destination$1.Types> = PushFn<T>;
+declare namespace destination {
+  export type { Config$1 as Config, destination_Destination as Destination, Env$1 as Env, Init$1 as Init, destination_InitFn as InitFn, PartialConfig$1 as PartialConfig, destination_PushEvent as PushEvent, destination_PushEvents as PushEvents, destination_PushFn as PushFn, TypesGeneric$1 as TypesGeneric };
+}
+
+type TypesGeneric = Source$1.TypesGeneric;
+interface Source<T extends TypesGeneric = Source$1.Types> extends Source$1.Instance<T> {
+}
+type Config<T extends TypesGeneric = Source$1.Types> = Source$1.Config<T>;
+type PartialConfig<T extends TypesGeneric = Source$1.Types> = Source$1.PartialConfig<T>;
+type Init<T extends TypesGeneric = Source$1.Types> = Source$1.Init<T>;
+type InitSource<T extends TypesGeneric = Source$1.Types> = Source$1.InitSource<T>;
+/**
+ * Server-specific environment requirements interface
+ *
+ * Extends the core BaseEnv interface for server-side sources.
+ * Used for dependency injection of SDK classes and external APIs.
+ */
+interface Env extends Source$1.BaseEnv {
+}
+
+type source_Config<T extends TypesGeneric = Source$1.Types> = Config<T>;
+type source_Env = Env;
+type source_Init<T extends TypesGeneric = Source$1.Types> = Init<T>;
+type source_InitSource<T extends TypesGeneric = Source$1.Types> = InitSource<T>;
+type source_PartialConfig<T extends TypesGeneric = Source$1.Types> = PartialConfig<T>;
+type source_Source<T extends TypesGeneric = Source$1.Types> = Source<T>;
+type source_TypesGeneric = TypesGeneric;
+declare namespace source {
+  export type { source_Config as Config, source_Env as Env, source_Init as Init, source_InitSource as InitSource, source_PartialConfig as PartialConfig, source_Source as Source, source_TypesGeneric as TypesGeneric };
+}
+
+type Fn<R = Return> = Elb.Fn<R> & CommandDestination<R> & CommandRun<R>;
+type CommandDestination<R = void> = (event: 'walker destination', destination: Destination | Init$1, config?: Config$1) => R;
+type CommandRun<R = void> = (event: 'walker run') => R;
+type PushData = Elb.PushData | Destination | Init$1;
+type PushOptions = Config$1;
+type PushResult = Elb.PushResult;
+type Return<R = Promise<PushResult>> = R;
+
+type elb_CommandDestination<R = void> = CommandDestination<R>;
+type elb_CommandRun<R = void> = CommandRun<R>;
+type elb_Fn<R = Return> = Fn<R>;
+type elb_PushData = PushData;
+type elb_PushOptions = PushOptions;
+type elb_PushResult = PushResult;
+type elb_Return<R = Promise<PushResult>> = Return<R>;
+declare namespace elb {
+  export type { elb_CommandDestination as CommandDestination, elb_CommandRun as CommandRun, elb_Fn as Fn, elb_PushData as PushData, elb_PushOptions as PushOptions, elb_PushResult as PushResult, elb_Return as Return };
+}
+
+export { destination as DestinationServer, elb as Elb, type SendServerOptions, source as SourceServer, getHashServer, sendServer };

package/dist/index.d.ts

@@ -0,0 +1,86 @@
+import { SendHeaders, SendDataValue, SendResponse, Destination as Destination$1, Source as Source$1, Elb } from '@walkeros/core';
+
+interface SendServerOptions {
+    headers?: SendHeaders;
+    method?: string;
+    timeout?: number;
+}
+declare function sendServer(url: string, data?: SendDataValue, options?: SendServerOptions): Promise<SendResponse>;
+
+declare function getHashServer(str: string, length?: number): Promise<string>;
+
+type TypesGeneric$1 = Destination$1.TypesGeneric;
+interface Destination<T extends TypesGeneric$1 = Destination$1.Types> extends Destination$1.Instance<T> {
+}
+type Init$1 = Destination$1.Init;
+type Config$1<T extends TypesGeneric$1 = Destination$1.Types> = Destination$1.Config<T>;
+type PartialConfig$1<T extends TypesGeneric$1 = Destination$1.Types> = Destination$1.PartialConfig<T>;
+type InitFn<T extends TypesGeneric$1 = Destination$1.Types> = Destination$1.InitFn<T>;
+type PushFn<T extends TypesGeneric$1 = Destination$1.Types> = Destination$1.PushFn<T>;
+type PushEvent<Mapping = unknown> = Destination$1.PushEvent<Mapping>;
+type PushEvents<Mapping = unknown> = Destination$1.PushEvents<Mapping>;
+/**
+ * Server-specific environment requirements interface
+ *
+ * Extends the core Env interface for server-side destinations.
+ * Used for dependency injection of SDK classes and external APIs.
+ */
+interface Env$1 extends Destination$1.Env {
+}
+
+type destination_Destination<T extends TypesGeneric$1 = Destination$1.Types> = Destination<T>;
+type destination_InitFn<T extends TypesGeneric$1 = Destination$1.Types> = InitFn<T>;
+type destination_PushEvent<Mapping = unknown> = PushEvent<Mapping>;
+type destination_PushEvents<Mapping = unknown> = PushEvents<Mapping>;
+type destination_PushFn<T extends TypesGeneric$1 = Destination$1.Types> = PushFn<T>;
+declare namespace destination {
+  export type { Config$1 as Config, destination_Destination as Destination, Env$1 as Env, Init$1 as Init, destination_InitFn as InitFn, PartialConfig$1 as PartialConfig, destination_PushEvent as PushEvent, destination_PushEvents as PushEvents, destination_PushFn as PushFn, TypesGeneric$1 as TypesGeneric };
+}
+
+type TypesGeneric = Source$1.TypesGeneric;
+interface Source<T extends TypesGeneric = Source$1.Types> extends Source$1.Instance<T> {
+}
+type Config<T extends TypesGeneric = Source$1.Types> = Source$1.Config<T>;
+type PartialConfig<T extends TypesGeneric = Source$1.Types> = Source$1.PartialConfig<T>;
+type Init<T extends TypesGeneric = Source$1.Types> = Source$1.Init<T>;
+type InitSource<T extends TypesGeneric = Source$1.Types> = Source$1.InitSource<T>;
+/**
+ * Server-specific environment requirements interface
+ *
+ * Extends the core BaseEnv interface for server-side sources.
+ * Used for dependency injection of SDK classes and external APIs.
+ */
+interface Env extends Source$1.BaseEnv {
+}
+
+type source_Config<T extends TypesGeneric = Source$1.Types> = Config<T>;
+type source_Env = Env;
+type source_Init<T extends TypesGeneric = Source$1.Types> = Init<T>;
+type source_InitSource<T extends TypesGeneric = Source$1.Types> = InitSource<T>;
+type source_PartialConfig<T extends TypesGeneric = Source$1.Types> = PartialConfig<T>;
+type source_Source<T extends TypesGeneric = Source$1.Types> = Source<T>;
+type source_TypesGeneric = TypesGeneric;
+declare namespace source {
+  export type { source_Config as Config, source_Env as Env, source_Init as Init, source_InitSource as InitSource, source_PartialConfig as PartialConfig, source_Source as Source, source_TypesGeneric as TypesGeneric };
+}
+
+type Fn<R = Return> = Elb.Fn<R> & CommandDestination<R> & CommandRun<R>;
+type CommandDestination<R = void> = (event: 'walker destination', destination: Destination | Init$1, config?: Config$1) => R;
+type CommandRun<R = void> = (event: 'walker run') => R;
+type PushData = Elb.PushData | Destination | Init$1;
+type PushOptions = Config$1;
+type PushResult = Elb.PushResult;
+type Return<R = Promise<PushResult>> = R;
+
+type elb_CommandDestination<R = void> = CommandDestination<R>;
+type elb_CommandRun<R = void> = CommandRun<R>;
+type elb_Fn<R = Return> = Fn<R>;
+type elb_PushData = PushData;
+type elb_PushOptions = PushOptions;
+type elb_PushResult = PushResult;
+type elb_Return<R = Promise<PushResult>> = Return<R>;
+declare namespace elb {
+  export type { elb_CommandDestination as CommandDestination, elb_CommandRun as CommandRun, elb_Fn as Fn, elb_PushData as PushData, elb_PushOptions as PushOptions, elb_PushResult as PushResult, elb_Return as Return };
+}
+
+export { destination as DestinationServer, elb as Elb, type SendServerOptions, source as SourceServer, getHashServer, sendServer };

package/dist/index.js

@@ -0,0 +1 @@
+"use strict";var e,t=Object.create,r=Object.defineProperty,o=Object.getOwnPropertyDescriptor,s=Object.getOwnPropertyNames,a=Object.getPrototypeOf,n=Object.prototype.hasOwnProperty,u=(e,t,a,u)=>{if(t&&"object"==typeof t||"function"==typeof t)for(let c of s(t))n.call(e,c)||c===a||r(e,c,{get:()=>t[c],enumerable:!(u=o(t,c))||u.enumerable});return e},c=(e,o,s)=>(s=null!=e?t(a(e)):{},u(!o&&e&&e.__esModule?s:r(s,"default",{value:e,enumerable:!0}),e)),i={};((e,t)=>{for(var o in t)r(e,o,{get:t[o],enumerable:!0})})(i,{DestinationServer:()=>y,Elb:()=>v,SourceServer:()=>b,getHashServer:()=>h,sendServer:()=>f}),module.exports=(e=i,u(r({},"__esModule",{value:!0}),e));var d=require("@walkeros/core"),l=c(require("http")),p=c(require("https"));function f(e,t,r={}){const o=(0,d.getHeaders)(r.headers),s=(0,d.transformData)(t),a=r.method||"POST",n=r.timeout||5e3;return new Promise(t=>{const r=new URL(e),u="https:"===r.protocol?p:l,c={method:a,headers:o},i=u.request(r,c,e=>{const r=[];e.on("data",e=>{r.push(e)}),e.on("end",()=>{const o=!!(e.statusCode&&e.statusCode>=200&&e.statusCode<300),s=Buffer.concat(r).toString(),a=(0,d.tryCatch)(JSON.parse,()=>s)(s);t({ok:o,data:a,error:o?void 0:`${e.statusCode} ${e.statusMessage}`})})});i.on("error",e=>{t({ok:!1,error:e.message})}),i.on("timeout",()=>{i.destroy(),t({ok:!1,error:"Request timeout"})}),i.setTimeout(n),s&&i.write(s),i.end()})}var m=require("crypto");async function h(e,t){return(await async function(e){const t=(0,m.createHash)("sha256");return t.update(e),t.digest("hex")}(e)).slice(0,t)}var y={},b={},v={};//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/sendServer.ts","../src/getHashServer.ts","../src/types/destination.ts","../src/types/source.ts","../src/types/elb.ts"],"sourcesContent":["// Export server-specific utilities\nexport * from './sendServer';\nexport * from './getHashServer';\n\n// Export server-specific types\nexport * from './types';\n","import type { SendDataValue, SendHeaders, SendResponse } from '@walkeros/core';\nimport { getHeaders, transformData, tryCatch } from '@walkeros/core';\nimport * as http from 'http';\nimport * as https from 'https';\n\nexport interface SendServerOptions {\n  headers?: SendHeaders;\n  method?: string;\n  timeout?: number;\n}\n\nexport function sendServer(\n  url: string,\n  data?: SendDataValue,\n  options: SendServerOptions = {},\n): Promise<SendResponse> {\n  const headers = getHeaders(options.headers);\n  const body = transformData(data);\n  const method = options.method || 'POST';\n  const timeout = options.timeout || 5000;\n\n  return new Promise((resolve) => {\n    const urlObj = new URL(url);\n    const lib = urlObj.protocol === 'https:' ? https : http;\n    const options: http.RequestOptions | https.RequestOptions = {\n      method,\n      headers,\n    };\n\n    const req = lib.request(urlObj, options, (res) => {\n      const chunks: Uint8Array[] = [];\n\n      res.on('data', (chunk) => {\n        chunks.push(chunk);\n      });\n\n      res.on('end', () => {\n        const ok = !!(\n          res.statusCode &&\n          res.statusCode >= 200 &&\n          res.statusCode < 300\n        );\n\n        const responseData = Buffer.concat(chunks).toString();\n        const parsedData = tryCatch(\n          JSON.parse,\n          () => responseData,\n        )(responseData);\n\n        resolve({\n          ok,\n          data: parsedData,\n          error: ok ? undefined : `${res.statusCode} ${res.statusMessage}`,\n        });\n      });\n    });\n\n    req.on('error', (error) => {\n      resolve({\n        ok: false,\n        error: error.message,\n      });\n    });\n\n    req.on('timeout', () => {\n      req.destroy();\n      resolve({\n        ok: false,\n        error: 'Request timeout',\n      });\n    });\n\n    req.setTimeout(timeout);\n\n    if (body) req.write(body);\n\n    req.end();\n  });\n}\n","import { createHash } from 'crypto';\n\nasync function sha256(message: string): Promise<string> {\n  const hash = createHash('sha256');\n  hash.update(message);\n  return hash.digest('hex');\n}\n\nexport async function getHashServer(\n  str: string,\n  length?: number,\n): Promise<string> {\n  return (await sha256(str)).slice(0, length);\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type { Destination as WalkerOSDestination } from '@walkeros/core';\n\nexport type TypesGeneric = WalkerOSDestination.TypesGeneric;\n\nexport interface Destination<T extends TypesGeneric = WalkerOSDestination.Types>\n  extends WalkerOSDestination.Instance<T> {}\n\nexport type Init = WalkerOSDestination.Init;\n\nexport type Config<T extends TypesGeneric = WalkerOSDestination.Types> =\n  WalkerOSDestination.Config<T>;\n\nexport type PartialConfig<T extends TypesGeneric = WalkerOSDestination.Types> =\n  WalkerOSDestination.PartialConfig<T>;\n\nexport type InitFn<T extends TypesGeneric = WalkerOSDestination.Types> =\n  WalkerOSDestination.InitFn<T>;\n\nexport type PushFn<T extends TypesGeneric = WalkerOSDestination.Types> =\n  WalkerOSDestination.PushFn<T>;\n\nexport type PushEvent<Mapping = unknown> =\n  WalkerOSDestination.PushEvent<Mapping>;\n\nexport type PushEvents<Mapping = unknown> =\n  WalkerOSDestination.PushEvents<Mapping>;\n\n/**\n * Server-specific environment requirements interface\n *\n * Extends the core Env interface for server-side destinations.\n * Used for dependency injection of SDK classes and external APIs.\n */\nexport interface Env extends WalkerOSDestination.Env {\n  // Server environments can include SDK constructors, API clients, etc.\n  // Each destination extends this further with specific requirements\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type { Source as WalkerOSSource } from '@walkeros/core';\n\nexport type TypesGeneric = WalkerOSSource.TypesGeneric;\n\nexport interface Source<T extends TypesGeneric = WalkerOSSource.Types>\n  extends WalkerOSSource.Instance<T> {}\n\nexport type Config<T extends TypesGeneric = WalkerOSSource.Types> =\n  WalkerOSSource.Config<T>;\n\nexport type PartialConfig<T extends TypesGeneric = WalkerOSSource.Types> =\n  WalkerOSSource.PartialConfig<T>;\n\nexport type Init<T extends TypesGeneric = WalkerOSSource.Types> =\n  WalkerOSSource.Init<T>;\n\nexport type InitSource<T extends TypesGeneric = WalkerOSSource.Types> =\n  WalkerOSSource.InitSource<T>;\n\n/**\n * Server-specific environment requirements interface\n *\n * Extends the core BaseEnv interface for server-side sources.\n * Used for dependency injection of SDK classes and external APIs.\n */\nexport interface Env extends WalkerOSSource.BaseEnv {\n  // Server environments can include SDK constructors, API clients, etc.\n  // Each source extends this further with specific requirements\n}\n","import type { Elb } from '@walkeros/core';\nimport type { Destination, Init, Config } from './destination';\n\nexport type Fn<R = Return> = Elb.Fn<R> & CommandDestination<R> & CommandRun<R>;\n\nexport type CommandDestination<R = void> = (\n  event: 'walker destination',\n  destination: Destination | Init,\n  config?: Config,\n) => R;\n\nexport type CommandRun<R = void> = (event: 'walker run') => R;\n\nexport type PushData = Elb.PushData | Destination | Init;\n\nexport type PushOptions = Config;\n\nexport type PushResult = Elb.PushResult;\n\nexport type Return<R = Promise<PushResult>> = R;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACCA,kBAAoD;AACpD,WAAsB;AACtB,YAAuB;AAQhB,SAAS,WACd,KACA,MACA,UAA6B,CAAC,GACP;AACvB,QAAM,cAAU,wBAAW,QAAQ,OAAO;AAC1C,QAAM,WAAO,2BAAc,IAAI;AAC/B,QAAM,SAAS,QAAQ,UAAU;AACjC,QAAM,UAAU,QAAQ,WAAW;AAEnC,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,SAAS,IAAI,IAAI,GAAG;AAC1B,UAAM,MAAM,OAAO,aAAa,WAAW,QAAQ;AACnD,UAAMA,WAAsD;AAAA,MAC1D;AAAA,MACA;AAAA,IACF;AAEA,UAAM,MAAM,IAAI,QAAQ,QAAQA,UAAS,CAAC,QAAQ;AAChD,YAAM,SAAuB,CAAC;AAE9B,UAAI,GAAG,QAAQ,CAAC,UAAU;AACxB,eAAO,KAAK,KAAK;AAAA,MACnB,CAAC;AAED,UAAI,GAAG,OAAO,MAAM;AAClB,cAAM,KAAK,CAAC,EACV,IAAI,cACJ,IAAI,cAAc,OAClB,IAAI,aAAa;AAGnB,cAAM,eAAe,OAAO,OAAO,MAAM,EAAE,SAAS;AACpD,cAAM,iBAAa;AAAA,UACjB,KAAK;AAAA,UACL,MAAM;AAAA,QACR,EAAE,YAAY;AAEd,gBAAQ;AAAA,UACN;AAAA,UACA,MAAM;AAAA,UACN,OAAO,KAAK,SAAY,GAAG,IAAI,UAAU,IAAI,IAAI,aAAa;AAAA,QAChE,CAAC;AAAA,MACH,CAAC;AAAA,IACH,CAAC;AAED,QAAI,GAAG,SAAS,CAAC,UAAU;AACzB,cAAQ;AAAA,QACN,IAAI;AAAA,QACJ,OAAO,MAAM;AAAA,MACf,CAAC;AAAA,IACH,CAAC;AAED,QAAI,GAAG,WAAW,MAAM;AACtB,UAAI,QAAQ;AACZ,cAAQ;AAAA,QACN,IAAI;AAAA,QACJ,OAAO;AAAA,MACT,CAAC;AAAA,IACH,CAAC;AAED,QAAI,WAAW,OAAO;AAEtB,QAAI,KAAM,KAAI,MAAM,IAAI;AAExB,QAAI,IAAI;AAAA,EACV,CAAC;AACH;;;AC9EA,oBAA2B;AAE3B,eAAe,OAAO,SAAkC;AACtD,QAAM,WAAO,0BAAW,QAAQ;AAChC,OAAK,OAAO,OAAO;AACnB,SAAO,KAAK,OAAO,KAAK;AAC1B;AAEA,eAAsB,cACpB,KACA,QACiB;AACjB,UAAQ,MAAM,OAAO,GAAG,GAAG,MAAM,GAAG,MAAM;AAC5C;;;ACbA;;;ACAA;;;ACAA;","names":["options"]}

package/dist/index.mjs

@@ -0,0 +1 @@
+import{getHeaders as t,transformData as e,tryCatch as o}from"@walkeros/core";import*as r from"http";import*as s from"https";function a(a,n,u={}){const i=t(u.headers),c=e(n),d=u.method||"POST",m=u.timeout||5e3;return new Promise(t=>{const e=new URL(a),n="https:"===e.protocol?s:r,u={method:d,headers:i},p=n.request(e,u,e=>{const r=[];e.on("data",t=>{r.push(t)}),e.on("end",()=>{const s=!!(e.statusCode&&e.statusCode>=200&&e.statusCode<300),a=Buffer.concat(r).toString(),n=o(JSON.parse,()=>a)(a);t({ok:s,data:n,error:s?void 0:`${e.statusCode} ${e.statusMessage}`})})});p.on("error",e=>{t({ok:!1,error:e.message})}),p.on("timeout",()=>{p.destroy(),t({ok:!1,error:"Request timeout"})}),p.setTimeout(m),c&&p.write(c),p.end()})}import{createHash as n}from"crypto";async function u(t,e){return(await async function(t){const e=n("sha256");return e.update(t),e.digest("hex")}(t)).slice(0,e)}var i={},c={},d={};export{i as DestinationServer,d as Elb,c as SourceServer,u as getHashServer,a as sendServer};//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/sendServer.ts","../src/getHashServer.ts","../src/types/destination.ts","../src/types/source.ts","../src/types/elb.ts"],"sourcesContent":["import type { SendDataValue, SendHeaders, SendResponse } from '@walkeros/core';\nimport { getHeaders, transformData, tryCatch } from '@walkeros/core';\nimport * as http from 'http';\nimport * as https from 'https';\n\nexport interface SendServerOptions {\n  headers?: SendHeaders;\n  method?: string;\n  timeout?: number;\n}\n\nexport function sendServer(\n  url: string,\n  data?: SendDataValue,\n  options: SendServerOptions = {},\n): Promise<SendResponse> {\n  const headers = getHeaders(options.headers);\n  const body = transformData(data);\n  const method = options.method || 'POST';\n  const timeout = options.timeout || 5000;\n\n  return new Promise((resolve) => {\n    const urlObj = new URL(url);\n    const lib = urlObj.protocol === 'https:' ? https : http;\n    const options: http.RequestOptions | https.RequestOptions = {\n      method,\n      headers,\n    };\n\n    const req = lib.request(urlObj, options, (res) => {\n      const chunks: Uint8Array[] = [];\n\n      res.on('data', (chunk) => {\n        chunks.push(chunk);\n      });\n\n      res.on('end', () => {\n        const ok = !!(\n          res.statusCode &&\n          res.statusCode >= 200 &&\n          res.statusCode < 300\n        );\n\n        const responseData = Buffer.concat(chunks).toString();\n        const parsedData = tryCatch(\n          JSON.parse,\n          () => responseData,\n        )(responseData);\n\n        resolve({\n          ok,\n          data: parsedData,\n          error: ok ? undefined : `${res.statusCode} ${res.statusMessage}`,\n        });\n      });\n    });\n\n    req.on('error', (error) => {\n      resolve({\n        ok: false,\n        error: error.message,\n      });\n    });\n\n    req.on('timeout', () => {\n      req.destroy();\n      resolve({\n        ok: false,\n        error: 'Request timeout',\n      });\n    });\n\n    req.setTimeout(timeout);\n\n    if (body) req.write(body);\n\n    req.end();\n  });\n}\n","import { createHash } from 'crypto';\n\nasync function sha256(message: string): Promise<string> {\n  const hash = createHash('sha256');\n  hash.update(message);\n  return hash.digest('hex');\n}\n\nexport async function getHashServer(\n  str: string,\n  length?: number,\n): Promise<string> {\n  return (await sha256(str)).slice(0, length);\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type { Destination as WalkerOSDestination } from '@walkeros/core';\n\nexport type TypesGeneric = WalkerOSDestination.TypesGeneric;\n\nexport interface Destination<T extends TypesGeneric = WalkerOSDestination.Types>\n  extends WalkerOSDestination.Instance<T> {}\n\nexport type Init = WalkerOSDestination.Init;\n\nexport type Config<T extends TypesGeneric = WalkerOSDestination.Types> =\n  WalkerOSDestination.Config<T>;\n\nexport type PartialConfig<T extends TypesGeneric = WalkerOSDestination.Types> =\n  WalkerOSDestination.PartialConfig<T>;\n\nexport type InitFn<T extends TypesGeneric = WalkerOSDestination.Types> =\n  WalkerOSDestination.InitFn<T>;\n\nexport type PushFn<T extends TypesGeneric = WalkerOSDestination.Types> =\n  WalkerOSDestination.PushFn<T>;\n\nexport type PushEvent<Mapping = unknown> =\n  WalkerOSDestination.PushEvent<Mapping>;\n\nexport type PushEvents<Mapping = unknown> =\n  WalkerOSDestination.PushEvents<Mapping>;\n\n/**\n * Server-specific environment requirements interface\n *\n * Extends the core Env interface for server-side destinations.\n * Used for dependency injection of SDK classes and external APIs.\n */\nexport interface Env extends WalkerOSDestination.Env {\n  // Server environments can include SDK constructors, API clients, etc.\n  // Each destination extends this further with specific requirements\n}\n","/* eslint-disable @typescript-eslint/no-explicit-any */\nimport type { Source as WalkerOSSource } from '@walkeros/core';\n\nexport type TypesGeneric = WalkerOSSource.TypesGeneric;\n\nexport interface Source<T extends TypesGeneric = WalkerOSSource.Types>\n  extends WalkerOSSource.Instance<T> {}\n\nexport type Config<T extends TypesGeneric = WalkerOSSource.Types> =\n  WalkerOSSource.Config<T>;\n\nexport type PartialConfig<T extends TypesGeneric = WalkerOSSource.Types> =\n  WalkerOSSource.PartialConfig<T>;\n\nexport type Init<T extends TypesGeneric = WalkerOSSource.Types> =\n  WalkerOSSource.Init<T>;\n\nexport type InitSource<T extends TypesGeneric = WalkerOSSource.Types> =\n  WalkerOSSource.InitSource<T>;\n\n/**\n * Server-specific environment requirements interface\n *\n * Extends the core BaseEnv interface for server-side sources.\n * Used for dependency injection of SDK classes and external APIs.\n */\nexport interface Env extends WalkerOSSource.BaseEnv {\n  // Server environments can include SDK constructors, API clients, etc.\n  // Each source extends this further with specific requirements\n}\n","import type { Elb } from '@walkeros/core';\nimport type { Destination, Init, Config } from './destination';\n\nexport type Fn<R = Return> = Elb.Fn<R> & CommandDestination<R> & CommandRun<R>;\n\nexport type CommandDestination<R = void> = (\n  event: 'walker destination',\n  destination: Destination | Init,\n  config?: Config,\n) => R;\n\nexport type CommandRun<R = void> = (event: 'walker run') => R;\n\nexport type PushData = Elb.PushData | Destination | Init;\n\nexport type PushOptions = Config;\n\nexport type PushResult = Elb.PushResult;\n\nexport type Return<R = Promise<PushResult>> = R;\n"],"mappings":";AACA,SAAS,YAAY,eAAe,gBAAgB;AACpD,YAAY,UAAU;AACtB,YAAY,WAAW;AAQhB,SAAS,WACd,KACA,MACA,UAA6B,CAAC,GACP;AACvB,QAAM,UAAU,WAAW,QAAQ,OAAO;AAC1C,QAAM,OAAO,cAAc,IAAI;AAC/B,QAAM,SAAS,QAAQ,UAAU;AACjC,QAAM,UAAU,QAAQ,WAAW;AAEnC,SAAO,IAAI,QAAQ,CAAC,YAAY;AAC9B,UAAM,SAAS,IAAI,IAAI,GAAG;AAC1B,UAAM,MAAM,OAAO,aAAa,WAAW,QAAQ;AACnD,UAAMA,WAAsD;AAAA,MAC1D;AAAA,MACA;AAAA,IACF;AAEA,UAAM,MAAM,IAAI,QAAQ,QAAQA,UAAS,CAAC,QAAQ;AAChD,YAAM,SAAuB,CAAC;AAE9B,UAAI,GAAG,QAAQ,CAAC,UAAU;AACxB,eAAO,KAAK,KAAK;AAAA,MACnB,CAAC;AAED,UAAI,GAAG,OAAO,MAAM;AAClB,cAAM,KAAK,CAAC,EACV,IAAI,cACJ,IAAI,cAAc,OAClB,IAAI,aAAa;AAGnB,cAAM,eAAe,OAAO,OAAO,MAAM,EAAE,SAAS;AACpD,cAAM,aAAa;AAAA,UACjB,KAAK;AAAA,UACL,MAAM;AAAA,QACR,EAAE,YAAY;AAEd,gBAAQ;AAAA,UACN;AAAA,UACA,MAAM;AAAA,UACN,OAAO,KAAK,SAAY,GAAG,IAAI,UAAU,IAAI,IAAI,aAAa;AAAA,QAChE,CAAC;AAAA,MACH,CAAC;AAAA,IACH,CAAC;AAED,QAAI,GAAG,SAAS,CAAC,UAAU;AACzB,cAAQ;AAAA,QACN,IAAI;AAAA,QACJ,OAAO,MAAM;AAAA,MACf,CAAC;AAAA,IACH,CAAC;AAED,QAAI,GAAG,WAAW,MAAM;AACtB,UAAI,QAAQ;AACZ,cAAQ;AAAA,QACN,IAAI;AAAA,QACJ,OAAO;AAAA,MACT,CAAC;AAAA,IACH,CAAC;AAED,QAAI,WAAW,OAAO;AAEtB,QAAI,KAAM,KAAI,MAAM,IAAI;AAExB,QAAI,IAAI;AAAA,EACV,CAAC;AACH;;;AC9EA,SAAS,kBAAkB;AAE3B,eAAe,OAAO,SAAkC;AACtD,QAAM,OAAO,WAAW,QAAQ;AAChC,OAAK,OAAO,OAAO;AACnB,SAAO,KAAK,OAAO,KAAK;AAC1B;AAEA,eAAsB,cACpB,KACA,QACiB;AACjB,UAAQ,MAAM,OAAO,GAAG,GAAG,MAAM,GAAG,MAAM;AAC5C;;;ACbA;;;ACAA;;;ACAA;","names":["options"]}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@walkeros/server-core",
+  "description": "Server-specific utilities for walkerOS",
+  "version": "0.0.0-next-20251219153324",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "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"
+  },
+  "repository": {
+    "url": "git+https://github.com/elbwalker/walkerOS.git",
+    "directory": "packages/server/core"
+  },
+  "author": "elbwalker <hello@elbwalker.com>",
+  "homepage": "https://github.com/elbwalker/walkerOS#readme",
+  "bugs": {
+    "url": "https://github.com/elbwalker/walkerOS/issues"
+  },
+  "keywords": [
+    "walker",
+    "walkerOS",
+    "server",
+    "node",
+    "utilities"
+  ],
+  "funding": [
+    {
+      "type": "GitHub Sponsors",
+      "url": "https://github.com/sponsors/elbwalker"
+    }
+  ]
+}