clipr-cli 0.0.5

package/dist/github-OYIAPRKM.js

@@ -0,0 +1,155 @@
+// src/backends/github.ts
+import {
+  appendUtm,
+  DB_VERSION,
+  generateRandomSlug,
+  hasUtm,
+  normalizeSlug,
+  SlugConflictError,
+  SlugNotFoundError
+} from "@clipr/core";
+var GitHubBackend = class {
+  constructor(config, shortBaseUrl) {
+    this.config = config;
+    this.shortBaseUrl = shortBaseUrl;
+    this.apiBase = `https://api.github.com/repos/${config.owner}/${config.repo}/contents/${config.path}`;
+    this.headers = {
+      Authorization: `token ${config.token}`,
+      Accept: "application/vnd.github.v3+json",
+      "Content-Type": "application/json"
+    };
+  }
+  apiBase;
+  headers;
+  /** Fetch the current urls.json from GitHub, returning content + SHA. */
+  async fetchDatabase() {
+    const url = `${this.apiBase}?ref=${this.config.branch}`;
+    const res = await fetch(url, { headers: this.headers });
+    if (res.status === 404) {
+      const db2 = {
+        version: DB_VERSION,
+        counter: 0,
+        baseUrl: this.shortBaseUrl,
+        urls: {}
+      };
+      return { db: db2, sha: "" };
+    }
+    if (!res.ok) {
+      throw new Error(`GitHub API error: ${res.status} ${res.statusText}`);
+    }
+    const data = await res.json();
+    const decoded = Buffer.from(data.content, "base64").toString("utf-8");
+    const db = JSON.parse(decoded);
+    return { db, sha: data.sha };
+  }
+  /** Commit updated urls.json back to GitHub. */
+  async commitDatabase(db, sha, message) {
+    const content = Buffer.from(`${JSON.stringify(db, null, 2)}
+`).toString("base64");
+    const body = {
+      message,
+      content,
+      branch: this.config.branch
+    };
+    if (sha) {
+      body.sha = sha;
+    }
+    const res = await fetch(this.apiBase, {
+      method: "PUT",
+      headers: this.headers,
+      body: JSON.stringify(body)
+    });
+    if (!res.ok) {
+      const errBody = await res.text();
+      throw new Error(`GitHub API commit failed: ${res.status} ${res.statusText} \u2014 ${errBody}`);
+    }
+  }
+  async create(slug, targetUrl, options) {
+    const { db, sha } = await this.fetchDatabase();
+    const finalSlug = normalizeSlug(slug || generateRandomSlug());
+    if (db.urls[finalSlug]) {
+      throw new SlugConflictError(finalSlug);
+    }
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const entry = {
+      slug: finalSlug,
+      url: targetUrl,
+      createdAt: now,
+      ...options?.description && { description: options.description },
+      ...options?.expiresAt && { expiresAt: options.expiresAt },
+      ...options?.utm && hasUtm(options.utm) && { utm: options.utm },
+      ...options?.tags && { tags: options.tags },
+      ...options?.ogTitle && { ogTitle: options.ogTitle },
+      ...options?.ogDescription && { ogDescription: options.ogDescription },
+      ...options?.ogImage && { ogImage: options.ogImage }
+    };
+    db.urls[finalSlug] = entry;
+    db.counter = Object.keys(db.urls).length;
+    await this.commitDatabase(db, sha, `clipr: add ${finalSlug} \u2192 ${targetUrl}`);
+    return entry;
+  }
+  async resolve(slug) {
+    const { db } = await this.fetchDatabase();
+    const entry = db.urls[slug];
+    if (!entry) return null;
+    const expired = entry.expiresAt ? new Date(entry.expiresAt) < /* @__PURE__ */ new Date() : false;
+    const url = hasUtm(entry.utm) ? appendUtm(entry.url, entry.utm) : entry.url;
+    return { url, passwordProtected: false, expired };
+  }
+  async list(options) {
+    const { db } = await this.fetchDatabase();
+    let entries = Object.values(db.urls);
+    if (options?.search) {
+      const q = options.search.toLowerCase();
+      entries = entries.filter(
+        (e) => e.slug.includes(q) || e.url.toLowerCase().includes(q) || e.description?.toLowerCase().includes(q)
+      );
+    }
+    if (options?.tag) {
+      entries = entries.filter((e) => e.tags?.includes(options.tag));
+    }
+    if (options?.limit) {
+      entries = entries.slice(0, options.limit);
+    }
+    return entries;
+  }
+  async delete(slug) {
+    const { db, sha } = await this.fetchDatabase();
+    if (!db.urls[slug]) {
+      throw new SlugNotFoundError(slug);
+    }
+    delete db.urls[slug];
+    db.counter = Object.keys(db.urls).length;
+    await this.commitDatabase(db, sha, `clipr: delete ${slug}`);
+  }
+  async update(slug, updates) {
+    const { db, sha } = await this.fetchDatabase();
+    const existing = db.urls[slug];
+    if (!existing) {
+      throw new SlugNotFoundError(slug);
+    }
+    const newSlug = updates.slug ?? slug;
+    if (newSlug !== slug) {
+      if (db.urls[newSlug]) {
+        throw new SlugConflictError(newSlug);
+      }
+      delete db.urls[slug];
+    }
+    const updated = { ...existing, ...updates, slug: newSlug };
+    db.urls[newSlug] = updated;
+    db.counter = Object.keys(db.urls).length;
+    await this.commitDatabase(
+      db,
+      sha,
+      `clipr: update ${slug}${newSlug !== slug ? ` \u2192 ${newSlug}` : ""}`
+    );
+    return updated;
+  }
+  async getStats(_slug) {
+    return null;
+  }
+};
+export {
+  GitHubBackend
+};
+//# sourceMappingURL=github-OYIAPRKM.js.map

