@offworld/backend-api 0.1.0 → 0.1.1

package/dist/_generated/api.d.ts

@@ -12,6 +12,7 @@ import type * as admin from "../admin.js";
 import type * as auth from "../auth.js";
 import type * as github from "../github.js";
 import type * as http from "../http.js";
+import type * as lib_githubAuth from "../lib/githubAuth.js";
 import type * as references from "../references.js";
 import type * as repository from "../repository.js";
 import type * as validation_github from "../validation/github.js";
@@ -29,6 +30,7 @@ declare const fullApi: ApiFromModules<{
   auth: typeof auth;
   github: typeof github;
   http: typeof http;
+  "lib/githubAuth": typeof lib_githubAuth;
   references: typeof references;
   repository: typeof repository;
   "validation/github": typeof validation_github;

package/package.json

@@ -1,33 +1,33 @@
 {
-	"name": "@offworld/backend-api",
-	"version": "0.1.0",
-	"description": "Generated Convex API types for Offworld",
-	"license": "MIT",
-	"files": [
-		"dist"
-	],
-	"type": "module",
-	"exports": {
-		"./api": {
-			"types": "./dist/_generated/api.d.ts",
-			"import": "./dist/_generated/api.js"
-		},
-		"./server": {
-			"types": "./dist/_generated/server.d.ts",
-			"import": "./dist/_generated/server.js"
-		}
-	},
-	"publishConfig": {
-		"access": "public"
-	},
-	"scripts": {
-		"build": "tsc -p tsconfig.json && bun run ./scripts/copy-generated.ts",
-		"prepublishOnly": "bun run build"
-	},
-	"dependencies": {
-		"convex": "catalog:"
-	},
-	"devDependencies": {
-		"typescript": "catalog:"
-	}
+  "name": "@offworld/backend-api",
+  "version": "0.1.1",
+  "description": "Generated Convex API types for Offworld",
+  "license": "MIT",
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "exports": {
+    "./api": {
+      "types": "./dist/_generated/api.d.ts",
+      "import": "./dist/_generated/api.js"
+    },
+    "./server": {
+      "types": "./dist/_generated/server.d.ts",
+      "import": "./dist/_generated/server.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "bun run ./scripts/copy-generated.ts",
+    "prepublishOnly": "bun run build"
+  },
+  "dependencies": {
+    "convex": "catalog:"
+  },
+  "devDependencies": {
+    "typescript": "catalog:"
+  }
 }

package/dist/__tests__/push-validation.test.d.ts

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

package/dist/__tests__/references.test.d.ts

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

package/dist/admin.d.ts

@@ -1,26 +0,0 @@
-export declare const listAllReferences: import("convex/server").RegisteredQuery<"public", {}, Promise<{
-    _id: import("convex/values").GenericId<"reference">;
-    fullName: string;
-    pullCount: number;
-    generatedAt: string;
-    commitSha: string;
-    isVerified: boolean;
-}[]>>;
-export declare const listAllUsers: import("convex/server").RegisteredQuery<"public", {}, Promise<{
-    _id: import("convex/values").GenericId<"user">;
-    email: string;
-    name: string | undefined;
-    image: string | undefined;
-    createdAt: string;
-}[]>>;
-export declare const deleteReference: import("convex/server").RegisteredMutation<"public", {
-    fullName: string;
-}, Promise<{
-    success: boolean;
-}>>;
-export declare const toggleVerified: import("convex/server").RegisteredMutation<"public", {
-    fullName: string;
-}, Promise<{
-    success: boolean;
-    isVerified: boolean;
-}>>;

package/dist/auth.config.d.ts

@@ -1,16 +0,0 @@
-declare const _default: {
-    providers: ({
-        type: "customJwt";
-        issuer: string;
-        algorithm: "RS256";
-        jwks: string;
-        applicationID: string;
-    } | {
-        type: "customJwt";
-        issuer: string;
-        algorithm: "RS256";
-        jwks: string;
-        applicationID?: undefined;
-    })[];
-};
-export default _default;

package/dist/auth.d.ts

@@ -1,39 +0,0 @@
-import { type QueryCtx, type MutationCtx } from "./_generated/server";
-export declare function getAuthUser(ctx: QueryCtx | MutationCtx): Promise<{
-    _id: import("convex/values").GenericId<"user">;
-    _creationTime: number;
-    name?: string | undefined;
-    image?: string | undefined;
-    workosId: string;
-    email: string;
-    createdAt: string;
-} | null>;
-export declare const ensureUser: import("convex/server").RegisteredMutation<"public", {}, Promise<import("convex/values").GenericId<"user">>>;
-export declare const getCurrentUser: import("convex/server").RegisteredQuery<"public", {}, Promise<{
-    _id: import("convex/values").GenericId<"user">;
-    _creationTime: number;
-    name?: string | undefined;
-    image?: string | undefined;
-    workosId: string;
-    email: string;
-    createdAt: string;
-} | null>>;
-export declare const getCurrentUserSafe: import("convex/server").RegisteredQuery<"public", {}, Promise<{
-    _id: import("convex/values").GenericId<"user">;
-    _creationTime: number;
-    name?: string | undefined;
-    image?: string | undefined;
-    workosId: string;
-    email: string;
-    createdAt: string;
-} | null>>;
-export declare function requireAdmin(ctx: QueryCtx | MutationCtx): Promise<{
-    _id: import("convex/values").GenericId<"user">;
-    _creationTime: number;
-    name?: string | undefined;
-    image?: string | undefined;
-    workosId: string;
-    email: string;
-    createdAt: string;
-}>;
-export declare const isAdmin: import("convex/server").RegisteredQuery<"public", {}, Promise<boolean>>;

package/dist/convex.config.d.ts

@@ -1,3 +0,0 @@
-import type { AppDefinition } from "convex/server";
-declare const app: AppDefinition;
-export default app;

package/dist/github.d.ts

@@ -1,36 +0,0 @@
-export declare const fetchRepoMetadata: import("convex/server").RegisteredAction<"public", {
-    owner: string;
-    name: string;
-}, Promise<{
-    owner: string;
-    name: string;
-    fullName: string;
-    description: string | undefined;
-    stars: number;
-    language: string | undefined;
-    githubUrl: string;
-    defaultBranch: string;
-} | null>>;
-export declare const fetchOwnerInfo: import("convex/server").RegisteredAction<"public", {
-    owner: string;
-}, Promise<{
-    login: string;
-    name: string;
-    avatarUrl: string;
-    bio: string | undefined;
-    type: "user" | "organization";
-    publicRepos: number;
-    followers: number;
-    htmlUrl: string;
-} | null>>;
-export declare const fetchOwnerRepos: import("convex/server").RegisteredAction<"public", {
-    perPage?: number | undefined;
-    owner: string;
-}, Promise<{
-    owner: string;
-    name: string;
-    fullName: string;
-    description: string | undefined;
-    stars: number;
-    language: string | undefined;
-}[] | null>>;

package/dist/healthCheck.d.ts

@@ -1,2 +0,0 @@
-import type { QueryBuilder } from "convex/server";
-export declare const get: ReturnType<QueryBuilder<any, "public">>;

package/dist/http.d.ts

@@ -1,2 +0,0 @@
-declare const http: import("convex/server").HttpRouter;
-export default http;

package/dist/references.d.ts

@@ -1,154 +0,0 @@
-/**
- * Reference Convex Functions
- * Public queries/mutations for CLI and web app
- */
-/**
- * Get reference by repository fullName (public)
- * Display reference on web
- */
-export declare const get: import("convex/server").RegisteredQuery<"public", {
-    fullName: string;
-}, Promise<{
-    _id: import("convex/values").GenericId<"reference">;
-    _creationTime: number;
-    workosId?: string | undefined;
-    repositoryId: import("convex/values").GenericId<"repository">;
-    referenceName: string;
-    referenceDescription: string;
-    referenceContent: string;
-    commitSha: string;
-    generatedAt: string;
-    pullCount: number;
-    isVerified: boolean;
-} | null>>;
-/**
- * Get reference by repository fullName + referenceName (public)
- * Display specific reference on web
- */
-export declare const getByName: import("convex/server").RegisteredQuery<"public", {
-    fullName: string;
-    referenceName: string;
-}, Promise<{
-    _id: import("convex/values").GenericId<"reference">;
-    _creationTime: number;
-    workosId?: string | undefined;
-    repositoryId: import("convex/values").GenericId<"repository">;
-    referenceName: string;
-    referenceDescription: string;
-    referenceContent: string;
-    commitSha: string;
-    generatedAt: string;
-    pullCount: number;
-    isVerified: boolean;
-} | null>>;
-/**
- * List all references for a repository (public)
- */
-export declare const listByRepo: import("convex/server").RegisteredQuery<"public", {
-    fullName: string;
-}, Promise<{
-    referenceName: string;
-    referenceDescription: string;
-    generatedAt: string;
-    commitSha: string;
-    pullCount: number;
-    isVerified: boolean;
-}[]>>;
-/**
- * List all references sorted by pull count (public)
- * Repo directory/explore page
- */
-export declare const list: import("convex/server").RegisteredQuery<"public", {
-    limit?: number | undefined;
-    cursor?: string | undefined;
-}, Promise<{
-    fullName: string;
-    pullCount: number;
-    generatedAt: string;
-    commitSha: string;
-    isVerified: boolean;
-}[]>>;
-/**
- * List references pushed by the current user
- */
-export declare const listByCurrentUser: import("convex/server").RegisteredQuery<"public", {}, Promise<{
-    fullName: string;
-    owner: string;
-    name: string;
-    referenceName: string;
-    referenceDescription: string;
-    pullCount: number;
-    generatedAt: string;
-    commitSha: string;
-    isVerified: boolean;
-}[]>>;
-/**
- * Fetch reference for CLI pull (no pull count tracking)
- */
-export declare const pull: import("convex/server").RegisteredQuery<"public", {
-    referenceName?: string | undefined;
-    fullName: string;
-}, Promise<{
-    fullName: string;
-    referenceName: string;
-    referenceDescription: string;
-    referenceContent: string;
-    commitSha: string;
-    generatedAt: string;
-} | null>>;
-/**
- * Lightweight existence check for CLI
- */
-export declare const check: import("convex/server").RegisteredQuery<"public", {
-    referenceName?: string | undefined;
-    fullName: string;
-}, Promise<{
-    exists: false;
-    commitSha?: undefined;
-    generatedAt?: undefined;
-} | {
-    exists: true;
-    commitSha: string;
-    generatedAt: string;
-}>>;
-export type PushError = "auth_required" | "invalid_input" | "invalid_reference" | "repo_not_found" | "low_stars" | "private_repo" | "commit_not_found" | "commit_already_exists" | "rate_limit" | "github_error";
-export type PushResult = {
-    success: true;
-} | {
-    success: false;
-    error: PushError;
-    message?: string;
-};
-/**
- * Push reference - public action with full validation
- */
-export declare const push: import("convex/server").RegisteredAction<"public", {
-    fullName: string;
-    referenceName: string;
-    referenceDescription: string;
-    referenceContent: string;
-    commitSha: string;
-    generatedAt: string;
-}, Promise<PushResult>>;
-/**
- * Internal mutation - DB operations only, not directly callable
- */
-export declare const pushInternal: import("convex/server").RegisteredMutation<"internal", {
-    canonicalFullName?: string | undefined;
-    repoStars?: number | undefined;
-    repoDescription?: string | undefined;
-    fullName: string;
-    referenceName: string;
-    referenceDescription: string;
-    referenceContent: string;
-    commitSha: string;
-    generatedAt: string;
-    workosId: string;
-}, Promise<PushResult>>;
-/**
- * Record a pull event - increments pullCount for display on repo pages
- */
-export declare const recordPull: import("convex/server").RegisteredMutation<"public", {
-    referenceName?: string | undefined;
-    fullName: string;
-}, Promise<void>>;

package/dist/repository.d.ts

@@ -1,93 +0,0 @@
-/**
- * Repository Convex Functions
- * Queries for GitHub repository metadata
- */
-/**
- * Get repository by fullName
- */
-export declare const get: import("convex/server").RegisteredQuery<"public", {
-    fullName: string;
-}, Promise<{
-    _id: import("convex/values").GenericId<"repository">;
-    _creationTime: number;
-    description?: string | undefined;
-    language?: string | undefined;
-    fullName: string;
-    fullNameLower: string;
-    owner: string;
-    name: string;
-    stars: number;
-    defaultBranch: string;
-    githubUrl: string;
-    fetchedAt: string;
-} | null>>;
-/**
- * List repositories by owner
- */
-export declare const listByOwner: import("convex/server").RegisteredQuery<"public", {
-    owner: string;
-}, Promise<{
-    _id: import("convex/values").GenericId<"repository">;
-    _creationTime: number;
-    description?: string | undefined;
-    language?: string | undefined;
-    fullName: string;
-    fullNameLower: string;
-    owner: string;
-    name: string;
-    stars: number;
-    defaultBranch: string;
-    githubUrl: string;
-    fetchedAt: string;
-}[]>>;
-/**
- * List repositories sorted by stars (for explore page)
- */
-export declare const list: import("convex/server").RegisteredQuery<"public", {
-    limit?: number | undefined;
-}, Promise<{
-    _id: import("convex/values").GenericId<"repository">;
-    _creationTime: number;
-    description?: string | undefined;
-    language?: string | undefined;
-    fullName: string;
-    fullNameLower: string;
-    owner: string;
-    name: string;
-    stars: number;
-    defaultBranch: string;
-    githubUrl: string;
-    fetchedAt: string;
-}[]>>;
-/**
- * List recently indexed repositories (for homepage carousel)
- */
-export declare const listRecent: import("convex/server").RegisteredQuery<"public", {
-    limit?: number | undefined;
-}, Promise<{
-    _id: import("convex/values").GenericId<"repository">;
-    _creationTime: number;
-    description?: string | undefined;
-    language?: string | undefined;
-    fullName: string;
-    fullNameLower: string;
-    owner: string;
-    name: string;
-    stars: number;
-    defaultBranch: string;
-    githubUrl: string;
-    fetchedAt: string;
-}[]>>;
-/**
- * Upsert repository (internal - called after fetching from GitHub)
- */
-export declare const upsert: import("convex/server").RegisteredMutation<"internal", {
-    description?: string | undefined;
-    language?: string | undefined;
-    fullName: string;
-    owner: string;
-    name: string;
-    stars: number;
-    defaultBranch: string;
-    githubUrl: string;
-}, Promise<import("convex/values").GenericId<"repository">>>;

package/dist/schema.d.ts

@@ -1,94 +0,0 @@
-/**
- * Offworld Backend Schema
- * Convex schema for reference storage
- */
-declare const _default: import("convex/server").SchemaDefinition<{
-    repository: import("convex/server").TableDefinition<import("convex/values").VObject<{
-        description?: string | undefined;
-        language?: string | undefined;
-        fullName: string;
-        fullNameLower: string;
-        owner: string;
-        name: string;
-        stars: number;
-        defaultBranch: string;
-        githubUrl: string;
-        fetchedAt: string;
-    }, {
-        fullName: import("convex/values").VString<string, "required">;
-        fullNameLower: import("convex/values").VString<string, "required">;
-        owner: import("convex/values").VString<string, "required">;
-        name: import("convex/values").VString<string, "required">;
-        description: import("convex/values").VString<string | undefined, "optional">;
-        stars: import("convex/values").VFloat64<number, "required">;
-        language: import("convex/values").VString<string | undefined, "optional">;
-        defaultBranch: import("convex/values").VString<string, "required">;
-        githubUrl: import("convex/values").VString<string, "required">;
-        fetchedAt: import("convex/values").VString<string, "required">;
-    }, "required", "fullName" | "fullNameLower" | "owner" | "name" | "description" | "stars" | "language" | "defaultBranch" | "githubUrl" | "fetchedAt">, {
-        by_fullName: ["fullName", "_creationTime"];
-        by_fullNameLower: ["fullNameLower", "_creationTime"];
-        by_owner: ["owner", "_creationTime"];
-        by_stars: ["stars", "_creationTime"];
-        by_fetchedAt: ["fetchedAt", "_creationTime"];
-    }, {}, {}>;
-    reference: import("convex/server").TableDefinition<import("convex/values").VObject<{
-        workosId?: string | undefined;
-        repositoryId: import("convex/values").GenericId<"repository">;
-        referenceName: string;
-        referenceDescription: string;
-        referenceContent: string;
-        commitSha: string;
-        generatedAt: string;
-        pullCount: number;
-        isVerified: boolean;
-    }, {
-        repositoryId: import("convex/values").VId<import("convex/values").GenericId<"repository">, "required">;
-        referenceName: import("convex/values").VString<string, "required">;
-        referenceDescription: import("convex/values").VString<string, "required">;
-        referenceContent: import("convex/values").VString<string, "required">;
-        commitSha: import("convex/values").VString<string, "required">;
-        generatedAt: import("convex/values").VString<string, "required">;
-        pullCount: import("convex/values").VFloat64<number, "required">;
-        isVerified: import("convex/values").VBoolean<boolean, "required">;
-        workosId: import("convex/values").VString<string | undefined, "optional">;
-    }, "required", "repositoryId" | "referenceName" | "referenceDescription" | "referenceContent" | "commitSha" | "generatedAt" | "pullCount" | "isVerified" | "workosId">, {
-        by_repositoryId: ["repositoryId", "_creationTime"];
-        by_repositoryId_referenceName: ["repositoryId", "referenceName", "_creationTime"];
-        by_repositoryId_commitSha: ["repositoryId", "commitSha", "_creationTime"];
-        by_pullCount: ["pullCount", "_creationTime"];
-        by_generatedAt: ["generatedAt", "_creationTime"];
-        by_workosId: ["workosId", "_creationTime"];
-    }, {}, {}>;
-    pushLog: import("convex/server").TableDefinition<import("convex/values").VObject<{
-        fullName: string;
-        commitSha: string;
-        workosId: string;
-        pushedAt: string;
-    }, {
-        fullName: import("convex/values").VString<string, "required">;
-        workosId: import("convex/values").VString<string, "required">;
-        pushedAt: import("convex/values").VString<string, "required">;
-        commitSha: import("convex/values").VString<string, "required">;
-    }, "required", "fullName" | "commitSha" | "workosId" | "pushedAt">, {
-        by_repo_date: ["fullName", "pushedAt", "_creationTime"];
-        by_workos_date: ["workosId", "pushedAt", "_creationTime"];
-    }, {}, {}>;
-    user: import("convex/server").TableDefinition<import("convex/values").VObject<{
-        name?: string | undefined;
-        image?: string | undefined;
-        workosId: string;
-        email: string;
-        createdAt: string;
-    }, {
-        workosId: import("convex/values").VString<string, "required">;
-        email: import("convex/values").VString<string, "required">;
-        name: import("convex/values").VString<string | undefined, "optional">;
-        image: import("convex/values").VString<string | undefined, "optional">;
-        createdAt: import("convex/values").VString<string, "required">;
-    }, "required", "name" | "workosId" | "email" | "image" | "createdAt">, {
-        by_email: ["email", "_creationTime"];
-        by_workosId: ["workosId", "_creationTime"];
-    }, {}, {}>;
-}, true>;
-export default _default;

package/dist/validation/github.d.ts

@@ -1,19 +0,0 @@
-export interface RepoValidationResult {
-    valid: boolean;
-    error?: string;
-    stars?: number;
-    description?: string;
-    canonicalFullName?: string;
-}
-export interface CommitValidationResult {
-    valid: boolean;
-    error?: string;
-}
-/**
- * Verify repo exists and has minimum stars
- */
-export declare function validateRepo(fullName: string): Promise<RepoValidationResult>;
-/**
- * Verify commit exists in repo
- */
-export declare function validateCommit(fullName: string, commitSha: string): Promise<CommitValidationResult>;

package/dist/validation/push.d.ts

@@ -1,36 +0,0 @@
-export declare const FULLNAME_MIN = 3;
-export declare const FULLNAME_MAX = 200;
-export declare const SKILLNAME_MIN = 2;
-export declare const SKILLNAME_MAX = 80;
-export declare const DESCRIPTION_MAX = 200;
-export declare const CONTENT_MIN = 500;
-export declare const CONTENT_MAX = 200000;
-export declare const COMMIT_SHA_LENGTH = 40;
-export declare const FULLNAME_PATTERN: RegExp;
-export declare const SKILLNAME_PATTERN: RegExp;
-export declare const COMMIT_SHA_PATTERN: RegExp;
-export declare const pushArgs: {
-    fullName: import("convex/values").VString<string, "required">;
-    referenceName: import("convex/values").VString<string, "required">;
-    referenceDescription: import("convex/values").VString<string, "required">;
-    referenceContent: import("convex/values").VString<string, "required">;
-    commitSha: import("convex/values").VString<string, "required">;
-    generatedAt: import("convex/values").VString<string, "required">;
-};
-export interface ValidationResult {
-    valid: boolean;
-    error?: string;
-    field?: string;
-}
-/**
- * Validates push arguments at runtime
- * Returns first validation error or { valid: true }
- */
-export declare function validatePushArgs(args: {
-    fullName: string;
-    referenceName: string;
-    referenceDescription: string;
-    referenceContent: string;
-    commitSha: string;
-    generatedAt: string;
-}): ValidationResult;

package/dist/validation/referenceContent.d.ts

@@ -1,7 +0,0 @@
-export interface ContentValidationResult {
-    valid: boolean;
-    error?: string;
-    name?: string;
-    description?: string;
-}
-export declare function validateReferenceContent(content: string): ContentValidationResult;