bunderstack 0.21.0 → 0.22.0

package/dist/start/index.d.ts

@@ -1,5 +1,5 @@
 import { QueryClient } from '@tanstack/react-query';
-import { type AnyBunderstackApp, type BunderstackSyncClient } from '../sync/index.js';
+import { type AnyBunderstackApp, type BunderstackClient } from '../query/index.js';
 export { createIsomorphicFetch } from './isomorphic-fetch.js';
 export type BunderstackStartOptions = {
     /** API mount point. Defaults to '/api'. */
@@ -9,7 +9,7 @@ export type BunderstackStartOptions = {
 };
 /**
  * One-call client setup for TanStack Start apps: SSR-aware fetch, sensible
- * QueryClient defaults, and a sync client whose tables and buckets are
+ * QueryClient defaults, and a typed query client whose procedures and buckets are
  * inferred from the server app type.
  *
  * @example
@@ -20,7 +20,7 @@ export type BunderstackStartOptions = {
  */
 export declare function bunderstackStart<TApp extends AnyBunderstackApp>(options?: BunderstackStartOptions): {
     createQueryClient: () => QueryClient;
-    createApi: (queryClient: QueryClient) => BunderstackSyncClient<TApp>;
+    createApi: (queryClient: QueryClient) => BunderstackClient<TApp>;
 };
 type StartRequestContext = {
     request: Request;

package/dist/start/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/start/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC3B,MAAM,eAAe,CAAA;AAGtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,MAAM,MAAM,uBAAuB,GAAG;IACpC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,iBAAiB,EAC7D,OAAO,GAAE,uBAA4B;;6BAUV,WAAW,KAAG,qBAAqB,CAAC,IAAI,CAAC;EAOrE;AAED,KAAK,mBAAmB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAA;AAC/C,KAAK,YAAY,GAAG,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAEnE;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE;IACrC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;CAC7C,GAAG;IACF,GAAG,EAAE,YAAY,CAAA;IACjB,IAAI,EAAE,YAAY,CAAA;IAClB,KAAK,EAAE,YAAY,CAAA;IACnB,MAAM,EAAE,YAAY,CAAA;CACrB,CAGA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE;QACJ,GAAG,EAAE;YACH,UAAU,EAAE,CAAC,IAAI,EAAE;gBACjB,OAAO,EAAE,OAAO,CAAA;aACjB,KAAK,OAAO,CAAC;gBAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAAA;aAAE,GAAG,IAAI,CAAC,CAAA;SACnD,CAAA;KACF,CAAA;CACF,CAAA;AAED,iFAAiF;AACjF,wBAAsB,cAAc,CAClC,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAG7B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/start/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,gBAAgB,CAAA;AAGvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,MAAM,MAAM,uBAAuB,GAAG;IACpC,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,wDAAwD;IACxD,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,SAAS,iBAAiB,EAC7D,OAAO,GAAE,uBAA4B;;6BAUV,WAAW,KAAG,iBAAiB,CAAC,IAAI,CAAC;EAOjE;AAED,KAAK,mBAAmB,GAAG;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAA;AAC/C,KAAK,YAAY,GAAG,CAAC,GAAG,EAAE,mBAAmB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;AAEnE;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE;IACrC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAA;CAC7C,GAAG;IACF,GAAG,EAAE,YAAY,CAAA;IACjB,IAAI,EAAE,YAAY,CAAA;IAClB,KAAK,EAAE,YAAY,CAAA;IACnB,MAAM,EAAE,YAAY,CAAA;CACrB,CAGA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAED,KAAK,UAAU,GAAG;IAChB,IAAI,EAAE;QACJ,GAAG,EAAE;YACH,UAAU,EAAE,CAAC,IAAI,EAAE;gBACjB,OAAO,EAAE,OAAO,CAAA;aACjB,KAAK,OAAO,CAAC;gBAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAAA;aAAE,GAAG,IAAI,CAAC,CAAA;SACnD,CAAA;KACF,CAAA;CACF,CAAA;AAED,iFAAiF;AACjF,wBAAsB,cAAc,CAClC,GAAG,EAAE,UAAU,EACf,OAAO,EAAE,OAAO,GACf,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAG7B"}

package/dist/start/index.js

@@ -1,10 +1,10 @@
 import { QueryClient } from '@tanstack/react-query';
-import { createSyncClient, } from '../sync/index.js';
+import { createClient, } from '../query/index.js';
 import { createIsomorphicFetch } from './isomorphic-fetch.js';
 export { createIsomorphicFetch } from './isomorphic-fetch.js';
 /**
  * One-call client setup for TanStack Start apps: SSR-aware fetch, sensible
- * QueryClient defaults, and a sync client whose tables and buckets are
+ * QueryClient defaults, and a typed query client whose procedures and buckets are
  * inferred from the server app type.
  *
  * @example
@@ -21,7 +21,7 @@ export function bunderstackStart(options = {}) {
                 queries: { staleTime: options.staleTime ?? 30_000 },
             },
         }),
-        createApi: (queryClient) => createSyncClient({
+        createApi: (queryClient) => createClient({
             queryClient,
             fetch: isoFetch,
             baseUrl: options.baseUrl,

package/dist/start/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/start/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,EACL,gBAAgB,GAGjB,MAAM,eAAe,CAAA;AACtB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAS1D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAmC,EAAE;IAErC,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAA;IACxC,OAAO;QACL,iBAAiB,EAAE,GAAG,EAAE,CACtB,IAAI,WAAW,CAAC;YACd,cAAc,EAAE;gBACd,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM,EAAE;aACpD;SACF,CAAC;QACJ,SAAS,EAAE,CAAC,WAAwB,EAA+B,EAAE,CACnE,gBAAgB,CAAO;YACrB,WAAW;YACX,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;KACL,CAAA;AACH,CAAC;AAKD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAEjC;IAMC,MAAM,MAAM,GAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAClE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;AACrE,CAAC;AAoBD,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAe,EACf,OAAgB;IAEhB,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAC3E,OAAO,OAAO,EAAE,IAAI,IAAI,IAAI,CAAA;AAC9B,CAAC","sourcesContent":["import { QueryClient } from '@tanstack/react-query'\n\nimport {\n  createSyncClient,\n  type AnyBunderstackApp,\n  type BunderstackSyncClient,\n} from '../sync/index'\nimport { createIsomorphicFetch } from './isomorphic-fetch'\n\nexport { createIsomorphicFetch } from './isomorphic-fetch'\n\nexport type BunderstackStartOptions = {\n  /** API mount point. Defaults to '/api'. */\n  baseUrl?: string\n  /** Default query staleTime (ms). Defaults to 30_000. */\n  staleTime?: number\n}\n\n/**\n * One-call client setup for TanStack Start apps: SSR-aware fetch, sensible\n * QueryClient defaults, and a sync client whose tables and buckets are\n * inferred from the server app type.\n *\n * @example\n * // src/api.ts — NOT src/client.ts, which is a reserved TanStack Start\n * // entry-point name (it would replace the hydration entry).\n * import type { App } from './bunderstack'\n * export const { createQueryClient, createApi } = bunderstackStart<App>()\n */\nexport function bunderstackStart<TApp extends AnyBunderstackApp>(\n  options: BunderstackStartOptions = {},\n) {\n  const isoFetch = createIsomorphicFetch()\n  return {\n    createQueryClient: () =>\n      new QueryClient({\n        defaultOptions: {\n          queries: { staleTime: options.staleTime ?? 30_000 },\n        },\n      }),\n    createApi: (queryClient: QueryClient): BunderstackSyncClient<TApp> =>\n      createSyncClient<TApp>({\n        queryClient,\n        fetch: isoFetch,\n        baseUrl: options.baseUrl,\n      }),\n  }\n}\n\ntype StartRequestContext = { request: Request }\ntype StartHandler = (ctx: StartRequestContext) => Promise<Response>\n\n/**\n * Handlers object for the catch-all API file route.\n *\n * @example\n * // src/routes/api/$.tsx\n * export const Route = createFileRoute('/api/$')({\n *   server: { handlers: createApiHandlers(app) },\n * })\n */\nexport function createApiHandlers(app: {\n  handler: (req: Request) => Promise<Response>\n}): {\n  GET: StartHandler\n  POST: StartHandler\n  PATCH: StartHandler\n  DELETE: StartHandler\n} {\n  const handle: StartHandler = ({ request }) => app.handler(request)\n  return { GET: handle, POST: handle, PATCH: handle, DELETE: handle }\n}\n\nexport type SessionUser = {\n  id: string\n  email: string\n  name: string\n  image?: string | null\n  role?: string\n}\n\ntype SessionApp = {\n  auth: {\n    api: {\n      getSession: (opts: {\n        headers: Headers\n      }) => Promise<{ user: SessionUser | null } | null>\n    }\n  }\n}\n\n/** Resolve the BetterAuth session user for an incoming request (server-side). */\nexport async function getSessionUser(\n  app: SessionApp,\n  request: Request,\n): Promise<SessionUser | null> {\n  const session = await app.auth.api.getSession({ headers: request.headers })\n  return session?.user ?? null\n}\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/start/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAEnD,OAAO,EACL,YAAY,GAGb,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAE1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAA;AAS1D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAmC,EAAE;IAErC,MAAM,QAAQ,GAAG,qBAAqB,EAAE,CAAA;IACxC,OAAO;QACL,iBAAiB,EAAE,GAAG,EAAE,CACtB,IAAI,WAAW,CAAC;YACd,cAAc,EAAE;gBACd,OAAO,EAAE,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,MAAM,EAAE;aACpD;SACF,CAAC;QACJ,SAAS,EAAE,CAAC,WAAwB,EAA2B,EAAE,CAC/D,YAAY,CAAO;YACjB,WAAW;YACX,KAAK,EAAE,QAAQ;YACf,OAAO,EAAE,OAAO,CAAC,OAAO;SACzB,CAAC;KACL,CAAA;AACH,CAAC;AAKD;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAEjC;IAMC,MAAM,MAAM,GAAiB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;IAClE,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAA;AACrE,CAAC;AAoBD,iFAAiF;AACjF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,GAAe,EACf,OAAgB;IAEhB,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;IAC3E,OAAO,OAAO,EAAE,IAAI,IAAI,IAAI,CAAA;AAC9B,CAAC","sourcesContent":["import { QueryClient } from '@tanstack/react-query'\n\nimport {\n  createClient,\n  type AnyBunderstackApp,\n  type BunderstackClient,\n} from '../query/index'\nimport { createIsomorphicFetch } from './isomorphic-fetch'\n\nexport { createIsomorphicFetch } from './isomorphic-fetch'\n\nexport type BunderstackStartOptions = {\n  /** API mount point. Defaults to '/api'. */\n  baseUrl?: string\n  /** Default query staleTime (ms). Defaults to 30_000. */\n  staleTime?: number\n}\n\n/**\n * One-call client setup for TanStack Start apps: SSR-aware fetch, sensible\n * QueryClient defaults, and a typed query client whose procedures and buckets are\n * inferred from the server app type.\n *\n * @example\n * // src/api.ts — NOT src/client.ts, which is a reserved TanStack Start\n * // entry-point name (it would replace the hydration entry).\n * import type { App } from './bunderstack'\n * export const { createQueryClient, createApi } = bunderstackStart<App>()\n */\nexport function bunderstackStart<TApp extends AnyBunderstackApp>(\n  options: BunderstackStartOptions = {},\n) {\n  const isoFetch = createIsomorphicFetch()\n  return {\n    createQueryClient: () =>\n      new QueryClient({\n        defaultOptions: {\n          queries: { staleTime: options.staleTime ?? 30_000 },\n        },\n      }),\n    createApi: (queryClient: QueryClient): BunderstackClient<TApp> =>\n      createClient<TApp>({\n        queryClient,\n        fetch: isoFetch,\n        baseUrl: options.baseUrl,\n      }),\n  }\n}\n\ntype StartRequestContext = { request: Request }\ntype StartHandler = (ctx: StartRequestContext) => Promise<Response>\n\n/**\n * Handlers object for the catch-all API file route.\n *\n * @example\n * // src/routes/api/$.tsx\n * export const Route = createFileRoute('/api/$')({\n *   server: { handlers: createApiHandlers(app) },\n * })\n */\nexport function createApiHandlers(app: {\n  handler: (req: Request) => Promise<Response>\n}): {\n  GET: StartHandler\n  POST: StartHandler\n  PATCH: StartHandler\n  DELETE: StartHandler\n} {\n  const handle: StartHandler = ({ request }) => app.handler(request)\n  return { GET: handle, POST: handle, PATCH: handle, DELETE: handle }\n}\n\nexport type SessionUser = {\n  id: string\n  email: string\n  name: string\n  image?: string | null\n  role?: string\n}\n\ntype SessionApp = {\n  auth: {\n    api: {\n      getSession: (opts: {\n        headers: Headers\n      }) => Promise<{ user: SessionUser | null } | null>\n    }\n  }\n}\n\n/** Resolve the BetterAuth session user for an incoming request (server-side). */\nexport async function getSessionUser(\n  app: SessionApp,\n  request: Request,\n): Promise<SessionUser | null> {\n  const session = await app.auth.api.getSession({ headers: request.headers })\n  return session?.user ?? null\n}\n"]}

package/dist/storage/background.d.ts

@@ -0,0 +1,3 @@
+export declare const STORAGE_SWEEP_JOB_NAME = "bunderstack:storage-sweep";
+export declare const STORAGE_SWEEP_SCHEDULE = "0 4 * * *";
+//# sourceMappingURL=background.d.ts.map

package/dist/storage/background.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background.d.ts","sourceRoot":"","sources":["../../src/storage/background.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,sBAAsB,8BAA8B,CAAA;AACjE,eAAO,MAAM,sBAAsB,cAAc,CAAA"}

package/dist/storage/background.js

@@ -0,0 +1,3 @@
+export const STORAGE_SWEEP_JOB_NAME = 'bunderstack:storage-sweep';
+export const STORAGE_SWEEP_SCHEDULE = '0 4 * * *';
+//# sourceMappingURL=background.js.map

package/dist/storage/background.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background.js","sourceRoot":"","sources":["../../src/storage/background.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,sBAAsB,GAAG,2BAA2B,CAAA;AACjE,MAAM,CAAC,MAAM,sBAAsB,GAAG,WAAW,CAAA","sourcesContent":["export const STORAGE_SWEEP_JOB_NAME = 'bunderstack:storage-sweep'\nexport const STORAGE_SWEEP_SCHEDULE = '0 4 * * *'\n"]}

package/dist/testing/auth.d.ts

@@ -0,0 +1,57 @@
+export type TestUser = {
+    id: string;
+    email: string;
+    name: string;
+    emailVerified?: boolean;
+    image?: string | null;
+    createdAt?: string | Date;
+    updatedAt?: string | Date;
+};
+export type TestIdentity = {
+    user: TestUser;
+    headers: Headers;
+};
+export declare class TestAuthError extends Error {
+    readonly status: number;
+    readonly body: unknown;
+    constructor(status: number, body: unknown);
+}
+export type SignUpEmailInput = {
+    email: string;
+    name: string;
+    password?: string;
+};
+export type TestAuth = {
+    signUpEmail(input: SignUpEmailInput): Promise<TestIdentity>;
+    mockSession<TUser extends TestUser>(user: TUser): TestIdentity & {
+        user: TUser;
+    };
+};
+export type AuthSessionResolverLike = {
+    api: {
+        getSession: (opts: {
+            headers: Headers;
+        }) => Promise<unknown>;
+    };
+};
+export type BunderstackAppLike = {
+    auth: unknown;
+};
+export declare function mockAuthSession<TUser extends {
+    id: string;
+    email: string;
+    name?: string;
+    role?: string;
+}>(app: BunderstackAppLike, resolver: (opts: {
+    headers: Headers;
+}) => Promise<{
+    user: TUser;
+    session?: {
+        activeOrganizationId?: string | null;
+    } | null;
+} | null>): void;
+export declare function createTestAuth(app: {
+    handler(request: Request): Promise<Response>;
+    auth: unknown;
+}): TestAuth;
+//# sourceMappingURL=auth.d.ts.map

package/dist/testing/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/testing/auth.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACzB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,QAAQ,CAAA;IACd,OAAO,EAAE,OAAO,CAAA;CACjB,CAAA;AAED,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;gBAEV,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO;CAM1C;AAED,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IAC3D,WAAW,CAAC,KAAK,SAAS,QAAQ,EAChC,IAAI,EAAE,KAAK,GACV,YAAY,GAAG;QAAE,IAAI,EAAE,KAAK,CAAA;KAAE,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,GAAG,EAAE;QACH,UAAU,EAAE,CAAC,IAAI,EAAE;YAAE,OAAO,EAAE,OAAO,CAAA;SAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;KAC7D,CAAA;CACF,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,OAAO,CAAA;CACd,CAAA;AAED,wBAAgB,eAAe,CAC7B,KAAK,SAAS;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAEzE,GAAG,EAAE,kBAAkB,EACvB,QAAQ,EAAE,CAAC,IAAI,EAAE;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,KAAK,OAAO,CAAC;IAChD,IAAI,EAAE,KAAK,CAAA;IACX,OAAO,CAAC,EAAE;QAAE,oBAAoB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAA;CAC1D,GAAG,IAAI,CAAC,GACR,IAAI,CAON;AAWD,wBAAgB,cAAc,CAAC,GAAG,EAAE;IAClC,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC5C,IAAI,EAAE,OAAO,CAAA;CACd,GAAG,QAAQ,CAyBX"}

package/dist/testing/auth.js

@@ -0,0 +1,51 @@
+export class TestAuthError extends Error {
+    status;
+    body;
+    constructor(status, body) {
+        super(`Better Auth request failed (${status})`);
+        this.name = 'TestAuthError';
+        this.status = status;
+        this.body = body;
+    }
+}
+export function mockAuthSession(app, resolver) {
+    const auth = app.auth;
+    if (auth?.api) {
+        auth.api.getSession = resolver;
+    }
+}
+function cookieHeaders(response) {
+    const values = response.headers.getSetCookie();
+    const cookie = values
+        .map((value) => value.split(';', 1)[0])
+        .filter((value) => Boolean(value))
+        .join('; ');
+    return new Headers(cookie ? { cookie } : undefined);
+}
+export function createTestAuth(app) {
+    return {
+        async signUpEmail(input) {
+            const response = await app.handler(new Request('http://bunderstack.test/api/auth/sign-up/email', {
+                method: 'POST',
+                headers: { 'content-type': 'application/json' },
+                body: JSON.stringify({
+                    email: input.email,
+                    name: input.name,
+                    password: input.password ?? 'password-123',
+                }),
+            }));
+            const body = await response.json().catch(() => null);
+            if (!response.ok)
+                throw new TestAuthError(response.status, body);
+            const user = body?.user;
+            if (!user)
+                throw new TestAuthError(response.status, body);
+            return { user, headers: cookieHeaders(response) };
+        },
+        mockSession(user) {
+            mockAuthSession(app, async () => ({ user, session: null }));
+            return { user, headers: new Headers() };
+        },
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/testing/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/testing/auth.ts"],"names":[],"mappings":"AAeA,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,MAAM,CAAQ;IACd,IAAI,CAAS;IAEtB,YAAY,MAAc,EAAE,IAAa;QACvC,KAAK,CAAC,+BAA+B,MAAM,GAAG,CAAC,CAAA;QAC/C,IAAI,CAAC,IAAI,GAAG,eAAe,CAAA;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAA;QACpB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAyBD,MAAM,UAAU,eAAe,CAG7B,GAAuB,EACvB,QAGS;IAET,MAAM,IAAI,GAAG,GAAG,CAAC,IAA0C,CAAA;IAC3D,IAAI,IAAI,EAAE,GAAG,EAAE,CAAC;QACd,IAAI,CAAC,GAAG,CAAC,UAAU,GAAG,QAEA,CAAA;IACxB,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,QAAkB;IACvC,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,EAAE,CAAA;IAC9C,MAAM,MAAM,GAAG,MAAM;SAClB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SACtC,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;SAClD,IAAI,CAAC,IAAI,CAAC,CAAA;IACb,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAA;AACrD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAG9B;IACC,OAAO;QACL,KAAK,CAAC,WAAW,CAAC,KAAK;YACrB,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,OAAO,CAChC,IAAI,OAAO,CAAC,gDAAgD,EAAE;gBAC5D,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;gBAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,KAAK,EAAE,KAAK,CAAC,KAAK;oBAClB,IAAI,EAAE,KAAK,CAAC,IAAI;oBAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,cAAc;iBAC3C,CAAC;aACH,CAAC,CACH,CAAA;YACD,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAA;YACpD,IAAI,CAAC,QAAQ,CAAC,EAAE;gBAAE,MAAM,IAAI,aAAa,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;YAChE,MAAM,IAAI,GAAI,IAAmC,EAAE,IAAI,CAAA;YACvD,IAAI,CAAC,IAAI;gBAAE,MAAM,IAAI,aAAa,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAA;YACzD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAA;QACnD,CAAC;QACD,WAAW,CAAC,IAAI;YACd,eAAe,CAAC,GAAG,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;YAC3D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,OAAO,EAAE,EAAE,CAAA;QACzC,CAAC;KACF,CAAA;AACH,CAAC","sourcesContent":["export type TestUser = {\n  id: string\n  email: string\n  name: string\n  emailVerified?: boolean\n  image?: string | null\n  createdAt?: string | Date\n  updatedAt?: string | Date\n}\n\nexport type TestIdentity = {\n  user: TestUser\n  headers: Headers\n}\n\nexport class TestAuthError extends Error {\n  readonly status: number\n  readonly body: unknown\n\n  constructor(status: number, body: unknown) {\n    super(`Better Auth request failed (${status})`)\n    this.name = 'TestAuthError'\n    this.status = status\n    this.body = body\n  }\n}\n\nexport type SignUpEmailInput = {\n  email: string\n  name: string\n  password?: string\n}\n\nexport type TestAuth = {\n  signUpEmail(input: SignUpEmailInput): Promise<TestIdentity>\n  mockSession<TUser extends TestUser>(\n    user: TUser,\n  ): TestIdentity & { user: TUser }\n}\n\nexport type AuthSessionResolverLike = {\n  api: {\n    getSession: (opts: { headers: Headers }) => Promise<unknown>\n  }\n}\n\nexport type BunderstackAppLike = {\n  auth: unknown\n}\n\nexport function mockAuthSession<\n  TUser extends { id: string; email: string; name?: string; role?: string },\n>(\n  app: BunderstackAppLike,\n  resolver: (opts: { headers: Headers }) => Promise<{\n    user: TUser\n    session?: { activeOrganizationId?: string | null } | null\n  } | null>,\n): void {\n  const auth = app.auth as unknown as AuthSessionResolverLike\n  if (auth?.api) {\n    auth.api.getSession = resolver as unknown as (opts: {\n      headers: Headers\n    }) => Promise<unknown>\n  }\n}\n\nfunction cookieHeaders(response: Response): Headers {\n  const values = response.headers.getSetCookie()\n  const cookie = values\n    .map((value) => value.split(';', 1)[0])\n    .filter((value): value is string => Boolean(value))\n    .join('; ')\n  return new Headers(cookie ? { cookie } : undefined)\n}\n\nexport function createTestAuth(app: {\n  handler(request: Request): Promise<Response>\n  auth: unknown\n}): TestAuth {\n  return {\n    async signUpEmail(input) {\n      const response = await app.handler(\n        new Request('http://bunderstack.test/api/auth/sign-up/email', {\n          method: 'POST',\n          headers: { 'content-type': 'application/json' },\n          body: JSON.stringify({\n            email: input.email,\n            name: input.name,\n            password: input.password ?? 'password-123',\n          }),\n        }),\n      )\n      const body = await response.json().catch(() => null)\n      if (!response.ok) throw new TestAuthError(response.status, body)\n      const user = (body as { user?: TestUser } | null)?.user\n      if (!user) throw new TestAuthError(response.status, body)\n      return { user, headers: cookieHeaders(response) }\n    },\n    mockSession(user) {\n      mockAuthSession(app, async () => ({ user, session: null }))\n      return { user, headers: new Headers() }\n    },\n  }\n}\n"]}

package/dist/testing/client.d.ts

@@ -0,0 +1,6 @@
+import type { AnyBunderstackApp, BunderstackClient } from '../client/rpc-client.js';
+import type { TestIdentity } from './auth.js';
+export declare function testClient<TApp extends AnyBunderstackApp>(app: TApp & {
+    handler(request: Request): Promise<Response>;
+}, identity?: TestIdentity): BunderstackClient<TApp>;
+//# sourceMappingURL=client.d.ts.map

package/dist/testing/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/testing/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAI1C,wBAAgB,UAAU,CAAC,IAAI,SAAS,iBAAiB,EACvD,GAAG,EAAE,IAAI,GAAG;IAAE,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;CAAE,EAC5D,QAAQ,CAAC,EAAE,YAAY,GACtB,iBAAiB,CAAC,IAAI,CAAC,CAMzB"}

package/dist/testing/client.js

@@ -0,0 +1,9 @@
+import { createClient } from '../client/rpc-client.js';
+export function testClient(app, identity) {
+    return createClient({
+        baseUrl: 'http://bunderstack.test/api',
+        fetch: (input, init) => app.handler(new Request(input, init)),
+        headers: identity?.headers,
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/testing/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/testing/client.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD,MAAM,UAAU,UAAU,CACxB,GAA4D,EAC5D,QAAuB;IAEvB,OAAO,YAAY,CAAO;QACxB,OAAO,EAAE,6BAA6B;QACtC,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;QAC7D,OAAO,EAAE,QAAQ,EAAE,OAAO;KAC3B,CAAC,CAAA;AACJ,CAAC","sourcesContent":["import type { AnyBunderstackApp, BunderstackClient } from '../client/rpc-client'\nimport type { TestIdentity } from './auth'\n\nimport { createClient } from '../client/rpc-client'\n\nexport function testClient<TApp extends AnyBunderstackApp>(\n  app: TApp & { handler(request: Request): Promise<Response> },\n  identity?: TestIdentity,\n): BunderstackClient<TApp> {\n  return createClient<TApp>({\n    baseUrl: 'http://bunderstack.test/api',\n    fetch: (input, init) => app.handler(new Request(input, init)),\n    headers: identity?.headers,\n  })\n}\n"]}

package/dist/testing/database.d.ts

@@ -0,0 +1,6 @@
+import type { DatabaseAdapter, TestDatabaseStrategy, TestDatabaseTarget } from '../database/adapter.js';
+export declare function createTestDatabaseTarget(adapter: DatabaseAdapter, options: {
+    mode: 'memory' | 'temporary';
+    strategy?: TestDatabaseStrategy;
+}): Promise<TestDatabaseTarget>;
+//# sourceMappingURL=database.d.ts.map

package/dist/testing/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/testing/database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EACnB,MAAM,qBAAqB,CAAA;AAE5B,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,eAAe,EACxB,OAAO,EAAE;IACP,IAAI,EAAE,QAAQ,GAAG,WAAW,CAAA;IAC5B,QAAQ,CAAC,EAAE,oBAAoB,CAAA;CAChC,GACA,OAAO,CAAC,kBAAkB,CAAC,CAQ7B"}

package/dist/testing/database.js

@@ -0,0 +1,8 @@
+export async function createTestDatabaseTarget(adapter, options) {
+    const strategy = options.strategy ?? adapter.testing;
+    if (!strategy) {
+        throw new Error(`[bunderstack] ${adapter.driver} requires an explicit test database strategy`);
+    }
+    return strategy.createTarget({ mode: options.mode });
+}
+//# sourceMappingURL=database.js.map

package/dist/testing/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/testing/database.ts"],"names":[],"mappings":"AAMA,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,OAAwB,EACxB,OAGC;IAED,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,OAAO,CAAA;IACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CACb,iBAAiB,OAAO,CAAC,MAAM,8CAA8C,CAC9E,CAAA;IACH,CAAC;IACD,OAAO,QAAQ,CAAC,YAAY,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAA;AACtD,CAAC","sourcesContent":["import type {\n  DatabaseAdapter,\n  TestDatabaseStrategy,\n  TestDatabaseTarget,\n} from '../database/adapter'\n\nexport async function createTestDatabaseTarget(\n  adapter: DatabaseAdapter,\n  options: {\n    mode: 'memory' | 'temporary'\n    strategy?: TestDatabaseStrategy\n  },\n): Promise<TestDatabaseTarget> {\n  const strategy = options.strategy ?? adapter.testing\n  if (!strategy) {\n    throw new Error(\n      `[bunderstack] ${adapter.driver} requires an explicit test database strategy`,\n    )\n  }\n  return strategy.createTarget({ mode: options.mode })\n}\n"]}

package/dist/testing/email.d.ts

@@ -0,0 +1,15 @@
+import type { EmailAdapter, EmailMessage } from '../email.js';
+export type CapturedEmail = Omit<EmailMessage, 'to' | 'cc' | 'bcc'> & {
+    from: string;
+    to: string[];
+    cc?: string[];
+    bcc?: string[];
+};
+export type TestEmail = {
+    readonly sent: readonly Readonly<CapturedEmail>[];
+};
+export declare function createTestEmail(): {
+    adapter: EmailAdapter;
+    email: TestEmail;
+};
+//# sourceMappingURL=email.d.ts.map

package/dist/testing/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../src/testing/email.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAE1D,MAAM,MAAM,aAAa,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC,GAAG;IACpE,IAAI,EAAE,MAAM,CAAA;IACZ,EAAE,EAAE,MAAM,EAAE,CAAA;IACZ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAA;IACb,GAAG,CAAC,EAAE,MAAM,EAAE,CAAA;CACf,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,IAAI,EAAE,SAAS,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAA;CAClD,CAAA;AAKD,wBAAgB,eAAe,IAAI;IACjC,OAAO,EAAE,YAAY,CAAA;IACrB,KAAK,EAAE,SAAS,CAAA;CACjB,CAiCA"}

package/dist/testing/email.js

@@ -0,0 +1,32 @@
+const addresses = (value) => value === undefined ? undefined : Array.isArray(value) ? [...value] : [value];
+export function createTestEmail() {
+    const messages = [];
+    return {
+        adapter: {
+            async send(message) {
+                messages.push({
+                    ...message,
+                    to: addresses(message.to) ?? [],
+                    cc: addresses(message.cc),
+                    bcc: addresses(message.bcc),
+                });
+                return { id: `test-email-${messages.length}` };
+            },
+        },
+        email: {
+            get sent() {
+                return Object.freeze(messages.map((message) => Object.freeze({
+                    ...message,
+                    to: Object.freeze([...message.to]),
+                    cc: message.cc
+                        ? Object.freeze([...message.cc])
+                        : undefined,
+                    bcc: message.bcc
+                        ? Object.freeze([...message.bcc])
+                        : undefined,
+                })));
+            },
+        },
+    };
+}
+//# sourceMappingURL=email.js.map

package/dist/testing/email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.js","sourceRoot":"","sources":["../../src/testing/email.ts"],"names":[],"mappings":"AAaA,MAAM,SAAS,GAAG,CAAC,KAAoC,EAAE,EAAE,CACzD,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAA;AAE/E,MAAM,UAAU,eAAe;IAI7B,MAAM,QAAQ,GAAoB,EAAE,CAAA;IACpC,OAAO;QACL,OAAO,EAAE;YACP,KAAK,CAAC,IAAI,CAAC,OAAO;gBAChB,QAAQ,CAAC,IAAI,CAAC;oBACZ,GAAG,OAAO;oBACV,EAAE,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE;oBAC/B,EAAE,EAAE,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;oBACzB,GAAG,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC;iBAC5B,CAAC,CAAA;gBACF,OAAO,EAAE,EAAE,EAAE,cAAc,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAA;YAChD,CAAC;SACF;QACD,KAAK,EAAE;YACL,IAAI,IAAI;gBACN,OAAO,MAAM,CAAC,MAAM,CAClB,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CACvB,MAAM,CAAC,MAAM,CAAC;oBACZ,GAAG,OAAO;oBACV,EAAE,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAwB;oBACzD,EAAE,EAAE,OAAO,CAAC,EAAE;wBACZ,CAAC,CAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,EAAE,CAAC,CAAyB;wBACzD,CAAC,CAAC,SAAS;oBACb,GAAG,EAAE,OAAO,CAAC,GAAG;wBACd,CAAC,CAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAyB;wBAC1D,CAAC,CAAC,SAAS;iBACd,CAAC,CACH,CACF,CAAA;YACH,CAAC;SACF;KACF,CAAA;AACH,CAAC","sourcesContent":["import type { EmailAdapter, EmailMessage } from '../email'\n\nexport type CapturedEmail = Omit<EmailMessage, 'to' | 'cc' | 'bcc'> & {\n  from: string\n  to: string[]\n  cc?: string[]\n  bcc?: string[]\n}\n\nexport type TestEmail = {\n  readonly sent: readonly Readonly<CapturedEmail>[]\n}\n\nconst addresses = (value: string | string[] | undefined) =>\n  value === undefined ? undefined : Array.isArray(value) ? [...value] : [value]\n\nexport function createTestEmail(): {\n  adapter: EmailAdapter\n  email: TestEmail\n} {\n  const messages: CapturedEmail[] = []\n  return {\n    adapter: {\n      async send(message) {\n        messages.push({\n          ...message,\n          to: addresses(message.to) ?? [],\n          cc: addresses(message.cc),\n          bcc: addresses(message.bcc),\n        })\n        return { id: `test-email-${messages.length}` }\n      },\n    },\n    email: {\n      get sent() {\n        return Object.freeze(\n          messages.map((message) =>\n            Object.freeze({\n              ...message,\n              to: Object.freeze([...message.to]) as unknown as string[],\n              cc: message.cc\n                ? (Object.freeze([...message.cc]) as unknown as string[])\n                : undefined,\n              bcc: message.bcc\n                ? (Object.freeze([...message.bcc]) as unknown as string[])\n                : undefined,\n            }),\n          ),\n        )\n      },\n    },\n  }\n}\n"]}

package/dist/testing/fixture.d.ts

@@ -0,0 +1,33 @@
+import type { BunderstackBackend } from '../backend.js';
+import type { AnyBunderstackApp, BunderstackClient } from '../client/rpc-client.js';
+import type { TestDatabaseStrategy } from '../database/adapter.js';
+import type { TestSchemaMode } from '../provision.js';
+import type { TestAuth, TestIdentity } from './auth.js';
+import type { TestEmail } from './email.js';
+import type { TestStorage } from './storage.js';
+import { type TestJobs } from './jobs.js';
+export type TestOptions = {
+    env?: Record<string, string | undefined>;
+    database?: {
+        mode?: 'memory' | 'temporary';
+        schema?: TestSchemaMode;
+        strategy?: TestDatabaseStrategy;
+    };
+};
+export type TestFixture<TApp> = AsyncDisposable & {
+    readonly app: TApp;
+    readonly auth: TestAuth;
+    readonly email: TestEmail;
+    readonly jobs: TestJobs;
+    readonly storage: TestStorage;
+    client(identity?: TestIdentity): TApp extends AnyBunderstackApp ? BunderstackClient<TApp> : never;
+    close(): Promise<void>;
+};
+type TestableApp = {
+    auth: unknown;
+    handler(request: Request): Promise<Response>;
+    close(): Promise<void>;
+};
+export declare function createTestApp<TApp extends TestableApp>(backend: BunderstackBackend<TApp>, options?: TestOptions): Promise<TestFixture<TApp>>;
+export {};
+//# sourceMappingURL=fixture.d.ts.map

package/dist/testing/fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../../src/testing/fixture.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAA;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAChF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AACpD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,WAAW,CAAA;AAW5C,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,QAAQ,CAAA;AAGtD,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;IACxC,QAAQ,CAAC,EAAE;QACT,IAAI,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAA;QAC7B,MAAM,CAAC,EAAE,cAAc,CAAA;QACvB,QAAQ,CAAC,EAAE,oBAAoB,CAAA;KAChC,CAAA;CACF,CAAA;AAED,MAAM,MAAM,WAAW,CAAC,IAAI,IAAI,eAAe,GAAG;IAChD,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAA;IAClB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAA;IACvB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAA;IAC7B,MAAM,CACJ,QAAQ,CAAC,EAAE,YAAY,GACtB,IAAI,SAAS,iBAAiB,GAAG,iBAAiB,CAAC,IAAI,CAAC,GAAG,KAAK,CAAA;IACnE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB,CAAA;AAED,KAAK,WAAW,GAAG;IACjB,IAAI,EAAE,OAAO,CAAA;IACb,OAAO,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC5C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB,CAAA;AAQD,wBAAsB,aAAa,CAAC,IAAI,SAAS,WAAW,EAC1D,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAC,EACjC,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAmH5B"}

package/dist/testing/fixture.js

@@ -0,0 +1,125 @@
+import { mkdtemp, rm } from 'node:fs/promises';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { BACKEND_INTERNALS, } from '../backend-internals.js';
+import { provisionForTest } from '../provision.js';
+import { createTestAuth } from './auth.js';
+import { testClient } from './client.js';
+import { createTestDatabaseTarget } from './database.js';
+import { createTestEmail } from './email.js';
+import { createTestJobs } from './jobs.js';
+import { createTestStorage, resolveTestBuckets } from './storage.js';
+const defaultTestEnv = {
+    NODE_ENV: 'test',
+    AUTH_SECRET: 'bunderstack-test-secret',
+    BUNDERSTACK_ROLE: 'web',
+};
+export async function createTestApp(backend, options = {}) {
+    const internals = backend[BACKEND_INTERNALS];
+    const storageRoot = await mkdtemp(join(tmpdir(), 'bunderstack-storage-'));
+    const resolvedStorage = resolveTestBuckets(internals.declaration.config.storage, storageRoot);
+    const { adapter: emailAdapter, email } = createTestEmail();
+    const storage = createTestStorage(resolvedStorage);
+    let target;
+    try {
+        target = await createTestDatabaseTarget(internals.declaration.config.database.adapter, {
+            mode: options.database?.mode ?? 'memory',
+            strategy: options.database?.strategy,
+        });
+    }
+    catch (cause) {
+        await rm(storageRoot, { recursive: true, force: true });
+        throw cause;
+    }
+    let app;
+    let testingHandle;
+    try {
+        app = await internals.start({ ...defaultTestEnv, ...options.env }, {
+            database: target.connection,
+            resolvedStorage,
+            emailAdapter,
+            forceMemoryRealtime: true,
+            backgroundAutoStart: false,
+            captureTestingHandle: (handle) => {
+                testingHandle = handle;
+            },
+        });
+        await provisionForTest(app, options.database?.schema ?? 'auto');
+    }
+    catch (cause) {
+        const cleanupErrors = [];
+        if (app) {
+            try {
+                await app.close();
+            }
+            catch (error) {
+                cleanupErrors.push(error);
+            }
+        }
+        try {
+            await target[Symbol.asyncDispose]();
+        }
+        catch (error) {
+            cleanupErrors.push(error);
+        }
+        try {
+            await rm(storageRoot, { recursive: true, force: true });
+        }
+        catch (error) {
+            cleanupErrors.push(error);
+        }
+        if (cleanupErrors.length > 0) {
+            throw new AggregateError([cause, ...cleanupErrors], '[bunderstack] test fixture setup and cleanup failed');
+        }
+        throw cause;
+    }
+    if (!testingHandle) {
+        await app.close();
+        await target[Symbol.asyncDispose]();
+        await rm(storageRoot, { recursive: true, force: true });
+        throw new Error('[bunderstack] runtime did not provide test controls');
+    }
+    const auth = createTestAuth(app);
+    const jobs = createTestJobs(testingHandle);
+    let closePromise;
+    const close = () => {
+        closePromise ??= (async () => {
+            const errors = [];
+            try {
+                await app.close();
+            }
+            catch (error) {
+                errors.push(error);
+            }
+            try {
+                await target[Symbol.asyncDispose]();
+            }
+            catch (error) {
+                errors.push(error);
+            }
+            try {
+                await rm(storageRoot, { recursive: true, force: true });
+            }
+            catch (error) {
+                errors.push(error);
+            }
+            if (errors.length === 1)
+                throw errors[0];
+            if (errors.length > 1) {
+                throw new AggregateError(errors, '[bunderstack] fixture cleanup failed');
+            }
+        })();
+        return closePromise;
+    };
+    return {
+        app,
+        auth,
+        email,
+        jobs,
+        storage,
+        client: (identity) => testClient(app, identity),
+        close,
+        [Symbol.asyncDispose]: close,
+    };
+}
+//# sourceMappingURL=fixture.js.map

package/dist/testing/fixture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.js","sourceRoot":"","sources":["../../src/testing/fixture.ts"],"names":[],"mappings":"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","sourcesContent":["import { mkdtemp, rm } from 'node:fs/promises'\nimport { tmpdir } from 'node:os'\nimport { join } from 'node:path'\n\nimport type { BunderstackBackend } from '../backend'\nimport type { AnyBunderstackApp, BunderstackClient } from '../client/rpc-client'\nimport type { TestDatabaseStrategy } from '../database/adapter'\nimport type { TestSchemaMode } from '../provision'\nimport type { TestAuth, TestIdentity } from './auth'\nimport type { TestEmail } from './email'\nimport type { TestStorage } from './storage'\n\nimport {\n  BACKEND_INTERNALS,\n  type RuntimeTestingHandle,\n} from '../backend-internals'\nimport { provisionForTest } from '../provision'\nimport { createTestAuth } from './auth'\nimport { testClient } from './client'\nimport { createTestDatabaseTarget } from './database'\nimport { createTestEmail } from './email'\nimport { createTestJobs, type TestJobs } from './jobs'\nimport { createTestStorage, resolveTestBuckets } from './storage'\n\nexport type TestOptions = {\n  env?: Record<string, string | undefined>\n  database?: {\n    mode?: 'memory' | 'temporary'\n    schema?: TestSchemaMode\n    strategy?: TestDatabaseStrategy\n  }\n}\n\nexport type TestFixture<TApp> = AsyncDisposable & {\n  readonly app: TApp\n  readonly auth: TestAuth\n  readonly email: TestEmail\n  readonly jobs: TestJobs\n  readonly storage: TestStorage\n  client(\n    identity?: TestIdentity,\n  ): TApp extends AnyBunderstackApp ? BunderstackClient<TApp> : never\n  close(): Promise<void>\n}\n\ntype TestableApp = {\n  auth: unknown\n  handler(request: Request): Promise<Response>\n  close(): Promise<void>\n}\n\nconst defaultTestEnv = {\n  NODE_ENV: 'test',\n  AUTH_SECRET: 'bunderstack-test-secret',\n  BUNDERSTACK_ROLE: 'web',\n} satisfies Record<string, string | undefined>\n\nexport async function createTestApp<TApp extends TestableApp>(\n  backend: BunderstackBackend<TApp>,\n  options: TestOptions = {},\n): Promise<TestFixture<TApp>> {\n  const internals = backend[BACKEND_INTERNALS]\n  const storageRoot = await mkdtemp(join(tmpdir(), 'bunderstack-storage-'))\n  const resolvedStorage = resolveTestBuckets(\n    internals.declaration.config.storage,\n    storageRoot,\n  )\n  const { adapter: emailAdapter, email } = createTestEmail()\n  const storage = createTestStorage(resolvedStorage)\n\n  let target\n  try {\n    target = await createTestDatabaseTarget(\n      internals.declaration.config.database.adapter,\n      {\n        mode: options.database?.mode ?? 'memory',\n        strategy: options.database?.strategy,\n      },\n    )\n  } catch (cause) {\n    await rm(storageRoot, { recursive: true, force: true })\n    throw cause\n  }\n\n  let app: TApp | undefined\n  let testingHandle: RuntimeTestingHandle | undefined\n  try {\n    app = await internals.start(\n      { ...defaultTestEnv, ...options.env },\n      {\n        database: target.connection,\n        resolvedStorage,\n        emailAdapter,\n        forceMemoryRealtime: true,\n        backgroundAutoStart: false,\n        captureTestingHandle: (handle) => {\n          testingHandle = handle\n        },\n      },\n    )\n    await provisionForTest(app as object, options.database?.schema ?? 'auto')\n  } catch (cause) {\n    const cleanupErrors: unknown[] = []\n    if (app) {\n      try {\n        await app.close()\n      } catch (error) {\n        cleanupErrors.push(error)\n      }\n    }\n    try {\n      await target[Symbol.asyncDispose]()\n    } catch (error) {\n      cleanupErrors.push(error)\n    }\n    try {\n      await rm(storageRoot, { recursive: true, force: true })\n    } catch (error) {\n      cleanupErrors.push(error)\n    }\n    if (cleanupErrors.length > 0) {\n      throw new AggregateError(\n        [cause, ...cleanupErrors],\n        '[bunderstack] test fixture setup and cleanup failed',\n      )\n    }\n    throw cause\n  }\n\n  if (!testingHandle) {\n    await app.close()\n    await target[Symbol.asyncDispose]()\n    await rm(storageRoot, { recursive: true, force: true })\n    throw new Error('[bunderstack] runtime did not provide test controls')\n  }\n\n  const auth = createTestAuth(app)\n  const jobs = createTestJobs(testingHandle)\n  let closePromise: Promise<void> | undefined\n  const close = () => {\n    closePromise ??= (async () => {\n      const errors: unknown[] = []\n      try {\n        await app.close()\n      } catch (error) {\n        errors.push(error)\n      }\n      try {\n        await target[Symbol.asyncDispose]()\n      } catch (error) {\n        errors.push(error)\n      }\n      try {\n        await rm(storageRoot, { recursive: true, force: true })\n      } catch (error) {\n        errors.push(error)\n      }\n      if (errors.length === 1) throw errors[0]\n      if (errors.length > 1) {\n        throw new AggregateError(errors, '[bunderstack] fixture cleanup failed')\n      }\n    })()\n    return closePromise\n  }\n\n  return {\n    app,\n    auth,\n    email,\n    jobs,\n    storage,\n    client: (identity) => testClient(app as never, identity) as never,\n    close,\n    [Symbol.asyncDispose]: close,\n  }\n}\n"]}

package/dist/testing/jobs.d.ts

@@ -0,0 +1,32 @@
+import type { RuntimeJobFailure, RuntimeTestingHandle } from '../backend-internals.js';
+export type JobRunReport = {
+    ticks: number;
+    claimed: number;
+    ran: number;
+    failed: number;
+    remainingRunnable: number;
+};
+export type RunNextOptions = {
+    now?: Date | number;
+};
+export type RunUntilIdleOptions = RunNextOptions & {
+    maxTicks?: number;
+    failOnJobError?: boolean;
+};
+export declare class TestJobsError extends Error {
+    readonly report: JobRunReport;
+    readonly failures: RuntimeJobFailure[];
+    readonly name = "TestJobsError";
+    constructor(report: JobRunReport, failures: RuntimeJobFailure[]);
+}
+export declare class TestJobsConvergenceError extends Error {
+    readonly report: JobRunReport;
+    readonly name = "TestJobsConvergenceError";
+    constructor(report: JobRunReport);
+}
+export type TestJobs = {
+    runNext(options?: RunNextOptions): Promise<JobRunReport>;
+    runUntilIdle(options?: RunUntilIdleOptions): Promise<JobRunReport>;
+};
+export declare function createTestJobs(handle: RuntimeTestingHandle): TestJobs;
+//# sourceMappingURL=jobs.d.ts.map

package/dist/testing/jobs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/testing/jobs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,oBAAoB,EACrB,MAAM,sBAAsB,CAAA;AAE7B,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,iBAAiB,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAAE,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,CAAA;AAEpD,MAAM,MAAM,mBAAmB,GAAG,cAAc,GAAG;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,cAAc,CAAC,EAAE,OAAO,CAAA;CACzB,CAAA;AAED,qBAAa,aAAc,SAAQ,KAAK;IAIpC,QAAQ,CAAC,MAAM,EAAE,YAAY;IAC7B,QAAQ,CAAC,QAAQ,EAAE,iBAAiB,EAAE;IAJxC,SAAkB,IAAI,mBAAkB;gBAG7B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,iBAAiB,EAAE;CAMzC;AAED,qBAAa,wBAAyB,SAAQ,KAAK;IAGrC,QAAQ,CAAC,MAAM,EAAE,YAAY;IAFzC,SAAkB,IAAI,8BAA6B;gBAE9B,MAAM,EAAE,YAAY;CAK1C;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;IACxD,YAAY,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAA;CACnE,CAAA;AAMD,wBAAgB,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,QAAQ,CAiDrE"}

package/dist/testing/jobs.js

@@ -0,0 +1,67 @@
+export class TestJobsError extends Error {
+    report;
+    failures;
+    name = 'TestJobsError';
+    constructor(report, failures) {
+        super(`[bunderstack] ${failures.length} background job${failures.length === 1 ? '' : 's'} failed: ${failures.map((failure) => `${failure.name}: ${failure.lastError ?? 'unknown error'}`).join('; ')}`);
+        this.report = report;
+        this.failures = failures;
+    }
+}
+export class TestJobsConvergenceError extends Error {
+    report;
+    name = 'TestJobsConvergenceError';
+    constructor(report) {
+        super(`[bunderstack] background jobs did not become idle after ${report.ticks} ticks (${report.remainingRunnable} still runnable)`);
+        this.report = report;
+    }
+}
+function timestamp(value) {
+    return value === undefined ? Date.now() : new Date(value).getTime();
+}
+export function createTestJobs(handle) {
+    return {
+        async runNext(options = {}) {
+            const now = timestamp(options.now);
+            const tick = await handle.tick(now);
+            const inspection = await handle.inspect(now);
+            return {
+                ticks: 1,
+                ...tick,
+                remainingRunnable: inspection.runnable,
+            };
+        },
+        async runUntilIdle(options = {}) {
+            const now = timestamp(options.now);
+            const maxTicks = options.maxTicks ?? 100;
+            if (!Number.isInteger(maxTicks) || maxTicks <= 0) {
+                throw new TypeError('[bunderstack] maxTicks must be a positive integer');
+            }
+            const report = {
+                ticks: 0,
+                claimed: 0,
+                ran: 0,
+                failed: 0,
+                remainingRunnable: 0,
+            };
+            let inspection;
+            do {
+                const tick = await handle.tick(now);
+                report.ticks++;
+                report.claimed += tick.claimed;
+                report.ran += tick.ran;
+                report.failed += tick.failed;
+                inspection = await handle.inspect(now);
+                report.remainingRunnable = inspection.runnable;
+                if (inspection.runnable > 0 && report.ticks >= maxTicks) {
+                    throw new TestJobsConvergenceError(report);
+                }
+            } while (inspection.runnable > 0);
+            if ((options.failOnJobError ?? true) && inspection.failed.length > 0) {
+                throw new TestJobsError(report, inspection.failed);
+            }
+            return report;
+        },
+    };
+}
+//# sourceMappingURL=jobs.js.map