@walkeros/web-source-session 1.1.0-next-1769684633114

package/README.md

@@ -0,0 +1,212 @@
+# @walkeros/web-source-session
+
+Standalone session detection and management for walkerOS.
+
+[Source Code](https://github.com/elbwalker/walkerOS/tree/main/packages/web/sources/session)
+| [NPM](https://www.npmjs.com/package/@walkeros/web-source-session) |
+[Documentation](https://www.walkeros.io/docs/sources/web/session)
+
+## Quick Start
+
+```typescript
+import { startFlow } from '@walkeros/collector';
+import { sourceBrowser } from '@walkeros/web-source-browser';
+import { sourceSession } from '@walkeros/web-source-session';
+
+const { collector, elb } = await startFlow({
+  sources: {
+    browser: sourceBrowser,
+    session: {
+      code: sourceSession,
+      config: {
+        settings: {
+          storage: true, // Enable persistent session storage
+        },
+      },
+    },
+  },
+});
+```
+
+## Features
+
+- **Session detection**: Automatic detection of new sessions based on
+  navigation, referrer, and marketing parameters
+- **Device tracking**: Persistent device ID across sessions (with consent)
+- **Consent-aware**: Switches between window-only and storage-based sessions
+  based on user consent
+- **Composable**: Works alongside any source (browser, dataLayer, custom)
+
+## Installation
+
+```bash
+npm install @walkeros/web-source-session
+```
+
+## Why Separate Session Source?
+
+The session source was extracted from the browser source to enable:
+
+1. **Composability**: Use session detection with any source, not just browser
+2. **Single responsibility**: Browser source focuses on DOM events, session
+   source on identity
+3. **Flexibility**: Configure session independently from event capture
+4. **Server-side ready**: Session logic can work with server sources too
+
+## Configuration Reference
+
+| Name             | Type                       | Description                                      | Default          |
+| ---------------- | -------------------------- | ------------------------------------------------ | ---------------- |
+| `storage`        | `boolean`                  | Enable persistent storage for session/device IDs | `false`          |
+| `consent`        | `string \| string[]`       | Consent key(s) required to enable storage mode   | -                |
+| `length`         | `number`                   | Session timeout in minutes                       | `30`             |
+| `pulse`          | `boolean`                  | Keep session alive on each event                 | `false`          |
+| `sessionKey`     | `string`                   | Storage key for session ID                       | `'elbSessionId'` |
+| `sessionStorage` | `'local' \| 'session'`     | Storage type for session                         | `'local'`        |
+| `deviceKey`      | `string`                   | Storage key for device ID                        | `'elbDeviceId'`  |
+| `deviceStorage`  | `'local' \| 'session'`     | Storage type for device                          | `'local'`        |
+| `cb`             | `SessionCallback \| false` | Custom callback or disable default               | -                |
+
+## Examples
+
+### Basic (Window-only)
+
+No persistent storage, session detected per page load:
+
+```typescript
+const { elb } = await startFlow({
+  sources: {
+    browser: sourceBrowser,
+    session: sourceSession, // Defaults to window-only mode
+  },
+});
+```
+
+### With Persistent Storage
+
+Store session and device IDs in localStorage:
+
+```typescript
+const { elb } = await startFlow({
+  sources: {
+    browser: sourceBrowser,
+    session: {
+      code: sourceSession,
+      config: {
+        settings: {
+          storage: true,
+          length: 30, // 30-minute session timeout
+        },
+      },
+    },
+  },
+});
+```
+
+### Consent-Aware
+
+Switch to storage mode only when user grants consent:
+
+```typescript
+const { elb } = await startFlow({
+  sources: {
+    browser: sourceBrowser,
+    session: {
+      code: sourceSession,
+      config: {
+        settings: {
+          consent: 'analytics', // Wait for analytics consent
+          storage: true,
+        },
+      },
+    },
+  },
+});
+
+// Later, when user grants consent:
+elb('walker consent', { analytics: true });
+// Session source automatically switches to storage mode
+```
+
+## Session Start Event
+
+When a new session is detected, the source pushes a `session start` event:
+
+```typescript
+{
+  name: 'session start',
+  data: {
+    isStart: true,
+    id: 'abc123',      // Session ID
+    device: 'xyz789',  // Device ID (if storage enabled)
+    storage: true,     // Whether storage mode is active
+    // ... additional session metadata
+  }
+}
+```
+
+## Migration from Browser Source
+
+If you were using the browser source with session enabled:
+
+```typescript
+// Before (browser source with built-in session)
+const { elb } = await startFlow({
+  sources: {
+    browser: {
+      code: sourceBrowser,
+      config: { settings: { session: true } },
+    },
+  },
+});
+
+// After (separate session source)
+const { elb } = await startFlow({
+  sources: {
+    browser: sourceBrowser,
+    session: {
+      code: sourceSession,
+      config: { settings: { storage: true } },
+    },
+  },
+});
+```
+
+## Exported Functions
+
+The session source exports session functions for direct usage:
+
+```typescript
+import {
+  // Session functions
+  sessionStart,
+  sessionWindow,
+  sessionStorage,
+} from '@walkeros/web-source-session';
+
+// Use sessionStart directly (advanced usage)
+const session = sessionStart({
+  storage: true,
+  collector: collectorInstance,
+});
+```
+
+Storage utilities are available from `@walkeros/web-core`:
+
+```typescript
+import { storageRead, storageWrite, storageDelete } from '@walkeros/web-core';
+
+storageWrite('key', 'value', 30); // 30-minute expiration
+const value = storageRead('key');
+storageDelete('key');
+```
+
+## Type Definitions
+
+See [src/types/index.ts](./src/types/index.ts) for TypeScript interfaces.
+
+## Related
+
+- [Browser Source](/docs/sources/web/browser) - DOM-based event tracking
+- [DataLayer Source](/docs/sources/web/dataLayer) - GTM/GA4 integration
+- [Session Documentation](https://www.walkeros.io/docs/sources/web/session)

package/dist/chunk-J5LGTIGS.mjs

@@ -0,0 +1,10 @@
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+export {
+  __export
+};
+//# sourceMappingURL=chunk-J5LGTIGS.mjs.map

package/dist/chunk-J5LGTIGS.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/dev.d.mts

@@ -0,0 +1,36 @@
+import * as _walkeros_core_dev from '@walkeros/core/dev';
+import { z } from '@walkeros/core/dev';
+
+/**
+ * Session source settings schema
+ */
+declare const SettingsSchema: z.ZodObject<{
+    storage: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    consent: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    length: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    pulse: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    sessionKey: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    sessionStorage: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        local: "local";
+        session: "session";
+    }>>>;
+    deviceKey: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    deviceStorage: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        local: "local";
+        session: "session";
+    }>>>;
+    deviceAge: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    cb: z.ZodOptional<z.ZodAny>;
+}, z.core.$strip>;
+type Settings = z.infer<typeof SettingsSchema>;
+
+declare const settings: _walkeros_core_dev.JSONSchema;
+
+type index_Settings = Settings;
+declare const index_SettingsSchema: typeof SettingsSchema;
+declare const index_settings: typeof settings;
+declare namespace index {
+  export { type index_Settings as Settings, index_SettingsSchema as SettingsSchema, index_settings as settings };
+}
+
+export { index as schemas };

package/dist/dev.d.ts

@@ -0,0 +1,36 @@
+import * as _walkeros_core_dev from '@walkeros/core/dev';
+import { z } from '@walkeros/core/dev';
+
+/**
+ * Session source settings schema
+ */
+declare const SettingsSchema: z.ZodObject<{
+    storage: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    consent: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>>;
+    length: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    pulse: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    sessionKey: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    sessionStorage: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        local: "local";
+        session: "session";
+    }>>>;
+    deviceKey: z.ZodOptional<z.ZodDefault<z.ZodString>>;
+    deviceStorage: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        local: "local";
+        session: "session";
+    }>>>;
+    deviceAge: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    cb: z.ZodOptional<z.ZodAny>;
+}, z.core.$strip>;
+type Settings = z.infer<typeof SettingsSchema>;
+
+declare const settings: _walkeros_core_dev.JSONSchema;
+
+type index_Settings = Settings;
+declare const index_SettingsSchema: typeof SettingsSchema;
+declare const index_settings: typeof settings;
+declare namespace index {
+  export { type index_Settings as Settings, index_SettingsSchema as SettingsSchema, index_settings as settings };
+}
+
+export { index as schemas };

