@sneat/core 0.15.2 → 0.17.0

package/esm2022/lib/index.js

@@ -14,6 +14,7 @@ export * from './sneat-extensions';
 export * from './form-field';
 export * from './team-type';
 export * from './location-href';
+export * from './reserved-public-path';
 export * from './interfaces';
 export * from './current-space-storage';
 export * from './directives';

package/esm2022/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,MAAM,CAAC;AACrB,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC","sourcesContent":["export * from './animations';\nexport * from './app.service';\nexport * from './core-models';\nexport * from './nav';\nexport * from './store';\nexport * from './sneat-enum-keys';\nexport * from './services';\nexport * from './exclude-undefined';\nexport * from './logging';\nexport * from './utils';\nexport * from './eq';\nexport * from './types';\nexport * from './sneat-extensions';\nexport * from './form-field';\nexport * from './team-type';\nexport * from './location-href';\nexport * from './interfaces';\nexport * from './current-space-storage';\nexport * from './directives';\nexport * from './environment-config';\nexport * from './logging/interfaces';\nexport * from './analytics.interface';\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,mBAAmB,CAAC;AAClC,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,MAAM,CAAC;AACrB,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,cAAc,CAAC;AAC7B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC","sourcesContent":["export * from './animations';\nexport * from './app.service';\nexport * from './core-models';\nexport * from './nav';\nexport * from './store';\nexport * from './sneat-enum-keys';\nexport * from './services';\nexport * from './exclude-undefined';\nexport * from './logging';\nexport * from './utils';\nexport * from './eq';\nexport * from './types';\nexport * from './sneat-extensions';\nexport * from './form-field';\nexport * from './team-type';\nexport * from './location-href';\nexport * from './reserved-public-path';\nexport * from './interfaces';\nexport * from './current-space-storage';\nexport * from './directives';\nexport * from './environment-config';\nexport * from './logging/interfaces';\nexport * from './analytics.interface';\n"]}

package/esm2022/lib/reserved-public-path.js

