srcpack 0.1.0

package/dist/init.d.ts

@@ -0,0 +1 @@
+export declare function runInit(): Promise<void>;

package/dist/src/bundle.d.ts

@@ -0,0 +1,37 @@
+import type { BundleConfigInput } from "./config.ts";
+export interface FileEntry {
+    path: string;
+    lines: number;
+    startLine: number;
+    endLine: number;
+}
+export interface BundleResult {
+    content: string;
+    index: FileEntry[];
+}
+/**
+ * Resolve bundle config to a list of file paths.
+ * Respects .gitignore patterns in the working directory.
+ */
+export declare function resolvePatterns(config: BundleConfigInput, cwd: string): Promise<string[]>;
+/**
+ * Format the index header block.
+ * Format designed for LLM context files (ChatGPT, Grok, Gemini):
+ * - Numbered entries for cross-reference with file separators
+ * - ASCII-only characters for broad compatibility
+ * - Line locations that point to actual file content
+ */
+export declare function formatIndex(index: FileEntry[]): string;
+export interface BundleOptions {
+    includeIndex?: boolean;
+}
+/**
+ * Create a bundle from a list of files.
+ * Line numbers in the index point to the first line of actual file content,
+ * not to the separator line.
+ */
+export declare function createBundle(files: string[], cwd: string, options?: BundleOptions): Promise<BundleResult>;
+/**
+ * Bundle a single named bundle from config
+ */
+export declare function bundleOne(name: string, config: BundleConfigInput, cwd: string): Promise<BundleResult>;

package/dist/src/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env bun
+export {};

package/dist/src/config.d.ts

@@ -0,0 +1,45 @@
+import { z } from "zod";
+export declare function expandPath(p: string): string;
+declare const BundleConfigSchema: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodObject<{
+    include: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+    outfile: z.ZodOptional<z.ZodString>;
+    index: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>]>;
+declare const UploadConfigSchema: z.ZodObject<{
+    provider: z.ZodLiteral<"gdrive">;
+    folder: z.ZodOptional<z.ZodString>;
+    clientId: z.ZodString;
+    clientSecret: z.ZodString;
+}, z.core.$strip>;
+declare const ConfigSchema: z.ZodObject<{
+    outDir: z.ZodDefault<z.ZodString>;
+    upload: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        provider: z.ZodLiteral<"gdrive">;
+        folder: z.ZodOptional<z.ZodString>;
+        clientId: z.ZodString;
+        clientSecret: z.ZodString;
+    }, z.core.$strip>, z.ZodArray<z.ZodObject<{
+        provider: z.ZodLiteral<"gdrive">;
+        folder: z.ZodOptional<z.ZodString>;
+        clientId: z.ZodString;
+        clientSecret: z.ZodString;
+    }, z.core.$strip>>]>>;
+    bundles: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>, z.ZodObject<{
+        include: z.ZodUnion<readonly [z.ZodString, z.ZodArray<z.ZodString>]>;
+        outfile: z.ZodOptional<z.ZodString>;
+        index: z.ZodDefault<z.ZodBoolean>;
+    }, z.core.$strip>]>>;
+}, z.core.$strip>;
+export type UploadConfig = z.infer<typeof UploadConfigSchema>;
+export type BundleConfig = z.infer<typeof BundleConfigSchema>;
+export type BundleConfigInput = z.input<typeof BundleConfigSchema>;
+export type Config = z.infer<typeof ConfigSchema>;
+export type ConfigInput = z.input<typeof ConfigSchema>;
+export declare function defineConfig(config: ConfigInput): ConfigInput;
+export declare class ConfigError extends Error {
+    constructor(message: string);
+}
+export declare function parseConfig(value: unknown): Config;
+export declare function loadConfig(searchFrom?: string): Promise<Config | null>;
+export declare function loadConfigFromFile(filepath: string): Promise<Config | null>;
+export {};

package/dist/src/gdrive.d.ts

@@ -0,0 +1,33 @@
+import { OAuthError } from "oauth-callback";
+import type { UploadConfig } from "./config.ts";
+export interface Tokens {
+    access_token: string;
+    refresh_token?: string;
+    expires_at?: number;
+    token_type: string;
+    scope: string;
+}
+/**
+ * Loads stored tokens from disk.
+ * Returns null if no tokens exist or they cannot be read.
+ */
+export declare function loadTokens(): Promise<Tokens | null>;
+/**
+ * Removes stored tokens from disk.
+ */
+export declare function clearTokens(): Promise<void>;
+/**
+ * Gets valid tokens, refreshing if necessary.
+ * Returns null if no tokens exist or refresh fails.
+ */
+export declare function getValidTokens(config: UploadConfig): Promise<Tokens | null>;
+/**
+ * Performs OAuth login flow - opens browser for user consent.
+ * Stores tokens on success for future use.
+ */
+export declare function login(config: UploadConfig): Promise<Tokens>;
+/**
+ * Ensures we have valid tokens - loads existing or triggers login.
+ */
+export declare function ensureAuthenticated(config: UploadConfig): Promise<Tokens>;
+export { OAuthError };

