@ductape/sdk 0.0.4-v6 → 0.0.4-v60

package/dist/sessions/sessions.resolver.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Sessions Resolver
+ *
+ * Utility for detecting and resolving $Session{key}{...path} patterns at runtime.
+ * This module handles:
+ * - Pattern detection in strings and objects
+ * - Session token verification and data extraction
+ * - Nested key path resolution (e.g., $Session{user}{address}{city})
+ * - Recursive resolution of nested objects
+ */
+/**
+ * Regex pattern to detect $Session{key} or $Session{key}{nested}{path} syntax (full string match)
+ * Matches: $Session{user}, $Session{user}{id}, $Session{user}{address}{city}
+ */
+export declare const SESSION_PATTERN: RegExp;
+/**
+ * Regex pattern to find all $Session{key}{...} occurrences in a string
+ */
+export declare const SESSION_PATTERN_GLOBAL: RegExp;
+/**
+ * Result of parsing a session token
+ */
+export interface ISessionTokenParts {
+    /** The session tag extracted from the token */
+    tag: string;
+    /** The JWT portion of the token */
+    jwt: string;
+}
+/**
+ * Result of verifying and decoding a session token
+ */
+export interface ISessionData {
+    /** The session tag */
+    tag: string;
+    /** The session ID */
+    sessionId: string;
+    /** The user identifier from session creation */
+    identifier?: string;
+    /** The session data payload */
+    data: Record<string, unknown>;
+    /** Session expiration timestamp */
+    expiresAt?: number;
+    /** Environment slug */
+    env?: string;
+}
+/**
+ * Result of checking if a value is a session reference
+ */
+export interface ISessionCheck {
+    /** Whether the value is a session reference */
+    isSession: boolean;
+    /** The key path segments if it's a session reference */
+    keyPath?: string[];
+}
+/**
+ * Options for resolving sessions at runtime
+ */
+export interface IResolveSessionOptions {
+    /** Current environment slug */
+    env?: string;
+}
+/**
+ * Result of session resolution
+ */
+export interface ISessionResolutionResult<T = unknown> {
+    /** The resolved value with session references replaced */
+    value: T;
+    /** Keys that were resolved */
+    resolvedKeys: string[];
+    /** Keys that failed to resolve */
+    failedKeys: string[];
+}
+/**
+ * Session context containing identifier and session metadata
+ */
+export interface ISessionContext {
+    /** User identifier from session */
+    identifier: string;
+    /** Session ID */
+    session_id: string;
+    /** Session tag */
+    session_tag: string;
+    /** Session data payload */
+    data: Record<string, unknown>;
+}
+/**
+ * Parse a session token in format "session_tag:jwt_token"
+ */
+export declare function parseSessionToken(token: string): ISessionTokenParts | null;
+/**
+ * Check if a string value is a session reference
+ */
+export declare function isSessionReference(value: string): ISessionCheck;
+/**
+ * Check if a string contains any session references (partial matches)
+ */
+export declare function containsSessionReferences(value: string): boolean;
+/**
+ * Extract all session references from a string
+ */
+export declare function extractSessionReferences(value: string): Array<{
+    full: string;
+    keyPath: string[];
+}>;
+/**
+ * Get a nested value from an object using a key path
+ */
+export declare function getNestedValue(obj: Record<string, unknown>, keyPath: string[]): unknown;
+/**
+ * Verify and decode a session JWT token
+ * Returns the session data if valid, null otherwise
+ */
+export declare function verifySessionToken(token: string, privateKey: string, expectedTag?: string, expectedEnv?: string): Promise<ISessionData | null>;
+/**
+ * Extract session context from a verified session
+ * This includes identifier, session_id, session_tag for logging
+ */
+export declare function extractSessionContext(sessionData: ISessionData, selector?: string): ISessionContext;
+/**
+ * Type guard to check if a value might contain session references
+ */
+export declare function mightContainSessions(value: unknown): boolean;
+/**
+ * Recursively find all session references in an object
+ */
+export declare function findAllSessionReferences(obj: unknown): Array<{
+    full: string;
+    keyPath: string[];
+}>;
+/**
+ * Replace a single session reference with its resolved value
+ */
+export declare function replaceSessionInString(value: string, reference: string, resolvedValue: unknown): string;
+/**
+ * Create a sessions resolver instance
+ */
+export declare function createSessionsResolver(sessionData: ISessionData): {
+    resolveReference: (keyPath: string[]) => unknown;
+    resolveString: (value: string) => ISessionResolutionResult<string>;
+    resolveObject: <T>(obj: T) => ISessionResolutionResult<T>;
+    getSessionData: () => ISessionData;
+};
+/**
+ * Error class for session resolution
+ */
+export declare class SessionResolutionError extends Error {
+    code: string;
+    details?: unknown;
+    constructor(message: string, code: string, details?: unknown);
+}

package/dist/sessions/sessions.resolver.js

@@ -0,0 +1,356 @@
+"use strict";
+/**
+ * Sessions Resolver
+ *
+ * Utility for detecting and resolving $Session{key}{...path} patterns at runtime.
+ * This module handles:
+ * - Pattern detection in strings and objects
+ * - Session token verification and data extraction
+ * - Nested key path resolution (e.g., $Session{user}{address}{city})
+ * - Recursive resolution of nested objects
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionResolutionError = exports.SESSION_PATTERN_GLOBAL = exports.SESSION_PATTERN = void 0;
+exports.parseSessionToken = parseSessionToken;
+exports.isSessionReference = isSessionReference;
+exports.containsSessionReferences = containsSessionReferences;
+exports.extractSessionReferences = extractSessionReferences;
+exports.getNestedValue = getNestedValue;
+exports.verifySessionToken = verifySessionToken;
+exports.extractSessionContext = extractSessionContext;
+exports.mightContainSessions = mightContainSessions;
+exports.findAllSessionReferences = findAllSessionReferences;
+exports.replaceSessionInString = replaceSessionInString;
+exports.createSessionsResolver = createSessionsResolver;
+/**
+ * Regex pattern to detect $Session{key} or $Session{key}{nested}{path} syntax (full string match)
+ * Matches: $Session{user}, $Session{user}{id}, $Session{user}{address}{city}
+ */
+exports.SESSION_PATTERN = /^\$Session(\{[a-zA-Z0-9._-]+\})+$/;
+/**
+ * Regex pattern to find all $Session{key}{...} occurrences in a string
+ */
+exports.SESSION_PATTERN_GLOBAL = /\$Session(\{[a-zA-Z0-9._-]+\})+/g;
+/**
+ * Regex pattern to extract individual key segments from a session reference
+ */
+const KEY_SEGMENT_PATTERN = /\{([a-zA-Z0-9._-]+)\}/g;
+/**
+ * Parse a session token in format "session_tag:jwt_token"
+ */
+function parseSessionToken(token) {
+    if (!token || typeof token !== 'string') {
+        return null;
+    }
+    const colonIndex = token.indexOf(':');
+    if (colonIndex === -1) {
+        return null;
+    }
+    const tag = token.substring(0, colonIndex);
+    const jwt = token.substring(colonIndex + 1);
+    if (!tag || !jwt) {
+        return null;
+    }
+    return { tag, jwt };
+}
+/**
+ * Check if a string value is a session reference
+ */
+function isSessionReference(value) {
+    if (typeof value !== 'string') {
+        return { isSession: false };
+    }
+    if (!exports.SESSION_PATTERN.test(value)) {
+        return { isSession: false };
+    }
+    // Extract key path segments
+    const keyPath = [];
+    let match;
+    const pattern = new RegExp(KEY_SEGMENT_PATTERN.source, 'g');
+    while ((match = pattern.exec(value)) !== null) {
+        keyPath.push(match[1]);
+    }
+    return { isSession: true, keyPath };
+}
+/**
+ * Check if a string contains any session references (partial matches)
+ */
+function containsSessionReferences(value) {
+    if (typeof value !== 'string') {
+        return false;
+    }
+    // Reset lastIndex and test
+    const pattern = new RegExp(exports.SESSION_PATTERN_GLOBAL.source, 'g');
+    return pattern.test(value);
+}
+/**
+ * Extract all session references from a string
+ */
+function extractSessionReferences(value) {
+    if (typeof value !== 'string') {
+        return [];
+    }
+    const references = [];
+    const pattern = new RegExp(exports.SESSION_PATTERN_GLOBAL.source, 'g');
+    let match;
+    while ((match = pattern.exec(value)) !== null) {
+        const full = match[0];
+        const keyPath = [];
+        const keyPattern = new RegExp(KEY_SEGMENT_PATTERN.source, 'g');
+        let keyMatch;
+        while ((keyMatch = keyPattern.exec(full)) !== null) {
+            keyPath.push(keyMatch[1]);
+        }
+        references.push({ full, keyPath });
+    }
+    return references;
+}
+/**
+ * Get a nested value from an object using a key path
+ */
+function getNestedValue(obj, keyPath) {
+    let current = obj;
+    for (const key of keyPath) {
+        if (current === null || current === undefined) {
+            return undefined;
+        }
+        if (typeof current !== 'object') {
+            return undefined;
+        }
+        current = current[key];
+    }
+    return current;
+}
+/**
+ * Verify and decode a session JWT token
+ * Returns the session data if valid, null otherwise
+ */
+async function verifySessionToken(token, privateKey, expectedTag, expectedEnv) {
+    const parts = parseSessionToken(token);
+    if (!parts) {
+        return null;
+    }
+    // Check tag match if expected
+    if (expectedTag && parts.tag !== expectedTag) {
+        return null;
+    }
+    try {
+        // Dynamic import for Node.js only
+        if (typeof window !== 'undefined') {
+            return null; // JWT verification not available in browser
+        }
+        const JWT = await Promise.resolve().then(() => __importStar(require('jsonwebtoken')));
+        const decoded = JWT.verify(parts.jwt, privateKey);
+        // Verify environment if expected
+        if (expectedEnv && decoded.env !== expectedEnv) {
+            return null;
+        }
+        return {
+            tag: decoded.session,
+            sessionId: decoded.session_id,
+            data: decoded.data,
+            expiresAt: decoded.exp,
+            env: decoded.env,
+        };
+    }
+    catch (error) {
+        // JWT verification failed (invalid, expired, etc.)
+        return null;
+    }
+}
+/**
+ * Extract session context from a verified session
+ * This includes identifier, session_id, session_tag for logging
+ */
+function extractSessionContext(sessionData, selector) {
+    let identifier = '';
+    // Try to extract identifier using selector path
+    if (selector) {
+        // Remove $Session{} wrapper if present
+        const selectorPath = selector.replace(/^\$Session\{/, '').replace(/\}$/, '');
+        const pathParts = selectorPath.split('.');
+        const value = getNestedValue(sessionData.data, pathParts);
+        if (value !== undefined && value !== null) {
+            identifier = String(value);
+        }
+    }
+    // Fallback: try common identifier fields
+    if (!identifier) {
+        const commonFields = ['id', 'userId', 'user_id', 'email', 'username', 'identifier'];
+        for (const field of commonFields) {
+            if (sessionData.data[field]) {
+                identifier = String(sessionData.data[field]);
+                break;
+            }
+        }
+    }
+    return {
+        identifier,
+        session_id: sessionData.sessionId,
+        session_tag: sessionData.tag,
+        data: sessionData.data,
+    };
+}
+/**
+ * Type guard to check if a value might contain session references
+ */
+function mightContainSessions(value) {
+    if (typeof value === 'string') {
+        return containsSessionReferences(value);
+    }
+    if (Array.isArray(value)) {
+        return value.some(mightContainSessions);
+    }
+    if (value !== null && typeof value === 'object') {
+        return Object.values(value).some(mightContainSessions);
+    }
+    return false;
+}
+/**
+ * Recursively find all session references in an object
+ */
+function findAllSessionReferences(obj) {
+    const refs = [];
+    function traverse(value) {
+        if (typeof value === 'string') {
+            const found = extractSessionReferences(value);
+            refs.push(...found);
+        }
+        else if (Array.isArray(value)) {
+            value.forEach(traverse);
+        }
+        else if (value !== null && typeof value === 'object') {
+            Object.values(value).forEach(traverse);
+        }
+    }
+    traverse(obj);
+    return refs;
+}
+/**
+ * Replace a single session reference with its resolved value
+ */
+function replaceSessionInString(value, reference, resolvedValue) {
+    // Escape special regex characters in the reference
+    const escaped = reference.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const pattern = new RegExp(escaped, 'g');
+    // Convert resolved value to string
+    const stringValue = typeof resolvedValue === 'object'
+        ? JSON.stringify(resolvedValue)
+        : String(resolvedValue !== null && resolvedValue !== void 0 ? resolvedValue : '');
+    return value.replace(pattern, stringValue);
+}
+/**
+ * Create a sessions resolver instance
+ */
+function createSessionsResolver(sessionData) {
+    /**
+     * Resolve a single session reference to its value
+     */
+    function resolveReference(keyPath) {
+        return getNestedValue(sessionData.data, keyPath);
+    }
+    /**
+     * Resolve a single string value, replacing all $Session{key}{...} patterns
+     */
+    function resolveString(value) {
+        const refs = extractSessionReferences(value);
+        const resolvedKeys = [];
+        const failedKeys = [];
+        let result = value;
+        for (const ref of refs) {
+            const resolved = resolveReference(ref.keyPath);
+            if (resolved !== undefined) {
+                result = replaceSessionInString(result, ref.full, resolved);
+                resolvedKeys.push(ref.keyPath.join('.'));
+            }
+            else {
+                failedKeys.push(ref.keyPath.join('.'));
+            }
+        }
+        return { value: result, resolvedKeys, failedKeys };
+    }
+    /**
+     * Recursively resolve all $Session{key}{...} patterns in an object
+     */
+    function resolveObject(obj) {
+        const allResolvedKeys = [];
+        const allFailedKeys = [];
+        function resolve(value) {
+            if (typeof value === 'string') {
+                const result = resolveString(value);
+                allResolvedKeys.push(...result.resolvedKeys);
+                allFailedKeys.push(...result.failedKeys);
+                return result.value;
+            }
+            if (Array.isArray(value)) {
+                return value.map(resolve);
+            }
+            if (value !== null && typeof value === 'object') {
+                const resolved = {};
+                for (const [key, val] of Object.entries(value)) {
+                    resolved[key] = resolve(val);
+                }
+                return resolved;
+            }
+            return value;
+        }
+        const resolvedValue = resolve(obj);
+        return {
+            value: resolvedValue,
+            resolvedKeys: [...new Set(allResolvedKeys)],
+            failedKeys: [...new Set(allFailedKeys)],
+        };
+    }
+    return {
+        resolveReference,
+        resolveString,
+        resolveObject,
+        getSessionData: () => sessionData,
+    };
+}
+/**
+ * Error class for session resolution
+ */
+class SessionResolutionError extends Error {
+    constructor(message, code, details) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.name = 'SessionResolutionError';
+    }
+}
+exports.SessionResolutionError = SessionResolutionError;
+//# sourceMappingURL=sessions.resolver.js.map

package/dist/sessions/sessions.resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessions.resolver.js","sourceRoot":"","sources":["../../src/sessions/sessions.resolver.ts"],"names":[],"mappings":"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"}

package/dist/sessions/sessions.service.d.ts

@@ -0,0 +1,170 @@
+/**
+ * SessionsService - Main Sessions Service Class
+ *
+ * Provides a unified interface for JWT-based session management including
+ * creating, refreshing, verifying, and revoking sessions.
+ */
+import { ISessionServiceConfig, ICreateSessionOptions, IRefreshSessionOptions, IVerifySessionOptions, IRevokeSessionOptions, IListSessionsOptions, ISessionResult, IVerifyResult, IListSessionsResult, IDefineSessionOptions, IDefinedSession, IFetchSessionUsersOptions, IFetchSessionUsersResult, IFetchSessionUserDetailsOptions, ISessionUserDetails, IFetchSessionActivityLogsOptions, IFetchSessionActivityLogsResult, IFetchSessionDashboardOptions, ISessionDashboardMetrics } from './types';
+/**
+ * Error class for session operations
+ */
+export declare class SessionError extends Error {
+    code: string;
+    details?: unknown;
+    constructor(message: string, code: string, details?: unknown);
+}
+/**
+ * SessionsService
+ *
+ * Unified API for JWT-based session management.
+ *
+ * @example
+ * ```ts
+ * import { SessionsService } from '@ductape/sdk';
+ *
+ * const sessions = new SessionsService({
+ *   workspace_id: 'your-workspace-id',
+ *   public_key: 'your-public-key',
+ *   user_id: 'your-user-id',
+ *   token: 'your-token',
+ *   env_type: 'prd',
+ * });
+ *
+ * // Create a session
+ * const result = await sessions.create({
+ *   product: 'my-product',
+ *   env: 'production',
+ *   tag: 'user-session',
+ *   data: { userId: '123', email: 'user@example.com' },
+ * });
+ *
+ * // Verify a session
+ * const verifyResult = await sessions.verify({
+ *   product: 'my-product',
+ *   env: 'production',
+ *   tag: 'user-session',
+ *   token: result.token,
+ * });
+ *
+ * // Refresh a session
+ * const refreshResult = await sessions.refresh({
+ *   product: 'my-product',
+ *   env: 'production',
+ *   tag: 'user-session',
+ *   refreshToken: result.refreshToken,
+ * });
+ *
+ * // Revoke a session
+ * await sessions.revoke({
+ *   product: 'my-product',
+ *   env: 'production',
+ *   tag: 'user-session',
+ *   sessionId: verifyResult.sessionId,
+ * });
+ * ```
+ */
+export declare class SessionsService {
+    private config;
+    private productBuilderService;
+    private processorApiService;
+    private inputService;
+    private logService;
+    private productId;
+    constructor(config: ISessionServiceConfig);
+    /**
+     * Get user access credentials
+     */
+    private getUserAccess;
+    /**
+     * Initialize logging service
+     */
+    private initializeLogService;
+    /**
+     * Create a new session
+     */
+    create(options: ICreateSessionOptions): Promise<ISessionResult>;
+    /**
+     * Refresh an existing session
+     */
+    refresh(options: IRefreshSessionOptions): Promise<ISessionResult>;
+    /**
+     * Verify a session token
+     */
+    verify(options: IVerifySessionOptions): Promise<IVerifyResult>;
+    /**
+     * Revoke a session
+     */
+    revoke(options: IRevokeSessionOptions): Promise<void>;
+    /**
+     * List active sessions
+     */
+    list(options: IListSessionsOptions): Promise<IListSessionsResult>;
+    /**
+     * Define a new session schema
+     */
+    define(options: IDefineSessionOptions): Promise<IDefinedSession>;
+    /**
+     * Register a defined session with a product
+     */
+    register(product: string, session: IDefinedSession): Promise<void>;
+    /**
+     * Fetch paginated session users
+     *
+     * @example
+     * ```ts
+     * const users = await sessions.fetchUsers({
+     *   product: 'my-product',
+     *   session: 'user-session',
+     *   env: 'production',
+     *   page: 1,
+     *   limit: 20,
+     * });
+     * ```
+     */
+    fetchUsers(options: IFetchSessionUsersOptions): Promise<IFetchSessionUsersResult>;
+    /**
+     * Fetch detailed information about a single session user
+     *
+     * @example
+     * ```ts
+     * const userDetails = await sessions.fetchUserDetails({
+     *   product: 'my-product',
+     *   session: 'user-session',
+     *   identifier: 'user@example.com',
+     *   env: 'production',
+     * });
+     * ```
+     */
+    fetchUserDetails(options: IFetchSessionUserDetailsOptions): Promise<ISessionUserDetails>;
+    /**
+     * Fetch paginated session activity logs
+     *
+     * @example
+     * ```ts
+     * const logs = await sessions.fetchActivityLogs({
+     *   product: 'my-product',
+     *   session: 'user-session',
+     *   env: 'production',
+     *   status: 'success',
+     *   page: 1,
+     *   limit: 20,
+     * });
+     * ```
+     */
+    fetchActivityLogs(options: IFetchSessionActivityLogsOptions): Promise<IFetchSessionActivityLogsResult>;
+    /**
+     * Fetch session dashboard metrics
+     *
+     * @example
+     * ```ts
+     * const dashboard = await sessions.fetchDashboard({
+     *   product: 'my-product',
+     *   session: 'user-session',
+     *   env: 'production',
+     *   groupBy: 'day',
+     * });
+     * ```
+     */
+    fetchDashboard(options: IFetchSessionDashboardOptions): Promise<ISessionDashboardMetrics>;
+}
+export default SessionsService;