@piqit/resolvers 0.0.2

package/dist/static.js

@@ -0,0 +1,194 @@
+/**
+ * Static Content Resolver
+ *
+ * A resolver for querying pre-compiled content in edge environments
+ * like Cloudflare Workers where filesystem access is not available.
+ *
+ * Content is compiled at build time and bundled as a static module.
+ *
+ * @example
+ * // 1. Build script compiles content:
+ * // build-content.ts
+ * import { fileMarkdown } from "@piqit/resolvers";
+ * const posts = fileMarkdown({ ... });
+ * const allPosts = await posts.resolve({ scan: {}, filter: {}, select: ["params.*", "frontmatter.*", "body.*"] });
+ * await Bun.write("src/generated/content.ts", `export const posts = ${JSON.stringify(allPosts)};`);
+ *
+ * // 2. Worker imports and uses static resolver:
+ * // worker.ts
+ * import { posts } from "./generated/content";
+ * import { staticContent } from "@piqit/resolvers";
+ * import { piq } from "piqit";
+ *
+ * const postsResolver = staticContent(posts);
+ *
+ * const results = await piq.from(postsResolver)
+ *   .filter({ author: "John" })
+ *   .select("params.slug", "frontmatter.title")
+ *   .exec();
+ */
+// =============================================================================
+// Filter Helpers
+// =============================================================================
+/**
+ * Get a nested value from an object using dot-path notation.
+ */
+function getByPath(obj, path) {
+    const parts = path.split(".");
+    let current = obj;
+    for (const part of parts) {
+        if (current == null || typeof current !== "object") {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return current;
+}
+/**
+ * Default filter implementation - checks equality on frontmatter fields.
+ */
+function defaultFilter(item, filter) {
+    const frontmatter = item.frontmatter;
+    if (!frontmatter) {
+        return Object.keys(filter).length === 0;
+    }
+    for (const [key, value] of Object.entries(filter)) {
+        if (frontmatter[key] !== value) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Check if scan constraints match params.
+ */
+function matchesScan(item, scan) {
+    const params = item.params;
+    if (!params) {
+        return Object.keys(scan).length === 0;
+    }
+    for (const [key, value] of Object.entries(scan)) {
+        if (value !== undefined && params[key] !== value) {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Select specific fields from an item based on select paths.
+ */
+function selectFields(item, selectPaths) {
+    const result = {};
+    for (const path of selectPaths) {
+        // Handle wildcards like "params.*"
+        if (path.endsWith(".*")) {
+            const namespace = path.slice(0, -2);
+            const nsValue = getByPath(item, namespace);
+            if (nsValue && typeof nsValue === "object") {
+                result[namespace] = { ...nsValue };
+            }
+        }
+        else {
+            // Regular path like "params.slug" or "frontmatter.title"
+            const parts = path.split(".");
+            const namespace = parts[0];
+            // Ensure namespace exists in result
+            if (!result[namespace]) {
+                result[namespace] = {};
+            }
+            // Set the value
+            const value = getByPath(item, path);
+            if (parts.length === 2) {
+                result[namespace][parts[1]] = value;
+            }
+            else {
+                // Deeper path - just copy the value
+                result[namespace] = value;
+            }
+        }
+    }
+    return result;
+}
+// =============================================================================
+// Schema Factories
+// =============================================================================
+/**
+ * Create a passthrough schema that accepts any value.
+ * Used for static content where validation happened at build time.
+ */
+function createPassthroughSchema() {
+    return {
+        "~standard": {
+            version: 1,
+            vendor: "piqit/resolvers/static",
+            validate(value) {
+                return { value: value };
+            },
+        },
+    };
+}
+// =============================================================================
+// Resolver Factory
+// =============================================================================
+/**
+ * Create a static content resolver from pre-compiled data.
+ *
+ * This resolver is designed for edge environments like Cloudflare Workers
+ * where filesystem access is not available. Content is compiled at build
+ * time and bundled as a static module.
+ *
+ * @param data - Array of pre-compiled content items
+ * @returns A resolver that queries the static data
+ *
+ * @example
+ * // In your worker:
+ * import { posts } from "./generated/content";
+ * import { staticContent } from "@piqit/resolvers";
+ * import { piq } from "piqit";
+ *
+ * const postsResolver = staticContent(posts);
+ *
+ * export default {
+ *   async fetch(request: Request) {
+ *     const results = await piq.from(postsResolver)
+ *       .scan({ year: "2024" })
+ *       .select("params.slug", "frontmatter.title")
+ *       .exec();
+ *
+ *     return Response.json(results);
+ *   }
+ * };
+ */
+export function staticContent(data) {
+    const scanSchema = createPassthroughSchema();
+    const filterSchema = createPassthroughSchema();
+    const resultSchema = createPassthroughSchema();
+    return {
+        schema: {
+            scanParams: scanSchema,
+            filterParams: filterSchema,
+            result: resultSchema,
+        },
+        async resolve(spec) {
+            let results = [...data];
+            // Apply scan constraints (filter by params)
+            if (spec.scan && Object.keys(spec.scan).length > 0) {
+                results = results.filter((item) => matchesScan(item, spec.scan));
+            }
+            // Apply filter constraints (filter by frontmatter)
+            if (spec.filter && Object.keys(spec.filter).length > 0) {
+                results = results.filter((item) => defaultFilter(item, spec.filter));
+            }
+            // Apply select to return only requested fields
+            if (spec.select && spec.select.length > 0) {
+                return results.map((item) => selectFields(item, spec.select));
+            }
+            return results;
+        },
+    };
+}
+/**
+ * Alias for staticContent - provides a more descriptive name for the use case.
+ */
+export const staticResolver = staticContent;
+//# sourceMappingURL=static.js.map

package/dist/static.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.js","sourceRoot":"","sources":["../src/static.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@piqit/resolvers",
+  "version": "0.0.2",
+  "type": "module",
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./src/index.ts"
+    },
+    "./edge": {
+      "types": "./src/edge.ts",
+      "import": "./src/edge.ts"
+    },
+    "./static": {
+      "types": "./src/static.ts",
+      "import": "./src/static.ts"
+    }
+  },
+  "files": [
+    "src",
+    "dist"
+  ],
+  "dependencies": {
+    "piqit": "0.0.2"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.8.3"
+  }
+}

package/src/edge.ts

@@ -0,0 +1,15 @@
+/**
+ * @piqit/resolvers/edge - Edge-compatible resolvers
+ *
+ * This entry point only exports resolvers that work in edge environments
+ * like Cloudflare Workers, where dynamic code generation is not allowed.
+ *
+ * Use this instead of '@piqit/resolvers' in your Worker:
+ *
+ * @example
+ * import { staticContent } from "@piqit/resolvers/edge";
+ *
+ * @packageDocumentation
+ */
+
+export { staticContent, staticResolver } from "./static"

package/src/file-markdown.ts

@@ -0,0 +1,352 @@
+/**
+ * Filesystem Markdown Resolver
+ *
+ * A resolver for querying markdown files from the filesystem.
+ * Optimized for reading only what's needed based on the query.
+ */
+
+import type { Resolver, StandardSchema, Infer } from "piqit"
+import { compilePattern, createParamsSchema, type PathParams } from "./path-pattern"
+import { parseFrontmatter } from "./frontmatter"
+import { parseMarkdownBody, type BodyOptions, type BodyResult, type Heading } from "./markdown"
+import path from "node:path"
+
+// =============================================================================
+// Types
+// =============================================================================
+
+/**
+ * Options for creating a file markdown resolver.
+ */
+export interface FileMarkdownOptions<
+  TPath extends string,
+  TFrontmatter extends StandardSchema,
+  TBody extends BodyOptions
+> {
+  /**
+   * Base directory for finding files.
+   * Can be absolute or relative to cwd.
+   */
+  base: string
+
+  /**
+   * Path pattern with {param} placeholders.
+   * @example '{year}/{slug}.md'
+   */
+  path: TPath
+
+  /**
+   * Schema for validating frontmatter.
+   * The schema's inferred type defines filter parameters.
+   */
+  frontmatter: TFrontmatter
+
+  /**
+   * Body parsing options.
+   * @default { raw: false, html: false, headings: false }
+   */
+  body?: TBody
+}
+
+/**
+ * The shape of results from a file markdown resolver.
+ */
+export interface FileMarkdownResult<
+  TParams,
+  TFrontmatter,
+  TBody extends BodyResult
+> {
+  params: TParams
+  frontmatter: TFrontmatter
+  body: TBody
+}
+
+/**
+ * Type for body shape based on options.
+ */
+type ComputedBodyShape<T extends BodyOptions | undefined> = T extends BodyOptions
+  ? {
+      raw: T["raw"] extends true ? string : never
+      html: T["html"] extends true ? string : never
+      headings: T["headings"] extends true ? Heading[] : never
+    }
+  : Record<string, never>
+
+/**
+ * Clean up body shape to remove never types.
+ */
+type CleanBodyShape<T> = {
+  [K in keyof T as T[K] extends never ? never : K]: T[K]
+}
+
+// =============================================================================
+// Result Schema Factory
+// =============================================================================
+
+/**
+ * Create a result schema for the resolver.
+ * This schema validates the namespaced result shape.
+ */
+function createResultSchema<TFrontmatter, TBody extends BodyResult>(
+  _paramNames: string[],
+  frontmatterSchema: StandardSchema<TFrontmatter>,
+  bodyOptions: BodyOptions
+): StandardSchema<FileMarkdownResult<Record<string, string>, TFrontmatter, TBody>> {
+  return {
+    "~standard": {
+      version: 1,
+      vendor: "piqit/resolvers",
+      validate(value: unknown) {
+        if (value === null || typeof value !== "object") {
+          return { issues: [{ message: "Expected object" }] }
+        }
+
+        const obj = value as Record<string, unknown>
+
+        // Validate params
+        if (obj.params == null || typeof obj.params !== "object") {
+          return { issues: [{ message: "Missing params", path: ["params"] }] }
+        }
+
+        // Validate frontmatter using the provided schema
+        const fmResult = frontmatterSchema["~standard"].validate(obj.frontmatter)
+        if (fmResult.issues) {
+          return {
+            issues: fmResult.issues.map((issue) => ({
+              ...issue,
+              path: ["frontmatter", ...(issue.path || [])],
+            })),
+          }
+        }
+
+        // Validate body shape
+        if (bodyOptions.raw || bodyOptions.html || bodyOptions.headings) {
+          if (obj.body == null || typeof obj.body !== "object") {
+            return { issues: [{ message: "Missing body", path: ["body"] }] }
+          }
+        }
+
+        return { value: obj as unknown as FileMarkdownResult<Record<string, string>, TFrontmatter, TBody> }
+      },
+    },
+  }
+}
+
+// =============================================================================
+// Helper Functions
+// =============================================================================
+
+/**
+ * Check if any select paths require frontmatter data.
+ */
+function needsFrontmatter(selectPaths: string[]): boolean {
+  return selectPaths.some((p) => p.startsWith("frontmatter.") || p === "frontmatter.*")
+}
+
+/**
+ * Check if any select paths require body data.
+ */
+function needsBody(selectPaths: string[]): boolean {
+  return selectPaths.some((p) => p.startsWith("body.") || p === "body.*")
+}
+
+/**
+ * Check if any select paths require params.
+ */
+function needsParams(selectPaths: string[]): boolean {
+  return selectPaths.some((p) => p.startsWith("params.") || p === "params.*")
+}
+
+/**
+ * Get which body parts are needed based on select paths.
+ */
+function getNeededBodyParts(selectPaths: string[]): BodyOptions {
+  const result: BodyOptions = {}
+
+  for (const path of selectPaths) {
+    if (path === "body.*") {
+      // Need all body parts
+      return { raw: true, html: true, headings: true }
+    }
+    if (path === "body.raw") result.raw = true
+    if (path === "body.html") result.html = true
+    if (path === "body.headings") result.headings = true
+  }
+
+  return result
+}
+
+/**
+ * Check if filter constraints match frontmatter.
+ * Simple equality check for now.
+ */
+function matchesFilter(
+  frontmatter: Record<string, unknown>,
+  filter: Record<string, unknown>
+): boolean {
+  for (const [key, value] of Object.entries(filter)) {
+    if (frontmatter[key] !== value) {
+      return false
+    }
+  }
+  return true
+}
+
+// =============================================================================
+// Resolver Factory
+// =============================================================================
+
+/**
+ * Create a filesystem markdown resolver.
+ *
+ * @example
+ * const postsResolver = fileMarkdown({
+ *   base: 'content/posts',
+ *   path: '{year}/{slug}.md',
+ *   frontmatter: z.object({
+ *     title: z.string(),
+ *     status: z.enum(['draft', 'published']),
+ *   }),
+ *   body: { html: true, headings: true }
+ * })
+ */
+export function fileMarkdown<
+  TPath extends string,
+  TFrontmatter extends StandardSchema,
+  TBody extends BodyOptions = Record<string, never>
+>(
+  options: FileMarkdownOptions<TPath, TFrontmatter, TBody>
+): Resolver<
+  StandardSchema<Partial<PathParams<TPath>>>,
+  TFrontmatter,
+  StandardSchema<
+    FileMarkdownResult<
+      PathParams<TPath>,
+      Infer<TFrontmatter>,
+      CleanBodyShape<ComputedBodyShape<TBody>>
+    >
+  >
+> {
+  const pattern = compilePattern(options.path)
+  const basePath = path.isAbsolute(options.base)
+    ? options.base
+    : path.join(process.cwd(), options.base)
+
+  const bodyOptions: BodyOptions = options.body || {}
+
+  // Create schemas
+  const scanSchema = createParamsSchema(pattern) as StandardSchema<Partial<PathParams<TPath>>>
+  const resultSchema = createResultSchema(
+    pattern.paramNames,
+    options.frontmatter,
+    bodyOptions
+  ) as StandardSchema<
+    FileMarkdownResult<
+      PathParams<TPath>,
+      Infer<TFrontmatter>,
+      CleanBodyShape<ComputedBodyShape<TBody>>
+    >
+  >
+
+  return {
+    schema: {
+      scanParams: scanSchema,
+      filterParams: options.frontmatter,
+      result: resultSchema,
+    },
+
+    async resolve(spec) {
+      const results: Array<
+        Partial<
+          FileMarkdownResult<
+            PathParams<TPath>,
+            Infer<TFrontmatter>,
+            CleanBodyShape<ComputedBodyShape<TBody>>
+          >
+        >
+      > = []
+
+      // 1. Generate glob pattern from scan constraints
+      const globPattern = pattern.toGlob(spec.scan as Record<string, unknown>)
+
+      // 2. Find matching files using Bun.Glob
+      const glob = new Bun.Glob(globPattern)
+      const files: string[] = []
+
+      for await (const file of glob.scan({ cwd: basePath, absolute: false })) {
+        files.push(file)
+      }
+
+      // 3. Determine what we need to read
+      const wantParams = needsParams(spec.select)
+      const wantFrontmatter = needsFrontmatter(spec.select)
+      const wantBody = needsBody(spec.select)
+      const hasFilter = spec.filter && Object.keys(spec.filter).length > 0
+      const neededBodyParts = wantBody ? getNeededBodyParts(spec.select) : {}
+
+      // 4. Process each file
+      for (const relativePath of files) {
+        // Extract params from path
+        const params = pattern.match(relativePath)
+        if (!params) continue
+
+        const fullPath = path.join(basePath, relativePath)
+
+        // Read file content only if needed
+        let content: string | null = null
+        let frontmatter: Record<string, unknown> | null = null
+        let body: BodyResult | null = null
+
+        // If filtering or selecting frontmatter, we need to read it
+        if (hasFilter || wantFrontmatter) {
+          content = await Bun.file(fullPath).text()
+          frontmatter = parseFrontmatter(content)
+
+          if (!frontmatter) {
+            frontmatter = {}
+          }
+
+          // Check filter constraints
+          if (hasFilter && !matchesFilter(frontmatter, spec.filter as Record<string, unknown>)) {
+            continue
+          }
+        }
+
+        // If selecting body, parse it
+        if (wantBody) {
+          if (!content) {
+            content = await Bun.file(fullPath).text()
+          }
+
+          // Only parse the body parts that are needed
+          body = parseMarkdownBody(content, neededBodyParts)
+        }
+
+        // Build result with only requested fields
+        const result: Partial<
+          FileMarkdownResult<
+            PathParams<TPath>,
+            Infer<TFrontmatter>,
+            CleanBodyShape<ComputedBodyShape<TBody>>
+          >
+        > = {}
+
+        if (wantParams) {
+          result.params = params as PathParams<TPath>
+        }
+
+        if (wantFrontmatter) {
+          result.frontmatter = frontmatter as Infer<TFrontmatter>
+        }
+
+        if (wantBody && body) {
+          result.body = body as CleanBodyShape<ComputedBodyShape<TBody>>
+        }
+
+        results.push(result)
+      }
+
+      return results
+    },
+  }
+}