@voobase/cli 0.1.1-nonprod.2039 → 0.1.1-nonprod.2050

package/template-blocks/assets.ts

@@ -0,0 +1,95 @@
+export function buildWebBackendLiteRuntimeAssetsSource(): string {
+  return [
+    "import { existsSync, readFileSync } from \"node:fs\";",
+    "",
+    "export function readRuntimeAsset(relativePath) {",
+    "  if (!/^[a-zA-Z0-9_./-]+$/.test(relativePath) || relativePath.includes(\"..\")) {",
+    "    return null;",
+    "  }",
+    "  try {",
+    "    const fileUrl = new URL(`../../vendor/runtime-sdk/${relativePath}`, import.meta.url);",
+    "    if (!existsSync(fileUrl)) {",
+    "      return null;",
+    "    }",
+    "    return readFileSync(fileUrl, \"utf8\");",
+    "  } catch {",
+    "    return null;",
+    "  }",
+    "}",
+    ""
+  ].join("\n");
+}
+
+export function buildWebBackendLiteCmsContentPresetCssSource(): string {
+  return [
+    "/* Platform CMS content preset */",
+    "/* Usage: <link rel=\"stylesheet\" href=\"./assets/cms-content.css\" /> and wrap HTML with <div class=\"cms-content\">...</div> */",
+    ".cms-content {",
+    "  color: #243431;",
+    "  line-height: 1.85;",
+    "  font-size: 1rem;",
+    "}",
+    ".cms-content > :first-child { margin-top: 0; }",
+    ".cms-content > :last-child { margin-bottom: 0; }",
+    ".cms-content h1, .cms-content h2, .cms-content h3, .cms-content h4, .cms-content h5, .cms-content h6 {",
+    "  color: #13211f;",
+    "  font-weight: 800;",
+    "  line-height: 1.2;",
+    "  letter-spacing: -0.03em;",
+    "  margin-top: 1.6em;",
+    "  margin-bottom: 0.6em;",
+    "}",
+    ".cms-content h1 { font-size: 2rem; }",
+    ".cms-content h2 { font-size: 1.55rem; }",
+    ".cms-content h3 { font-size: 1.2rem; }",
+    ".cms-content h4, .cms-content h5, .cms-content h6 { font-size: 1rem; }",
+    ".cms-content p, .cms-content ul, .cms-content ol, .cms-content blockquote, .cms-content pre, .cms-content table, .cms-content hr {",
+    "  margin-top: 1em;",
+    "  margin-bottom: 1em;",
+    "}",
+    ".cms-content ul, .cms-content ol { padding-left: 1.5rem; }",
+    ".cms-content ul { list-style: disc; }",
+    ".cms-content ol { list-style: decimal; }",
+    ".cms-content li + li { margin-top: 0.35rem; }",
+    ".cms-content li > p { margin-top: 0; margin-bottom: 0; }",
+    ".cms-content li > ul, .cms-content li > ol { margin-top: 0.5rem; margin-bottom: 0; }",
+    ".cms-content blockquote {",
+    "  margin-left: 0;",
+    "  margin-right: 0;",
+    "  padding: 0.8rem 1rem;",
+    "  border-left: 3px solid rgba(15,23,42,0.12);",
+    "  background: rgba(18, 60, 51, 0.06);",
+    "  color: #5f6f69;",
+    "}",
+    ".cms-content hr { border: 0; border-top: 1px solid rgba(15,23,42,0.12); }",
+    ".cms-content a { color: #2563eb; text-decoration: underline; text-underline-offset: 0.18em; }",
+    ".cms-content code {",
+    "  font-family: ui-monospace, SFMono-Regular, Menlo, monospace;",
+    "  font-size: 0.875em;",
+    "  line-height: 1.45;",
+    "  padding: 0.15rem 0.35rem;",
+    "  border-radius: 0.375rem;",
+    "  background: rgba(18, 60, 51, 0.08);",
+    "}",
+    ".cms-content pre {",
+    "  overflow-x: auto;",
+    "  margin-top: 0.75rem;",
+    "  margin-bottom: 0.75rem;",
+    "  padding: 0.8rem 1rem;",
+    "  border: 1px solid rgba(15,23,42,0.12);",
+    "  border-radius: 0.9rem;",
+    "  background: rgba(18, 60, 51, 0.06);",
+    "}",
+    ".cms-content pre code { padding: 0; border-radius: 0; background: transparent; }",
+    ".cms-content table { width: 100%; border-collapse: collapse; font-size: 0.95rem; overflow: hidden; border-radius: 16px; }",
+    ".cms-content th, .cms-content td {",
+    "  padding: 0.7rem 0.85rem;",
+    "  border: 1px solid rgba(15,23,42,0.12);",
+    "  text-align: left;",
+    "  vertical-align: top;",
+    "}",
+    ".cms-content th { font-weight: 700; color: #13211f; background: rgba(18, 60, 51, 0.08); }",
+    ".cms-content img { display: block; max-width: 100%; height: auto; margin: 1rem auto; border-radius: 0.9rem; }",
+    ""
+  ].join("\n");
+}

