@momentumcms/server-analog 0.0.1

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@momentumcms/server-analog",
+  "version": "0.0.1",
+  "description": "Nitro/h3 adapter for Momentum CMS with Analog.js support",
+  "license": "MIT",
+  "author": "Momentum CMS Contributors",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/momentum-cms/momentum-cms.git",
+    "directory": "libs/server-analog"
+  },
+  "homepage": "https://github.com/momentum-cms/momentum-cms#readme",
+  "bugs": {
+    "url": "https://github.com/momentum-cms/momentum-cms/issues"
+  },
+  "keywords": [
+    "cms",
+    "momentum-cms",
+    "analog",
+    "nitro",
+    "h3",
+    "server"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "type": "commonjs",
+  "main": "./index.cjs",
+  "types": "./src/index.d.ts",
+  "peerDependencies": {
+    "@momentumcms/core": ">=0.0.1",
+    "@momentumcms/server-core": ">=0.0.1"
+  },
+  "dependencies": {
+    "@aws-sdk/client-s3": "^3.983.0",
+    "@aws-sdk/s3-request-presigner": "^3.983.0",
+    "graphql": "^16.12.0"
+  }
+}

package/src/index.d.ts

@@ -0,0 +1 @@
+export * from './lib/server-analog';

package/src/lib/server-analog.d.ts

@@ -0,0 +1,120 @@
+import { type MomentumResponse } from '@momentumcms/server-core';
+import type { MomentumConfig, ResolvedMomentumConfig, UserContext } from '@momentumcms/core';
+/**
+ * H3 Event interface (simplified for type compatibility).
+ */
+export interface H3Event {
+    method: string;
+    path: string;
+    context: {
+        params?: Record<string, string>;
+    };
+    node?: {
+        req: {
+            url?: string;
+        };
+    };
+}
+/**
+ * Type for readBody function from h3.
+ */
+export type ReadBodyFn = (event: H3Event) => Promise<Record<string, unknown>>;
+/**
+ * Type for getQuery function from h3.
+ */
+export type GetQueryFn = (event: H3Event) => Record<string, string | string[]>;
+/**
+ * Type for getRouterParams function from h3.
+ */
+export type GetRouterParamsFn = (event: H3Event) => Record<string, string>;
+/**
+ * Type for setResponseHeader function from h3.
+ */
+export type SetResponseHeaderFn = (event: H3Event, key: string, value: string) => void;
+/**
+ * Type for readMultipartFormData function from h3.
+ */
+export type ReadMultipartFormDataFn = (event: H3Event) => Promise<Array<{
+    name?: string;
+    filename?: string;
+    type?: string;
+    data: Buffer;
+}> | undefined>;
+/**
+ * Type for send function from h3.
+ */
+export type SendFn = (event: H3Event, data: Buffer | string, type?: string) => unknown;
+/**
+ * Extended h3 utilities for comprehensive API handling.
+ */
+export interface MomentumH3Utils {
+    readBody(event: H3Event): Promise<Record<string, unknown>>;
+    getQuery(event: H3Event): Record<string, string | string[]>;
+    getRouterParams(event: H3Event): Record<string, string>;
+    setResponseStatus(event: H3Event, status: number): void;
+    setResponseHeader(event: H3Event, key: string, value: string): void;
+    readMultipartFormData(event: H3Event): Promise<Array<{
+        name?: string;
+        filename?: string;
+        type?: string;
+        data: Buffer;
+    }> | undefined>;
+    send(event: H3Event, data: Buffer | string, type?: string): unknown;
+}
+/**
+ * Creates an h3 event handler for Momentum CMS API.
+ *
+ * Usage in Analog.js:
+ * ```typescript
+ * // src/server/routes/api/[...momentum].ts
+ * import { defineEventHandler, readBody, getQuery, getRouterParams } from 'h3';
+ * import { createMomentumHandler } from '@momentumcms/server-analog';
+ * import momentumConfig from '../../../momentum.config';
+ *
+ * const handler = createMomentumHandler(momentumConfig);
+ *
+ * export default defineEventHandler(async (event) => {
+ *   return handler(event, { readBody, getQuery, getRouterParams });
+ * });
+ * ```
+ */
+export declare function createMomentumHandler(config: MomentumConfig | ResolvedMomentumConfig): (event: H3Event, utils: {
+    readBody: ReadBodyFn;
+    getQuery: GetQueryFn;
+    getRouterParams: GetRouterParamsFn;
+}) => Promise<{
+    status: number;
+    body: MomentumResponse;
+}>;
+/**
+ * Simplified handler that returns the response directly (for use with defineEventHandler).
+ * This version handles method extraction and body parsing internally.
+ */
+export declare function createSimpleMomentumHandler(config: MomentumConfig | ResolvedMomentumConfig): (event: H3Event, utils: {
+    readBody: ReadBodyFn;
+    getQuery: GetQueryFn;
+    getRouterParams: GetRouterParamsFn;
+    setResponseStatus: (event: H3Event, status: number) => void;
+}) => Promise<MomentumResponse>;
+/**
+ * Creates a comprehensive h3 event handler that mirrors all Express API routes.
+ * Handles: access control, GraphQL, globals, versioning, publishing, media,
+ * batch operations, search, import/export, custom endpoints, preview, and CRUD.
+ *
+ * Usage in Analog.js:
+ * ```typescript
+ * import { defineEventHandler, readBody, getQuery, getRouterParams,
+ *   setResponseStatus, setResponseHeader, readMultipartFormData, send, getHeaders } from 'h3';
+ * import { createComprehensiveMomentumHandler } from '@momentumcms/server-analog';
+ *
+ * const handler = createComprehensiveMomentumHandler(momentumConfig);
+ *
+ * export default defineEventHandler(async (event) => {
+ *   const user = await resolveSession(event);
+ *   return handler(event, { readBody, getQuery, ... }, { user });
+ * });
+ * ```
+ */
+export declare function createComprehensiveMomentumHandler(config: MomentumConfig | ResolvedMomentumConfig): (event: H3Event, utils: MomentumH3Utils, context?: {
+    user?: UserContext;
+}) => Promise<unknown>;