lobster-cli 0.1.0 → 0.3.0

package/dist/domain-guard.js

@@ -0,0 +1,103 @@
+// src/domain-guard.ts
+var DEFAULT_BLOCK_MESSAGE = "This domain is not allowed by the current configuration.";
+var DomainGuard = class {
+  allow;
+  block;
+  message;
+  matchSubs;
+  constructor(config = {}) {
+    this.allow = (config.allowDomains || []).map((d) => d.toLowerCase().replace(/^www\./, ""));
+    this.block = (config.blockDomains || []).map((d) => d.toLowerCase().replace(/^www\./, ""));
+    this.message = config.blockMessage || DEFAULT_BLOCK_MESSAGE;
+    this.matchSubs = config.matchSubdomains ?? true;
+  }
+  /**
+   * Check if a URL is allowed. Returns true if allowed, throws if blocked.
+   */
+  check(url) {
+    if (this.allow.length === 0 && this.block.length === 0) return true;
+    const domain = this.extractDomain(url);
+    if (!domain) return true;
+    if (this.allow.length > 0) {
+      if (!this.matches(domain, this.allow)) {
+        throw new DomainBlockedError(domain, this.message);
+      }
+      return true;
+    }
+    if (this.block.length > 0) {
+      if (this.matches(domain, this.block)) {
+        throw new DomainBlockedError(domain, this.message);
+      }
+      return true;
+    }
+    return true;
+  }
+  /**
+   * Check without throwing — returns { allowed, domain, message }.
+   */
+  test(url) {
+    const domain = this.extractDomain(url);
+    if (!domain) return { allowed: true, domain: "" };
+    try {
+      this.check(url);
+      return { allowed: true, domain };
+    } catch (err) {
+      if (err instanceof DomainBlockedError) {
+        return { allowed: false, domain, message: err.message };
+      }
+      return { allowed: true, domain };
+    }
+  }
+  /**
+   * Check if domain matches any pattern in the list.
+   */
+  matches(domain, patterns) {
+    for (const pattern of patterns) {
+      if (domain === pattern) return true;
+      if (this.matchSubs && domain.endsWith("." + pattern)) return true;
+    }
+    return false;
+  }
+  /**
+   * Extract domain from URL, stripping www. prefix.
+   */
+  extractDomain(url) {
+    try {
+      const parsed = new URL(url.startsWith("http") ? url : "https://" + url);
+      return parsed.hostname.toLowerCase().replace(/^www\./, "");
+    } catch {
+      return "";
+    }
+  }
+  /**
+   * Whether any restrictions are active.
+   */
+  get isRestricted() {
+    return this.allow.length > 0 || this.block.length > 0;
+  }
+  /**
+   * Get list of allowed domains (empty = all allowed).
+   */
+  get allowedDomains() {
+    return [...this.allow];
+  }
+  /**
+   * Get list of blocked domains.
+   */
+  get blockedDomains() {
+    return [...this.block];
+  }
+};
+var DomainBlockedError = class extends Error {
+  domain;
+  constructor(domain, message) {
+    super(message);
+    this.name = "DomainBlockedError";
+    this.domain = domain;
+  }
+};
+export {
+  DomainBlockedError,
+  DomainGuard
+};
+//# sourceMappingURL=domain-guard.js.map

package/dist/domain-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/domain-guard.ts"],"sourcesContent":["/**\n * Domain Guard — restrict which websites LobsterCLI can operate on.\n *\n * Three modes:\n *   - No config: works on all websites (default)\n *   - allowDomains: whitelist — ONLY these sites work\n *   - blockDomains: blacklist — everything EXCEPT these sites works\n *\n * Usage (library):\n *   import { DomainGuard } from 'lobster-cli'\n *   const guard = new DomainGuard({ allowDomains: ['bloomberg.com', 'yahoo.com'] })\n *   guard.check('https://bloomberg.com/markets')  // → ok\n *   guard.check('https://reddit.com')             // → throws\n *\n * Usage (config):\n *   lobster config set domains.allow \"bloomberg.com,yahoo.com\"\n *   lobster config set domains.blockMessage \"This tool only works on finance sites.\"\n */\n\nexport interface DomainGuardConfig {\n  /** Whitelist — only these domains are allowed. Empty = allow all. */\n  allowDomains?: string[];\n  /** Blacklist — these domains are blocked. Ignored if allowDomains is set. */\n  blockDomains?: string[];\n  /** Custom message shown when a domain is blocked. */\n  blockMessage?: string;\n  /** Allow subdomains to match (e.g., \"yahoo.com\" matches \"finance.yahoo.com\"). Default: true */\n  matchSubdomains?: boolean;\n}\n\nconst DEFAULT_BLOCK_MESSAGE = 'This domain is not allowed by the current configuration.';\n\nexport class DomainGuard {\n  private allow: string[];\n  private block: string[];\n  private message: string;\n  private matchSubs: boolean;\n\n  constructor(config: DomainGuardConfig = {}) {\n    this.allow = (config.allowDomains || []).map(d => d.toLowerCase().replace(/^www\\./, ''));\n    this.block = (config.blockDomains || []).map(d => d.toLowerCase().replace(/^www\\./, ''));\n    this.message = config.blockMessage || DEFAULT_BLOCK_MESSAGE;\n    this.matchSubs = config.matchSubdomains ?? true;\n  }\n\n  /**\n   * Check if a URL is allowed. Returns true if allowed, throws if blocked.\n   */\n  check(url: string): true {\n    // No restrictions configured — allow everything\n    if (this.allow.length === 0 && this.block.length === 0) return true;\n\n    const domain = this.extractDomain(url);\n    if (!domain) return true; // Can't parse = allow (for local files, etc.)\n\n    // Whitelist mode: only allowed domains pass\n    if (this.allow.length > 0) {\n      if (!this.matches(domain, this.allow)) {\n        throw new DomainBlockedError(domain, this.message);\n      }\n      return true;\n    }\n\n    // Blacklist mode: blocked domains fail\n    if (this.block.length > 0) {\n      if (this.matches(domain, this.block)) {\n        throw new DomainBlockedError(domain, this.message);\n      }\n      return true;\n    }\n\n    return true;\n  }\n\n  /**\n   * Check without throwing — returns { allowed, domain, message }.\n   */\n  test(url: string): { allowed: boolean; domain: string; message?: string } {\n    const domain = this.extractDomain(url);\n    if (!domain) return { allowed: true, domain: '' };\n\n    try {\n      this.check(url);\n      return { allowed: true, domain };\n    } catch (err) {\n      if (err instanceof DomainBlockedError) {\n        return { allowed: false, domain, message: err.message };\n      }\n      return { allowed: true, domain };\n    }\n  }\n\n  /**\n   * Check if domain matches any pattern in the list.\n   */\n  private matches(domain: string, patterns: string[]): boolean {\n    for (const pattern of patterns) {\n      if (domain === pattern) return true;\n      if (this.matchSubs && domain.endsWith('.' + pattern)) return true;\n    }\n    return false;\n  }\n\n  /**\n   * Extract domain from URL, stripping www. prefix.\n   */\n  private extractDomain(url: string): string {\n    try {\n      const parsed = new URL(url.startsWith('http') ? url : 'https://' + url);\n      return parsed.hostname.toLowerCase().replace(/^www\\./, '');\n    } catch {\n      return '';\n    }\n  }\n\n  /**\n   * Whether any restrictions are active.\n   */\n  get isRestricted(): boolean {\n    return this.allow.length > 0 || this.block.length > 0;\n  }\n\n  /**\n   * Get list of allowed domains (empty = all allowed).\n   */\n  get allowedDomains(): string[] {\n    return [...this.allow];\n  }\n\n  /**\n   * Get list of blocked domains.\n   */\n  get blockedDomains(): string[] {\n    return [...this.block];\n  }\n}\n\nexport class DomainBlockedError extends Error {\n  public readonly domain: string;\n\n  constructor(domain: string, message: string) {\n    super(message);\n    this.name = 'DomainBlockedError';\n    this.domain = domain;\n  }\n}\n"],"mappings":";AA8BA,IAAM,wBAAwB;AAEvB,IAAM,cAAN,MAAkB;AAAA,EACf;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAER,YAAY,SAA4B,CAAC,GAAG;AAC1C,SAAK,SAAS,OAAO,gBAAgB,CAAC,GAAG,IAAI,OAAK,EAAE,YAAY,EAAE,QAAQ,UAAU,EAAE,CAAC;AACvF,SAAK,SAAS,OAAO,gBAAgB,CAAC,GAAG,IAAI,OAAK,EAAE,YAAY,EAAE,QAAQ,UAAU,EAAE,CAAC;AACvF,SAAK,UAAU,OAAO,gBAAgB;AACtC,SAAK,YAAY,OAAO,mBAAmB;AAAA,EAC7C;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,KAAmB;AAEvB,QAAI,KAAK,MAAM,WAAW,KAAK,KAAK,MAAM,WAAW,EAAG,QAAO;AAE/D,UAAM,SAAS,KAAK,cAAc,GAAG;AACrC,QAAI,CAAC,OAAQ,QAAO;AAGpB,QAAI,KAAK,MAAM,SAAS,GAAG;AACzB,UAAI,CAAC,KAAK,QAAQ,QAAQ,KAAK,KAAK,GAAG;AACrC,cAAM,IAAI,mBAAmB,QAAQ,KAAK,OAAO;AAAA,MACnD;AACA,aAAO;AAAA,IACT;AAGA,QAAI,KAAK,MAAM,SAAS,GAAG;AACzB,UAAI,KAAK,QAAQ,QAAQ,KAAK,KAAK,GAAG;AACpC,cAAM,IAAI,mBAAmB,QAAQ,KAAK,OAAO;AAAA,MACnD;AACA,aAAO;AAAA,IACT;AAEA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKA,KAAK,KAAqE;AACxE,UAAM,SAAS,KAAK,cAAc,GAAG;AACrC,QAAI,CAAC,OAAQ,QAAO,EAAE,SAAS,MAAM,QAAQ,GAAG;AAEhD,QAAI;AACF,WAAK,MAAM,GAAG;AACd,aAAO,EAAE,SAAS,MAAM,OAAO;AAAA,IACjC,SAAS,KAAK;AACZ,UAAI,eAAe,oBAAoB;AACrC,eAAO,EAAE,SAAS,OAAO,QAAQ,SAAS,IAAI,QAAQ;AAAA,MACxD;AACA,aAAO,EAAE,SAAS,MAAM,OAAO;AAAA,IACjC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKQ,QAAQ,QAAgB,UAA6B;AAC3D,eAAW,WAAW,UAAU;AAC9B,UAAI,WAAW,QAAS,QAAO;AAC/B,UAAI,KAAK,aAAa,OAAO,SAAS,MAAM,OAAO,EAAG,QAAO;AAAA,IAC/D;AACA,WAAO;AAAA,EACT;AAAA;AAAA;AAAA;AAAA,EAKQ,cAAc,KAAqB;AACzC,QAAI;AACF,YAAM,SAAS,IAAI,IAAI,IAAI,WAAW,MAAM,IAAI,MAAM,aAAa,GAAG;AACtE,aAAO,OAAO,SAAS,YAAY,EAAE,QAAQ,UAAU,EAAE;AAAA,IAC3D,QAAQ;AACN,aAAO;AAAA,IACT;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,eAAwB;AAC1B,WAAO,KAAK,MAAM,SAAS,KAAK,KAAK,MAAM,SAAS;AAAA,EACtD;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,iBAA2B;AAC7B,WAAO,CAAC,GAAG,KAAK,KAAK;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA,EAKA,IAAI,iBAA2B;AAC7B,WAAO,CAAC,GAAG,KAAK,KAAK;AAAA,EACvB;AACF;AAEO,IAAM,qBAAN,cAAiC,MAAM;AAAA,EAC5B;AAAA,EAEhB,YAAY,QAAgB,SAAiB;AAC3C,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,SAAS;AAAA,EAChB;AACF;","names":[]}