package/template-blocks/contract/capabilities.ts

@@ -0,0 +1,33 @@
+export const PLATFORM_CAPABILITIES = [
+  "auth",
+  "cms",
+  "workflow",
+  "notification",
+  "blob"
+] as const;
+
+export type PlatformCapability = (typeof PLATFORM_CAPABILITIES)[number];
+
+export function isPlatformCapability(value: string): value is PlatformCapability {
+  return PLATFORM_CAPABILITIES.includes(value as PlatformCapability);
+}
+
+export function normalizePlatformCapabilities(
+  values: readonly string[] | null | undefined
+): PlatformCapability[] {
+  if (!values || values.length === 0) {
+    return [];
+  }
+  const normalized = new Set<PlatformCapability>();
+  for (const value of values) {
+    if (!value) {
+      continue;
+    }
+    const trimmed = value.trim();
+    if (!trimmed || !isPlatformCapability(trimmed)) {
+      continue;
+    }
+    normalized.add(trimmed);
+  }
+  return [...normalized];
+}

package/template-blocks/contract/facade-contract.ts

@@ -0,0 +1,59 @@
+import type { PlatformCapability } from "./capabilities.js";
+import type { PlatformRuntimeConfig } from "./runtime-config.js";
+
+export type PlatformApiQueryValue =
+  | string
+  | number
+  | boolean
+  | null
+  | undefined;
+
+export type PlatformApiRequestInit = RequestInit & {
+  query?: Record<string, PlatformApiQueryValue>;
+};
+
+export type PlatformApiFetcher = <TResponse = unknown>(
+  path: string,
+  init?: PlatformApiRequestInit
+) => Promise<TResponse>;
+
+export type PlatformCapabilityState = {
+  capability: PlatformCapability;
+  ready: boolean;
+};
+
+export interface PlatformCapabilityFacade {
+  readonly capability: PlatformCapability;
+  isReady(): boolean;
+  getState(): PlatformCapabilityState;
+}
+
+export interface AuthFacade extends PlatformCapabilityFacade {
+  readonly capability: "auth";
+}
+
+export interface CmsFacade extends PlatformCapabilityFacade {
+  readonly capability: "cms";
+}
+
+export interface WorkflowFacade extends PlatformCapabilityFacade {
+  readonly capability: "workflow";
+}
+
+export interface NotificationFacade extends PlatformCapabilityFacade {
+  readonly capability: "notification";
+}
+
+export interface BlobFacade extends PlatformCapabilityFacade {
+  readonly capability: "blob";
+}
+
+export interface PlatformClientContract {
+  readonly config: PlatformRuntimeConfig;
+  fetchPlatformApi: PlatformApiFetcher;
+  auth: AuthFacade;
+  cms: CmsFacade;
+  workflow: WorkflowFacade;
+  notification: NotificationFacade;
+  blob: BlobFacade;
+}

package/template-blocks/contract/index.ts

@@ -0,0 +1,4 @@
+export * from "./capabilities.js";
+export * from "./facade-contract.js";
+export * from "./path-builders.js";
+export * from "./runtime-config.js";

package/template-blocks/contract/path-builders.ts