package/dist/dev.js

@@ -0,0 +1,56 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/dev.ts
+var dev_exports = {};
+__export(dev_exports, {
+  schemas: () => schemas_exports
+});
+module.exports = __toCommonJS(dev_exports);
+
+// src/schemas/index.ts
+var schemas_exports = {};
+__export(schemas_exports, {
+  SettingsSchema: () => SettingsSchema,
+  settings: () => settings
+});
+var import_dev2 = require("@walkeros/core/dev");
+
+// src/schemas/settings.ts
+var import_dev = require("@walkeros/core/dev");
+var SettingsSchema = import_dev.z.object({
+  storage: import_dev.z.boolean().default(false).describe("Enable persistent storage for session/device IDs").optional(),
+  consent: import_dev.z.union([import_dev.z.string(), import_dev.z.array(import_dev.z.string())]).describe("Consent key(s) required to enable storage mode").optional(),
+  length: import_dev.z.number().default(30).describe("Session timeout in minutes").optional(),
+  pulse: import_dev.z.boolean().default(false).describe("Keep session alive on each event").optional(),
+  sessionKey: import_dev.z.string().default("elbSessionId").describe("Storage key for session ID").optional(),
+  sessionStorage: import_dev.z.enum(["local", "session"]).default("local").describe("Storage type for session").optional(),
+  deviceKey: import_dev.z.string().default("elbDeviceId").describe("Storage key for device ID").optional(),
+  deviceStorage: import_dev.z.enum(["local", "session"]).default("local").describe("Storage type for device").optional(),
+  deviceAge: import_dev.z.number().default(30).describe("Device ID age in days").optional(),
+  cb: import_dev.z.any().describe("Custom session callback function or false to disable").optional()
+});
+
+// src/schemas/index.ts
+var settings = (0, import_dev2.zodToSchema)(SettingsSchema);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  schemas
+});
+//# sourceMappingURL=dev.js.map

package/dist/dev.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/dev.ts","../src/schemas/index.ts","../src/schemas/settings.ts"],"sourcesContent":["export * as schemas from './schemas';\n","import { zodToSchema } from '@walkeros/core/dev';\nimport { SettingsSchema } from './settings';\n\n// Export Zod schemas and types\nexport { SettingsSchema, type Settings } from './settings';\n\n// JSON Schema exports (for website PropertyTable)\nexport const settings = zodToSchema(SettingsSchema);\n","import { z } from '@walkeros/core/dev';\n\n/**\n * Session source settings schema\n */\nexport const SettingsSchema = z.object({\n  storage: z\n    .boolean()\n    .default(false)\n    .describe('Enable persistent storage for session/device IDs')\n    .optional(),\n\n  consent: z\n    .union([z.string(), z.array(z.string())])\n    .describe('Consent key(s) required to enable storage mode')\n    .optional(),\n\n  length: z\n    .number()\n    .default(30)\n    .describe('Session timeout in minutes')\n    .optional(),\n\n  pulse: z\n    .boolean()\n    .default(false)\n    .describe('Keep session alive on each event')\n    .optional(),\n\n  sessionKey: z\n    .string()\n    .default('elbSessionId')\n    .describe('Storage key for session ID')\n    .optional(),\n\n  sessionStorage: z\n    .enum(['local', 'session'])\n    .default('local')\n    .describe('Storage type for session')\n    .optional(),\n\n  deviceKey: z\n    .string()\n    .default('elbDeviceId')\n    .describe('Storage key for device ID')\n    .optional(),\n\n  deviceStorage: z\n    .enum(['local', 'session'])\n    .default('local')\n    .describe('Storage type for device')\n    .optional(),\n\n  deviceAge: z\n    .number()\n    .default(30)\n    .describe('Device ID age in days')\n    .optional(),\n\n  cb: z\n    .any()\n    .describe('Custom session callback function or false to disable')\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAAAA,cAA4B;;;ACA5B,iBAAkB;AAKX,IAAM,iBAAiB,aAAE,OAAO;AAAA,EACrC,SAAS,aACN,QAAQ,EACR,QAAQ,KAAK,EACb,SAAS,kDAAkD,EAC3D,SAAS;AAAA,EAEZ,SAAS,aACN,MAAM,CAAC,aAAE,OAAO,GAAG,aAAE,MAAM,aAAE,OAAO,CAAC,CAAC,CAAC,EACvC,SAAS,gDAAgD,EACzD,SAAS;AAAA,EAEZ,QAAQ,aACL,OAAO,EACP,QAAQ,EAAE,EACV,SAAS,4BAA4B,EACrC,SAAS;AAAA,EAEZ,OAAO,aACJ,QAAQ,EACR,QAAQ,KAAK,EACb,SAAS,kCAAkC,EAC3C,SAAS;AAAA,EAEZ,YAAY,aACT,OAAO,EACP,QAAQ,cAAc,EACtB,SAAS,4BAA4B,EACrC,SAAS;AAAA,EAEZ,gBAAgB,aACb,KAAK,CAAC,SAAS,SAAS,CAAC,EACzB,QAAQ,OAAO,EACf,SAAS,0BAA0B,EACnC,SAAS;AAAA,EAEZ,WAAW,aACR,OAAO,EACP,QAAQ,aAAa,EACrB,SAAS,2BAA2B,EACpC,SAAS;AAAA,EAEZ,eAAe,aACZ,KAAK,CAAC,SAAS,SAAS,CAAC,EACzB,QAAQ,OAAO,EACf,SAAS,yBAAyB,EAClC,SAAS;AAAA,EAEZ,WAAW,aACR,OAAO,EACP,QAAQ,EAAE,EACV,SAAS,uBAAuB,EAChC,SAAS;AAAA,EAEZ,IAAI,aACD,IAAI,EACJ,SAAS,sDAAsD,EAC/D,SAAS;AACd,CAAC;;;ADxDM,IAAM,eAAW,yBAAY,cAAc;","names":["import_dev"]}

package/dist/dev.mjs

@@ -0,0 +1,33 @@
+import {
+  __export
+} from "./chunk-J5LGTIGS.mjs";
+
+// src/schemas/index.ts
+var schemas_exports = {};
+__export(schemas_exports, {
+  SettingsSchema: () => SettingsSchema,
+  settings: () => settings
+});
+import { zodToSchema } from "@walkeros/core/dev";
+
+// src/schemas/settings.ts
+import { z } from "@walkeros/core/dev";
+var SettingsSchema = z.object({
+  storage: z.boolean().default(false).describe("Enable persistent storage for session/device IDs").optional(),
+  consent: z.union([z.string(), z.array(z.string())]).describe("Consent key(s) required to enable storage mode").optional(),
+  length: z.number().default(30).describe("Session timeout in minutes").optional(),
+  pulse: z.boolean().default(false).describe("Keep session alive on each event").optional(),
+  sessionKey: z.string().default("elbSessionId").describe("Storage key for session ID").optional(),
+  sessionStorage: z.enum(["local", "session"]).default("local").describe("Storage type for session").optional(),
+  deviceKey: z.string().default("elbDeviceId").describe("Storage key for device ID").optional(),
+  deviceStorage: z.enum(["local", "session"]).default("local").describe("Storage type for device").optional(),
+  deviceAge: z.number().default(30).describe("Device ID age in days").optional(),
+  cb: z.any().describe("Custom session callback function or false to disable").optional()
+});
+
+// src/schemas/index.ts
+var settings = zodToSchema(SettingsSchema);
+export {
+  schemas_exports as schemas
+};
+//# sourceMappingURL=dev.mjs.map