package/dist/src/index.d.ts

@@ -0,0 +1,2 @@
+export { defineConfig, loadConfig, loadConfigFromFile } from "./config.ts";
+export type { Config, BundleConfig } from "./config.ts";

package/dist/src/init.d.ts

@@ -0,0 +1 @@
+export declare function runInit(): Promise<void>;

package/dist/tests/bundle.test.d.ts

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

package/dist/tests/cli.test.d.ts

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

package/dist/tests/config.test.d.ts

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

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "srcpack",
+  "version": "0.1.0",
+  "description": "Zero-config CLI for bundling code into LLM-optimized context files",
+  "keywords": [
+    "llm",
+    "ai",
+    "context",
+    "chatgpt",
+    "claude",
+    "gemini",
+    "grok",
+    "copilot",
+    "code-bundler",
+    "concatenate",
+    "codebase",
+    "source-code",
+    "monorepo",
+    "prompt",
+    "context-window",
+    "rag",
+    "embedding",
+    "ai-tools",
+    "ai-coding",
+    "agentic",
+    "glob",
+    "cli",
+    "bun"
+  ],
+  "author": "Konstantin Tarkus <koistya@kriasoft.com>",
+  "license": "MIT",
+  "homepage": "https://kriasoft.com/srcpack/",
+  "repository": "github:kriasoft/srcpack",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "srcpack": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "src",
+    "schema.json"
+  ],
+  "scripts": {
+    "build": "bun build ./src/cli.ts ./src/index.ts --outdir ./dist --target bun && tsc",
+    "typecheck": "tsc -p tsconfig.check.json",
+    "check": "tsc -p tsconfig.check.json",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "docs:dev": "vitepress dev",
+    "docs:build": "vitepress build",
+    "docs:preview": "vitepress preview",
+    "docs:deploy": "gh-pages -d .vitepress/dist"
+  },
+  "dependencies": {
+    "@clack/prompts": "^0.11.0",
+    "cosmiconfig": "^9.0.0",
+    "ignore": "^7.0.5",
+    "oauth-callback": "^1.2.1",
+    "zod": "^4.3.5"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.3.6",
+    "gh-pages": "^6.3.0",
+    "prettier": "^3.8.0",
+    "typescript": "^5.9.3",
+    "vitepress": "^2.0.0-alpha.15"
+  }
+}

package/src/bundle.ts