@@ -0,0 +1,76 @@
+import type { PlatformRuntimeConfig } from "./runtime-config.js";
+
+export type PlatformPathContext = Pick<PlatformRuntimeConfig, "basePath">;
+
+export type PlatformAbsoluteUrlContext = Pick<
+  PlatformRuntimeConfig,
+  "basePath" | "requestOrigin" | "publicBaseUrl" | "baseUrl"
+>;
+
+export function normalizeBasePath(basePath: string): string {
+  const trimmed = basePath.trim();
+  if (!trimmed || trimmed === "/") {
+    return "/";
+  }
+
+  const withLeadingSlash = trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+  return withLeadingSlash.replace(/\/+$/u, "") || "/";
+}
+
+export function buildPlatformPath(
+  config: PlatformPathContext,
+  path = "/"
+): string {
+  const normalizedBasePath = normalizeBasePath(config.basePath);
+  const normalizedBase = normalizedBasePath === "/" ? "" : normalizedBasePath.replace(/\/+$/u, "");
+  const normalizedPath = normalizeRelativePath(path);
+
+  if (normalizedPath === "/") {
+    return normalizedBase || "/";
+  }
+
+  return `${normalizedBase}${normalizedPath}`;
+}
+
+export function buildPlatformAbsoluteUrl(
+  config: PlatformAbsoluteUrlContext,
+  path = "/"
+): string {
+  const origin = resolveRequestOrigin(config);
+  return new URL(buildPlatformPath(config, path), normalizeBaseUrl(origin)).toString();
+}
+
+export function buildPlatformAuthPath(config: PlatformPathContext): string {
+  return buildPlatformPath(config, "/auth");
+}
+
+function normalizeRelativePath(path: string): string {
+  if (!path || path === "/") {
+    return "/";
+  }
+
+  return path.startsWith("/") ? path : `/${path}`;
+}
+
+function normalizeBaseUrl(baseUrl: string): string {
+  const trimmed = baseUrl.trim();
+  return trimmed.endsWith("/") ? trimmed : `${trimmed}/`;
+}
+
+function resolveRequestOrigin(config: PlatformAbsoluteUrlContext): string {
+  const requestOrigin = config.requestOrigin?.trim();
+  if (requestOrigin) {
+    return requestOrigin;
+  }
+
+  const publicBaseUrl = config.publicBaseUrl?.trim();
+  if (publicBaseUrl) {
+    try {
+      return new URL(publicBaseUrl).origin;
+    } catch {
+      return publicBaseUrl;
+    }
+  }
+
+  return config.baseUrl;
+}

package/template-blocks/contract/route-path-patterns-source.ts