package/dist/dev.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/schemas/index.ts","../src/schemas/settings.ts"],"sourcesContent":["import { zodToSchema } from '@walkeros/core/dev';\nimport { SettingsSchema } from './settings';\n\n// Export Zod schemas and types\nexport { SettingsSchema, type Settings } from './settings';\n\n// JSON Schema exports (for website PropertyTable)\nexport const settings = zodToSchema(SettingsSchema);\n","import { z } from '@walkeros/core/dev';\n\n/**\n * Session source settings schema\n */\nexport const SettingsSchema = z.object({\n  storage: z\n    .boolean()\n    .default(false)\n    .describe('Enable persistent storage for session/device IDs')\n    .optional(),\n\n  consent: z\n    .union([z.string(), z.array(z.string())])\n    .describe('Consent key(s) required to enable storage mode')\n    .optional(),\n\n  length: z\n    .number()\n    .default(30)\n    .describe('Session timeout in minutes')\n    .optional(),\n\n  pulse: z\n    .boolean()\n    .default(false)\n    .describe('Keep session alive on each event')\n    .optional(),\n\n  sessionKey: z\n    .string()\n    .default('elbSessionId')\n    .describe('Storage key for session ID')\n    .optional(),\n\n  sessionStorage: z\n    .enum(['local', 'session'])\n    .default('local')\n    .describe('Storage type for session')\n    .optional(),\n\n  deviceKey: z\n    .string()\n    .default('elbDeviceId')\n    .describe('Storage key for device ID')\n    .optional(),\n\n  deviceStorage: z\n    .enum(['local', 'session'])\n    .default('local')\n    .describe('Storage type for device')\n    .optional(),\n\n  deviceAge: z\n    .number()\n    .default(30)\n    .describe('Device ID age in days')\n    .optional(),\n\n  cb: z\n    .any()\n    .describe('Custom session callback function or false to disable')\n    .optional(),\n});\n\nexport type Settings = z.infer<typeof SettingsSchema>;\n"],"mappings":";;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,SAAS,mBAAmB;;;ACA5B,SAAS,SAAS;AAKX,IAAM,iBAAiB,EAAE,OAAO;AAAA,EACrC,SAAS,EACN,QAAQ,EACR,QAAQ,KAAK,EACb,SAAS,kDAAkD,EAC3D,SAAS;AAAA,EAEZ,SAAS,EACN,MAAM,CAAC,EAAE,OAAO,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EACvC,SAAS,gDAAgD,EACzD,SAAS;AAAA,EAEZ,QAAQ,EACL,OAAO,EACP,QAAQ,EAAE,EACV,SAAS,4BAA4B,EACrC,SAAS;AAAA,EAEZ,OAAO,EACJ,QAAQ,EACR,QAAQ,KAAK,EACb,SAAS,kCAAkC,EAC3C,SAAS;AAAA,EAEZ,YAAY,EACT,OAAO,EACP,QAAQ,cAAc,EACtB,SAAS,4BAA4B,EACrC,SAAS;AAAA,EAEZ,gBAAgB,EACb,KAAK,CAAC,SAAS,SAAS,CAAC,EACzB,QAAQ,OAAO,EACf,SAAS,0BAA0B,EACnC,SAAS;AAAA,EAEZ,WAAW,EACR,OAAO,EACP,QAAQ,aAAa,EACrB,SAAS,2BAA2B,EACpC,SAAS;AAAA,EAEZ,eAAe,EACZ,KAAK,CAAC,SAAS,SAAS,CAAC,EACzB,QAAQ,OAAO,EACf,SAAS,yBAAyB,EAClC,SAAS;AAAA,EAEZ,WAAW,EACR,OAAO,EACP,QAAQ,EAAE,EACV,SAAS,uBAAuB,EAChC,SAAS;AAAA,EAEZ,IAAI,EACD,IAAI,EACJ,SAAS,sDAAsD,EAC/D,SAAS;AACd,CAAC;;;ADxDM,IAAM,WAAW,YAAY,cAAc;","names":[]}

package/dist/index.d.mts

@@ -0,0 +1,68 @@
+import { WalkerOS, MarketingParameters, Collector, StorageType, Source, Elb } from '@walkeros/core';
+
+interface SessionWindowConfig {
+    data?: WalkerOS.Properties;
+    domains?: string[];
+    isStart?: boolean;
+    parameters?: MarketingParameters;
+    referrer?: string;
+    url?: string;
+}
+declare function sessionWindow(config?: SessionWindowConfig): Collector.SessionData;
+
+interface SessionStorageConfig extends SessionWindowConfig {
+    deviceKey?: string;
+    deviceStorage?: StorageType;
+    deviceAge?: number;
+    sessionKey?: string;
+    sessionStorage?: StorageType;
+    length?: number;
+    pulse?: boolean;
+}
+declare function sessionStorage(config?: SessionStorageConfig): Collector.SessionData;
+
+interface SessionConfig extends SessionStorageConfig {
+    consent?: string | string[];
+    storage?: boolean;
+    cb?: SessionCallback | false;
+    collector?: Collector.Instance;
+}
+type SessionFunction = typeof sessionStorage | typeof sessionWindow;
+type SessionCallback = (session: Collector.SessionData, collector: Collector.Instance | undefined, defaultCb: SessionCallback) => void;
+declare function sessionStart(config?: SessionConfig): Collector.SessionData | void;
+
+interface Settings extends SessionConfig {
+}
+type InitSettings = Partial<Settings>;
+interface Mapping {
+}
+type Push = Elb.Fn;
+interface Env extends Source.BaseEnv {
+}
+type Types = Source.Types<Settings, Mapping, Push, Env, InitSettings>;
+type Config = Source.Config<Types>;
+
+type index_Config = Config;
+type index_Env = Env;
+type index_InitSettings = InitSettings;
+type index_Mapping = Mapping;
+type index_Push = Push;
+type index_SessionCallback = SessionCallback;
+type index_SessionConfig = SessionConfig;
+type index_SessionFunction = SessionFunction;
+type index_SessionStorageConfig = SessionStorageConfig;
+type index_SessionWindowConfig = SessionWindowConfig;
+type index_Settings = Settings;
+type index_Types = Types;
+declare namespace index {
+  export type { index_Config as Config, index_Env as Env, index_InitSettings as InitSettings, index_Mapping as Mapping, index_Push as Push, index_SessionCallback as SessionCallback, index_SessionConfig as SessionConfig, index_SessionFunction as SessionFunction, index_SessionStorageConfig as SessionStorageConfig, index_SessionWindowConfig as SessionWindowConfig, index_Settings as Settings, index_Types as Types };
+}
+
+/**
+ * Session source implementation.
+ *
+ * This source handles session detection and management.
+ */
+declare const sourceSession: Source.Init<Types>;
+
+export { type SessionCallback, type SessionConfig, type SessionFunction, type SessionStorageConfig, type SessionWindowConfig, index as SourceSession, sourceSession as default, sessionStart, sessionStorage, sessionWindow, sourceSession };

package/dist/index.d.ts

@@ -0,0 +1,68 @@
+import { WalkerOS, MarketingParameters, Collector, StorageType, Source, Elb } from '@walkeros/core';
+
+interface SessionWindowConfig {
+    data?: WalkerOS.Properties;
+    domains?: string[];
+    isStart?: boolean;
+    parameters?: MarketingParameters;
+    referrer?: string;
+    url?: string;
+}
+declare function sessionWindow(config?: SessionWindowConfig): Collector.SessionData;
+
+interface SessionStorageConfig extends SessionWindowConfig {
+    deviceKey?: string;
+    deviceStorage?: StorageType;
+    deviceAge?: number;
+    sessionKey?: string;
+    sessionStorage?: StorageType;
+    length?: number;
+    pulse?: boolean;
+}
+declare function sessionStorage(config?: SessionStorageConfig): Collector.SessionData;
+
+interface SessionConfig extends SessionStorageConfig {
+    consent?: string | string[];
+    storage?: boolean;
+    cb?: SessionCallback | false;
+    collector?: Collector.Instance;
+}
+type SessionFunction = typeof sessionStorage | typeof sessionWindow;
+type SessionCallback = (session: Collector.SessionData, collector: Collector.Instance | undefined, defaultCb: SessionCallback) => void;
+declare function sessionStart(config?: SessionConfig): Collector.SessionData | void;
+
+interface Settings extends SessionConfig {
+}
+type InitSettings = Partial<Settings>;
+interface Mapping {
+}
+type Push = Elb.Fn;
+interface Env extends Source.BaseEnv {
+}
+type Types = Source.Types<Settings, Mapping, Push, Env, InitSettings>;
+type Config = Source.Config<Types>;
+
+type index_Config = Config;
+type index_Env = Env;
+type index_InitSettings = InitSettings;
+type index_Mapping = Mapping;
+type index_Push = Push;
+type index_SessionCallback = SessionCallback;
+type index_SessionConfig = SessionConfig;
+type index_SessionFunction = SessionFunction;
+type index_SessionStorageConfig = SessionStorageConfig;
+type index_SessionWindowConfig = SessionWindowConfig;
+type index_Settings = Settings;
+type index_Types = Types;
+declare namespace index {
+  export type { index_Config as Config, index_Env as Env, index_InitSettings as InitSettings, index_Mapping as Mapping, index_Push as Push, index_SessionCallback as SessionCallback, index_SessionConfig as SessionConfig, index_SessionFunction as SessionFunction, index_SessionStorageConfig as SessionStorageConfig, index_SessionWindowConfig as SessionWindowConfig, index_Settings as Settings, index_Types as Types };
+}
+
+/**
+ * Session source implementation.
+ *
+ * This source handles session detection and management.
+ */
+declare const sourceSession: Source.Init<Types>;
+
+export { type SessionCallback, type SessionConfig, type SessionFunction, type SessionStorageConfig, type SessionWindowConfig, index as SourceSession, sourceSession as default, sessionStart, sessionStorage, sessionWindow, sourceSession };