@@ -0,0 +1,237 @@
+// SPDX-License-Identifier: MIT
+
+import { join } from "node:path";
+import { Glob } from "bun";
+import ignore, { type Ignore } from "ignore";
+import type { BundleConfigInput } from "./config.ts";
+
+export interface FileEntry {
+  path: string; // Relative path from cwd
+  lines: number; // Line count in source file
+  startLine: number; // Start line in bundle (1-indexed)
+  endLine: number; // End line in bundle
+}
+
+export interface BundleResult {
+  content: string;
+  index: FileEntry[];
+}
+
+/**
+ * Normalize BundleConfig to arrays of include/exclude patterns
+ */
+function normalizePatterns(config: BundleConfigInput): {
+  include: string[];
+  exclude: string[];
+} {
+  let patterns: string[];
+
+  if (typeof config === "string") {
+    patterns = [config];
+  } else if (Array.isArray(config)) {
+    patterns = config;
+  } else {
+    patterns = Array.isArray(config.include)
+      ? config.include
+      : [config.include];
+  }
+
+  const include: string[] = [];
+  const exclude: string[] = [];
+
+  for (const p of patterns) {
+    if (p.startsWith("!")) {
+      exclude.push(p.slice(1));
+    } else {
+      include.push(p);
+    }
+  }
+
+  return { include, exclude };
+}
+
+/**
+ * Check if a path matches any of the exclusion patterns
+ */
+function isExcluded(filePath: string, excludePatterns: string[]): boolean {
+  for (const pattern of excludePatterns) {
+    const glob = new Glob(pattern);
+    if (glob.match(filePath)) {
+      return true;
+    }
+  }
+  return false;
+}
+
+/**
+ * Load and parse .gitignore file from a directory
+ */
+async function loadGitignore(cwd: string): Promise<Ignore> {
+  const ig = ignore();
+  const gitignorePath = join(cwd, ".gitignore");
+
+  try {
+    const content = await Bun.file(gitignorePath).text();
+    ig.add(content);
+  } catch {
+    // No .gitignore file, return empty ignore instance
+  }
+
+  return ig;
+}
+
+/**
+ * Resolve bundle config to a list of file paths.
+ * Respects .gitignore patterns in the working directory.
+ */
+export async function resolvePatterns(
+  config: BundleConfigInput,
+  cwd: string,
+): Promise<string[]> {
+  const { include, exclude } = normalizePatterns(config);
+  const gitignore = await loadGitignore(cwd);
+  const files = new Set<string>();
+
+  for (const pattern of include) {
+    const glob = new Glob(pattern);
+    for await (const match of glob.scan({ cwd, onlyFiles: true })) {
+      if (!isExcluded(match, exclude) && !gitignore.ignores(match)) {
+        files.add(match);
+      }
+    }
+  }
+
+  // Sort for deterministic output
+  return [...files].sort();
+}
+
+/**
+ * Count lines in a string (handles empty strings correctly)
+ */
+function countLines(content: string): number {
+  if (content === "") return 0;
+  // Count newlines and add 1 for the last line (if not ending with newline)
+  const newlines = (content.match(/\n/g) || []).length;
+  return content.endsWith("\n") ? newlines : newlines + 1;
+}
+
+/**
+ * Format the index header block.
+ * Format designed for LLM context files (ChatGPT, Grok, Gemini):
+ * - Numbered entries for cross-reference with file separators
+ * - ASCII-only characters for broad compatibility
+ * - Line locations that point to actual file content
+ */
+export function formatIndex(index: FileEntry[]): string {
+  if (index.length === 0) return "# Index\n# (empty)";
+
+  const count = index.length;
+  const lines = [`# Index (${count} file${count === 1 ? "" : "s"})`];
+  for (let i = 0; i < index.length; i++) {
+    const entry = index[i]!;
+    const num = `[${i + 1}]`.padEnd(5);
+    const lineWord = entry.lines === 1 ? "line" : "lines";
+    lines.push(
+      `# ${num} ${entry.path}  L${entry.startLine}-L${entry.endLine} (${entry.lines} ${lineWord})`,
+    );
+  }
+  return lines.join("\n");
+}
+
+export interface BundleOptions {
+  includeIndex?: boolean; // Default: true
+}
+
+/**
+ * Format a file separator line with index number for cross-reference.
+ * Uses `==>` / `<==` pattern (from Unix head/tail) which is unlikely
+ * to appear naturally in bundled files.
+ */
+function formatSeparator(index: number, filePath: string): string {
+  return `#==> [${index}] ${filePath} <==`;
+}
+
+/**
+ * Create a bundle from a list of files.
+ * Line numbers in the index point to the first line of actual file content,
+ * not to the separator line.
+ */
+export async function createBundle(
+  files: string[],
+  cwd: string,
+  options: BundleOptions = {},
+): Promise<BundleResult> {
+  const { includeIndex = true } = options;
+  const index: FileEntry[] = [];
+  const contentParts: string[] = [];
+  let currentLine = 1;
+
+  for (let i = 0; i < files.length; i++) {
+    const filePath = files[i]!;
+    const fullPath = join(cwd, filePath);
+    const content = await Bun.file(fullPath).text();
+    const lines = countLines(content);
+
+    // Separator takes 1 line, then content starts on next line
+    const contentStartLine = currentLine + 1;
+
+    const entry: FileEntry = {
+      path: filePath,
+      lines,
+      startLine: contentStartLine,
+      endLine: contentStartLine + Math.max(0, lines - 1),
+    };
+    index.push(entry);
+
+    contentParts.push(formatSeparator(i + 1, filePath));
+    contentParts.push(content.endsWith("\n") ? content.slice(0, -1) : content);
+
+    // Next separator line = after content
+    currentLine = entry.endLine + 1;
+  }
+
+  if (includeIndex) {
+    // Adjust line numbers to account for index header
+    // Header: "# Index (N files)" + N index lines + 1 blank line
+    const headerLines = index.length + 2;
+    for (const entry of index) {
+      entry.startLine += headerLines;
+      entry.endLine += headerLines;
+    }
+
+    const indexBlock = formatIndex(index);
+    const content =
+      index.length === 0
+        ? indexBlock
+        : indexBlock + "\n\n" + contentParts.join("\n");
+
+    return { content, index };
+  }
+
+  // No index: just join file content
+  const content = contentParts.join("\n");
+  return { content, index };
+}
+
+/**
+ * Extract the index option from bundle config (default: true)
+ */
+function getIncludeIndex(config: BundleConfigInput): boolean {
+  if (typeof config === "object" && !Array.isArray(config)) {
+    return config.index ?? true;
+  }
+  return true;
+}
+
+/**
+ * Bundle a single named bundle from config
+ */
+export async function bundleOne(
+  name: string,
+  config: BundleConfigInput,
+  cwd: string,
+): Promise<BundleResult> {
+  const files = await resolvePatterns(config, cwd);
+  const includeIndex = getIncludeIndex(config);
+  return createBundle(files, cwd, { includeIndex });
+}