jamdesk 1.0.0

package/dist/commands/deploy/templates.js

@@ -0,0 +1,179 @@
+/**
+ * Cloudflare Worker Templates
+ *
+ * Generates the worker code, wrangler.toml, and package.json.
+ */
+export function generateWorkerCode(config) {
+    const { slug, pathPrefix } = config;
+    const jamdeskHost = `${slug}.jamdesk.app`;
+    return `/**
+ * Jamdesk Documentation Proxy Worker
+ *
+ * Generated by: jamdesk deploy cloudflare
+ * Proxies ${pathPrefix}/* requests AND their assets to ${jamdeskHost}
+ *
+ * Assets under /_jd/* (images, fonts, branding, analytics) must also be proxied
+ * since they use absolute paths in the HTML.
+ */
+
+const JAMDESK_HOST = "${jamdeskHost}";
+
+// Paths that should be proxied to Jamdesk
+const PROXY_PATHS = [
+  "${pathPrefix}",  // Documentation pages
+  "/_next/",        // Next.js static assets (JS, CSS)
+  "/_jd/",          // All Jamdesk assets (images, fonts, branding, analytics)
+];
+
+function shouldProxy(pathname) {
+  return PROXY_PATHS.some(prefix => {
+    // For the docs path, require exact match or prefix with slash (not /docs.json)
+    if (prefix === "${pathPrefix}") {
+      return pathname === "${pathPrefix}" || pathname.startsWith("${pathPrefix}/");
+    }
+    return pathname.startsWith(prefix);
+  });
+}
+
+export default {
+  async fetch(request) {
+    const url = new URL(request.url);
+
+    // Only proxy docs-related paths
+    if (!shouldProxy(url.pathname)) {
+      return fetch(request);
+    }
+
+    // Rewrite the request to Jamdesk
+    const proxyUrl = new URL(request.url);
+    proxyUrl.hostname = JAMDESK_HOST;
+
+    // Clone headers and add proxy headers
+    const headers = new Headers(request.headers);
+    headers.set("Host", JAMDESK_HOST);
+    headers.set("X-Forwarded-Host", url.hostname);
+    headers.set("X-Forwarded-Proto", "https");
+    // Custom header for domain verification (Vercel strips standard forwarding headers)
+    headers.set("X-Jamdesk-Forwarded-Host", url.hostname);
+
+    const proxyRequest = new Request(proxyUrl, {
+      method: request.method,
+      headers: headers,
+      body: request.body,
+    });
+
+    return fetch(proxyRequest);
+  },
+};
+`;
+}
+export function generateWranglerConfig(config) {
+    const { domain, zoneName } = config;
+    const workerName = `docs-proxy-${domain.replace(/\./g, '-')}`;
+    return `# Jamdesk Documentation Proxy Worker
+# Generated by: jamdesk deploy cloudflare
+#
+# Deploy: npx wrangler deploy
+
+name = "${workerName}"
+main = "index.js"
+compatibility_date = "2024-01-01"
+
+# Route configuration
+# Single catch-all route — the worker's shouldProxy() handles path filtering internally
+routes = [
+  { pattern = "${domain}/*", zone_name = "${zoneName}" },
+]
+
+# Optional: Uncomment to add environment variables
+# [vars]
+# ENVIRONMENT = "production"
+`;
+}
+export function generatePackageJson(config) {
+    const { domain } = config;
+    const packageName = `docs-proxy-${domain.replace(/\./g, '-')}`;
+    const pkg = {
+        name: packageName,
+        version: '1.0.0',
+        description: `Jamdesk documentation proxy for ${domain}`,
+        main: 'index.js',
+        scripts: {
+            deploy: 'wrangler deploy',
+            dev: 'wrangler dev',
+        },
+        devDependencies: {
+            wrangler: '^3.0.0',
+        },
+        keywords: ['cloudflare-worker', 'jamdesk', 'documentation', 'proxy'],
+        private: true,
+    };
+    return JSON.stringify(pkg, null, 2) + '\n';
+}
+/**
+ * Generate a .gitignore file for the worker directory.
+ */
+export function generateGitignore() {
+    return `node_modules/
+.wrangler/
+.dev.vars
+`;
+}
+/**
+ * Common second-level domains that are part of country-code TLDs.
+ * These require three parts for the root domain (e.g., example.co.uk).
+ */
+const MULTI_PART_TLDS = new Set([
+    // UK
+    'co.uk',
+    'org.uk',
+    'me.uk',
+    'ac.uk',
+    // Australia
+    'com.au',
+    'net.au',
+    'org.au',
+    // New Zealand
+    'co.nz',
+    'org.nz',
+    // South Africa
+    'co.za',
+    'org.za',
+    // Brazil
+    'com.br',
+    'org.br',
+    // Japan
+    'co.jp',
+    'or.jp',
+    // India
+    'co.in',
+    'org.in',
+    // Other common ones
+    'com.mx',
+    'com.cn',
+    'com.sg',
+    'com.hk',
+]);
+/**
+ * Extract root domain from a full domain.
+ * Handles both simple TLDs (example.com) and multi-part TLDs (example.co.uk).
+ *
+ * @example
+ * extractRootDomain("docs.example.com") // "example.com"
+ * extractRootDomain("api.docs.example.co.uk") // "example.co.uk"
+ */
+export function extractRootDomain(domain) {
+    const parts = domain.split('.');
+    if (parts.length <= 2) {
+        return domain;
+    }
+    // Check if last two parts form a known multi-part TLD
+    const lastTwo = parts.slice(-2).join('.');
+    if (MULTI_PART_TLDS.has(lastTwo)) {
+        // Return last three parts for multi-part TLDs
+        return parts.slice(-3).join('.');
+    }
+    // Return last two parts for standard TLDs
+    return parts.slice(-2).join('.');
+}
+//# sourceMappingURL=templates.js.map

package/dist/commands/deploy/templates.js.map

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

package/dist/commands/deploy/types.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Types for deploy commands
+ */
+export interface DeployCloudflareOptions {
+    slug?: string;
+    domain?: string;
+    path?: string;
+    outputDir?: string;
+    skipDeploy?: boolean;
+    force?: boolean;
+    yes?: boolean;
+}
+export interface CloudflareConfig {
+    slug: string;
+    domain: string;
+    pathPrefix: string;
+    zoneName: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/commands/deploy/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/commands/deploy/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/commands/deploy/types.js

@@ -0,0 +1,5 @@
+/**
+ * Types for deploy commands
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/commands/deploy/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/commands/deploy/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/commands/dev.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Dev Command
+ *
+ * Runs local development server for documentation preview.
+ * Wraps the dev-project.cjs logic from build-service.
+ */
+export interface DevOptions {
+    port: string;
+    verbose: boolean;
+    webpack?: boolean;
+    clean?: boolean;
+}
+export declare function dev(options: DevOptions): Promise<void>;
+//# sourceMappingURL=dev.d.ts.map

package/dist/commands/dev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/commands/dev.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmBH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAsQD,wBAAsB,GAAG,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAwpB5D"}