@timber-js/app 0.2.0-alpha.12 → 0.2.0-alpha.121

package/dist/utils/directive-parser.d.ts

@@ -1,70 +0,0 @@
-/**
- * AST-based directive detection for 'use cache', 'use dynamic',
- * 'use client', and 'use server'.
- *
- * Uses acorn to parse source code and detect directives properly,
- * avoiding false positives from regex matching inside string literals,
- * comments, or template expressions.
- *
- * @module
- */
-export interface FileDirective {
-    /** The directive value, e.g. 'use client', 'use server' */
-    directive: string;
-    /** 1-based line number where the directive appears */
-    line: number;
-}
-export interface FunctionWithDirective {
-    /** Function name (or 'default' for anonymous default exports) */
-    name: string;
-    /** The directive found in the function body */
-    directive: string;
-    /** 1-based line number of the directive */
-    directiveLine: number;
-    /** Start offset of the function in the source */
-    start: number;
-    /** End offset of the function in the source */
-    end: number;
-    /** Start offset of the function body block (after the '{') */
-    bodyStart: number;
-    /** End offset of the function body block (the '}') */
-    bodyEnd: number;
-    /** Content between { and } of the function body */
-    bodyContent: string;
-    /** 'export ', 'export default ', or '' */
-    prefix: string;
-    /** Whether this is an arrow function */
-    isArrow: boolean;
-    /** The function signature (everything before the body '{') */
-    declaration: string;
-}
-/**
- * Detect a file-level directive ('use client', 'use server', etc.).
- *
- * Per the ECMAScript spec, directives are string literal expression
- * statements at the start of a program body (before any non-directive
- * statements). This function checks the AST `Program.body` for
- * `ExpressionStatement` nodes whose expression is a `Literal` string
- * matching a known directive.
- *
- * Returns the first matching directive, or null if none found.
- */
-export declare function detectFileDirective(code: string, directives?: string[]): FileDirective | null;
-/**
- * Find all functions in the source code that contain a directive
- * (e.g. 'use cache', 'use dynamic') as their first body statement.
- *
- * Parses the source with acorn and walks the AST looking for function
- * declarations and arrow function expressions whose body is a
- * BlockStatement with a directive prologue.
- *
- * Returns an array of function info objects, sorted by position
- * (descending) for safe end-to-start replacement.
- */
-export declare function findFunctionsWithDirective(code: string, directive: string): FunctionWithDirective[];
-/**
- * Quick regex check for whether code contains a directive string.
- * Use as a fast bail-out before calling the AST-based functions.
- */
-export declare function containsDirective(code: string, directive: string): boolean;
-//# sourceMappingURL=directive-parser.d.ts.map

package/dist/utils/directive-parser.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"directive-parser.d.ts","sourceRoot":"","sources":["../../src/utils/directive-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAYH,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACpC,iEAAiE;IACjE,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,2CAA2C;IAC3C,aAAa,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IACpB,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,OAAO,EAAE,OAAO,CAAC;IACjB,8DAA8D;IAC9D,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,UAAU,GAAE,MAAM,EAAiC,GAClD,aAAa,GAAG,IAAI,CAmCtB;AAiED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,GAChB,qBAAqB,EAAE,CAqBzB;AA4TD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAE1E"}

package/src/cache/register-cached-function.ts

@@ -1,103 +0,0 @@
-import type { CacheHandler } from './index';
-import { stableStringify } from './stable-stringify';
-import { createSingleflight } from './singleflight';
-import { fnv1aHash } from './fast-hash.js';
-
-const singleflight = createSingleflight();
-
-// Prop names that suggest request-specific data — triggers dev warning for "use cache" components.
-const REQUEST_SPECIFIC_PROPS = new Set([
-  'cookies',
-  'cookie',
-  'session',
-  'sessionId',
-  'token',
-  'authorization',
-  'auth',
-  'headers',
-]);
-
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export interface RegisterCachedFunctionOptions<Fn extends (...args: any[]) => any> {
-  ttl: number;
-  id: string;
-  tags?: string[] | ((...args: Parameters<Fn>) => string[]);
-  /** True when the cached function is a React component (PascalCase name). */
-  isComponent?: boolean;
-}
-
-/**
- * Generate a cache key from a stable function ID and serialized args.
- *
- * Uses FNV-1a (fast non-crypto hash) instead of SHA-256. The id prefix
- * provides namespace isolation; the hash covers the args.
- * See TIM-370.
- */
-function generateKey(id: string, args: unknown[]): string {
-  const raw = id + ':' + stableStringify(args);
-  return id + ':' + fnv1aHash(raw);
-}
-
-/**
- * Resolve tags from options — supports static array or function form.
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-function resolveTags<Fn extends (...args: any[]) => any>(
-  opts: RegisterCachedFunctionOptions<Fn>,
-  args: Parameters<Fn>
-): string[] {
-  if (!opts.tags) return [];
-  if (Array.isArray(opts.tags)) return opts.tags;
-  return opts.tags(...args);
-}
-
-/**
- * Checks if component props contain request-specific keys and emits a dev warning.
- * Only runs when process.env.NODE_ENV !== 'production'.
- */
-function warnRequestSpecificProps(id: string, props: unknown): void {
-  if (typeof props !== 'object' || props === null) return;
-  const keys = Object.keys(props);
-  const suspicious = keys.filter((k) => REQUEST_SPECIFIC_PROPS.has(k.toLowerCase()));
-  if (suspicious.length > 0) {
-    console.warn(
-      `[timber] "use cache" component ${id} received request-specific props: ${suspicious.join(', ')}. ` +
-        `This may serve one user's cached render to another user. ` +
-        `Remove request-specific data from props or remove "use cache".`
-    );
-  }
-}
-
-/**
- * Runtime for the "use cache" directive transform. Wraps an async function
- * with caching using the same cache handler as timber.cache.
- *
- * The stable `id` (file path + function name) ensures cache keys are consistent
- * across builds. Args/props are hashed with SHA-256 for the per-call key.
- */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export function registerCachedFunction<Fn extends (...args: any[]) => Promise<any>>(
-  fn: Fn,
-  opts: RegisterCachedFunctionOptions<Fn>,
-  handler: CacheHandler
-): (...args: Parameters<Fn>) => Promise<Awaited<ReturnType<Fn>>> {
-  return async (...args: Parameters<Fn>): Promise<Awaited<ReturnType<Fn>>> => {
-    // Dev-mode warning for components with request-specific props
-    if (opts.isComponent && process.env.NODE_ENV !== 'production' && args.length > 0) {
-      warnRequestSpecificProps(opts.id, args[0]);
-    }
-
-    const key = generateKey(opts.id, args);
-    const cached = await handler.get(key);
-
-    if (cached && !cached.stale) {
-      return cached.value as Awaited<ReturnType<Fn>>;
-    }
-
-    // Cache miss or stale — execute with singleflight
-    const result = await singleflight.do(key, () => fn(...args));
-    const tags = resolveTags(opts, args);
-    await handler.set(key, result, { ttl: opts.ttl, tags });
-    return result as Awaited<ReturnType<Fn>>;
-  };
-}