@platformos/platformos-common 0.0.11 → 0.0.15

package/dist/route-table/RouteTable.js

@@ -0,0 +1,384 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouteTable = void 0;
+const js_yaml_1 = __importDefault(require("js-yaml"));
+const vscode_uri_1 = require("vscode-uri");
+const AbstractFileSystem_1 = require("../AbstractFileSystem");
+const path_utils_1 = require("../path-utils");
+const slugFromFilePath_1 = require("./slugFromFilePath");
+const parseSlug_1 = require("./parseSlug");
+function extractFrontmatter(source) {
+    const trimmed = source.trimStart();
+    if (!trimmed.startsWith('---'))
+        return null;
+    const end = trimmed.indexOf('---', 3);
+    if (end === -1)
+        return null;
+    const yamlBlock = trimmed.slice(3, end).trim();
+    if (yamlBlock.length === 0)
+        return null;
+    try {
+        const result = js_yaml_1.default.load(yamlBlock);
+        if (typeof result !== 'object' || result === null)
+            return null;
+        return result;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Extract the path relative to the pages directory from a full URI.
+ * Handles both app-level and module page paths.
+ *
+ * App-level: matches `/(app|marketplace_builder)/(views/pages|pages)/`
+ * Module-level: matches `/(public|private)/(views/pages|pages)/`
+ * (marketplace_builder module pages always go through public/private subdirs,
+ * so the second pattern covers them.)
+ *
+ * Expects a `file://` URI with forward slashes (as produced by `vscode-uri`).
+ * On Windows, `vscode-uri` normalizes filesystem paths to forward-slash URIs
+ * (`file:///C:/...`), so the forward-slash regex patterns work cross-platform.
+ *
+ * Examples:
+ *   file:///project/app/views/pages/about.html.liquid -> about.html.liquid
+ *   file:///project/modules/admin/public/views/pages/dashboard.html.liquid -> dashboard.html.liquid
+ */
+function extractRelativePagePath(uri) {
+    const patterns = [
+        // App-level pages: app/views/pages/ or marketplace_builder/pages/
+        /\/(app|marketplace_builder)\/(views\/pages|pages)\//,
+        // Module pages: must be under modules/<name>/(public|private)/(views/pages|pages)/
+        /\/modules\/[^/]+\/(public|private)\/(views\/pages|pages)\//,
+    ];
+    for (const pattern of patterns) {
+        const match = uri.match(pattern);
+        if (match) {
+            const idx = uri.indexOf(match[0]) + match[0].length;
+            return uri.slice(idx);
+        }
+    }
+    return null;
+}
+function buildRouteEntry(uri, slug, method, format) {
+    const { requiredSegments, optionalGroups } = (0, parseSlug_1.parseSlug)(slug);
+    const precedence = (0, parseSlug_1.calculatePrecedence)(slug, format);
+    return {
+        slug,
+        method,
+        format,
+        uri,
+        requiredSegments,
+        optionalGroups,
+        precedence,
+    };
+}
+/**
+ * Try to match a list of URL segments against a list of route segments.
+ * Returns true if all URL segments are consumed and matched.
+ */
+function matchSegments(urlSegments, routeSegments, urlStart) {
+    let ui = urlStart;
+    for (let ri = 0; ri < routeSegments.length; ri++) {
+        const rs = routeSegments[ri];
+        if (rs.type === 'wildcard') {
+            // Wildcard consumes all remaining segments but requires at least one
+            if (ui >= urlSegments.length)
+                return false;
+            return urlSegments.length;
+        }
+        if (ui >= urlSegments.length) {
+            // Ran out of URL segments but route still has more
+            return false;
+        }
+        const us = urlSegments[ui];
+        if (us.type === 'dynamic') {
+            // Liquid interpolation matches any route segment type
+            ui++;
+            continue;
+        }
+        // us.type === 'static'
+        if (rs.type === 'static') {
+            if (us.value !== rs.value)
+                return false;
+            ui++;
+        }
+        else if (rs.type === 'param') {
+            // :param matches any single static segment
+            ui++;
+        }
+    }
+    return ui;
+}
+/**
+ * Parse a URL pattern into segments and an optional format suffix.
+ *
+ * Following Rails/platformOS convention, a known format extension on the last
+ * segment (e.g., `/api/data.json`) is stripped and returned separately so that
+ * matching can filter by format.
+ */
+function parseUrlPattern(pattern) {
+    // Strip leading and trailing slashes
+    let path = pattern.startsWith('/') ? pattern.slice(1) : pattern;
+    if (path.endsWith('/'))
+        path = path.slice(0, -1);
+    if (path === '')
+        return { segments: [], format: null };
+    const rawSegments = path.split('/');
+    let format = null;
+    // Check if the last segment has a known format extension (e.g., my-page.json)
+    const lastIdx = rawSegments.length - 1;
+    const lastSeg = rawSegments[lastIdx];
+    if (lastSeg !== ':_liquid_') {
+        const dotIdx = lastSeg.lastIndexOf('.');
+        if (dotIdx > 0) {
+            const ext = lastSeg.slice(dotIdx + 1);
+            if (slugFromFilePath_1.KNOWN_FORMATS.has(ext)) {
+                format = ext;
+                rawSegments[lastIdx] = lastSeg.slice(0, dotIdx);
+            }
+        }
+    }
+    const segments = rawSegments.map((seg) => {
+        if (seg === ':_liquid_') {
+            return { type: 'dynamic' };
+        }
+        return { type: 'static', value: seg };
+    });
+    return { segments, format };
+}
+class RouteTable {
+    constructor(fs) {
+        this.fs = fs;
+        this.routes = new Map(); // uri -> entries (a page can register multiple entries for index aliasing)
+        this._built = false;
+    }
+    /** Returns true if build() has completed at least once. */
+    isBuilt() {
+        return this._built;
+    }
+    async build(rootUri) {
+        this.routes.clear();
+        const pageUris = await this.discoverPageFiles(rootUri);
+        for (const uri of pageUris) {
+            try {
+                const content = await this.fs.readFile(uri);
+                this.addPageFromContent(uri, content);
+            }
+            catch {
+                // Skip files we can't read
+            }
+        }
+        this._built = true;
+    }
+    updateFile(uri, content) {
+        this.removeFile(uri);
+        this.addPageFromContent(uri, content);
+    }
+    removeFile(uri) {
+        this.routes.delete(uri);
+    }
+    /**
+     * Find all routes matching a URL pattern and optional method.
+     * The pattern can contain `:_liquid_` segments for Liquid interpolations.
+     * Results are sorted by precedence (highest priority first = lowest number).
+     *
+     * A known format extension on the last segment (e.g., `/api/data.json`)
+     * is stripped and used to filter routes by format. When no format extension
+     * is present (e.g., `/about`), only `html` routes match — following the
+     * platformOS/Rails convention where HTML is the default format and non-HTML
+     * formats require an explicit extension or Accept header.
+     */
+    match(urlPattern, method) {
+        const { segments: urlSegments, format } = parseUrlPattern(urlPattern);
+        const effectiveFormat = format ?? 'html';
+        const results = [];
+        for (const entries of this.routes.values()) {
+            for (const entry of entries) {
+                if (method && entry.method !== method)
+                    continue;
+                if (entry.format !== effectiveFormat)
+                    continue;
+                if (this.matchEntry(urlSegments, entry)) {
+                    results.push(entry);
+                }
+            }
+        }
+        results.sort((a, b) => a.precedence - b.precedence);
+        return results;
+    }
+    hasMatch(urlPattern, method) {
+        const { segments: urlSegments, format } = parseUrlPattern(urlPattern);
+        const effectiveFormat = format ?? 'html';
+        for (const entries of this.routes.values()) {
+            for (const entry of entries) {
+                if (method && entry.method !== method)
+                    continue;
+                if (entry.format !== effectiveFormat)
+                    continue;
+                if (this.matchEntry(urlSegments, entry))
+                    return true;
+            }
+        }
+        return false;
+    }
+    /** Returns the total number of route entries (including index aliases). */
+    routeCount() {
+        let count = 0;
+        for (const entries of this.routes.values()) {
+            count += entries.length;
+        }
+        return count;
+    }
+    allRoutes() {
+        const all = [];
+        for (const entries of this.routes.values()) {
+            all.push(...entries);
+        }
+        return all.sort((a, b) => a.precedence - b.precedence);
+    }
+    matchEntry(urlSegments, entry) {
+        // Try matching with required segments only
+        const afterRequired = matchSegments(urlSegments, entry.requiredSegments, 0);
+        if (afterRequired !== false && afterRequired === urlSegments.length) {
+            return true;
+        }
+        // Try matching with required + optional groups progressively
+        if (afterRequired !== false && entry.optionalGroups.length > 0) {
+            return this.matchOptionalGroups(urlSegments, entry.optionalGroups, afterRequired);
+        }
+        return false;
+    }
+    /**
+     * Try optional groups left-to-right greedily — matching Rails' ActionDispatch::Journey
+     * semantics. Each group is tried in order; if it matches, its segments are consumed
+     * and the next group is attempted. If it doesn't match, it's skipped (optional).
+     *
+     * This greedy approach is correct because the platformOS backend converts slugs like
+     * `search(/:country)(/:city)` into Journey path strings and Journey matches
+     * left-to-right without backtracking.
+     */
+    matchOptionalGroups(urlSegments, groups, startIdx) {
+        let current = startIdx;
+        for (const group of groups) {
+            if (current === urlSegments.length) {
+                // Remaining optional groups can be omitted
+                return true;
+            }
+            const after = matchSegments(urlSegments, group, current);
+            if (after !== false) {
+                current = after;
+                if (current === urlSegments.length)
+                    return true;
+            }
+        }
+        return current === urlSegments.length;
+    }
+    addPageFromContent(uri, content) {
+        const relativePath = extractRelativePagePath(uri);
+        if (!relativePath)
+            return;
+        const frontmatter = extractFrontmatter(content);
+        const fileFormat = (0, slugFromFilePath_1.formatFromFilePath)(relativePath);
+        const method = (frontmatter?.method || 'get').toLowerCase();
+        const format = frontmatter?.format || fileFormat;
+        let slug;
+        if (frontmatter?.slug !== undefined && frontmatter.slug !== null) {
+            slug = String(frontmatter.slug);
+        }
+        else {
+            slug = (0, slugFromFilePath_1.slugFromFilePath)(relativePath, format);
+        }
+        const entries = [];
+        // Primary route
+        entries.push(buildRouteEntry(uri, slug, method, format));
+        // Index aliasing: if slug was derived from stripping /index,
+        // also register the /index variant
+        if (!frontmatter?.slug) {
+            const slugWithIndex = slug + '/index';
+            // Only add alias if the raw derivation actually stripped /index
+            // (i.e., the file is named index.{format}.liquid or index.liquid)
+            const baseName = relativePath.split('/').pop() || '';
+            const isIndexFile = baseName === 'index.liquid' ||
+                baseName === `index.${format}.liquid` ||
+                baseName === `index.${format}`;
+            if (isIndexFile && slug !== '/') {
+                entries.push(buildRouteEntry(uri, slugWithIndex, method, format));
+            }
+        }
+        this.routes.set(uri, entries);
+    }
+    async discoverPageFiles(rootUri) {
+        const uris = [];
+        // App-level pages
+        const appPaths = (0, path_utils_1.getAppPaths)(path_utils_1.PlatformOSFileType.Page);
+        for (const basePath of appPaths) {
+            const baseUri = vscode_uri_1.Utils.joinPath(rootUri, basePath);
+            await this.walkDirectory(baseUri.toString(), uris);
+        }
+        // Module pages — discover module names first, then walk all in parallel
+        const moduleNames = await this.discoverModuleNames(rootUri);
+        const moduleWalks = [];
+        for (const moduleName of moduleNames) {
+            const modulePaths = (0, path_utils_1.getModulePaths)(path_utils_1.PlatformOSFileType.Page, moduleName);
+            for (const basePath of modulePaths) {
+                const baseUri = vscode_uri_1.Utils.joinPath(rootUri, basePath);
+                moduleWalks.push(this.walkDirectory(baseUri.toString(), uris));
+            }
+        }
+        await Promise.all(moduleWalks);
+        return uris;
+    }
+    async discoverModuleNames(rootUri) {
+        const names = new Set();
+        for (const prefix of ['app/modules', 'modules']) {
+            const dirUri = vscode_uri_1.Utils.joinPath(rootUri, prefix).toString();
+            try {
+                const entries = await this.fs.readDirectory(dirUri);
+                for (const [name, type] of entries) {
+                    if (type === AbstractFileSystem_1.FileType.Directory) {
+                        // Extract the module name from the entry.
+                        // readDirectory may return a full URI (file:///…/modules/admin) or
+                        // a bare name ("admin"). Use URI.parse().path to normalise, then
+                        // take the last non-empty segment.
+                        const parsed = vscode_uri_1.URI.parse(name).path || name;
+                        const segments = parsed.split('/').filter((s) => s.length > 0);
+                        const moduleName = segments[segments.length - 1];
+                        if (moduleName)
+                            names.add(moduleName);
+                    }
+                }
+            }
+            catch {
+                // Directory doesn't exist
+            }
+        }
+        return Array.from(names);
+    }
+    async walkDirectory(dirUri, results) {
+        let entries;
+        try {
+            entries = await this.fs.readDirectory(dirUri);
+        }
+        catch {
+            return;
+        }
+        const subdirs = [];
+        for (const [name, type] of entries) {
+            if (type === AbstractFileSystem_1.FileType.Directory) {
+                subdirs.push(this.walkDirectory(name, results));
+            }
+            else if (type === AbstractFileSystem_1.FileType.File && name.endsWith('.liquid')) {
+                // All platformOS page files use the .liquid extension (e.g. page.html.liquid,
+                // page.json.liquid). Non-.liquid pages are not supported by the platform.
+                results.push(name);
+            }
+        }
+        await Promise.all(subdirs);
+    }
+}
+exports.RouteTable = RouteTable;
+//# sourceMappingURL=RouteTable.js.map

package/dist/route-table/RouteTable.js.map

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

package/dist/route-table/index.d.ts

@@ -0,0 +1,5 @@
+export { RouteTable } from './RouteTable';
+export { slugFromFilePath, formatFromFilePath, KNOWN_FORMATS } from './slugFromFilePath';
+export { parseSlug, calculatePrecedence } from './parseSlug';
+export type { RouteEntry, RouteSegment } from './types';
+export type { ParsedSlug } from './parseSlug';

package/dist/route-table/index.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculatePrecedence = exports.parseSlug = exports.KNOWN_FORMATS = exports.formatFromFilePath = exports.slugFromFilePath = exports.RouteTable = void 0;
+var RouteTable_1 = require("./RouteTable");
+Object.defineProperty(exports, "RouteTable", { enumerable: true, get: function () { return RouteTable_1.RouteTable; } });
+var slugFromFilePath_1 = require("./slugFromFilePath");
+Object.defineProperty(exports, "slugFromFilePath", { enumerable: true, get: function () { return slugFromFilePath_1.slugFromFilePath; } });
+Object.defineProperty(exports, "formatFromFilePath", { enumerable: true, get: function () { return slugFromFilePath_1.formatFromFilePath; } });
+Object.defineProperty(exports, "KNOWN_FORMATS", { enumerable: true, get: function () { return slugFromFilePath_1.KNOWN_FORMATS; } });
+var parseSlug_1 = require("./parseSlug");
+Object.defineProperty(exports, "parseSlug", { enumerable: true, get: function () { return parseSlug_1.parseSlug; } });
+Object.defineProperty(exports, "calculatePrecedence", { enumerable: true, get: function () { return parseSlug_1.calculatePrecedence; } });
+//# sourceMappingURL=index.js.map

package/dist/route-table/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/route-table/index.ts"],"names":[],"mappings":";;;AAAA,2CAA0C;AAAjC,wGAAA,UAAU,OAAA;AACnB,uDAAyF;AAAhF,oHAAA,gBAAgB,OAAA;AAAE,sHAAA,kBAAkB,OAAA;AAAE,iHAAA,aAAa,OAAA;AAC5D,yCAA6D;AAApD,sGAAA,SAAS,OAAA;AAAE,gHAAA,mBAAmB,OAAA"}

package/dist/route-table/parseSlug.d.ts

@@ -0,0 +1,31 @@
+import { RouteSegment } from './types';
+export interface ParsedSlug {
+    requiredSegments: RouteSegment[];
+    optionalGroups: RouteSegment[][];
+}
+/**
+ * Parse a slug string into required segments and optional groups.
+ *
+ * Slug syntax:
+ *   - `about` -> required: [static('about')]
+ *   - `users/:id` -> required: [static('users'), param('id')]
+ *   - `users(/:id)` -> required: [static('users')], optional: [[param('id')]]
+ *   - `search(/:country)(/:city)` -> required: [static('search')], optional: [[param('country')], [param('city')]]
+ *   - `users(/section/*)` -> required: [static('users')], optional: [[static('section'), wildcard('*')]]
+ *   - `/` (root) -> required: [], optional: []
+ */
+export declare function parseSlug(slug: string): ParsedSlug;
+/**
+ * Calculate route precedence following the backend's scoring algorithm.
+ * Returns a negative number; more negative = higher priority.
+ * When sorting ascending, highest-priority routes come first.
+ *
+ * Segment weights:
+ * - Static/hardcoded: 100 points
+ * - Required parameter (:param): 10 points
+ * - Optional parameter (inside parens): 1 point
+ *
+ * Base: weighted_size * -100
+ * Adjustments: slug='/' +1, format='html' +1, format-in-last-component -1
+ */
+export declare function calculatePrecedence(slug: string, format: string): number;

package/dist/route-table/parseSlug.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSlug = parseSlug;
+exports.calculatePrecedence = calculatePrecedence;
+/**
+ * Parse a single segment string (without slashes) into a RouteSegment.
+ * - Starts with `:` -> param
+ * - Starts with `*` -> wildcard
+ * - Otherwise -> static
+ */
+function parseSegment(raw) {
+    // Strip trailing `)` if present (from optional group splitting)
+    const cleaned = raw.endsWith(')') ? raw.slice(0, -1) : raw;
+    if (cleaned.startsWith(':')) {
+        return { type: 'param', name: cleaned.slice(1) };
+    }
+    if (cleaned.startsWith('*')) {
+        return { type: 'wildcard', name: cleaned.slice(1) || '*' };
+    }
+    return { type: 'static', value: cleaned };
+}
+function parseSegments(part) {
+    return part
+        .split('/')
+        .filter((s) => s.length > 0)
+        .map(parseSegment);
+}
+/**
+ * Parse a slug string into required segments and optional groups.
+ *
+ * Slug syntax:
+ *   - `about` -> required: [static('about')]
+ *   - `users/:id` -> required: [static('users'), param('id')]
+ *   - `users(/:id)` -> required: [static('users')], optional: [[param('id')]]
+ *   - `search(/:country)(/:city)` -> required: [static('search')], optional: [[param('country')], [param('city')]]
+ *   - `users(/section/*)` -> required: [static('users')], optional: [[static('section'), wildcard('*')]]
+ *   - `/` (root) -> required: [], optional: []
+ */
+function parseSlug(slug) {
+    // Root is special
+    if (slug === '/' || slug === '') {
+        return { requiredSegments: [], optionalGroups: [] };
+    }
+    // Split into required part and optional groups by finding `(`
+    const firstParen = slug.indexOf('(');
+    if (firstParen === -1) {
+        // No optional groups
+        return {
+            requiredSegments: parseSegments(slug),
+            optionalGroups: [],
+        };
+    }
+    // Required part is everything before the first `(`
+    const requiredPart = slug.slice(0, firstParen);
+    const optionalPart = slug.slice(firstParen);
+    const requiredSegments = requiredPart.length > 0 ? parseSegments(requiredPart) : [];
+    // Parse optional groups: split on `(` to get each group, strip `)` and leading `/`
+    const optionalGroups = [];
+    const groupRegex = /\(([^)]+)\)/g;
+    let match;
+    while ((match = groupRegex.exec(optionalPart)) !== null) {
+        const groupContent = match[1];
+        // Strip leading `/` if present
+        const normalized = groupContent.startsWith('/') ? groupContent.slice(1) : groupContent;
+        if (normalized.length > 0) {
+            optionalGroups.push(parseSegments(normalized));
+        }
+    }
+    return { requiredSegments, optionalGroups };
+}
+/**
+ * Calculate route precedence following the backend's scoring algorithm.
+ * Returns a negative number; more negative = higher priority.
+ * When sorting ascending, highest-priority routes come first.
+ *
+ * Segment weights:
+ * - Static/hardcoded: 100 points
+ * - Required parameter (:param): 10 points
+ * - Optional parameter (inside parens): 1 point
+ *
+ * Base: weighted_size * -100
+ * Adjustments: slug='/' +1, format='html' +1, format-in-last-component -1
+ */
+function calculatePrecedence(slug, format) {
+    if (slug === '/' || slug === '') {
+        // Special case for root: weighted_size=0 -> use 1
+        let precedence = 1 * -100;
+        precedence += 1; // root "/" adjustment
+        if (format === 'html')
+            precedence += 1;
+        return precedence;
+    }
+    // Split on `(?/` boundary to get all segments with their weight context
+    // The Ruby code: slug.split(%r{\(?/}).inject(0) { ... }
+    const parts = slug.split(/\(?\//);
+    let weightedSize = 0;
+    for (const part of parts) {
+        if (part.length === 0)
+            continue;
+        if (part.startsWith(':')) {
+            weightedSize += part.endsWith(')') ? 1 : 10;
+        }
+        else if (part.startsWith('*')) {
+            weightedSize += part.endsWith(')') ? 1 : 10;
+        }
+        else {
+            weightedSize += 100;
+        }
+    }
+    let precedence = (weightedSize === 0 ? 1 : weightedSize) * -100;
+    if (format === 'html')
+        precedence += 1;
+    // Check if format is embedded in last slug component (e.g. `data.json`)
+    const lastSlash = slug.lastIndexOf('/');
+    const lastComponent = lastSlash >= 0 ? slug.slice(lastSlash + 1) : slug;
+    // Strip optional group parens for checking
+    const cleanLast = lastComponent.replace(/[()]/g, '');
+    const dotIdx = cleanLast.lastIndexOf('.');
+    if (dotIdx > 0 && dotIdx < cleanLast.length - 1) {
+        precedence -= 1;
+    }
+    return precedence;
+}
+//# sourceMappingURL=parseSlug.js.map

package/dist/route-table/parseSlug.js.map

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

package/dist/route-table/slugFromFilePath.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Derives a URL slug from a page file path relative to the pages directory.
+ *
+ * Rules (ported from Ruby Page.default_routing_options):
+ * 1. Strip file extensions: first `.liquid`, then `.{format}` (e.g. `.html`)
+ * 2. If result is `index` -> slug = `/`
+ * 3. If result ends with `/index` -> strip it (e.g. `test/index` -> `test`)
+ * 4. If result is `home` -> slug = `/` (deprecated alias for root)
+ * 5. Otherwise slug = the remaining path
+ */
+export declare function slugFromFilePath(relativeToPages: string, format?: string): string;
+/**
+ * Known response formats supported by the platformOS engine.
+ * Derived from the platform's FORMAT_ENUM.
+ */
+export declare const KNOWN_FORMATS: Set<string>;
+/**
+ * Extracts the format from a page filename.
+ * Returns the format if the file has a double extension like `.json.liquid` or `.xml.liquid`
+ * and the extension is a known platformOS format.
+ * Returns 'html' as the default if only `.liquid` is present or the extension is unknown.
+ */
+export declare function formatFromFilePath(relativeToPages: string): string;