@@ -0,0 +1,222 @@
+import {
+  DNS_LABEL_ROUTE_SEGMENT_SOURCE,
+  TENANT_ROUTE_SEGMENT_SOURCE,
+  buildLegacyPreviewPathPattern,
+  buildProdPathPattern,
+  buildTenantPreviewPathPattern,
+  buildTypedPreviewPathPattern
+} from "@platform/url-contract";
+
+export function buildRoutePathPatternsSource(): string {
+  return `// Keep these scaffolded patterns aligned with @platform/url-contract path segment rules.
+const ROUTE_SEGMENT_PATTERN = ${JSON.stringify(DNS_LABEL_ROUTE_SEGMENT_SOURCE)};
+const TENANT_ROUTE_SEGMENT_PATTERN = ${JSON.stringify(TENANT_ROUTE_SEGMENT_SOURCE)};
+
+export type PreviewRouteKind = "runtime" | "static";
+
+export const PREVIEW_TYPED_PATH_PATTERN =
+  ${JSON.stringify(buildTypedPreviewPathPattern())};
+export const PREVIEW_TENANT_PATH_PATTERN =
+  ${JSON.stringify(buildTenantPreviewPathPattern())};
+export const PREVIEW_LEGACY_PATH_PATTERN =
+  ${JSON.stringify(buildLegacyPreviewPathPattern())};
+export const PROD_PATH_PATTERN =
+  ${JSON.stringify(buildProdPathPattern())};
+
+export type TypedPreviewPathMatch = {
+  routeKind: PreviewRouteKind;
+  tenantId: string;
+  appId: string;
+  releaseId: string;
+  routeBasePath: string;
+  upstreamPath: string;
+};
+
+export type TenantPreviewPathMatch = {
+  routeKind: "runtime";
+  tenantId: string;
+  appId: string;
+  releaseId: string;
+  routeBasePath: string;
+  upstreamPath: string;
+};
+
+export type LegacyPreviewPathMatch = {
+  routeKind: "static";
+  appId: string;
+  releaseId: string;
+  routeBasePath: string;
+  upstreamPath: string;
+};
+
+export type ProdPathMatch = {
+  routeKind?: PreviewRouteKind;
+  tenantId: string;
+  appId: string;
+  routeBasePath: string;
+  upstreamPath: string;
+};
+
+export type PlatformPathMatch =
+  | ({ kind: "typed-preview"; mode: "preview"; routeMode: "path" } & TypedPreviewPathMatch)
+  | ({ kind: "tenant-preview"; mode: "preview"; routeMode: "path" } & TenantPreviewPathMatch)
+  | ({ kind: "legacy-preview"; mode: "preview"; routeMode: "path"; tenantId: "" } & LegacyPreviewPathMatch)
+  | ({ kind: "prod-path"; mode: "prod-path"; routeMode: "path" } & ProdPathMatch);
+
+export function buildInlineParsePlatformPathSource(functionName = "parsePlatformPath"): string {
+  return [
+    \`function \${functionName}(pathname) {\`,
+    \`  const typedPreviewMatch = pathname.match(new RegExp(\${JSON.stringify(PREVIEW_TYPED_PATH_PATTERN)}));\`,
+    "  if (typedPreviewMatch) {",
+    "    const routeBasePath = '/previews/' + typedPreviewMatch[1] + '/' + typedPreviewMatch[2] + '/' + typedPreviewMatch[3] + '/' + typedPreviewMatch[4];",
+    "    return { kind: 'typed-preview', mode: 'preview', routeMode: 'path', routeKind: typedPreviewMatch[1] === 's' ? 'static' : 'runtime', tenantId: typedPreviewMatch[2], appId: typedPreviewMatch[3], releaseId: typedPreviewMatch[4], routeBasePath, upstreamPath: inferInlineUpstreamPath(pathname, routeBasePath) };",
+    "  }",
+    \`  const tenantPreviewMatch = pathname.match(new RegExp(\${JSON.stringify(PREVIEW_TENANT_PATH_PATTERN)}));\`,
+    "  if (tenantPreviewMatch) {",
+    "    const routeBasePath = '/previews/' + tenantPreviewMatch[1] + '/' + tenantPreviewMatch[2] + '/' + tenantPreviewMatch[3];",
+    "    return { kind: 'tenant-preview', mode: 'preview', routeMode: 'path', routeKind: 'runtime', tenantId: tenantPreviewMatch[1], appId: tenantPreviewMatch[2], releaseId: tenantPreviewMatch[3], routeBasePath, upstreamPath: inferInlineUpstreamPath(pathname, routeBasePath) };",
+    "  }",
+    \`  const previewMatch = pathname.match(new RegExp(\${JSON.stringify(PREVIEW_LEGACY_PATH_PATTERN)}));\`,
+    "  if (previewMatch) {",
+    "    const routeBasePath = '/previews/' + previewMatch[1] + '/' + previewMatch[2];",
+    "    return { kind: 'legacy-preview', mode: 'preview', routeMode: 'path', routeKind: 'static', tenantId: '', appId: previewMatch[1], releaseId: previewMatch[2], routeBasePath, upstreamPath: inferInlineUpstreamPath(pathname, routeBasePath) };",
+    "  }",
+    \`  const prodMatch = pathname.match(new RegExp(\${JSON.stringify(PROD_PATH_PATTERN)}));\`,
+    "  if (prodMatch) {",
+    "    const routeBasePath = '/apps/' + prodMatch[1] + '/' + prodMatch[2];",
+    "    return { kind: 'prod-path', mode: 'prod-path', routeMode: 'path', routeKind: 'runtime', tenantId: prodMatch[1], appId: prodMatch[2], routeBasePath, upstreamPath: inferInlineUpstreamPath(pathname, routeBasePath) };",
+    "  }",
+    "  return null;",
+    "}",
+    "function inferInlineUpstreamPath(pathname, routeBasePath) {",
+    "  if (pathname === routeBasePath || pathname === routeBasePath + '/') {",
+    "    return '/';",
+    "  }",
+    "  if (pathname.startsWith(routeBasePath + '/')) {",
+    "    return pathname.slice(routeBasePath.length) || '/';",
+    "  }",
+    "  return '/';",
+    "}"
+  ].join("\\n");
+}
+
+export function parseTypedPreviewPath(pathname: string): TypedPreviewPathMatch | null {
+  const match = normalizePathname(pathname).match(new RegExp(PREVIEW_TYPED_PATH_PATTERN, "u"));
+  if (!match) {
+    return null;
+  }
+  const routeBasePath = \`/previews/\${match[1]}/\${match[2]}/\${match[3]}/\${match[4]}\`;
+  return {
+    routeKind: match[1] === "s" ? "static" : "runtime",
+    tenantId: match[2] ?? "",
+    appId: match[3] ?? "",
+    releaseId: match[4] ?? "",
+    routeBasePath,
+    upstreamPath: inferUpstreamPath(pathname, routeBasePath),
+  };
+}
+
+export function parseTenantPreviewPath(pathname: string): TenantPreviewPathMatch | null {
+  const match = normalizePathname(pathname).match(new RegExp(PREVIEW_TENANT_PATH_PATTERN, "u"));
+  if (!match) {
+    return null;
+  }
+  const routeBasePath = \`/previews/\${match[1]}/\${match[2]}/\${match[3]}\`;
+  return {
+    routeKind: "runtime",
+    tenantId: match[1] ?? "",
+    appId: match[2] ?? "",
+    releaseId: match[3] ?? "",
+    routeBasePath,
+    upstreamPath: inferUpstreamPath(pathname, routeBasePath),
+  };
+}
+
+export function parseLegacyPreviewPath(pathname: string): LegacyPreviewPathMatch | null {
+  const match = normalizePathname(pathname).match(new RegExp(PREVIEW_LEGACY_PATH_PATTERN, "u"));
+  if (!match) {
+    return null;
+  }
+  const routeBasePath = \`/previews/\${match[1]}/\${match[2]}\`;
+  return {
+    routeKind: "static",
+    appId: match[1] ?? "",
+    releaseId: match[2] ?? "",
+    routeBasePath,
+    upstreamPath: inferUpstreamPath(pathname, routeBasePath),
+  };
+}
+
+export function parseProdPath(pathname: string): ProdPathMatch | null {
+  const match = normalizePathname(pathname).match(new RegExp(PROD_PATH_PATTERN, "u"));
+  if (!match) {
+    return null;
+  }
+  const routeBasePath = \`/apps/\${match[1]}/\${match[2]}\`;
+  return {
+    routeKind: "runtime",
+    tenantId: match[1] ?? "",
+    appId: match[2] ?? "",
+    routeBasePath,
+    upstreamPath: inferUpstreamPath(pathname, routeBasePath),
+  };
+}
+
+export function parsePlatformPath(pathname: string): PlatformPathMatch | null {
+  const typedPreview = parseTypedPreviewPath(pathname);
+  if (typedPreview) {
+    return {
+      kind: "typed-preview",
+      mode: "preview",
+      routeMode: "path",
+      ...typedPreview
+    };
+  }
+  const tenantPreview = parseTenantPreviewPath(pathname);
+  if (tenantPreview) {
+    return {
+      kind: "tenant-preview",
+      mode: "preview",
+      routeMode: "path",
+      ...tenantPreview
+    };
+  }
+  const legacyPreview = parseLegacyPreviewPath(pathname);
+  if (legacyPreview) {
+    return {
+      kind: "legacy-preview",
+      mode: "preview",
+      routeMode: "path",
+      tenantId: "",
+      ...legacyPreview
+    };
+  }
+  const prodPath = parseProdPath(pathname);
+  if (prodPath) {
+    return {
+      kind: "prod-path",
+      mode: "prod-path",
+      routeMode: "path",
+      ...prodPath
+    };
+  }
+  return null;
+}
+
+function normalizePathname(pathname: string): string {
+  const trimmed = pathname.trim() || "/";
+  return trimmed.startsWith("/") ? trimmed : \`/\${trimmed}\`;
+}
+
+function inferUpstreamPath(pathname: string, routeBasePath: string): string {
+  const normalizedPathname = normalizePathname(pathname);
+  if (normalizedPathname === routeBasePath || normalizedPathname === \`\${routeBasePath}/\`) {
+    return "/";
+  }
+  if (normalizedPathname.startsWith(\`\${routeBasePath}/\`)) {
+    return normalizedPathname.slice(routeBasePath.length) || "/";
+  }
+  return "/";
+}
+`;
+}