offcourse 0.0.1 → 1.0.0

package/src/shared/url.ts

@@ -0,0 +1,57 @@
+/**
+ * Generic URL utilities for parsing and manipulation.
+ */
+
+/**
+ * Extracts the query string from a URL (including the leading ?).
+ * Returns empty string if no query params exist.
+ *
+ * @example
+ * extractQueryParams("https://example.com/path?foo=bar&baz=1")
+ * // => "?foo=bar&baz=1"
+ */
+export function extractQueryParams(url: string): string {
+  const queryStart = url.indexOf("?");
+  return queryStart !== -1 ? url.substring(queryStart) : "";
+}
+
+/**
+ * Gets the base URL (everything up to and including the last slash).
+ * Useful for resolving relative URLs.
+ *
+ * @example
+ * getBaseUrl("https://example.com/videos/playlist.m3u8")
+ * // => "https://example.com/videos/"
+ */
+export function getBaseUrl(url: string): string {
+  return url.substring(0, url.lastIndexOf("/") + 1);
+}
+
+/**
+ * Resolves a potentially relative URI against a base URL.
+ * If the URI is already absolute (starts with http), returns it unchanged.
+ *
+ * @example
+ * resolveUrl("segment001.ts", "https://cdn.example.com/videos/")
+ * // => "https://cdn.example.com/videos/segment001.ts"
+ *
+ * resolveUrl("https://other.com/file.ts", "https://cdn.example.com/videos/")
+ * // => "https://other.com/file.ts"
+ */
+export function resolveUrl(uri: string, baseUrl: string): string {
+  return uri.startsWith("http") ? uri : baseUrl + uri;
+}
+
+/**
+ * Resolves a URI and appends query params for authentication.
+ * Useful for signed URLs where auth tokens need to be preserved.
+ *
+ * @example
+ * resolveUrlWithParams("segment.ts", "https://cdn.com/", "?token=abc")
+ * // => "https://cdn.com/segment.ts?token=abc"
+ */
+export function resolveUrlWithParams(uri: string, baseUrl: string, queryParams: string): string {
+  const resolved = resolveUrl(uri, baseUrl);
+  // Don't add params if URL already has them
+  return resolved.includes("?") ? resolved : resolved + queryParams;
+}

package/src/state/database.test.ts

@@ -0,0 +1,49 @@
+import { describe, expect, it } from "vitest";
+import { extractCommunitySlug } from "./database.js";
+
+describe("extractCommunitySlug", () => {
+  it("extracts slug from standard Skool URL", () => {
+    expect(extractCommunitySlug("https://www.skool.com/my-community")).toBe("my-community");
+  });
+
+  it("extracts slug from Skool URL without www", () => {
+    expect(extractCommunitySlug("https://skool.com/test-group")).toBe("test-group");
+  });
+
+  it("extracts slug from URL with path", () => {
+    expect(extractCommunitySlug("https://www.skool.com/my-community/classroom")).toBe(
+      "my-community"
+    );
+    expect(extractCommunitySlug("https://www.skool.com/my-community/classroom/lessons/123")).toBe(
+      "my-community"
+    );
+  });
+
+  it("extracts slug from URL with query params (includes params in slug)", () => {
+    // Note: current implementation doesn't strip query params
+    expect(extractCommunitySlug("https://www.skool.com/my-community?ref=abc")).toBe(
+      "my-community?ref=abc"
+    );
+  });
+
+  it("handles complex community names", () => {
+    expect(extractCommunitySlug("https://skool.com/the-best-community-ever-2024")).toBe(
+      "the-best-community-ever-2024"
+    );
+  });
+
+  it("returns 'unknown' for non-Skool URLs", () => {
+    expect(extractCommunitySlug("https://example.com/path")).toBe("unknown");
+    expect(extractCommunitySlug("https://youtube.com/channel/abc")).toBe("unknown");
+  });
+
+  it("returns 'unknown' for invalid URLs", () => {
+    expect(extractCommunitySlug("not-a-url")).toBe("unknown");
+    expect(extractCommunitySlug("")).toBe("unknown");
+  });
+
+  it("returns 'unknown' for Skool root URL", () => {
+    expect(extractCommunitySlug("https://www.skool.com/")).toBe("unknown");
+    expect(extractCommunitySlug("https://www.skool.com")).toBe("unknown");
+  });
+});