@hasna/shortlinks 0.1.11 → 0.1.13

package/dist/pg-migrate.d.ts

@@ -0,0 +1,7 @@
+export interface PgMigrationResult {
+    applied: number[];
+    alreadyApplied: number[];
+    errors: string[];
+    totalMigrations: number;
+}
+export declare function applyPgMigrations(connectionString: string): Promise<PgMigrationResult>;

package/dist/pg-store.d.ts

@@ -9,7 +9,8 @@ export declare class PgShortlinksStore {
     private readonly pg;
     constructor(pg: PgAdapterLike);
     static fromConnectionString(connectionString: string): Promise<PgShortlinksStore>;
-    static fromCloud(service?: string): Promise<PgShortlinksStore>;
+    static fromStorage(service?: string): Promise<PgShortlinksStore>;
+    static fromCloud: typeof PgShortlinksStore.fromStorage;
     close(): Promise<void>;
     addDomain(input: AddDomainInput): Promise<Domain>;
     listDomains(): Promise<Domain[]>;

package/dist/remote-storage.d.ts

@@ -0,0 +1,11 @@
+export declare class PgAdapterAsync {
+    private readonly pool;
+    constructor(connectionString: string);
+    run(sql: string, ...params: unknown[]): Promise<{
+        changes: number;
+    }>;
+    get(sql: string, ...params: unknown[]): Promise<unknown>;
+    all(sql: string, ...params: unknown[]): Promise<unknown[]>;
+    exec(sql: string): Promise<void>;
+    close(): Promise<void>;
+}

package/dist/server.d.ts

@@ -17,6 +17,7 @@ export interface ShortlinksHandlerOptions {
     dbPath?: string;
     defaultHost?: string;
     redirectStatus?: 301 | 302 | 307 | 308;
+    reservedPathPrefixes?: string[];
 }
 export declare function createShortlinksHandler(options?: ShortlinksHandlerOptions): (request: Request) => Response | Promise<Response>;
 export declare function serveShortlinks(options?: ShortlinksHandlerOptions & {

package/dist/server.js

@@ -555,6 +555,7 @@ function isExpired(link) {
 function createShortlinksHandler(options = {}) {
   const store = options.store || new ShortlinksStore(options.dbPath);
   const redirectStatus = options.redirectStatus || 302;
+  const reservedPathPrefixes = new Set((options.reservedPathPrefixes ?? ["a"]).map((prefix) => prefix.toLowerCase()));
   return async (request) => {
     const url = new URL(request.url);
     if (url.pathname === "/healthz") {
@@ -571,6 +572,9 @@ function createShortlinksHandler(options = {}) {
     }
     if (!slug)
       return json({ error: "Missing slug." }, 404);
+    if (reservedPathPrefixes.has(slug.toLowerCase())) {
+      return json({ error: "Reserved path prefix.", slug }, 404);
+    }
     const host = getHost(request, options.defaultHost);
     if (!host)
       return json({ error: "Missing Host header." }, 400);

package/dist/storage-config.d.ts

@@ -0,0 +1,37 @@
+export type StorageMode = "local" | "remote" | "hybrid";
+export interface StorageConfig {
+    mode: StorageMode;
+    rds: {
+        host: string;
+        port: number;
+        username: string;
+        password_env: string;
+        ssl: boolean;
+    };
+}
+export interface StorageEnv {
+    name: string;
+}
+export declare const SHORTLINKS_STORAGE_ENV = "HASNA_SHORTLINKS_DATABASE_URL";
+export declare const SHORTLINKS_STORAGE_FALLBACK_ENV = "SHORTLINKS_DATABASE_URL";
+export declare const SHORTLINKS_STORAGE_MODE_ENV = "HASNA_SHORTLINKS_STORAGE_MODE";
+export declare const SHORTLINKS_STORAGE_MODE_FALLBACK_ENV = "SHORTLINKS_STORAGE_MODE";
+export declare const STORAGE_DATABASE_ENV: readonly ["HASNA_SHORTLINKS_DATABASE_URL", "SHORTLINKS_DATABASE_URL"];
+export declare const STORAGE_MODE_ENV: readonly ["HASNA_SHORTLINKS_STORAGE_MODE", "SHORTLINKS_STORAGE_MODE"];
+export declare const CANONICAL_SHORTLINKS_RDS_CLUSTER = "postgres-compatible-database";
+export declare const CANONICAL_SHORTLINKS_RDS_DATABASE = "shortlinks";
+export declare const CANONICAL_SHORTLINKS_RDS_SECRET_PATH = "configured-by-environment";
+export interface CanonicalShortlinksRdsConfig {
+    cluster: typeof CANONICAL_SHORTLINKS_RDS_CLUSTER;
+    database: typeof CANONICAL_SHORTLINKS_RDS_DATABASE;
+    runtimeSecretPath: typeof CANONICAL_SHORTLINKS_RDS_SECRET_PATH;
+    primaryEnv: typeof SHORTLINKS_STORAGE_ENV;
+    fallbackEnv: typeof SHORTLINKS_STORAGE_FALLBACK_ENV;
+}
+export declare function getCanonicalShortlinksRdsConfig(): CanonicalShortlinksRdsConfig;
+export declare function getStorageDatabaseUrl(): string | undefined;
+export declare function getStorageDatabaseEnvName(): (typeof STORAGE_DATABASE_ENV)[number] | null;
+export declare function getStorageDatabaseEnv(): StorageEnv | null;
+export declare function getStorageConfig(): StorageConfig;
+export declare function getStorageConnectionString(dbName?: string): string;
+export declare const getConnectionString: typeof getStorageConnectionString;

package/dist/storage-sync.d.ts

@@ -0,0 +1,36 @@
+import { STORAGE_DATABASE_ENV, type CanonicalShortlinksRdsConfig, type StorageMode } from "./storage-config.js";
+import { PgAdapterAsync } from "./remote-storage.js";
+export interface StorageSyncResult {
+    table: string;
+    direction: "push" | "pull";
+    rowsRead: number;
+    rowsWritten: number;
+    errors: string[];
+}
+export type SyncResult = StorageSyncResult;
+export interface StorageStatus {
+    configured: boolean;
+    mode: StorageMode;
+    enabled: boolean;
+    env: typeof STORAGE_DATABASE_ENV;
+    activeEnv: string | null;
+    canonical: CanonicalShortlinksRdsConfig;
+    service: "shortlinks";
+    db_path: string;
+    tables: Array<{
+        table: string;
+        rows: number;
+    }>;
+}
+export declare const STORAGE_TABLES: readonly ["domains", "links", "clicks"];
+export declare const SHORTLINKS_STORAGE_TABLES: readonly ["domains", "links", "clicks"];
+export declare function getStoragePg(): Promise<PgAdapterAsync>;
+export declare function runStorageMigrations(remote: PgAdapterAsync): Promise<void>;
+export declare function getStorageStatus(dbPath?: string): StorageStatus;
+export declare function pushStorageChanges(dbPath?: string, tables?: string[]): Promise<StorageSyncResult[]>;
+export declare function pullStorageChanges(dbPath?: string, tables?: string[]): Promise<StorageSyncResult[]>;
+export declare function syncStorageChanges(dbPath?: string, tables?: string[]): Promise<{
+    push: StorageSyncResult[];
+    pull: StorageSyncResult[];
+}>;
+export declare function parseStorageTables(raw?: string): string[];

package/dist/storage.d.ts

@@ -0,0 +1,6 @@
+export { CANONICAL_SHORTLINKS_RDS_CLUSTER, CANONICAL_SHORTLINKS_RDS_DATABASE, CANONICAL_SHORTLINKS_RDS_SECRET_PATH, SHORTLINKS_STORAGE_ENV, SHORTLINKS_STORAGE_FALLBACK_ENV, SHORTLINKS_STORAGE_MODE_ENV, SHORTLINKS_STORAGE_MODE_FALLBACK_ENV, STORAGE_DATABASE_ENV, STORAGE_MODE_ENV, getConnectionString, getCanonicalShortlinksRdsConfig, getStorageConfig, getStorageConnectionString, getStorageDatabaseEnv, getStorageDatabaseEnvName, getStorageDatabaseUrl, } from "./storage-config.js";
+export type { CanonicalShortlinksRdsConfig, StorageConfig, StorageEnv, StorageMode } from "./storage-config.js";
+export { SHORTLINKS_STORAGE_TABLES, STORAGE_TABLES, getStoragePg, getStorageStatus, parseStorageTables, pullStorageChanges, pushStorageChanges, runStorageMigrations, syncStorageChanges, } from "./storage-sync.js";
+export type { StorageStatus, StorageSyncResult, SyncResult } from "./storage-sync.js";
+export { PgAdapterAsync } from "./remote-storage.js";
+export { PG_MIGRATIONS } from "./pg-migrations.js";