package/dist/index.js

@@ -0,0 +1,259 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  SourceSession: () => types_exports,
+  default: () => index_default,
+  sessionStart: () => sessionStart,
+  sessionStorage: () => sessionStorage,
+  sessionWindow: () => sessionWindow,
+  sourceSession: () => sourceSession
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/lib/sessionStorage.ts
+var import_core2 = require("@walkeros/core");
+var import_web_core = require("@walkeros/web-core");
+
+// src/lib/sessionWindow.ts
+var import_core = require("@walkeros/core");
+function sessionWindow(config = {}) {
+  let isStart = config.isStart || false;
+  const known = { isStart, storage: false };
+  if (config.isStart === false) return known;
+  if (!isStart) {
+    const [perf] = performance.getEntriesByType(
+      "navigation"
+    );
+    if (perf.type !== "navigate") return known;
+  }
+  const url = new URL(config.url || window.location.href);
+  const ref = config.referrer || document.referrer;
+  const referrer = ref && new URL(ref).hostname;
+  const marketing = (0, import_core.getMarketingParameters)(url, config.parameters);
+  if (Object.keys(marketing).length) {
+    if (!marketing.marketing)
+      marketing.marketing = true;
+    isStart = true;
+  }
+  if (!isStart) {
+    const domains = config.domains || [];
+    domains.push(url.hostname);
+    isStart = !domains.includes(referrer);
+  }
+  return isStart ? (
+    // It's a session start, moin
+    Object.assign(
+      {
+        isStart,
+        storage: false,
+        start: Date.now(),
+        id: (0, import_core.getId)(12),
+        referrer
+      },
+      marketing,
+      config.data
+    )
+  ) : (
+    // No session start
+    known
+  );
+}
+
+// src/lib/sessionStorage.ts
+function sessionStorage(config = {}) {
+  const now = Date.now();
+  const {
+    length = 30,
+    // Session length in minutes
+    deviceKey = "elbDeviceId",
+    deviceStorage = "local",
+    deviceAge = 30,
+    // Device ID age in days
+    sessionKey = "elbSessionId",
+    sessionStorage: sessionStorage2 = "local",
+    pulse = false
+    // Handle the counting
+  } = config;
+  const windowSession = sessionWindow(config);
+  let isStart = false;
+  const device = (0, import_core2.tryCatch)((key, age, storage) => {
+    let id = (0, import_web_core.storageRead)(key, storage);
+    if (!id) {
+      id = (0, import_core2.getId)(8);
+      (0, import_web_core.storageWrite)(key, id, age * 1440, storage);
+    }
+    return String(id);
+  })(deviceKey, deviceAge, deviceStorage);
+  const existingSession = (0, import_core2.tryCatch)(
+    (key, storage) => {
+      const session2 = JSON.parse(String((0, import_web_core.storageRead)(key, storage)));
+      if (pulse) return session2;
+      session2.isNew = false;
+      if (windowSession.marketing) {
+        Object.assign(session2, windowSession);
+        isStart = true;
+      }
+      if (isStart || session2.updated + length * 6e4 < now) {
+        delete session2.id;
+        delete session2.referrer;
+        session2.start = now;
+        session2.count++;
+        session2.runs = 1;
+        isStart = true;
+      } else {
+        session2.runs++;
+      }
+      return session2;
+    },
+    () => {
+      isStart = true;
+    }
+  )(sessionKey, sessionStorage2) || {};
+  const defaultSession = {
+    id: (0, import_core2.getId)(12),
+    start: now,
+    isNew: true,
+    count: 1,
+    runs: 1
+  };
+  const session = Object.assign(
+    defaultSession,
+    // Default session values
+    windowSession,
+    // Basic session data based on window
+    existingSession,
+    // (Updated) existing session
+    { device },
+    // Device ID
+    { isStart, storage: true, updated: now },
+    // Status of the session
+    config.data
+    // Given data has the highest priority
+  );
+  (0, import_web_core.storageWrite)(sessionKey, JSON.stringify(session), length * 2, sessionStorage2);
+  return session;
+}
+
+// src/lib/sessionStart.ts
+var import_core3 = require("@walkeros/core");
+function sessionStart(config = {}) {
+  const { cb, consent, collector, storage } = config;
+  const sessionFn = storage ? sessionStorage : sessionWindow;
+  if (consent) {
+    const consentHandler = onConsentFn(config, cb);
+    const consentConfig = ((0, import_core3.isArray)(consent) ? consent : [consent]).reduce(
+      (acc, key) => ({ ...acc, [key]: consentHandler }),
+      {}
+    );
+    if (collector) {
+      collector.command("on", "consent", consentConfig);
+    }
+  } else {
+    return callFuncAndCb(sessionFn(config), collector, cb);
+  }
+}
+function callFuncAndCb(session, collector, cb) {
+  if (cb === false) return session;
+  if (!cb) cb = defaultCb;
+  return cb(session, collector, defaultCb);
+}
+function onConsentFn(config, cb) {
+  let lastProcessedGroup;
+  const func = (collector, consent) => {
+    if ((0, import_core3.isDefined)(lastProcessedGroup) && lastProcessedGroup === (collector == null ? void 0 : collector.group))
+      return;
+    lastProcessedGroup = collector == null ? void 0 : collector.group;
+    let sessionFn = () => sessionWindow(config);
+    if (config.consent) {
+      const consentKeys = ((0, import_core3.isArray)(config.consent) ? config.consent : [config.consent]).reduce((acc, key) => ({ ...acc, [key]: true }), {});
+      if ((0, import_core3.getGrantedConsent)(consentKeys, consent))
+        sessionFn = () => sessionStorage(config);
+    }
+    return callFuncAndCb(sessionFn(), collector, cb);
+  };
+  return func;
+}
+var defaultCb = (session, collector) => {
+  const user = {};
+  if (session.id) user.session = session.id;
+  if (session.storage && session.device) user.device = session.device;
+  if (collector) {
+    collector.command("user", user);
+  }
+  if (session.isStart) {
+    if (collector) {
+      collector.push({
+        name: "session start",
+        data: session
+      });
+    }
+  }
+  return session;
+};
+
+// src/types/index.ts
+var types_exports = {};
+
+// src/index.ts
+var sourceSession = async (context) => {
+  const { config, env } = context;
+  const { elb, command } = env;
+  const settings = {
+    ...config == null ? void 0 : config.settings
+  };
+  const fullConfig = {
+    settings
+  };
+  const collectorInterface = {
+    push: elb,
+    group: void 0,
+    command
+  };
+  sessionStart({
+    ...settings,
+    collector: collectorInterface
+  });
+  const handleEvent = async (event) => {
+    if (event === "consent") {
+      sessionStart({
+        ...settings,
+        collector: collectorInterface
+      });
+    }
+  };
+  return {
+    type: "session",
+    config: fullConfig,
+    push: elb,
+    on: handleEvent
+  };
+};
+var index_default = sourceSession;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SourceSession,
+  sessionStart,
+  sessionStorage,
+  sessionWindow,
+  sourceSession
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/lib/sessionStorage.ts","../src/lib/sessionWindow.ts","../src/lib/sessionStart.ts","../src/types/index.ts"],"sourcesContent":["import type { Source, On, Collector } from '@walkeros/core';\nimport type { Types, Settings } from './types';\nimport { sessionStart } from './lib';\n\n// Export types for external usage\nexport * as SourceSession from './types';\n\n// Export lib functions for direct usage\nexport { sessionStart, sessionStorage, sessionWindow } from './lib';\nexport type {\n  SessionConfig,\n  SessionCallback,\n  SessionFunction,\n  SessionStorageConfig,\n  SessionWindowConfig,\n} from './lib';\n\n/**\n * Session source implementation.\n *\n * This source handles session detection and management.\n */\nexport const sourceSession: Source.Init<Types> = async (context) => {\n  const { config, env } = context;\n  const { elb, command } = env;\n\n  const settings: Settings = {\n    ...config?.settings,\n  };\n\n  const fullConfig: Source.Config<Types> = {\n    settings,\n  };\n\n  // Create minimal collector interface for sessionStart\n  const collectorInterface: Partial<Collector.Instance> = {\n    push: elb,\n    group: undefined,\n    command,\n  };\n\n  // Initialize session using local lib\n  sessionStart({\n    ...settings,\n    collector: collectorInterface as Collector.Instance,\n  });\n\n  // Handle events pushed from collector (consent, session, ready, run)\n  const handleEvent = async (event: On.Types) => {\n    if (event === 'consent') {\n      // Re-initialize session on consent changes\n      sessionStart({\n        ...settings,\n        collector: collectorInterface as Collector.Instance,\n      });\n    }\n  };\n\n  return {\n    type: 'session',\n    config: fullConfig,\n    push: elb,\n    on: handleEvent,\n  };\n};\n\nexport default sourceSession;\n","import type { Collector } from '@walkeros/core';\nimport type { SessionWindowConfig } from './sessionWindow';\nimport type { StorageType } from '@walkeros/core';\nimport { getId, tryCatch } from '@walkeros/core';\nimport { storageRead, storageWrite } from '@walkeros/web-core';\nimport { sessionWindow } from './sessionWindow';\n\nexport interface SessionStorageConfig extends SessionWindowConfig {\n  deviceKey?: string;\n  deviceStorage?: StorageType;\n  deviceAge?: number;\n  sessionKey?: string;\n  sessionStorage?: StorageType;\n  length?: number; // Minutes after last update to consider session as expired (default: 30)\n  pulse?: boolean;\n}\n\nexport function sessionStorage(\n  config: SessionStorageConfig = {},\n): Collector.SessionData {\n  const now = Date.now();\n  const {\n    length = 30, // Session length in minutes\n    deviceKey = 'elbDeviceId',\n    deviceStorage = 'local',\n    deviceAge = 30, // Device ID age in days\n    sessionKey = 'elbSessionId',\n    sessionStorage = 'local',\n    pulse = false, // Handle the counting\n  } = config;\n  const windowSession = sessionWindow(config); // Status based on window only\n  let isStart = false;\n\n  // Retrieve or create device ID\n  const device = tryCatch((key: string, age: number, storage: StorageType) => {\n    let id = storageRead(key, storage);\n    if (!id) {\n      id = getId(8); // Create a new device ID\n      storageWrite(key, id, age * 1440, storage); // Write device ID to storage\n    }\n    return String(id);\n  })(deviceKey, deviceAge, deviceStorage);\n\n  // Retrieve or initialize session data\n  const existingSession: Collector.SessionData =\n    tryCatch(\n      (key: string, storage?: StorageType) => {\n        const session = JSON.parse(String(storageRead(key, storage)));\n\n        // Only update session if it's not a pulse check\n        if (pulse) return session;\n\n        // Mark session as not new by default\n        session.isNew = false;\n\n        // Handle new marketing entry\n        if (windowSession.marketing) {\n          Object.assign(session, windowSession); // Overwrite existing session with marketing data\n          isStart = true; // This is a session start\n        }\n\n        // Check if session is still active\n        if (isStart || session.updated + length * 60000 < now) {\n          // Session has expired\n          delete session.id; // Unset session ID\n          delete session.referrer; // Unset referrer\n          session.start = now; // Set new session start\n          session.count++; // Increase session count\n          session.runs = 1; // Reset runs\n          isStart = true; // It's a new session\n        } else {\n          // Session is still active\n          session.runs++; // Increase number of runs\n        }\n\n        return session;\n      },\n      () => {\n        // No existing session or something went wrong\n        isStart = true; // Start a new session\n      },\n    )(sessionKey, sessionStorage) || {};\n\n  // Default session data\n  const defaultSession: Partial<Collector.SessionData> = {\n    id: getId(12),\n    start: now,\n    isNew: true,\n    count: 1,\n    runs: 1,\n  };\n\n  // Merge session data\n  const session = Object.assign(\n    defaultSession, // Default session values\n    windowSession, // Basic session data based on window\n    existingSession, // (Updated) existing session\n    { device }, // Device ID\n    { isStart, storage: true, updated: now }, // Status of the session\n    config.data, // Given data has the highest priority\n  );\n\n  // Write (updated) session to storage\n  storageWrite(sessionKey, JSON.stringify(session), length * 2, sessionStorage);\n\n  return session;\n}\n","import type { Collector, WalkerOS } from '@walkeros/core';\nimport {\n  getId,\n  getMarketingParameters,\n  type MarketingParameters,\n} from '@walkeros/core';\n\nexport interface SessionWindowConfig {\n  data?: WalkerOS.Properties;\n  domains?: string[];\n  isStart?: boolean;\n  parameters?: MarketingParameters;\n  referrer?: string;\n  url?: string;\n}\n\nexport function sessionWindow(\n  config: SessionWindowConfig = {},\n): Collector.SessionData {\n  let isStart = config.isStart || false;\n  const known = { isStart, storage: false };\n\n  // If session has explicitly started, return known\n  if (config.isStart === false) return known;\n\n  // Entry type\n  if (!isStart) {\n    // Only focus on linked or direct navigation types\n    // and ignore reloads and all others\n    const [perf] = performance.getEntriesByType(\n      'navigation',\n    ) as PerformanceNavigationTiming[];\n    if (perf.type !== 'navigate') return known;\n  }\n\n  const url = new URL(config.url || window.location.href);\n  const ref = config.referrer || document.referrer;\n  const referrer = ref && new URL(ref).hostname;\n\n  // Marketing\n  const marketing = getMarketingParameters(url, config.parameters);\n  if (Object.keys(marketing).length) {\n    // Check for marketing parameters like UTM and add existing\n    if (!marketing.marketing)\n      // Flag as a marketing session without overwriting\n      marketing.marketing = true;\n\n    isStart = true;\n  }\n\n  // Referrer\n  if (!isStart) {\n    // Small chance of multiple unintended events for same users\n    // https://en.wikipedia.org/wiki/HTTP_referer#Referrer_hiding\n    // Use domains: [''] to disable direct or hidden referrer\n\n    const domains = config.domains || [];\n    domains.push(url.hostname);\n    isStart = !domains.includes(referrer);\n  }\n\n  return isStart\n    ? // It's a session start, moin\n      Object.assign(\n        {\n          isStart,\n          storage: false,\n          start: Date.now(),\n          id: getId(12),\n          referrer,\n        },\n        marketing,\n        config.data,\n      )\n    : // No session start\n      known;\n}\n","import type { Collector, WalkerOS, On } from '@walkeros/core';\nimport type { SessionStorageConfig } from './sessionStorage';\nimport { sessionStorage } from './sessionStorage';\nimport { sessionWindow } from './sessionWindow';\nimport { getGrantedConsent, isArray, isDefined } from '@walkeros/core';\n\nexport interface SessionConfig extends SessionStorageConfig {\n  consent?: string | string[];\n  storage?: boolean;\n  cb?: SessionCallback | false;\n  collector?: Collector.Instance;\n}\n\nexport type SessionFunction = typeof sessionStorage | typeof sessionWindow;\nexport type SessionCallback = (\n  session: Collector.SessionData,\n  collector: Collector.Instance | undefined,\n  defaultCb: SessionCallback,\n) => void;\n\nexport function sessionStart(\n  config: SessionConfig = {},\n): Collector.SessionData | void {\n  const { cb, consent, collector, storage } = config;\n  const sessionFn: SessionFunction = storage ? sessionStorage : sessionWindow;\n\n  // Consent\n  if (consent) {\n    const consentHandler = onConsentFn(config, cb);\n\n    const consentConfig = (\n      isArray(consent) ? consent : [consent]\n    ).reduce<On.ConsentConfig>(\n      (acc, key) => ({ ...acc, [key]: consentHandler }),\n      {},\n    );\n    // Register consent handlers with the collector\n    if (collector) {\n      collector.command('on', 'consent', consentConfig);\n    }\n    // No fallback - session source always provides collector\n  } else {\n    // just do it\n    return callFuncAndCb(sessionFn(config), collector, cb);\n  }\n}\n\nfunction callFuncAndCb(\n  session: Collector.SessionData,\n  collector?: Collector.Instance,\n  cb?: SessionCallback | false,\n) {\n  if (cb === false) return session; // Callback is disabled\n  if (!cb) cb = defaultCb; // Default callback if none is provided\n  return cb(session, collector, defaultCb);\n}\n\nfunction onConsentFn(config: SessionConfig, cb?: SessionCallback | false) {\n  // Track the last processed group to prevent duplicate processing\n  let lastProcessedGroup: string | undefined;\n\n  const func = (collector: Collector.Instance, consent: WalkerOS.Consent) => {\n    // Skip if we've already processed this group\n    if (\n      isDefined(lastProcessedGroup) &&\n      lastProcessedGroup === collector?.group\n    )\n      return;\n\n    // Remember this group has been processed\n    lastProcessedGroup = collector?.group;\n\n    let sessionFn: SessionFunction = () => sessionWindow(config); // Window by default\n\n    if (config.consent) {\n      const consentKeys = (\n        isArray(config.consent) ? config.consent : [config.consent]\n      ).reduce<WalkerOS.Consent>((acc, key) => ({ ...acc, [key]: true }), {});\n\n      if (getGrantedConsent(consentKeys, consent))\n        // Use storage if consent is granted\n        sessionFn = () => sessionStorage(config);\n    }\n\n    return callFuncAndCb(sessionFn(), collector, cb);\n  };\n\n  return func;\n}\n\nconst defaultCb: SessionCallback = (\n  session,\n  collector,\n): Collector.SessionData => {\n  const user: WalkerOS.User = {};\n\n  // User.session is the session ID\n  if (session.id) user.session = session.id;\n\n  // Set device ID only in storage mode\n  if (session.storage && session.device) user.device = session.device;\n\n  // Set user IDs\n  if (collector) {\n    collector.command('user', user);\n  }\n  // No fallback - session source always provides collector\n\n  if (session.isStart) {\n    // Convert session start to an event object\n    if (collector) {\n      collector.push({\n        name: 'session start',\n        data: session,\n      });\n    }\n    // No fallback - session source always provides collector\n  }\n\n  return session;\n};\n","import type { Source, Elb } from '@walkeros/core';\nimport type { SessionConfig, SessionCallback } from '../lib';\n\n// Settings: configuration for session source\nexport interface Settings extends SessionConfig {\n  // All settings inherited from SessionConfig:\n  // - consent?: string | string[]\n  // - storage?: boolean\n  // - cb?: SessionCallback | false\n  // - pulse?: boolean\n  // - sessionStorage?: 'local' | 'session'\n  // - deviceStorage?: 'local' | 'session'\n  // - sessionKey?: string\n  // - deviceKey?: string\n  // - length?: number (session timeout in minutes)\n}\n\n// InitSettings: user input (all optional)\nexport type InitSettings = Partial<Settings>;\n\nexport interface Mapping {}\n\nexport type Push = Elb.Fn;\n\nexport interface Env extends Source.BaseEnv {}\n\nexport type Types = Source.Types<Settings, Mapping, Push, Env, InitSettings>;\n\nexport type Config = Source.Config<Types>;\n\n// Re-export session types from lib\nexport type {\n  SessionConfig,\n  SessionCallback,\n  SessionFunction,\n  SessionStorageConfig,\n  SessionWindowConfig,\n} from '../lib';\n"],"mappings":"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","names":["import_core","sessionStorage","session","import_core"]}

