@hasna/switcher 0.1.0

package/dist/serve.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export declare function main(args?: string[]): Promise<void>;

package/dist/service.d.ts

@@ -0,0 +1,2 @@
+import { Store } from "./store";
+export declare function createHandler(store: Store, apiKey: string, providerEnv?: Record<string, string | undefined>): (request: Request) => Promise<Response>;

package/dist/store.d.ts

@@ -0,0 +1,48 @@
+import { SQL } from "bun";
+type Connection = Pick<SQL, "unsafe">;
+export type Resource = "providers" | "profiles" | "runs" | "catalogs";
+export type RecordValue = {
+    id: string;
+    version: number;
+    updatedAt: string;
+    [key: string]: unknown;
+};
+export declare class Store {
+    private tail;
+    private exclusive;
+    readonly sql: SQL;
+    readonly engine: "sqlite" | "postgresql";
+    private constructor();
+    static open(config: {
+        databaseUrl?: string;
+        sqlitePath?: string;
+    }): Promise<Store>;
+    private migrate;
+    ready(): Promise<void>;
+    close(): Promise<void>;
+    get<T>(kind: Resource, id: string, db?: Connection): Promise<T>;
+    private read;
+    list<T>(kind: Resource, { limit, offset, search }?: {
+        limit?: number | undefined;
+        offset?: number | undefined;
+        search?: string | undefined;
+    }): Promise<{
+        data: T[];
+        total: number;
+        limit: number;
+        offset: number;
+    }>;
+    put(kind: Resource, input: Record<string, any>, expectedVersion: number | undefined, db: Connection): Promise<any>;
+    remove(kind: "providers" | "profiles", id: string, version: number, db: Connection): Promise<{
+        deleted: string;
+    }>;
+    mutate<T>(key: string, fingerprint: string, action: (db: Connection) => Promise<T>): Promise<T>;
+    replay(key: string, fingerprint: string): Promise<{
+        found: false;
+    } | {
+        found: true;
+        value: unknown;
+    }>;
+    private transaction;
+}
+export {};

package/docker-compose.yml

@@ -0,0 +1,41 @@
+services:
+  switcher-sqlite:
+    profiles: [sqlite]
+    build: .
+    command: ["bun", "dist/serve/index.js", "--host", "0.0.0.0", "--port", "8080", "--data-dir", "/data"]
+    environment:
+      HASNA_SWITCHER_API_KEY: ${HASNA_SWITCHER_API_KEY:?Inject the operator API token}
+      SWITCHER_PROVIDER_OPENROUTER: ${SWITCHER_PROVIDER_OPENROUTER:-}
+    volumes:
+      - switcher-data:/data
+    ports:
+      - "127.0.0.1:8080:8080"
+  switcher-postgres:
+    profiles: [postgres]
+    build: .
+    environment:
+      HASNA_SWITCHER_API_KEY: ${HASNA_SWITCHER_API_KEY:?Inject the operator API token}
+      HASNA_SWITCHER_DATABASE_URL: ${HASNA_SWITCHER_DATABASE_URL:-}
+      SWITCHER_PROVIDER_OPENROUTER: ${SWITCHER_PROVIDER_OPENROUTER:-}
+    ports:
+      - "127.0.0.1:8080:8080"
+    depends_on:
+      postgres:
+        condition: service_healthy
+  postgres:
+    profiles: [postgres]
+    image: postgres:17
+    environment:
+      POSTGRES_DB: switcher
+      POSTGRES_USER: switcher
+      POSTGRES_PASSWORD: ${SWITCHER_POSTGRES_PASSWORD:-}
+    volumes:
+      - postgres-data:/var/lib/postgresql/data
+    healthcheck:
+      test: ["CMD-SHELL", "pg_isready -U switcher -d switcher"]
+      interval: 5s
+      timeout: 3s
+      retries: 10
+volumes:
+  switcher-data:
+  postgres-data:

package/hasna.contract.json

@@ -0,0 +1,94 @@
+{
+  "$schema": "./node_modules/@hasna/contracts/src/hasna.contract.schema.json",
+  "schema": "hasna.service_contract.v1",
+  "name": "switcher",
+  "class": "cli-with-store",
+  "contractVersion": "v1",
+  "kitVersion": "1.0.1",
+  "description": "Universal provider and model switcher for coding harnesses with an API, SDK and self-hosted storage",
+  "bins": [
+    "switcher",
+    "switcher-mcp",
+    "switcher-serve"
+  ],
+  "hosting": [
+    "user-hosted"
+  ],
+  "serviceSurfaces": [
+    {
+      "name": "http-api",
+      "kind": "api",
+      "status": "supported",
+      "bin": "switcher-serve",
+      "authMode": "api-key",
+      "health": {
+        "method": "GET",
+        "path": "/health",
+        "public": true
+      },
+      "readiness": {
+        "method": "GET",
+        "path": "/ready",
+        "public": true
+      },
+      "version": {
+        "method": "GET",
+        "path": "/version",
+        "public": true
+      },
+      "apiBasePath": "/v1",
+      "openApiPath": "/v1/openapi.json"
+    },
+    {
+      "name": "package-sdk",
+      "kind": "sdk",
+      "status": "supported",
+      "authMode": "api-key",
+      "exportSubpath": "./sdk",
+      "generatedFrom": "/v1/openapi.json"
+    },
+    {
+      "name": "mcp",
+      "kind": "mcp",
+      "status": "supported",
+      "mcpBin": "switcher-mcp",
+      "authMode": "api-key"
+    },
+    {
+      "name": "cli",
+      "kind": "cli",
+      "status": "supported",
+      "bin": "switcher",
+      "authMode": "api-key"
+    }
+  ],
+  "storage": {
+    "backend": "postgresql",
+    "engines": [
+      "sqlite",
+      "postgresql"
+    ],
+    "envPrefix": "HASNA_SWITCHER_",
+    "aliasEnvPrefix": "SWITCHER_",
+    "sqlitePath": "~/.hasna/switcher/switcher.db",
+    "pgTestGate": {
+      "envVar": "SWITCHER_TEST_DATABASE_URL",
+      "command": "bun run test:postgres"
+    }
+  },
+  "metadata": {
+    "release": {
+      "artifactScan": {
+        "script": "scan:artifact"
+      }
+    },
+    "switcherStorageException": {
+      "authority": "Explicit user directive 2026-09-05, task 01a07181-ca8d-70c1-99a2-b276dc5770f3",
+      "serverBackends": [
+        "sqlite",
+        "postgresql"
+      ],
+      "scope": "Only switcher HTTP server; all CLI, SDK and MCP data access remains authenticated HTTP. PostgreSQL remains canonical backend."
+    }
+  }
+}