package/dist/github-OYIAPRKM.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/backends/github.ts"],"sourcesContent":["import type {\n  CreateOptions,\n  LinkStats,\n  ListOptions,\n  ResolveResult,\n  ShortUrl,\n  UrlBackend,\n  UrlDatabase,\n} from '@clipr/core';\nimport {\n  appendUtm,\n  DB_VERSION,\n  generateRandomSlug,\n  hasUtm,\n  normalizeSlug,\n  SlugConflictError,\n  SlugNotFoundError,\n} from '@clipr/core';\n\ninterface GitHubConfig {\n  owner: string;\n  repo: string;\n  branch: string;\n  path: string;\n  token: string;\n}\n\ninterface GitHubContentsResponse {\n  sha: string;\n  content: string;\n  encoding: string;\n}\n\n/**\n * UrlBackend implementation using the GitHub Contents API.\n * Stores all URL data in a urls.json file in a GitHub repo.\n */\nexport class GitHubBackend implements UrlBackend {\n  private readonly apiBase: string;\n  private readonly headers: Record<string, string>;\n\n  constructor(\n    private readonly config: GitHubConfig,\n    private readonly shortBaseUrl: string,\n  ) {\n    this.apiBase = `https://api.github.com/repos/${config.owner}/${config.repo}/contents/${config.path}`;\n    this.headers = {\n      Authorization: `token ${config.token}`,\n      Accept: 'application/vnd.github.v3+json',\n      'Content-Type': 'application/json',\n    };\n  }\n\n  /** Fetch the current urls.json from GitHub, returning content + SHA. */\n  private async fetchDatabase(): Promise<{ db: UrlDatabase; sha: string }> {\n    const url = `${this.apiBase}?ref=${this.config.branch}`;\n    const res = await fetch(url, { headers: this.headers });\n\n    if (res.status === 404) {\n      // File doesn't exist yet, return empty database\n      const db: UrlDatabase = {\n        version: DB_VERSION,\n        counter: 0,\n        baseUrl: this.shortBaseUrl,\n        urls: {},\n      };\n      return { db, sha: '' };\n    }\n\n    if (!res.ok) {\n      throw new Error(`GitHub API error: ${res.status} ${res.statusText}`);\n    }\n\n    const data = (await res.json()) as GitHubContentsResponse;\n    const decoded = Buffer.from(data.content, 'base64').toString('utf-8');\n    const db = JSON.parse(decoded) as UrlDatabase;\n\n    return { db, sha: data.sha };\n  }\n\n  /** Commit updated urls.json back to GitHub. */\n  private async commitDatabase(db: UrlDatabase, sha: string, message: string): Promise<void> {\n    const content = Buffer.from(`${JSON.stringify(db, null, 2)}\\n`).toString('base64');\n\n    const body: Record<string, string> = {\n      message,\n      content,\n      branch: this.config.branch,\n    };\n\n    // Include SHA for updates (not for creation)\n    if (sha) {\n      body.sha = sha;\n    }\n\n    const res = await fetch(this.apiBase, {\n      method: 'PUT',\n      headers: this.headers,\n      body: JSON.stringify(body),\n    });\n\n    if (!res.ok) {\n      const errBody = await res.text();\n      throw new Error(`GitHub API commit failed: ${res.status} ${res.statusText} — ${errBody}`);\n    }\n  }\n\n  async create(slug: string, targetUrl: string, options?: CreateOptions): Promise<ShortUrl> {\n    const { db, sha } = await this.fetchDatabase();\n    const finalSlug = normalizeSlug(slug || generateRandomSlug());\n\n    if (db.urls[finalSlug]) {\n      throw new SlugConflictError(finalSlug);\n    }\n\n    const now = new Date().toISOString();\n    const entry: ShortUrl = {\n      slug: finalSlug,\n      url: targetUrl,\n      createdAt: now,\n      ...(options?.description && { description: options.description }),\n      ...(options?.expiresAt && { expiresAt: options.expiresAt }),\n      ...(options?.utm && hasUtm(options.utm) && { utm: options.utm }),\n      ...(options?.tags && { tags: options.tags }),\n      ...(options?.ogTitle && { ogTitle: options.ogTitle }),\n      ...(options?.ogDescription && { ogDescription: options.ogDescription }),\n      ...(options?.ogImage && { ogImage: options.ogImage }),\n    };\n\n    db.urls[finalSlug] = entry;\n    db.counter = Object.keys(db.urls).length;\n\n    await this.commitDatabase(db, sha, `clipr: add ${finalSlug} → ${targetUrl}`);\n    return entry;\n  }\n\n  async resolve(slug: string): Promise<ResolveResult | null> {\n    const { db } = await this.fetchDatabase();\n    const entry = db.urls[slug];\n    if (!entry) return null;\n\n    const expired = entry.expiresAt ? new Date(entry.expiresAt) < new Date() : false;\n    const url = hasUtm(entry.utm) ? appendUtm(entry.url, entry.utm!) : entry.url;\n\n    return { url, passwordProtected: false, expired };\n  }\n\n  async list(options?: ListOptions): Promise<ShortUrl[]> {\n    const { db } = await this.fetchDatabase();\n    let entries = Object.values(db.urls) as ShortUrl[];\n\n    if (options?.search) {\n      const q = options.search.toLowerCase();\n      entries = entries.filter(\n        (e) =>\n          e.slug.includes(q) ||\n          e.url.toLowerCase().includes(q) ||\n          e.description?.toLowerCase().includes(q),\n      );\n    }\n\n    if (options?.tag) {\n      entries = entries.filter((e) => e.tags?.includes(options.tag!));\n    }\n\n    if (options?.limit) {\n      entries = entries.slice(0, options.limit);\n    }\n\n    return entries;\n  }\n\n  async delete(slug: string): Promise<void> {\n    const { db, sha } = await this.fetchDatabase();\n\n    if (!db.urls[slug]) {\n      throw new SlugNotFoundError(slug);\n    }\n\n    delete db.urls[slug];\n    db.counter = Object.keys(db.urls).length;\n\n    await this.commitDatabase(db, sha, `clipr: delete ${slug}`);\n  }\n\n  async update(slug: string, updates: Partial<ShortUrl>): Promise<ShortUrl> {\n    const { db, sha } = await this.fetchDatabase();\n    const existing = db.urls[slug];\n\n    if (!existing) {\n      throw new SlugNotFoundError(slug);\n    }\n\n    const newSlug = updates.slug ?? slug;\n\n    // If renaming, check for conflict and remove old entry\n    if (newSlug !== slug) {\n      if (db.urls[newSlug]) {\n        throw new SlugConflictError(newSlug);\n      }\n      delete db.urls[slug];\n    }\n\n    const updated: ShortUrl = { ...existing, ...updates, slug: newSlug };\n    db.urls[newSlug] = updated;\n    db.counter = Object.keys(db.urls).length;\n\n    await this.commitDatabase(\n      db,\n      sha,\n      `clipr: update ${slug}${newSlug !== slug ? ` → ${newSlug}` : ''}`,\n    );\n    return updated;\n  }\n\n  async getStats(_slug: string): Promise<LinkStats | null> {\n    // GitHub mode has no click tracking\n    return null;\n  }\n}\n"],"mappings":"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","names":["db"]}

package/dist/github-PSGU4YYI.js

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+
+// src/backends/github.ts
+import {
+  appendUtm,
+  DB_VERSION,
+  generateRandomSlug,
+  hasUtm,
+  normalizeSlug,
+  SlugConflictError,
+  SlugNotFoundError
+} from "@clipr/core";
+var GitHubBackend = class {
+  constructor(config, shortBaseUrl) {
+    this.config = config;
+    this.shortBaseUrl = shortBaseUrl;
+    this.apiBase = `https://api.github.com/repos/${config.owner}/${config.repo}/contents/${config.path}`;
+    this.headers = {
+      Authorization: `token ${config.token}`,
+      Accept: "application/vnd.github.v3+json",
+      "Content-Type": "application/json"
+    };
+  }
+  apiBase;
+  headers;
+  /** Fetch the current urls.json from GitHub, returning content + SHA. */
+  async fetchDatabase() {
+    const url = `${this.apiBase}?ref=${this.config.branch}`;
+    const res = await fetch(url, { headers: this.headers });
+    if (res.status === 404) {
+      const db2 = {
+        version: DB_VERSION,
+        counter: 0,
+        baseUrl: this.shortBaseUrl,
+        urls: {}
+      };
+      return { db: db2, sha: "" };
+    }
+    if (!res.ok) {
+      throw new Error(`GitHub API error: ${res.status} ${res.statusText}`);
+    }
+    const data = await res.json();
+    const decoded = Buffer.from(data.content, "base64").toString("utf-8");
+    const db = JSON.parse(decoded);
+    return { db, sha: data.sha };
+  }
+  /** Commit updated urls.json back to GitHub. */
+  async commitDatabase(db, sha, message) {
+    const content = Buffer.from(`${JSON.stringify(db, null, 2)}
+`).toString("base64");
+    const body = {
+      message,
+      content,
+      branch: this.config.branch
+    };
+    if (sha) {
+      body.sha = sha;
+    }
+    const res = await fetch(this.apiBase, {
+      method: "PUT",
+      headers: this.headers,
+      body: JSON.stringify(body)
+    });
+    if (!res.ok) {
+      const errBody = await res.text();
+      throw new Error(`GitHub API commit failed: ${res.status} ${res.statusText} \u2014 ${errBody}`);
+    }
+  }
+  async create(slug, targetUrl, options) {
+    const { db, sha } = await this.fetchDatabase();
+    const finalSlug = normalizeSlug(slug || generateRandomSlug());
+    if (db.urls[finalSlug]) {
+      throw new SlugConflictError(finalSlug);
+    }
+    const now = (/* @__PURE__ */ new Date()).toISOString();
+    const entry = {
+      slug: finalSlug,
+      url: targetUrl,
+      createdAt: now,
+      ...options?.description && { description: options.description },
+      ...options?.expiresAt && { expiresAt: options.expiresAt },
+      ...options?.utm && hasUtm(options.utm) && { utm: options.utm },
+      ...options?.tags && { tags: options.tags },
+      ...options?.ogTitle && { ogTitle: options.ogTitle },
+      ...options?.ogDescription && { ogDescription: options.ogDescription },
+      ...options?.ogImage && { ogImage: options.ogImage }
+    };
+    db.urls[finalSlug] = entry;
+    db.counter = Object.keys(db.urls).length;
+    await this.commitDatabase(db, sha, `clipr: add ${finalSlug} \u2192 ${targetUrl}`);
+    return entry;
+  }
+  async resolve(slug) {
+    const { db } = await this.fetchDatabase();
+    const entry = db.urls[slug];
+    if (!entry) return null;
+    const expired = entry.expiresAt ? new Date(entry.expiresAt) < /* @__PURE__ */ new Date() : false;
+    const url = hasUtm(entry.utm) ? appendUtm(entry.url, entry.utm) : entry.url;
+    return { url, passwordProtected: false, expired };
+  }
+  async list(options) {
+    const { db } = await this.fetchDatabase();
+    let entries = Object.values(db.urls);
+    if (options?.search) {
+      const q = options.search.toLowerCase();
+      entries = entries.filter(
+        (e) => e.slug.includes(q) || e.url.toLowerCase().includes(q) || e.description?.toLowerCase().includes(q)
+      );
+    }
+    if (options?.tag) {
+      entries = entries.filter((e) => e.tags?.includes(options.tag));
+    }
+    if (options?.limit) {
+      entries = entries.slice(0, options.limit);
+    }
+    return entries;
+  }
+  async delete(slug) {
+    const { db, sha } = await this.fetchDatabase();
+    if (!db.urls[slug]) {
+      throw new SlugNotFoundError(slug);
+    }
+    delete db.urls[slug];
+    db.counter = Object.keys(db.urls).length;
+    await this.commitDatabase(db, sha, `clipr: delete ${slug}`);
+  }
+  async update(slug, updates) {
+    const { db, sha } = await this.fetchDatabase();
+    const existing = db.urls[slug];
+    if (!existing) {
+      throw new SlugNotFoundError(slug);
+    }
+    const newSlug = updates.slug ?? slug;
+    if (newSlug !== slug) {
+      if (db.urls[newSlug]) {
+        throw new SlugConflictError(newSlug);
+      }
+      delete db.urls[slug];
+    }
+    const updated = { ...existing, ...updates, slug: newSlug };
+    db.urls[newSlug] = updated;
+    db.counter = Object.keys(db.urls).length;
+    await this.commitDatabase(
+      db,
+      sha,
+      `clipr: update ${slug}${newSlug !== slug ? ` \u2192 ${newSlug}` : ""}`
+    );
+    return updated;
+  }
+  async getStats(_slug) {
+    return null;
+  }
+};
+export {
+  GitHubBackend
+};
+//# sourceMappingURL=github-PSGU4YYI.js.map

package/dist/github-PSGU4YYI.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/backends/github.ts"],"sourcesContent":["import type {\n  CreateOptions,\n  LinkStats,\n  ListOptions,\n  ResolveResult,\n  ShortUrl,\n  UrlBackend,\n  UrlDatabase,\n} from '@clipr/core';\nimport {\n  appendUtm,\n  DB_VERSION,\n  generateRandomSlug,\n  hasUtm,\n  normalizeSlug,\n  SlugConflictError,\n  SlugNotFoundError,\n} from '@clipr/core';\n\ninterface GitHubConfig {\n  owner: string;\n  repo: string;\n  branch: string;\n  path: string;\n  token: string;\n}\n\ninterface GitHubContentsResponse {\n  sha: string;\n  content: string;\n  encoding: string;\n}\n\n/**\n * UrlBackend implementation using the GitHub Contents API.\n * Stores all URL data in a urls.json file in a GitHub repo.\n */\nexport class GitHubBackend implements UrlBackend {\n  private readonly apiBase: string;\n  private readonly headers: Record<string, string>;\n\n  constructor(\n    private readonly config: GitHubConfig,\n    private readonly shortBaseUrl: string,\n  ) {\n    this.apiBase = `https://api.github.com/repos/${config.owner}/${config.repo}/contents/${config.path}`;\n    this.headers = {\n      Authorization: `token ${config.token}`,\n      Accept: 'application/vnd.github.v3+json',\n      'Content-Type': 'application/json',\n    };\n  }\n\n  /** Fetch the current urls.json from GitHub, returning content + SHA. */\n  private async fetchDatabase(): Promise<{ db: UrlDatabase; sha: string }> {\n    const url = `${this.apiBase}?ref=${this.config.branch}`;\n    const res = await fetch(url, { headers: this.headers });\n\n    if (res.status === 404) {\n      // File doesn't exist yet, return empty database\n      const db: UrlDatabase = {\n        version: DB_VERSION,\n        counter: 0,\n        baseUrl: this.shortBaseUrl,\n        urls: {},\n      };\n      return { db, sha: '' };\n    }\n\n    if (!res.ok) {\n      throw new Error(`GitHub API error: ${res.status} ${res.statusText}`);\n    }\n\n    const data = (await res.json()) as GitHubContentsResponse;\n    const decoded = Buffer.from(data.content, 'base64').toString('utf-8');\n    const db = JSON.parse(decoded) as UrlDatabase;\n\n    return { db, sha: data.sha };\n  }\n\n  /** Commit updated urls.json back to GitHub. */\n  private async commitDatabase(db: UrlDatabase, sha: string, message: string): Promise<void> {\n    const content = Buffer.from(`${JSON.stringify(db, null, 2)}\\n`).toString('base64');\n\n    const body: Record<string, string> = {\n      message,\n      content,\n      branch: this.config.branch,\n    };\n\n    // Include SHA for updates (not for creation)\n    if (sha) {\n      body.sha = sha;\n    }\n\n    const res = await fetch(this.apiBase, {\n      method: 'PUT',\n      headers: this.headers,\n      body: JSON.stringify(body),\n    });\n\n    if (!res.ok) {\n      const errBody = await res.text();\n      throw new Error(`GitHub API commit failed: ${res.status} ${res.statusText} — ${errBody}`);\n    }\n  }\n\n  async create(slug: string, targetUrl: string, options?: CreateOptions): Promise<ShortUrl> {\n    const { db, sha } = await this.fetchDatabase();\n    const finalSlug = normalizeSlug(slug || generateRandomSlug());\n\n    if (db.urls[finalSlug]) {\n      throw new SlugConflictError(finalSlug);\n    }\n\n    const now = new Date().toISOString();\n    const entry: ShortUrl = {\n      slug: finalSlug,\n      url: targetUrl,\n      createdAt: now,\n      ...(options?.description && { description: options.description }),\n      ...(options?.expiresAt && { expiresAt: options.expiresAt }),\n      ...(options?.utm && hasUtm(options.utm) && { utm: options.utm }),\n      ...(options?.tags && { tags: options.tags }),\n      ...(options?.ogTitle && { ogTitle: options.ogTitle }),\n      ...(options?.ogDescription && { ogDescription: options.ogDescription }),\n      ...(options?.ogImage && { ogImage: options.ogImage }),\n    };\n\n    db.urls[finalSlug] = entry;\n    db.counter = Object.keys(db.urls).length;\n\n    await this.commitDatabase(db, sha, `clipr: add ${finalSlug} → ${targetUrl}`);\n    return entry;\n  }\n\n  async resolve(slug: string): Promise<ResolveResult | null> {\n    const { db } = await this.fetchDatabase();\n    const entry = db.urls[slug];\n    if (!entry) return null;\n\n    const expired = entry.expiresAt ? new Date(entry.expiresAt) < new Date() : false;\n    const url = hasUtm(entry.utm) ? appendUtm(entry.url, entry.utm!) : entry.url;\n\n    return { url, passwordProtected: false, expired };\n  }\n\n  async list(options?: ListOptions): Promise<ShortUrl[]> {\n    const { db } = await this.fetchDatabase();\n    let entries = Object.values(db.urls) as ShortUrl[];\n\n    if (options?.search) {\n      const q = options.search.toLowerCase();\n      entries = entries.filter(\n        (e) =>\n          e.slug.includes(q) ||\n          e.url.toLowerCase().includes(q) ||\n          e.description?.toLowerCase().includes(q),\n      );\n    }\n\n    if (options?.tag) {\n      entries = entries.filter((e) => e.tags?.includes(options.tag!));\n    }\n\n    if (options?.limit) {\n      entries = entries.slice(0, options.limit);\n    }\n\n    return entries;\n  }\n\n  async delete(slug: string): Promise<void> {\n    const { db, sha } = await this.fetchDatabase();\n\n    if (!db.urls[slug]) {\n      throw new SlugNotFoundError(slug);\n    }\n\n    delete db.urls[slug];\n    db.counter = Object.keys(db.urls).length;\n\n    await this.commitDatabase(db, sha, `clipr: delete ${slug}`);\n  }\n\n  async update(slug: string, updates: Partial<ShortUrl>): Promise<ShortUrl> {\n    const { db, sha } = await this.fetchDatabase();\n    const existing = db.urls[slug];\n\n    if (!existing) {\n      throw new SlugNotFoundError(slug);\n    }\n\n    const newSlug = updates.slug ?? slug;\n\n    // If renaming, check for conflict and remove old entry\n    if (newSlug !== slug) {\n      if (db.urls[newSlug]) {\n        throw new SlugConflictError(newSlug);\n      }\n      delete db.urls[slug];\n    }\n\n    const updated: ShortUrl = { ...existing, ...updates, slug: newSlug };\n    db.urls[newSlug] = updated;\n    db.counter = Object.keys(db.urls).length;\n\n    await this.commitDatabase(\n      db,\n      sha,\n      `clipr: update ${slug}${newSlug !== slug ? ` → ${newSlug}` : ''}`,\n    );\n    return updated;\n  }\n\n  async getStats(_slug: string): Promise<LinkStats | null> {\n    // GitHub mode has no click tracking\n    return null;\n  }\n}\n"],"mappings":";;;AASA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAoBA,IAAM,gBAAN,MAA0C;AAAA,EAI/C,YACmB,QACA,cACjB;AAFiB;AACA;AAEjB,SAAK,UAAU,gCAAgC,OAAO,KAAK,IAAI,OAAO,IAAI,aAAa,OAAO,IAAI;AAClG,SAAK,UAAU;AAAA,MACb,eAAe,SAAS,OAAO,KAAK;AAAA,MACpC,QAAQ;AAAA,MACR,gBAAgB;AAAA,IAClB;AAAA,EACF;AAAA,EAbiB;AAAA,EACA;AAAA;AAAA,EAejB,MAAc,gBAA2D;AACvE,UAAM,MAAM,GAAG,KAAK,OAAO,QAAQ,KAAK,OAAO,MAAM;AACrD,UAAM,MAAM,MAAM,MAAM,KAAK,EAAE,SAAS,KAAK,QAAQ,CAAC;AAEtD,QAAI,IAAI,WAAW,KAAK;AAEtB,YAAMA,MAAkB;AAAA,QACtB,SAAS;AAAA,QACT,SAAS;AAAA,QACT,SAAS,KAAK;AAAA,QACd,MAAM,CAAC;AAAA,MACT;AACA,aAAO,EAAE,IAAAA,KAAI,KAAK,GAAG;AAAA,IACvB;AAEA,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,IAAI,MAAM,qBAAqB,IAAI,MAAM,IAAI,IAAI,UAAU,EAAE;AAAA,IACrE;AAEA,UAAM,OAAQ,MAAM,IAAI,KAAK;AAC7B,UAAM,UAAU,OAAO,KAAK,KAAK,SAAS,QAAQ,EAAE,SAAS,OAAO;AACpE,UAAM,KAAK,KAAK,MAAM,OAAO;AAE7B,WAAO,EAAE,IAAI,KAAK,KAAK,IAAI;AAAA,EAC7B;AAAA;AAAA,EAGA,MAAc,eAAe,IAAiB,KAAa,SAAgC;AACzF,UAAM,UAAU,OAAO,KAAK,GAAG,KAAK,UAAU,IAAI,MAAM,CAAC,CAAC;AAAA,CAAI,EAAE,SAAS,QAAQ;AAEjF,UAAM,OAA+B;AAAA,MACnC;AAAA,MACA;AAAA,MACA,QAAQ,KAAK,OAAO;AAAA,IACtB;AAGA,QAAI,KAAK;AACP,WAAK,MAAM;AAAA,IACb;AAEA,UAAM,MAAM,MAAM,MAAM,KAAK,SAAS;AAAA,MACpC,QAAQ;AAAA,MACR,SAAS,KAAK;AAAA,MACd,MAAM,KAAK,UAAU,IAAI;AAAA,IAC3B,CAAC;AAED,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,UAAU,MAAM,IAAI,KAAK;AAC/B,YAAM,IAAI,MAAM,6BAA6B,IAAI,MAAM,IAAI,IAAI,UAAU,WAAM,OAAO,EAAE;AAAA,IAC1F;AAAA,EACF;AAAA,EAEA,MAAM,OAAO,MAAc,WAAmB,SAA4C;AACxF,UAAM,EAAE,IAAI,IAAI,IAAI,MAAM,KAAK,cAAc;AAC7C,UAAM,YAAY,cAAc,QAAQ,mBAAmB,CAAC;AAE5D,QAAI,GAAG,KAAK,SAAS,GAAG;AACtB,YAAM,IAAI,kBAAkB,SAAS;AAAA,IACvC;AAEA,UAAM,OAAM,oBAAI,KAAK,GAAE,YAAY;AACnC,UAAM,QAAkB;AAAA,MACtB,MAAM;AAAA,MACN,KAAK;AAAA,MACL,WAAW;AAAA,MACX,GAAI,SAAS,eAAe,EAAE,aAAa,QAAQ,YAAY;AAAA,MAC/D,GAAI,SAAS,aAAa,EAAE,WAAW,QAAQ,UAAU;AAAA,MACzD,GAAI,SAAS,OAAO,OAAO,QAAQ,GAAG,KAAK,EAAE,KAAK,QAAQ,IAAI;AAAA,MAC9D,GAAI,SAAS,QAAQ,EAAE,MAAM,QAAQ,KAAK;AAAA,MAC1C,GAAI,SAAS,WAAW,EAAE,SAAS,QAAQ,QAAQ;AAAA,MACnD,GAAI,SAAS,iBAAiB,EAAE,eAAe,QAAQ,cAAc;AAAA,MACrE,GAAI,SAAS,WAAW,EAAE,SAAS,QAAQ,QAAQ;AAAA,IACrD;AAEA,OAAG,KAAK,SAAS,IAAI;AACrB,OAAG,UAAU,OAAO,KAAK,GAAG,IAAI,EAAE;AAElC,UAAM,KAAK,eAAe,IAAI,KAAK,cAAc,SAAS,WAAM,SAAS,EAAE;AAC3E,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,QAAQ,MAA6C;AACzD,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,cAAc;AACxC,UAAM,QAAQ,GAAG,KAAK,IAAI;AAC1B,QAAI,CAAC,MAAO,QAAO;AAEnB,UAAM,UAAU,MAAM,YAAY,IAAI,KAAK,MAAM,SAAS,IAAI,oBAAI,KAAK,IAAI;AAC3E,UAAM,MAAM,OAAO,MAAM,GAAG,IAAI,UAAU,MAAM,KAAK,MAAM,GAAI,IAAI,MAAM;AAEzE,WAAO,EAAE,KAAK,mBAAmB,OAAO,QAAQ;AAAA,EAClD;AAAA,EAEA,MAAM,KAAK,SAA4C;AACrD,UAAM,EAAE,GAAG,IAAI,MAAM,KAAK,cAAc;AACxC,QAAI,UAAU,OAAO,OAAO,GAAG,IAAI;AAEnC,QAAI,SAAS,QAAQ;AACnB,YAAM,IAAI,QAAQ,OAAO,YAAY;AACrC,gBAAU,QAAQ;AAAA,QAChB,CAAC,MACC,EAAE,KAAK,SAAS,CAAC,KACjB,EAAE,IAAI,YAAY,EAAE,SAAS,CAAC,KAC9B,EAAE,aAAa,YAAY,EAAE,SAAS,CAAC;AAAA,MAC3C;AAAA,IACF;AAEA,QAAI,SAAS,KAAK;AAChB,gBAAU,QAAQ,OAAO,CAAC,MAAM,EAAE,MAAM,SAAS,QAAQ,GAAI,CAAC;AAAA,IAChE;AAEA,QAAI,SAAS,OAAO;AAClB,gBAAU,QAAQ,MAAM,GAAG,QAAQ,KAAK;AAAA,IAC1C;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,OAAO,MAA6B;AACxC,UAAM,EAAE,IAAI,IAAI,IAAI,MAAM,KAAK,cAAc;AAE7C,QAAI,CAAC,GAAG,KAAK,IAAI,GAAG;AAClB,YAAM,IAAI,kBAAkB,IAAI;AAAA,IAClC;AAEA,WAAO,GAAG,KAAK,IAAI;AACnB,OAAG,UAAU,OAAO,KAAK,GAAG,IAAI,EAAE;AAElC,UAAM,KAAK,eAAe,IAAI,KAAK,iBAAiB,IAAI,EAAE;AAAA,EAC5D;AAAA,EAEA,MAAM,OAAO,MAAc,SAA+C;AACxE,UAAM,EAAE,IAAI,IAAI,IAAI,MAAM,KAAK,cAAc;AAC7C,UAAM,WAAW,GAAG,KAAK,IAAI;AAE7B,QAAI,CAAC,UAAU;AACb,YAAM,IAAI,kBAAkB,IAAI;AAAA,IAClC;AAEA,UAAM,UAAU,QAAQ,QAAQ;AAGhC,QAAI,YAAY,MAAM;AACpB,UAAI,GAAG,KAAK,OAAO,GAAG;AACpB,cAAM,IAAI,kBAAkB,OAAO;AAAA,MACrC;AACA,aAAO,GAAG,KAAK,IAAI;AAAA,IACrB;AAEA,UAAM,UAAoB,EAAE,GAAG,UAAU,GAAG,SAAS,MAAM,QAAQ;AACnE,OAAG,KAAK,OAAO,IAAI;AACnB,OAAG,UAAU,OAAO,KAAK,GAAG,IAAI,EAAE;AAElC,UAAM,KAAK;AAAA,MACT;AAAA,MACA;AAAA,MACA,iBAAiB,IAAI,GAAG,YAAY,OAAO,WAAM,OAAO,KAAK,EAAE;AAAA,IACjE;AACA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,SAAS,OAA0C;AAEvD,WAAO;AAAA,EACT;AACF;","names":["db"]}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }