@smartnet360/svelte-components 0.0.142 → 0.0.143

package/dist/map-v3/features/custom/db/custom-sets-api.js

@@ -0,0 +1,220 @@
+/**
+ * Custom Feature - API Client
+ *
+ * Client-side service for interacting with custom cell sets API.
+ * Designed to work with any backend that implements the expected endpoints.
+ *
+ * Usage in consuming app:
+ * ```typescript
+ * const api = new CustomSetsApiClient('/api/custom-sets');
+ * const sets = await api.listSets();
+ * ```
+ */
+import { serializeSet, deserializeSet, extractListItem } from './types';
+/**
+ * API client for custom cell sets
+ * Provides CRUD operations against a REST API endpoint
+ */
+export class CustomSetsApiClient {
+    baseUrl;
+    headers;
+    /**
+     * Create a new API client
+     * @param baseUrl Base URL for the API (e.g., '/api/custom-sets')
+     * @param headers Optional additional headers (e.g., auth tokens)
+     */
+    constructor(baseUrl, headers = {}) {
+        // Remove trailing slash
+        this.baseUrl = baseUrl.replace(/\/$/, '');
+        this.headers = {
+            'Content-Type': 'application/json',
+            ...headers
+        };
+    }
+    /**
+     * Update headers (e.g., after auth token refresh)
+     */
+    setHeaders(headers) {
+        this.headers = {
+            'Content-Type': 'application/json',
+            ...headers
+        };
+    }
+    /**
+     * List all available sets (lightweight, no cell data)
+     */
+    async listSets() {
+        try {
+            const response = await fetch(`${this.baseUrl}`, {
+                method: 'GET',
+                headers: this.headers
+            });
+            if (!response.ok) {
+                return {
+                    success: false,
+                    error: `Failed to fetch sets: ${response.status} ${response.statusText}`
+                };
+            }
+            const data = await response.json();
+            return {
+                success: true,
+                data: data.sets || data
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    }
+    /**
+     * Get a single set by ID (full data including cells)
+     */
+    async getSet(id) {
+        try {
+            const response = await fetch(`${this.baseUrl}/${id}`, {
+                method: 'GET',
+                headers: this.headers
+            });
+            if (!response.ok) {
+                if (response.status === 404) {
+                    return {
+                        success: false,
+                        error: 'Set not found'
+                    };
+                }
+                return {
+                    success: false,
+                    error: `Failed to fetch set: ${response.status} ${response.statusText}`
+                };
+            }
+            const dbRecord = await response.json();
+            const set = deserializeSet(dbRecord);
+            return {
+                success: true,
+                data: set
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    }
+    /**
+     * Save a set to the server (create or update)
+     * @param set The CustomCellSet to save
+     * @param id Optional ID for update (omit for create)
+     */
+    async saveSet(set, id) {
+        try {
+            const serialized = serializeSet(set);
+            const isUpdate = !!id;
+            const response = await fetch(isUpdate ? `${this.baseUrl}/${id}` : this.baseUrl, {
+                method: isUpdate ? 'PUT' : 'POST',
+                headers: this.headers,
+                body: JSON.stringify({
+                    name: set.name,
+                    data_json: JSON.stringify(serialized)
+                })
+            });
+            if (!response.ok) {
+                return {
+                    success: false,
+                    error: `Failed to save set: ${response.status} ${response.statusText}`
+                };
+            }
+            const result = await response.json();
+            return {
+                success: true,
+                data: { id: result.id || id }
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    }
+    /**
+     * Delete a set from the server
+     */
+    async deleteSet(id) {
+        try {
+            const response = await fetch(`${this.baseUrl}/${id}`, {
+                method: 'DELETE',
+                headers: this.headers
+            });
+            if (!response.ok) {
+                if (response.status === 404) {
+                    return {
+                        success: false,
+                        error: 'Set not found'
+                    };
+                }
+                return {
+                    success: false,
+                    error: `Failed to delete set: ${response.status} ${response.statusText}`
+                };
+            }
+            return { success: true };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    }
+    /**
+     * Check if a set with the given name exists
+     */
+    async checkNameExists(name) {
+        try {
+            const response = await fetch(`${this.baseUrl}/check-name?name=${encodeURIComponent(name)}`, {
+                method: 'GET',
+                headers: this.headers
+            });
+            if (!response.ok) {
+                // If endpoint doesn't exist, fall back to listing
+                const listResult = await this.listSets();
+                if (listResult.success && listResult.data) {
+                    const existing = listResult.data.find(s => s.name === name);
+                    return {
+                        success: true,
+                        data: {
+                            exists: !!existing,
+                            id: existing?.id
+                        }
+                    };
+                }
+                return {
+                    success: false,
+                    error: `Failed to check name: ${response.status}`
+                };
+            }
+            const result = await response.json();
+            return {
+                success: true,
+                data: result
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : 'Unknown error'
+            };
+        }
+    }
+}
+/**
+ * Factory function to create API client
+ * @param baseUrl API endpoint base URL
+ * @param headers Optional headers (e.g., auth tokens)
+ */
+export function createCustomSetsApi(baseUrl, headers) {
+    return new CustomSetsApiClient(baseUrl, headers);
+}

package/dist/map-v3/features/custom/db/custom-sets-repository.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Custom Feature - Oracle Repository
+ *
+ * Server-side repository for Oracle database operations.
+ * Uses a factory pattern - accepts a query executor function
+ * so the consuming app provides its own database connection.
+ *
+ * Usage in SvelteKit +server.ts:
+ * ```typescript
+ * import { createCustomSetsRepository } from 'rf-tool-components/map-v3/features/custom';
+ * import { executeQuery } from '../../../../db'; // Your Oracle connection
+ *
+ * const repo = createCustomSetsRepository(executeQuery);
+ * const sets = await repo.list();
+ * ```
+ */
+import type { CustomSetDbRecord, CustomSetListItem } from './types';
+/**
+ * Query executor function signature
+ * The consuming app provides this, wrapping their Oracle connection
+ *
+ * @param sql The SQL query to execute
+ * @param params Bind parameters (positional or named)
+ * @returns Promise resolving to array of result rows
+ */
+export type QueryExecutor = (sql: string, params?: Record<string, unknown> | unknown[]) => Promise<Record<string, unknown>[]>;
+/**
+ * Repository interface for custom cell sets
+ */
+export interface CustomSetsRepository {
+    /**
+     * List all sets (lightweight, extracts summary from JSON)
+     */
+    list(): Promise<CustomSetListItem[]>;
+    /**
+     * Get a single set by ID (full data)
+     */
+    get(id: string): Promise<CustomSetDbRecord | null>;
+    /**
+     * Find set by name
+     */
+    findByName(name: string): Promise<CustomSetDbRecord | null>;
+    /**
+     * Insert a new set
+     */
+    insert(name: string, dataJson: string, createdBy?: string): Promise<string>;
+    /**
+     * Update an existing set
+     */
+    update(id: string, name: string, dataJson: string): Promise<boolean>;
+    /**
+     * Insert or update based on existence
+     */
+    upsert(id: string | null, name: string, dataJson: string, createdBy?: string): Promise<string>;
+    /**
+     * Delete a set by ID
+     */
+    delete(id: string): Promise<boolean>;
+}
+/**
+ * Create a repository instance with the provided query executor
+ *
+ * @param executeQuery Function that executes SQL against Oracle
+ * @param tableName Optional custom table name (default: 'custom_cell_sets')
+ */
+export declare function createCustomSetsRepository(executeQuery: QueryExecutor, tableName?: string): CustomSetsRepository;
+/**
+ * SQL statements for reference (can be used directly if preferred)
+ */
+export declare const SQL: {
+    readonly LIST: "\n\t\tSELECT id, name, data_json, created_by, created_at, updated_at\n\t\tFROM custom_cell_sets\n\t\tORDER BY updated_at DESC\n\t";
+    readonly GET_BY_ID: "\n\t\tSELECT id, name, data_json, created_by, created_at, updated_at\n\t\tFROM custom_cell_sets\n\t\tWHERE id = :id\n\t";
+    readonly FIND_BY_NAME: "\n\t\tSELECT id, name, data_json, created_by, created_at, updated_at\n\t\tFROM custom_cell_sets\n\t\tWHERE LOWER(name) = LOWER(:name)\n\t";
+    readonly INSERT: "\n\t\tINSERT INTO custom_cell_sets \n\t\t(id, name, data_json, created_by, created_at, updated_at)\n\t\tVALUES \n\t\t(:id, :name, :data_json, :created_by, SYSTIMESTAMP, SYSTIMESTAMP)\n\t";
+    readonly UPDATE: "\n\t\tUPDATE custom_cell_sets\n\t\tSET name = :name,\n\t\t    data_json = :data_json,\n\t\t    updated_at = SYSTIMESTAMP\n\t\tWHERE id = :id\n\t";
+    readonly DELETE: "\n\t\tDELETE FROM custom_cell_sets\n\t\tWHERE id = :id\n\t";
+};

package/dist/map-v3/features/custom/db/custom-sets-repository.js

@@ -0,0 +1,195 @@
+/**
+ * Custom Feature - Oracle Repository
+ *
+ * Server-side repository for Oracle database operations.
+ * Uses a factory pattern - accepts a query executor function
+ * so the consuming app provides its own database connection.
+ *
+ * Usage in SvelteKit +server.ts:
+ * ```typescript
+ * import { createCustomSetsRepository } from 'rf-tool-components/map-v3/features/custom';
+ * import { executeQuery } from '../../../../db'; // Your Oracle connection
+ *
+ * const repo = createCustomSetsRepository(executeQuery);
+ * const sets = await repo.list();
+ * ```
+ */
+import { extractListItem } from './types';
+/**
+ * Generate a UUID v4
+ * Using crypto.randomUUID if available, fallback to manual generation
+ */
+function generateId() {
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    // Fallback for older Node.js
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+        const r = Math.random() * 16 | 0;
+        const v = c === 'x' ? r : (r & 0x3 | 0x8);
+        return v.toString(16);
+    });
+}
+/**
+ * Map Oracle row to CustomSetDbRecord
+ * Handles Oracle's uppercase column names
+ */
+function mapRowToRecord(row) {
+    return {
+        id: String(row.ID || row.id || ''),
+        name: String(row.NAME || row.name || ''),
+        data_json: String(row.DATA_JSON || row.data_json || '{}'),
+        created_by: String(row.CREATED_BY || row.created_by || 'system'),
+        created_at: formatTimestamp(row.CREATED_AT || row.created_at),
+        updated_at: formatTimestamp(row.UPDATED_AT || row.updated_at)
+    };
+}
+/**
+ * Format Oracle timestamp to ISO string
+ */
+function formatTimestamp(value) {
+    if (!value)
+        return new Date().toISOString();
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value === 'string')
+        return value;
+    return new Date().toISOString();
+}
+/**
+ * Create a repository instance with the provided query executor
+ *
+ * @param executeQuery Function that executes SQL against Oracle
+ * @param tableName Optional custom table name (default: 'custom_cell_sets')
+ */
+export function createCustomSetsRepository(executeQuery, tableName = 'custom_cell_sets') {
+    return {
+        async list() {
+            const sql = `
+				SELECT id, name, data_json, created_by, created_at, updated_at
+				FROM ${tableName}
+				ORDER BY updated_at DESC
+			`;
+            const rows = await executeQuery(sql);
+            return rows.map(row => extractListItem(mapRowToRecord(row)));
+        },
+        async get(id) {
+            const sql = `
+				SELECT id, name, data_json, created_by, created_at, updated_at
+				FROM ${tableName}
+				WHERE id = :id
+			`;
+            const rows = await executeQuery(sql, { id });
+            if (rows.length === 0)
+                return null;
+            return mapRowToRecord(rows[0]);
+        },
+        async findByName(name) {
+            const sql = `
+				SELECT id, name, data_json, created_by, created_at, updated_at
+				FROM ${tableName}
+				WHERE LOWER(name) = LOWER(:name)
+			`;
+            const rows = await executeQuery(sql, { name });
+            if (rows.length === 0)
+                return null;
+            return mapRowToRecord(rows[0]);
+        },
+        async insert(name, dataJson, createdBy = 'system') {
+            const id = generateId();
+            const sql = `
+				INSERT INTO ${tableName} 
+				(id, name, data_json, created_by, created_at, updated_at)
+				VALUES 
+				(:id, :name, :data_json, :created_by, SYSTIMESTAMP, SYSTIMESTAMP)
+			`;
+            await executeQuery(sql, {
+                id,
+                name,
+                data_json: dataJson,
+                created_by: createdBy
+            });
+            return id;
+        },
+        async update(id, name, dataJson) {
+            const sql = `
+				UPDATE ${tableName}
+				SET name = :name,
+				    data_json = :data_json,
+				    updated_at = SYSTIMESTAMP
+				WHERE id = :id
+			`;
+            await executeQuery(sql, {
+                id,
+                name,
+                data_json: dataJson
+            });
+            // Note: executeQuery doesn't return affected rows count
+            // The consuming app can wrap this if needed
+            return true;
+        },
+        async upsert(id, name, dataJson, createdBy = 'system') {
+            if (id) {
+                // Check if exists
+                const existing = await this.get(id);
+                if (existing) {
+                    await this.update(id, name, dataJson);
+                    return id;
+                }
+            }
+            // Check by name for overwrite scenario
+            const byName = await this.findByName(name);
+            if (byName) {
+                await this.update(byName.id, name, dataJson);
+                return byName.id;
+            }
+            // Insert new
+            return this.insert(name, dataJson, createdBy);
+        },
+        async delete(id) {
+            const sql = `
+				DELETE FROM ${tableName}
+				WHERE id = :id
+			`;
+            await executeQuery(sql, { id });
+            return true;
+        }
+    };
+}
+/**
+ * SQL statements for reference (can be used directly if preferred)
+ */
+export const SQL = {
+    LIST: `
+		SELECT id, name, data_json, created_by, created_at, updated_at
+		FROM custom_cell_sets
+		ORDER BY updated_at DESC
+	`,
+    GET_BY_ID: `
+		SELECT id, name, data_json, created_by, created_at, updated_at
+		FROM custom_cell_sets
+		WHERE id = :id
+	`,
+    FIND_BY_NAME: `
+		SELECT id, name, data_json, created_by, created_at, updated_at
+		FROM custom_cell_sets
+		WHERE LOWER(name) = LOWER(:name)
+	`,
+    INSERT: `
+		INSERT INTO custom_cell_sets 
+		(id, name, data_json, created_by, created_at, updated_at)
+		VALUES 
+		(:id, :name, :data_json, :created_by, SYSTIMESTAMP, SYSTIMESTAMP)
+	`,
+    UPDATE: `
+		UPDATE custom_cell_sets
+		SET name = :name,
+		    data_json = :data_json,
+		    updated_at = SYSTIMESTAMP
+		WHERE id = :id
+	`,
+    DELETE: `
+		DELETE FROM custom_cell_sets
+		WHERE id = :id
+	`
+};

package/dist/map-v3/features/custom/db/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Custom Feature - Database Module
+ *
+ * Exports for database persistence of custom cell sets.
+ */
+export type { CustomSetDbRecord, CustomCellSerializable, CustomSetSerializable, CustomSetListItem, ApiResponse } from './types';
+export { serializeSet, deserializeSet, extractListItem } from './types';
+export { CustomSetsApiClient, createCustomSetsApi } from './custom-sets-api';
+export type { QueryExecutor, CustomSetsRepository } from './custom-sets-repository';
+export { createCustomSetsRepository, SQL } from './custom-sets-repository';

package/dist/map-v3/features/custom/db/index.js

@@ -0,0 +1,9 @@
+/**
+ * Custom Feature - Database Module
+ *
+ * Exports for database persistence of custom cell sets.
+ */
+export { serializeSet, deserializeSet, extractListItem } from './types';
+// API Client (client-side)
+export { CustomSetsApiClient, createCustomSetsApi } from './custom-sets-api';
+export { createCustomSetsRepository, SQL } from './custom-sets-repository';

package/dist/map-v3/features/custom/db/schema.sql

@@ -0,0 +1,102 @@
+-- ============================================================================
+-- Custom Cell Sets - Oracle Schema
+-- ============================================================================
+-- 
+-- Table for storing shared custom cell/point sets with JSON CLOB data.
+-- Designed for global sharing between users.
+--
+-- Usage:
+--   1. Run this script to create the table and indexes
+--   2. The data_json column stores serialized CustomSetSerializable as JSON
+--   3. Use the repository functions from custom-sets-repository.ts
+--
+-- ============================================================================
+
+-- Drop existing table (uncomment for clean install)
+-- DROP TABLE custom_cell_sets;
+
+-- Main table
+CREATE TABLE custom_cell_sets (
+    id              VARCHAR2(36)    PRIMARY KEY,           -- UUID primary key
+    name            VARCHAR2(255)   NOT NULL,              -- Display name
+    data_json       CLOB            NOT NULL,              -- Serialized set data (JSON)
+    created_by      VARCHAR2(100)   DEFAULT 'system',      -- Creator username
+    created_at      TIMESTAMP       DEFAULT SYSTIMESTAMP,  -- Creation timestamp
+    updated_at      TIMESTAMP       DEFAULT SYSTIMESTAMP,  -- Last update timestamp
+    
+    -- Constraints
+    CONSTRAINT chk_data_json_valid CHECK (data_json IS JSON)
+);
+
+-- Indexes for common queries
+CREATE INDEX idx_custom_sets_name ON custom_cell_sets(name);
+CREATE INDEX idx_custom_sets_created_by ON custom_cell_sets(created_by);
+CREATE INDEX idx_custom_sets_created_at ON custom_cell_sets(created_at DESC);
+CREATE INDEX idx_custom_sets_updated_at ON custom_cell_sets(updated_at DESC);
+
+-- Comments
+COMMENT ON TABLE custom_cell_sets IS 'Shared custom cell/point sets imported from CSV';
+COMMENT ON COLUMN custom_cell_sets.id IS 'UUID primary key';
+COMMENT ON COLUMN custom_cell_sets.name IS 'Display name for the set';
+COMMENT ON COLUMN custom_cell_sets.data_json IS 'JSON CLOB containing cells, groups, styling, etc. See CustomSetSerializable type';
+COMMENT ON COLUMN custom_cell_sets.created_by IS 'Username of creator';
+COMMENT ON COLUMN custom_cell_sets.created_at IS 'Creation timestamp';
+COMMENT ON COLUMN custom_cell_sets.updated_at IS 'Last modification timestamp';
+
+-- ============================================================================
+-- Sample data_json structure (for reference):
+-- ============================================================================
+-- {
+--   "name": "Q4 Expansion Sites",
+--   "groups": ["high-priority", "phase-2"],
+--   "extraColumns": ["traffic", "notes"],
+--   "unmatchedTxIds": ["CELL_999"],
+--   "cells": [
+--     {
+--       "id": "SITE_001_A",
+--       "customGroup": "high-priority",
+--       "sizeFactor": 1.5,
+--       "extraFields": {"traffic": 1234, "notes": "New site"},
+--       "geometry": "cell"
+--     },
+--     {
+--       "id": "POINT_001",
+--       "customGroup": "phase-2",
+--       "sizeFactor": 1,
+--       "extraFields": {},
+--       "geometry": "point",
+--       "lat": 51.5074,
+--       "lon": -0.1278
+--     }
+--   ],
+--   "baseSize": 50,
+--   "pointSize": 8,
+--   "opacity": 0.7,
+--   "defaultColor": "#3b82f6",
+--   "groupColors": {"high-priority": "#ef4444", "phase-2": "#22c55e"},
+--   "visibleGroups": ["high-priority", "phase-2"]
+-- }
+-- ============================================================================
+
+-- ============================================================================
+-- Useful queries for maintenance
+-- ============================================================================
+
+-- List all sets with cell counts (using JSON_VALUE)
+-- SELECT 
+--     id,
+--     name,
+--     created_by,
+--     created_at,
+--     JSON_VALUE(data_json, '$.cells.size()' RETURNING NUMBER) as cell_count
+-- FROM custom_cell_sets
+-- ORDER BY updated_at DESC;
+
+-- Find sets containing a specific cell ID
+-- SELECT id, name
+-- FROM custom_cell_sets
+-- WHERE JSON_EXISTS(data_json, '$.cells[*]?(@.id == "SITE_001_A")');
+
+-- Delete sets older than 90 days
+-- DELETE FROM custom_cell_sets
+-- WHERE created_at < SYSTIMESTAMP - INTERVAL '90' DAY;