package/dist/index.mjs

@@ -0,0 +1,233 @@
+import "./chunk-J5LGTIGS.mjs";
+
+// src/lib/sessionStorage.ts
+import { getId as getId2, tryCatch } from "@walkeros/core";
+import { storageRead, storageWrite } from "@walkeros/web-core";
+
+// src/lib/sessionWindow.ts
+import {
+  getId,
+  getMarketingParameters
+} from "@walkeros/core";
+function sessionWindow(config = {}) {
+  let isStart = config.isStart || false;
+  const known = { isStart, storage: false };
+  if (config.isStart === false) return known;
+  if (!isStart) {
+    const [perf] = performance.getEntriesByType(
+      "navigation"
+    );
+    if (perf.type !== "navigate") return known;
+  }
+  const url = new URL(config.url || window.location.href);
+  const ref = config.referrer || document.referrer;
+  const referrer = ref && new URL(ref).hostname;
+  const marketing = getMarketingParameters(url, config.parameters);
+  if (Object.keys(marketing).length) {
+    if (!marketing.marketing)
+      marketing.marketing = true;
+    isStart = true;
+  }
+  if (!isStart) {
+    const domains = config.domains || [];
+    domains.push(url.hostname);
+    isStart = !domains.includes(referrer);
+  }
+  return isStart ? (
+    // It's a session start, moin
+    Object.assign(
+      {
+        isStart,
+        storage: false,
+        start: Date.now(),
+        id: getId(12),
+        referrer
+      },
+      marketing,
+      config.data
+    )
+  ) : (
+    // No session start
+    known
+  );
+}
+
+// src/lib/sessionStorage.ts
+function sessionStorage(config = {}) {
+  const now = Date.now();
+  const {
+    length = 30,
+    // Session length in minutes
+    deviceKey = "elbDeviceId",
+    deviceStorage = "local",
+    deviceAge = 30,
+    // Device ID age in days
+    sessionKey = "elbSessionId",
+    sessionStorage: sessionStorage2 = "local",
+    pulse = false
+    // Handle the counting
+  } = config;
+  const windowSession = sessionWindow(config);
+  let isStart = false;
+  const device = tryCatch((key, age, storage) => {
+    let id = storageRead(key, storage);
+    if (!id) {
+      id = getId2(8);
+      storageWrite(key, id, age * 1440, storage);
+    }
+    return String(id);
+  })(deviceKey, deviceAge, deviceStorage);
+  const existingSession = tryCatch(
+    (key, storage) => {
+      const session2 = JSON.parse(String(storageRead(key, storage)));
+      if (pulse) return session2;
+      session2.isNew = false;
+      if (windowSession.marketing) {
+        Object.assign(session2, windowSession);
+        isStart = true;
+      }
+      if (isStart || session2.updated + length * 6e4 < now) {
+        delete session2.id;
+        delete session2.referrer;
+        session2.start = now;
+        session2.count++;
+        session2.runs = 1;
+        isStart = true;
+      } else {
+        session2.runs++;
+      }
+      return session2;
+    },
+    () => {
+      isStart = true;
+    }
+  )(sessionKey, sessionStorage2) || {};
+  const defaultSession = {
+    id: getId2(12),
+    start: now,
+    isNew: true,
+    count: 1,
+    runs: 1
+  };
+  const session = Object.assign(
+    defaultSession,
+    // Default session values
+    windowSession,
+    // Basic session data based on window
+    existingSession,
+    // (Updated) existing session
+    { device },
+    // Device ID
+    { isStart, storage: true, updated: now },
+    // Status of the session
+    config.data
+    // Given data has the highest priority
+  );
+  storageWrite(sessionKey, JSON.stringify(session), length * 2, sessionStorage2);
+  return session;
+}
+
+// src/lib/sessionStart.ts
+import { getGrantedConsent, isArray, isDefined } from "@walkeros/core";
+function sessionStart(config = {}) {
+  const { cb, consent, collector, storage } = config;
+  const sessionFn = storage ? sessionStorage : sessionWindow;
+  if (consent) {
+    const consentHandler = onConsentFn(config, cb);
+    const consentConfig = (isArray(consent) ? consent : [consent]).reduce(
+      (acc, key) => ({ ...acc, [key]: consentHandler }),
+      {}
+    );
+    if (collector) {
+      collector.command("on", "consent", consentConfig);
+    }
+  } else {
+    return callFuncAndCb(sessionFn(config), collector, cb);
+  }
+}
+function callFuncAndCb(session, collector, cb) {
+  if (cb === false) return session;
+  if (!cb) cb = defaultCb;
+  return cb(session, collector, defaultCb);
+}
+function onConsentFn(config, cb) {
+  let lastProcessedGroup;
+  const func = (collector, consent) => {
+    if (isDefined(lastProcessedGroup) && lastProcessedGroup === (collector == null ? void 0 : collector.group))
+      return;
+    lastProcessedGroup = collector == null ? void 0 : collector.group;
+    let sessionFn = () => sessionWindow(config);
+    if (config.consent) {
+      const consentKeys = (isArray(config.consent) ? config.consent : [config.consent]).reduce((acc, key) => ({ ...acc, [key]: true }), {});
+      if (getGrantedConsent(consentKeys, consent))
+        sessionFn = () => sessionStorage(config);
+    }
+    return callFuncAndCb(sessionFn(), collector, cb);
+  };
+  return func;
+}
+var defaultCb = (session, collector) => {
+  const user = {};
+  if (session.id) user.session = session.id;
+  if (session.storage && session.device) user.device = session.device;
+  if (collector) {
+    collector.command("user", user);
+  }
+  if (session.isStart) {
+    if (collector) {
+      collector.push({
+        name: "session start",
+        data: session
+      });
+    }
+  }
+  return session;
+};
+
+// src/types/index.ts
+var types_exports = {};
+
+// src/index.ts
+var sourceSession = async (context) => {
+  const { config, env } = context;
+  const { elb, command } = env;
+  const settings = {
+    ...config == null ? void 0 : config.settings
+  };
+  const fullConfig = {
+    settings
+  };
+  const collectorInterface = {
+    push: elb,
+    group: void 0,
+    command
+  };
+  sessionStart({
+    ...settings,
+    collector: collectorInterface
+  });
+  const handleEvent = async (event) => {
+    if (event === "consent") {
+      sessionStart({
+        ...settings,
+        collector: collectorInterface
+      });
+    }
+  };
+  return {
+    type: "session",
+    config: fullConfig,
+    push: elb,
+    on: handleEvent
+  };
+};
+var index_default = sourceSession;
+export {
+  types_exports as SourceSession,
+  index_default as default,
+  sessionStart,
+  sessionStorage,
+  sessionWindow,
+  sourceSession
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/sessionStorage.ts","../src/lib/sessionWindow.ts","../src/lib/sessionStart.ts","../src/types/index.ts","../src/index.ts"],"sourcesContent":["import type { Collector } from '@walkeros/core';\nimport type { SessionWindowConfig } from './sessionWindow';\nimport type { StorageType } from '@walkeros/core';\nimport { getId, tryCatch } from '@walkeros/core';\nimport { storageRead, storageWrite } from '@walkeros/web-core';\nimport { sessionWindow } from './sessionWindow';\n\nexport interface SessionStorageConfig extends SessionWindowConfig {\n  deviceKey?: string;\n  deviceStorage?: StorageType;\n  deviceAge?: number;\n  sessionKey?: string;\n  sessionStorage?: StorageType;\n  length?: number; // Minutes after last update to consider session as expired (default: 30)\n  pulse?: boolean;\n}\n\nexport function sessionStorage(\n  config: SessionStorageConfig = {},\n): Collector.SessionData {\n  const now = Date.now();\n  const {\n    length = 30, // Session length in minutes\n    deviceKey = 'elbDeviceId',\n    deviceStorage = 'local',\n    deviceAge = 30, // Device ID age in days\n    sessionKey = 'elbSessionId',\n    sessionStorage = 'local',\n    pulse = false, // Handle the counting\n  } = config;\n  const windowSession = sessionWindow(config); // Status based on window only\n  let isStart = false;\n\n  // Retrieve or create device ID\n  const device = tryCatch((key: string, age: number, storage: StorageType) => {\n    let id = storageRead(key, storage);\n    if (!id) {\n      id = getId(8); // Create a new device ID\n      storageWrite(key, id, age * 1440, storage); // Write device ID to storage\n    }\n    return String(id);\n  })(deviceKey, deviceAge, deviceStorage);\n\n  // Retrieve or initialize session data\n  const existingSession: Collector.SessionData =\n    tryCatch(\n      (key: string, storage?: StorageType) => {\n        const session = JSON.parse(String(storageRead(key, storage)));\n\n        // Only update session if it's not a pulse check\n        if (pulse) return session;\n\n        // Mark session as not new by default\n        session.isNew = false;\n\n        // Handle new marketing entry\n        if (windowSession.marketing) {\n          Object.assign(session, windowSession); // Overwrite existing session with marketing data\n          isStart = true; // This is a session start\n        }\n\n        // Check if session is still active\n        if (isStart || session.updated + length * 60000 < now) {\n          // Session has expired\n          delete session.id; // Unset session ID\n          delete session.referrer; // Unset referrer\n          session.start = now; // Set new session start\n          session.count++; // Increase session count\n          session.runs = 1; // Reset runs\n          isStart = true; // It's a new session\n        } else {\n          // Session is still active\n          session.runs++; // Increase number of runs\n        }\n\n        return session;\n      },\n      () => {\n        // No existing session or something went wrong\n        isStart = true; // Start a new session\n      },\n    )(sessionKey, sessionStorage) || {};\n\n  // Default session data\n  const defaultSession: Partial<Collector.SessionData> = {\n    id: getId(12),\n    start: now,\n    isNew: true,\n    count: 1,\n    runs: 1,\n  };\n\n  // Merge session data\n  const session = Object.assign(\n    defaultSession, // Default session values\n    windowSession, // Basic session data based on window\n    existingSession, // (Updated) existing session\n    { device }, // Device ID\n    { isStart, storage: true, updated: now }, // Status of the session\n    config.data, // Given data has the highest priority\n  );\n\n  // Write (updated) session to storage\n  storageWrite(sessionKey, JSON.stringify(session), length * 2, sessionStorage);\n\n  return session;\n}\n","import type { Collector, WalkerOS } from '@walkeros/core';\nimport {\n  getId,\n  getMarketingParameters,\n  type MarketingParameters,\n} from '@walkeros/core';\n\nexport interface SessionWindowConfig {\n  data?: WalkerOS.Properties;\n  domains?: string[];\n  isStart?: boolean;\n  parameters?: MarketingParameters;\n  referrer?: string;\n  url?: string;\n}\n\nexport function sessionWindow(\n  config: SessionWindowConfig = {},\n): Collector.SessionData {\n  let isStart = config.isStart || false;\n  const known = { isStart, storage: false };\n\n  // If session has explicitly started, return known\n  if (config.isStart === false) return known;\n\n  // Entry type\n  if (!isStart) {\n    // Only focus on linked or direct navigation types\n    // and ignore reloads and all others\n    const [perf] = performance.getEntriesByType(\n      'navigation',\n    ) as PerformanceNavigationTiming[];\n    if (perf.type !== 'navigate') return known;\n  }\n\n  const url = new URL(config.url || window.location.href);\n  const ref = config.referrer || document.referrer;\n  const referrer = ref && new URL(ref).hostname;\n\n  // Marketing\n  const marketing = getMarketingParameters(url, config.parameters);\n  if (Object.keys(marketing).length) {\n    // Check for marketing parameters like UTM and add existing\n    if (!marketing.marketing)\n      // Flag as a marketing session without overwriting\n      marketing.marketing = true;\n\n    isStart = true;\n  }\n\n  // Referrer\n  if (!isStart) {\n    // Small chance of multiple unintended events for same users\n    // https://en.wikipedia.org/wiki/HTTP_referer#Referrer_hiding\n    // Use domains: [''] to disable direct or hidden referrer\n\n    const domains = config.domains || [];\n    domains.push(url.hostname);\n    isStart = !domains.includes(referrer);\n  }\n\n  return isStart\n    ? // It's a session start, moin\n      Object.assign(\n        {\n          isStart,\n          storage: false,\n          start: Date.now(),\n          id: getId(12),\n          referrer,\n        },\n        marketing,\n        config.data,\n      )\n    : // No session start\n      known;\n}\n","import type { Collector, WalkerOS, On } from '@walkeros/core';\nimport type { SessionStorageConfig } from './sessionStorage';\nimport { sessionStorage } from './sessionStorage';\nimport { sessionWindow } from './sessionWindow';\nimport { getGrantedConsent, isArray, isDefined } from '@walkeros/core';\n\nexport interface SessionConfig extends SessionStorageConfig {\n  consent?: string | string[];\n  storage?: boolean;\n  cb?: SessionCallback | false;\n  collector?: Collector.Instance;\n}\n\nexport type SessionFunction = typeof sessionStorage | typeof sessionWindow;\nexport type SessionCallback = (\n  session: Collector.SessionData,\n  collector: Collector.Instance | undefined,\n  defaultCb: SessionCallback,\n) => void;\n\nexport function sessionStart(\n  config: SessionConfig = {},\n): Collector.SessionData | void {\n  const { cb, consent, collector, storage } = config;\n  const sessionFn: SessionFunction = storage ? sessionStorage : sessionWindow;\n\n  // Consent\n  if (consent) {\n    const consentHandler = onConsentFn(config, cb);\n\n    const consentConfig = (\n      isArray(consent) ? consent : [consent]\n    ).reduce<On.ConsentConfig>(\n      (acc, key) => ({ ...acc, [key]: consentHandler }),\n      {},\n    );\n    // Register consent handlers with the collector\n    if (collector) {\n      collector.command('on', 'consent', consentConfig);\n    }\n    // No fallback - session source always provides collector\n  } else {\n    // just do it\n    return callFuncAndCb(sessionFn(config), collector, cb);\n  }\n}\n\nfunction callFuncAndCb(\n  session: Collector.SessionData,\n  collector?: Collector.Instance,\n  cb?: SessionCallback | false,\n) {\n  if (cb === false) return session; // Callback is disabled\n  if (!cb) cb = defaultCb; // Default callback if none is provided\n  return cb(session, collector, defaultCb);\n}\n\nfunction onConsentFn(config: SessionConfig, cb?: SessionCallback | false) {\n  // Track the last processed group to prevent duplicate processing\n  let lastProcessedGroup: string | undefined;\n\n  const func = (collector: Collector.Instance, consent: WalkerOS.Consent) => {\n    // Skip if we've already processed this group\n    if (\n      isDefined(lastProcessedGroup) &&\n      lastProcessedGroup === collector?.group\n    )\n      return;\n\n    // Remember this group has been processed\n    lastProcessedGroup = collector?.group;\n\n    let sessionFn: SessionFunction = () => sessionWindow(config); // Window by default\n\n    if (config.consent) {\n      const consentKeys = (\n        isArray(config.consent) ? config.consent : [config.consent]\n      ).reduce<WalkerOS.Consent>((acc, key) => ({ ...acc, [key]: true }), {});\n\n      if (getGrantedConsent(consentKeys, consent))\n        // Use storage if consent is granted\n        sessionFn = () => sessionStorage(config);\n    }\n\n    return callFuncAndCb(sessionFn(), collector, cb);\n  };\n\n  return func;\n}\n\nconst defaultCb: SessionCallback = (\n  session,\n  collector,\n): Collector.SessionData => {\n  const user: WalkerOS.User = {};\n\n  // User.session is the session ID\n  if (session.id) user.session = session.id;\n\n  // Set device ID only in storage mode\n  if (session.storage && session.device) user.device = session.device;\n\n  // Set user IDs\n  if (collector) {\n    collector.command('user', user);\n  }\n  // No fallback - session source always provides collector\n\n  if (session.isStart) {\n    // Convert session start to an event object\n    if (collector) {\n      collector.push({\n        name: 'session start',\n        data: session,\n      });\n    }\n    // No fallback - session source always provides collector\n  }\n\n  return session;\n};\n","import type { Source, Elb } from '@walkeros/core';\nimport type { SessionConfig, SessionCallback } from '../lib';\n\n// Settings: configuration for session source\nexport interface Settings extends SessionConfig {\n  // All settings inherited from SessionConfig:\n  // - consent?: string | string[]\n  // - storage?: boolean\n  // - cb?: SessionCallback | false\n  // - pulse?: boolean\n  // - sessionStorage?: 'local' | 'session'\n  // - deviceStorage?: 'local' | 'session'\n  // - sessionKey?: string\n  // - deviceKey?: string\n  // - length?: number (session timeout in minutes)\n}\n\n// InitSettings: user input (all optional)\nexport type InitSettings = Partial<Settings>;\n\nexport interface Mapping {}\n\nexport type Push = Elb.Fn;\n\nexport interface Env extends Source.BaseEnv {}\n\nexport type Types = Source.Types<Settings, Mapping, Push, Env, InitSettings>;\n\nexport type Config = Source.Config<Types>;\n\n// Re-export session types from lib\nexport type {\n  SessionConfig,\n  SessionCallback,\n  SessionFunction,\n  SessionStorageConfig,\n  SessionWindowConfig,\n} from '../lib';\n","import type { Source, On, Collector } from '@walkeros/core';\nimport type { Types, Settings } from './types';\nimport { sessionStart } from './lib';\n\n// Export types for external usage\nexport * as SourceSession from './types';\n\n// Export lib functions for direct usage\nexport { sessionStart, sessionStorage, sessionWindow } from './lib';\nexport type {\n  SessionConfig,\n  SessionCallback,\n  SessionFunction,\n  SessionStorageConfig,\n  SessionWindowConfig,\n} from './lib';\n\n/**\n * Session source implementation.\n *\n * This source handles session detection and management.\n */\nexport const sourceSession: Source.Init<Types> = async (context) => {\n  const { config, env } = context;\n  const { elb, command } = env;\n\n  const settings: Settings = {\n    ...config?.settings,\n  };\n\n  const fullConfig: Source.Config<Types> = {\n    settings,\n  };\n\n  // Create minimal collector interface for sessionStart\n  const collectorInterface: Partial<Collector.Instance> = {\n    push: elb,\n    group: undefined,\n    command,\n  };\n\n  // Initialize session using local lib\n  sessionStart({\n    ...settings,\n    collector: collectorInterface as Collector.Instance,\n  });\n\n  // Handle events pushed from collector (consent, session, ready, run)\n  const handleEvent = async (event: On.Types) => {\n    if (event === 'consent') {\n      // Re-initialize session on consent changes\n      sessionStart({\n        ...settings,\n        collector: collectorInterface as Collector.Instance,\n      });\n    }\n  };\n\n  return {\n    type: 'session',\n    config: fullConfig,\n    push: elb,\n    on: handleEvent,\n  };\n};\n\nexport default sourceSession;\n"],"mappings":"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","names":["getId","sessionStorage","getId","session"]}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@walkeros/web-source-session",
+  "description": "Session source for walkerOS",
+  "version": "1.1.0-next-1769684633114",
+  "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"
+    },
+    "./dev": {
+      "types": "./dist/dev.d.ts",
+      "import": "./dist/dev.mjs",
+      "require": "./dist/dev.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": "1.2.0-next-1769684633114",
+    "@walkeros/web-core": "1.0.2-next-1769684633114"
+  },
+  "devDependencies": {},
+  "repository": {
+    "url": "git+https://github.com/elbwalker/walkerOS.git",
+    "directory": "packages/web/sources/session"
+  },
+  "author": "elbwalker <hello@elbwalker.com>",
+  "homepage": "https://github.com/elbwalker/walkerOS#readme",
+  "bugs": {
+    "url": "https://github.com/elbwalker/walkerOS/issues"
+  },
+  "keywords": [
+    "walker",
+    "walkerOS",
+    "source",
+    "web",
+    "session"
+  ]
+}