@@ -0,0 +1,84 @@
+// Reserved public paths for the standard Sneat routing model: the Angular
+// application is mounted at the ROOT (`/`), and a small, fixed set of paths is
+// reserved for the public landing/content surface. The edge (Cloudflare Worker)
+// uses this to split traffic:
+//
+//   if (isReservedPublicPath(pathname)) return serveLanding(request)
+//   return serveApplication(request)   // root-mounted Angular SPA
+//
+// See docs/extension-standards/routing-and-deployment.md for the full contract.
+/**
+ * Locale codes whose `/{locale}/*` subtree is reserved for landing/content
+ * pages. Two-letter ISO-639-1 codes.
+ *
+ * This is an explicit ALLOW-LIST, not an "any two-letter segment" rule, and
+ * that distinction is load-bearing: `/my` (the personal-dashboard section) is
+ * also two letters. Matching "any two letters" would swallow `/my/assets` as if
+ * `my` were a locale. With an allow-list, unknown two-letter segments fall
+ * through to the application (fail-closed): `/my/assets` → app, `/en/about` →
+ * landing.
+ */
+export const DEFAULT_RESERVED_LOCALES = ['en'];
+/**
+ * Returns `true` when `pathname` belongs to the public landing/content surface
+ * rather than the root-mounted Angular application.
+ *
+ * Reserved:
+ * - `/` — root landing page
+ * - `/{locale}` and `/{locale}/*` — localized content/marketing/legal/docs/SEO
+ *   (locale ∈ the allow-list; see {@link ReservedPublicPathOptions.locales})
+ * - `/static` and `/static/*` — shared static files
+ * - `/.well-known` and `/.well-known/*` — well-known files
+ * - `/robots.txt`
+ * - `/sitemap.xml`, `/sitemap-*.xml`, `/sitemap-index.xml`
+ * - `/favicon.ico`, `/favicon.svg`
+ * - `/manifest.webmanifest`
+ *
+ * Everything else (e.g. `/`, `/space/...`, `/my/assets`, `/event/abc`,
+ * `/u/alex`) is an application route.
+ *
+ * Query strings and fragments are ignored — pass a bare pathname (a full URL is
+ * tolerated and reduced to its pathname).
+ */
+export function isReservedPublicPath(pathname, options) {
+    const locales = options?.locales ?? DEFAULT_RESERVED_LOCALES;
+    let p = pathname || '/';
+    // Tolerate a full URL or a path carrying a query/hash.
+    if (/^[a-z]+:\/\//i.test(p)) {
+        try {
+            p = new URL(p).pathname;
+        }
+        catch {
+            // fall through with the raw value
+        }
+    }
+    else {
+        const cut = p.search(/[?#]/);
+        if (cut >= 0)
+            p = p.slice(0, cut);
+    }
+    if (!p.startsWith('/'))
+        p = '/' + p;
+    // Normalize a trailing slash away (except for the bare root).
+    if (p.length > 1 && p.endsWith('/'))
+        p = p.replace(/\/+$/, '') || '/';
+    if (p === '/')
+        return true;
+    const firstSegment = p.split('/')[1];
+    if (locales.includes(firstSegment))
+        return true;
+    if (p === '/static' || p.startsWith('/static/'))
+        return true;
+    if (p === '/.well-known' || p.startsWith('/.well-known/'))
+        return true;
+    if (p === '/robots.txt')
+        return true;
+    if (/^\/sitemap[-\w]*\.xml$/.test(p))
+        return true;
+    if (p === '/favicon.ico' || p === '/favicon.svg')
+        return true;
+    if (p === '/manifest.webmanifest')
+        return true;
+    return false;
+}
+//# sourceMappingURL=reserved-public-path.js.map

package/esm2022/lib/reserved-public-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reserved-public-path.js","sourceRoot":"","sources":["../../../../../libs/core/src/lib/reserved-public-path.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,+EAA+E;AAC/E,gFAAgF;AAChF,8BAA8B;AAC9B,EAAE;AACF,qEAAqE;AACrE,mEAAmE;AACnE,EAAE;AACF,gFAAgF;AAEhF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAsB,CAAC,IAAI,CAAC,CAAC;AAWlE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,oBAAoB,CAClC,QAAgB,EAChB,OAAmC;IAEnC,MAAM,OAAO,GAAG,OAAO,EAAE,OAAO,IAAI,wBAAwB,CAAC;IAE7D,IAAI,CAAC,GAAG,QAAQ,IAAI,GAAG,CAAC;IACxB,uDAAuD;IACvD,IAAI,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,kCAAkC;QACpC,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QAC7B,IAAI,GAAG,IAAI,CAAC;YAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACpC,CAAC;IACD,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC;IACpC,8DAA8D;IAC9D,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;IAEtE,IAAI,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IAE3B,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACrC,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC;QAAE,OAAO,IAAI,CAAC;IAEhD,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC7D,IAAI,CAAC,KAAK,cAAc,IAAI,CAAC,CAAC,UAAU,CAAC,eAAe,CAAC;QAAE,OAAO,IAAI,CAAC;IACvE,IAAI,CAAC,KAAK,aAAa;QAAE,OAAO,IAAI,CAAC;IACrC,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,IAAI,CAAC,KAAK,cAAc,IAAI,CAAC,KAAK,cAAc;QAAE,OAAO,IAAI,CAAC;IAC9D,IAAI,CAAC,KAAK,uBAAuB;QAAE,OAAO,IAAI,CAAC;IAE/C,OAAO,KAAK,CAAC;AACf,CAAC","sourcesContent":["// Reserved public paths for the standard Sneat routing model: the Angular\n// application is mounted at the ROOT (`/`), and a small, fixed set of paths is\n// reserved for the public landing/content surface. The edge (Cloudflare Worker)\n// uses this to split traffic:\n//\n//   if (isReservedPublicPath(pathname)) return serveLanding(request)\n//   return serveApplication(request)   // root-mounted Angular SPA\n//\n// See docs/extension-standards/routing-and-deployment.md for the full contract.\n\n/**\n * Locale codes whose `/{locale}/*` subtree is reserved for landing/content\n * pages. Two-letter ISO-639-1 codes.\n *\n * This is an explicit ALLOW-LIST, not an \"any two-letter segment\" rule, and\n * that distinction is load-bearing: `/my` (the personal-dashboard section) is\n * also two letters. Matching \"any two letters\" would swallow `/my/assets` as if\n * `my` were a locale. With an allow-list, unknown two-letter segments fall\n * through to the application (fail-closed): `/my/assets` → app, `/en/about` →\n * landing.\n */\nexport const DEFAULT_RESERVED_LOCALES: readonly string[] = ['en'];\n\nexport interface ReservedPublicPathOptions {\n  /**\n   * Locale codes reserved for `/{locale}/*` landing content. Defaults to\n   * {@link DEFAULT_RESERVED_LOCALES}. Pass the set your landing actually\n   * publishes so unknown locales fail closed to the application.\n   */\n  locales?: readonly string[];\n}\n\n/**\n * Returns `true` when `pathname` belongs to the public landing/content surface\n * rather than the root-mounted Angular application.\n *\n * Reserved:\n * - `/` — root landing page\n * - `/{locale}` and `/{locale}/*` — localized content/marketing/legal/docs/SEO\n *   (locale ∈ the allow-list; see {@link ReservedPublicPathOptions.locales})\n * - `/static` and `/static/*` — shared static files\n * - `/.well-known` and `/.well-known/*` — well-known files\n * - `/robots.txt`\n * - `/sitemap.xml`, `/sitemap-*.xml`, `/sitemap-index.xml`\n * - `/favicon.ico`, `/favicon.svg`\n * - `/manifest.webmanifest`\n *\n * Everything else (e.g. `/`, `/space/...`, `/my/assets`, `/event/abc`,\n * `/u/alex`) is an application route.\n *\n * Query strings and fragments are ignored — pass a bare pathname (a full URL is\n * tolerated and reduced to its pathname).\n */\nexport function isReservedPublicPath(\n  pathname: string,\n  options?: ReservedPublicPathOptions,\n): boolean {\n  const locales = options?.locales ?? DEFAULT_RESERVED_LOCALES;\n\n  let p = pathname || '/';\n  // Tolerate a full URL or a path carrying a query/hash.\n  if (/^[a-z]+:\\/\\//i.test(p)) {\n    try {\n      p = new URL(p).pathname;\n    } catch {\n      // fall through with the raw value\n    }\n  } else {\n    const cut = p.search(/[?#]/);\n    if (cut >= 0) p = p.slice(0, cut);\n  }\n  if (!p.startsWith('/')) p = '/' + p;\n  // Normalize a trailing slash away (except for the bare root).\n  if (p.length > 1 && p.endsWith('/')) p = p.replace(/\\/+$/, '') || '/';\n\n  if (p === '/') return true;\n\n  const firstSegment = p.split('/')[1];\n  if (locales.includes(firstSegment)) return true;\n\n  if (p === '/static' || p.startsWith('/static/')) return true;\n  if (p === '/.well-known' || p.startsWith('/.well-known/')) return true;\n  if (p === '/robots.txt') return true;\n  if (/^\\/sitemap[-\\w]*\\.xml$/.test(p)) return true;\n  if (p === '/favicon.ico' || p === '/favicon.svg') return true;\n  if (p === '/manifest.webmanifest') return true;\n\n  return false;\n}\n"]}

package/lib/index.d.ts

@@ -14,6 +14,7 @@ export * from './sneat-extensions';
 export * from './form-field';
 export * from './team-type';
 export * from './location-href';
+export * from './reserved-public-path';
 export * from './interfaces';
 export * from './current-space-storage';
 export * from './directives';

package/lib/reserved-public-path.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Locale codes whose `/{locale}/*` subtree is reserved for landing/content
+ * pages. Two-letter ISO-639-1 codes.
+ *
+ * This is an explicit ALLOW-LIST, not an "any two-letter segment" rule, and
+ * that distinction is load-bearing: `/my` (the personal-dashboard section) is
+ * also two letters. Matching "any two letters" would swallow `/my/assets` as if
+ * `my` were a locale. With an allow-list, unknown two-letter segments fall
+ * through to the application (fail-closed): `/my/assets` → app, `/en/about` →
+ * landing.
+ */
+export declare const DEFAULT_RESERVED_LOCALES: readonly string[];
+export interface ReservedPublicPathOptions {
+    /**
+     * Locale codes reserved for `/{locale}/*` landing content. Defaults to
+     * {@link DEFAULT_RESERVED_LOCALES}. Pass the set your landing actually
+     * publishes so unknown locales fail closed to the application.
+     */
+    locales?: readonly string[];
+}
+/**
+ * Returns `true` when `pathname` belongs to the public landing/content surface
+ * rather than the root-mounted Angular application.
+ *
+ * Reserved:
+ * - `/` — root landing page
+ * - `/{locale}` and `/{locale}/*` — localized content/marketing/legal/docs/SEO
+ *   (locale ∈ the allow-list; see {@link ReservedPublicPathOptions.locales})
+ * - `/static` and `/static/*` — shared static files
+ * - `/.well-known` and `/.well-known/*` — well-known files
+ * - `/robots.txt`
+ * - `/sitemap.xml`, `/sitemap-*.xml`, `/sitemap-index.xml`
+ * - `/favicon.ico`, `/favicon.svg`
+ * - `/manifest.webmanifest`
+ *
+ * Everything else (e.g. `/`, `/space/...`, `/my/assets`, `/event/abc`,
+ * `/u/alex`) is an application route.
+ *
+ * Query strings and fragments are ignored — pass a bare pathname (a full URL is
+ * tolerated and reduced to its pathname).
+ */
+export declare function isReservedPublicPath(pathname: string, options?: ReservedPublicPathOptions): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sneat/core",
-  "version": "0.15.2",
+  "version": "0.17.0",
   "publishConfig": {
     "access": "public"
   },