@fnd-platform/api 1.0.0-alpha.1

package/lib/handlers/content.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Content CRUD handler template.
+ *
+ * This template demonstrates the standard patterns for building
+ * CRUD (Create, Read, Update, Delete) API endpoints using
+ * fnd-platform utilities.
+ *
+ * @packageDocumentation
+ */
+import type { APIGatewayProxyHandler } from 'aws-lambda';
+/**
+ * GET /content - List all content items.
+ *
+ * Supports pagination via query parameters:
+ * - limit: Maximum items per page (default: 20)
+ * - cursor: Pagination cursor for next page
+ *
+ * @example
+ * GET /content?limit=10&cursor=abc123
+ */
+export declare const list: APIGatewayProxyHandler;
+/**
+ * GET /content/:id - Get a single content item.
+ *
+ * @example
+ * GET /content/abc123
+ */
+export declare const get: APIGatewayProxyHandler;
+/**
+ * POST /content - Create a new content item.
+ *
+ * @example
+ * POST /content
+ * Body: { "title": "My Post", "content": "Hello world" }
+ */
+export declare const create: APIGatewayProxyHandler;
+/**
+ * PUT /content/:id - Update an existing content item.
+ *
+ * @example
+ * PUT /content/abc123
+ * Body: { "title": "Updated Title" }
+ */
+export declare const update: APIGatewayProxyHandler;
+/**
+ * DELETE /content/:id - Delete a content item.
+ *
+ * @example
+ * DELETE /content/abc123
+ */
+export declare const remove: APIGatewayProxyHandler;
+//# sourceMappingURL=content.d.ts.map

package/lib/handlers/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../src/handlers/content.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAgBzD;;;;;;;;;GASG;AACH,eAAO,MAAM,IAAI,EAAE,sBAmBlB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,GAAG,EAAE,sBAYjB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,EAAE,sBAiBpB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,EAAE,sBAcpB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,MAAM,EAAE,sBAWpB,CAAC"}

package/lib/handlers/content.js

@@ -0,0 +1,122 @@
+"use strict";
+/**
+ * Content CRUD handler template.
+ *
+ * This template demonstrates the standard patterns for building
+ * CRUD (Create, Read, Update, Delete) API endpoints using
+ * fnd-platform utilities.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.remove = exports.update = exports.create = exports.get = exports.list = void 0;
+const response_1 = require("../lib/response");
+const request_1 = require("../lib/request");
+/**
+ * GET /content - List all content items.
+ *
+ * Supports pagination via query parameters:
+ * - limit: Maximum items per page (default: 20)
+ * - cursor: Pagination cursor for next page
+ *
+ * @example
+ * GET /content?limit=10&cursor=abc123
+ */
+const list = async (event) => {
+    const _limit = parseInt((0, request_1.getQueryParam)(event, 'limit', '20') ?? '20', 10);
+    const _cursor = (0, request_1.getQueryParam)(event, 'cursor');
+    // TODO: Implement with DynamoDB in Phase 3
+    // const result = await db.query({
+    //   limit,
+    //   cursor,
+    //   indexName: 'GSI1',
+    // });
+    const items = [];
+    const response = {
+        items,
+        nextCursor: undefined,
+        total: 0,
+    };
+    return (0, response_1.success)(response);
+};
+exports.list = list;
+/**
+ * GET /content/:id - Get a single content item.
+ *
+ * @example
+ * GET /content/abc123
+ */
+const get = async (event) => {
+    const id = (0, request_1.requirePathParam)(event, 'id');
+    // TODO: Implement with DynamoDB in Phase 3
+    // const item = await db.get('CONTENT', id);
+    // if (!item) {
+    //   return notFound(`Content with id '${id}' not found`);
+    // }
+    // return success(item);
+    // Placeholder: return not found until DynamoDB is implemented
+    return (0, response_1.notFound)(`Content with id '${id}' not found`);
+};
+exports.get = get;
+/**
+ * POST /content - Create a new content item.
+ *
+ * @example
+ * POST /content
+ * Body: { "title": "My Post", "content": "Hello world" }
+ */
+const create = async (event) => {
+    const body = (0, request_1.parseBody)(event);
+    // TODO: Implement with DynamoDB in Phase 3
+    // const item = await db.create('CONTENT', {
+    //   title: body.title,
+    //   content: body.content,
+    // });
+    const item = {
+        id: crypto.randomUUID(),
+        title: body.title,
+        content: body.content,
+        createdAt: new Date().toISOString(),
+    };
+    return (0, response_1.created)(item);
+};
+exports.create = create;
+/**
+ * PUT /content/:id - Update an existing content item.
+ *
+ * @example
+ * PUT /content/abc123
+ * Body: { "title": "Updated Title" }
+ */
+const update = async (event) => {
+    const id = (0, request_1.requirePathParam)(event, 'id');
+    const _body = (0, request_1.parseBody)(event);
+    // TODO: Implement with DynamoDB in Phase 3
+    // const item = await db.get('CONTENT', id);
+    // if (!item) {
+    //   return notFound(`Content with id '${id}' not found`);
+    // }
+    // const updated = await db.update('CONTENT', id, body);
+    // return success(updated);
+    // Placeholder: return not found until DynamoDB is implemented
+    return (0, response_1.notFound)(`Content with id '${id}' not found`);
+};
+exports.update = update;
+/**
+ * DELETE /content/:id - Delete a content item.
+ *
+ * @example
+ * DELETE /content/abc123
+ */
+const remove = async (event) => {
+    const id = (0, request_1.requirePathParam)(event, 'id');
+    // TODO: Implement with DynamoDB in Phase 3
+    // const item = await db.get('CONTENT', id);
+    // if (!item) {
+    //   return notFound(`Content with id '${id}' not found`);
+    // }
+    // await db.delete('CONTENT', id);
+    return (0, response_1.success)({ deleted: true, id });
+};
+exports.remove = remove;
+//# sourceMappingURL=content.js.map

package/lib/handlers/content.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.js","sourceRoot":"","sources":["../../src/handlers/content.ts"],"names":[],"mappings":";AAAA;;;;;;;;GAQG;;;AAGH,8CAA6D;AAC7D,4CAA4E;AAc5E;;;;;;;;;GASG;AACI,MAAM,IAAI,GAA2B,KAAK,EAAE,KAAK,EAAE,EAAE;IAC1D,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAA,uBAAa,EAAC,KAAK,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IACzE,MAAM,OAAO,GAAG,IAAA,uBAAa,EAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAE/C,2CAA2C;IAC3C,kCAAkC;IAClC,WAAW;IACX,YAAY;IACZ,uBAAuB;IACvB,MAAM;IAEN,MAAM,KAAK,GAAkB,EAAE,CAAC;IAChC,MAAM,QAAQ,GAAmC;QAC/C,KAAK;QACL,UAAU,EAAE,SAAS;QACrB,KAAK,EAAE,CAAC;KACT,CAAC;IAEF,OAAO,IAAA,kBAAO,EAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC,CAAC;AAnBW,QAAA,IAAI,QAmBf;AAEF;;;;;GAKG;AACI,MAAM,GAAG,GAA2B,KAAK,EAAE,KAAK,EAAE,EAAE;IACzD,MAAM,EAAE,GAAG,IAAA,0BAAgB,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAEzC,2CAA2C;IAC3C,4CAA4C;IAC5C,eAAe;IACf,0DAA0D;IAC1D,IAAI;IACJ,wBAAwB;IAExB,8DAA8D;IAC9D,OAAO,IAAA,mBAAQ,EAAC,oBAAoB,EAAE,aAAa,CAAC,CAAC;AACvD,CAAC,CAAC;AAZW,QAAA,GAAG,OAYd;AAEF;;;;;;GAMG;AACI,MAAM,MAAM,GAA2B,KAAK,EAAE,KAAK,EAAE,EAAE;IAC5D,MAAM,IAAI,GAAG,IAAA,mBAAS,EAAqC,KAAK,CAAC,CAAC;IAElE,2CAA2C;IAC3C,4CAA4C;IAC5C,uBAAuB;IACvB,2BAA2B;IAC3B,MAAM;IAEN,MAAM,IAAI,GAAgB;QACxB,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IAEF,OAAO,IAAA,kBAAO,EAAC,IAAI,CAAC,CAAC;AACvB,CAAC,CAAC;AAjBW,QAAA,MAAM,UAiBjB;AAEF;;;;;;GAMG;AACI,MAAM,MAAM,GAA2B,KAAK,EAAE,KAAK,EAAE,EAAE;IAC5D,MAAM,EAAE,GAAG,IAAA,0BAAgB,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,IAAA,mBAAS,EAAuC,KAAK,CAAC,CAAC;IAErE,2CAA2C;IAC3C,4CAA4C;IAC5C,eAAe;IACf,0DAA0D;IAC1D,IAAI;IACJ,wDAAwD;IACxD,2BAA2B;IAE3B,8DAA8D;IAC9D,OAAO,IAAA,mBAAQ,EAAC,oBAAoB,EAAE,aAAa,CAAC,CAAC;AACvD,CAAC,CAAC;AAdW,QAAA,MAAM,UAcjB;AAEF;;;;;GAKG;AACI,MAAM,MAAM,GAA2B,KAAK,EAAE,KAAK,EAAE,EAAE;IAC5D,MAAM,EAAE,GAAG,IAAA,0BAAgB,EAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IAEzC,2CAA2C;IAC3C,4CAA4C;IAC5C,eAAe;IACf,0DAA0D;IAC1D,IAAI;IACJ,kCAAkC;IAElC,OAAO,IAAA,kBAAO,EAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;AACxC,CAAC,CAAC;AAXW,QAAA,MAAM,UAWjB"}

package/lib/handlers/health.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Health check endpoint handler.
+ *
+ * Provides a simple health check endpoint for monitoring
+ * and load balancer health checks.
+ *
+ * @packageDocumentation
+ */
+import type { APIGatewayProxyHandler } from 'aws-lambda';
+/**
+ * Health check response structure.
+ */
+export interface HealthCheckResponse {
+  /** Health status indicator */
+  status: 'healthy' | 'unhealthy';
+  /** ISO 8601 timestamp of the check */
+  timestamp: string;
+  /** API version from environment variable */
+  version: string;
+}
+/**
+ * GET /health - Health check endpoint.
+ *
+ * Returns the current health status of the API.
+ * Used for monitoring and load balancer health checks.
+ *
+ * @returns Health status with timestamp and version
+ *
+ * @example
+ * Response:
+ * ```json
+ * {
+ *   "success": true,
+ *   "data": {
+ *     "status": "healthy",
+ *     "timestamp": "2024-01-15T12:00:00.000Z",
+ *     "version": "1.0.0"
+ *   }
+ * }
+ * ```
+ */
+export declare const handler: APIGatewayProxyHandler;
+//# sourceMappingURL=health.d.ts.map

package/lib/handlers/health.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.d.ts","sourceRoot":"","sources":["../../src/handlers/health.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAyB,MAAM,YAAY,CAAC;AAGhF;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IAChC,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,OAAO,EAAE,sBAQrB,CAAC"}

package/lib/handlers/health.js

@@ -0,0 +1,43 @@
+'use strict';
+/**
+ * Health check endpoint handler.
+ *
+ * Provides a simple health check endpoint for monitoring
+ * and load balancer health checks.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, '__esModule', { value: true });
+exports.handler = void 0;
+const response_1 = require('../lib/response');
+/**
+ * GET /health - Health check endpoint.
+ *
+ * Returns the current health status of the API.
+ * Used for monitoring and load balancer health checks.
+ *
+ * @returns Health status with timestamp and version
+ *
+ * @example
+ * Response:
+ * ```json
+ * {
+ *   "success": true,
+ *   "data": {
+ *     "status": "healthy",
+ *     "timestamp": "2024-01-15T12:00:00.000Z",
+ *     "version": "1.0.0"
+ *   }
+ * }
+ * ```
+ */
+const handler = async () => {
+  const response = {
+    status: 'healthy',
+    timestamp: new Date().toISOString(),
+    version: process.env.API_VERSION ?? '0.0.0',
+  };
+  return (0, response_1.success)(response);
+};
+exports.handler = handler;
+//# sourceMappingURL=health.js.map

package/lib/handlers/health.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/handlers/health.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;AAGH,8CAA0C;AAc1C;;;;;;;;;;;;;;;;;;;;GAoBG;AACI,MAAM,OAAO,GAA2B,KAAK,IAAoC,EAAE;IACxF,MAAM,QAAQ,GAAwB;QACpC,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,OAAO;KAC5C,CAAC;IAEF,OAAO,IAAA,kBAAO,EAAC,QAAQ,CAAC,CAAC;AAC3B,CAAC,CAAC;AARW,QAAA,OAAO,WAQlB"}

package/lib/handlers/media.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Media upload and management handler template.
+ *
+ * This template demonstrates the standard patterns for building
+ * media upload endpoints using presigned URLs for direct S3 uploads.
+ *
+ * @packageDocumentation
+ */
+import type { APIGatewayProxyHandler } from 'aws-lambda';
+/**
+ * Media item interface.
+ */
+export interface MediaItem {
+  id: string;
+  key: string;
+  filename: string;
+  mimeType: string;
+  size: number;
+  url: string;
+  uploadedAt: string;
+  uploadedBy?: string;
+}
+/**
+ * POST /media/upload-url - Get a presigned URL for direct S3 upload.
+ *
+ * Request body:
+ * - filename: Original filename
+ * - contentType: MIME type of the file
+ * - size: File size in bytes
+ *
+ * Response:
+ * - uploadUrl: Presigned PUT URL for direct upload
+ * - key: S3 object key (needed to create media record after upload)
+ * - expiresIn: URL expiration time in seconds
+ *
+ * @example
+ * POST /media/upload-url
+ * Body: { "filename": "photo.jpg", "contentType": "image/jpeg", "size": 1024000 }
+ */
+export declare const getUploadUrl: APIGatewayProxyHandler;
+/**
+ * POST /media - Create a media record after successful S3 upload.
+ *
+ * Request body:
+ * - id: Media ID from upload-url response
+ * - key: S3 object key from upload-url response
+ * - filename: Original filename
+ * - mimeType: MIME type of the file
+ * - size: File size in bytes
+ *
+ * @example
+ * POST /media
+ * Body: { "id": "abc123", "key": "uploads/2024-01/abc123.jpg", "filename": "photo.jpg", "mimeType": "image/jpeg", "size": 1024000 }
+ */
+export declare const create: APIGatewayProxyHandler;
+/**
+ * GET /media - List media items with pagination and filtering.
+ *
+ * Query parameters:
+ * - limit: Maximum items per page (default: 20)
+ * - cursor: Pagination cursor for next page
+ * - type: Filter by media type (image, video, audio, document)
+ *
+ * @example
+ * GET /media?limit=10&type=image
+ */
+export declare const list: APIGatewayProxyHandler;
+/**
+ * GET /media/:id - Get a single media item.
+ *
+ * @example
+ * GET /media/abc123
+ */
+export declare const get: APIGatewayProxyHandler;
+/**
+ * DELETE /media/:id - Delete a media item from S3 and DynamoDB.
+ *
+ * @example
+ * DELETE /media/abc123
+ */
+export declare const remove: APIGatewayProxyHandler;
+/**
+ * Helper to get MIME type filter for type category.
+ */
+export declare function getTypeFilter(type: string): string[];
+//# sourceMappingURL=media.d.ts.map

package/lib/handlers/media.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media.d.ts","sourceRoot":"","sources":["../../src/handlers/media.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAyDzD;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAuCD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,YAAY,EAAE,sBAqD1B,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,MAAM,EAAE,sBAwCpB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,IAAI,EAAE,sBAsBlB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,GAAG,EAAE,sBAWjB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,MAAM,EAAE,sBAwBpB,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAapD"}

package/lib/handlers/media.js

@@ -0,0 +1,287 @@
+"use strict";
+/**
+ * Media upload and management handler template.
+ *
+ * This template demonstrates the standard patterns for building
+ * media upload endpoints using presigned URLs for direct S3 uploads.
+ *
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.remove = exports.get = exports.list = exports.create = exports.getUploadUrl = void 0;
+exports.getTypeFilter = getTypeFilter;
+const client_s3_1 = require("@aws-sdk/client-s3");
+const s3_request_presigner_1 = require("@aws-sdk/s3-request-presigner");
+const response_1 = require("../lib/response");
+const request_1 = require("../lib/request");
+/**
+ * Allowed media MIME types.
+ */
+const ALLOWED_MIME_TYPES = [
+    // Images
+    'image/jpeg',
+    'image/png',
+    'image/gif',
+    'image/webp',
+    'image/svg+xml',
+    // Documents
+    'application/pdf',
+    // Video
+    'video/mp4',
+    'video/webm',
+    // Audio
+    'audio/mpeg',
+    'audio/wav',
+    'audio/ogg',
+];
+/**
+ * Maximum file size in bytes (50MB default).
+ */
+const MAX_FILE_SIZE = parseInt(process.env.MAX_FILE_SIZE || '52428800', 10);
+/**
+ * S3 bucket name for media storage.
+ */
+const BUCKET_NAME = process.env.MEDIA_BUCKET_NAME || '';
+/**
+ * Base URL for media access (CloudFront or S3).
+ */
+const MEDIA_BASE_URL = process.env.MEDIA_BASE_URL || '';
+/**
+ * Presigned URL expiration time in seconds.
+ */
+const PRESIGNED_URL_EXPIRES_IN = 300; // 5 minutes
+/**
+ * S3 client instance.
+ */
+const s3Client = new client_s3_1.S3Client({});
+/**
+ * Generates a unique ID for media items.
+ * Uses a combination of timestamp and random string for uniqueness.
+ */
+function generateId() {
+    const timestamp = Date.now().toString(36);
+    const randomPart = Math.random().toString(36).substring(2, 10);
+    return `${timestamp}${randomPart}`;
+}
+/**
+ * Extracts file extension from MIME type.
+ */
+function getExtensionFromMimeType(mimeType) {
+    const mimeToExt = {
+        'image/jpeg': 'jpg',
+        'image/png': 'png',
+        'image/gif': 'gif',
+        'image/webp': 'webp',
+        'image/svg+xml': 'svg',
+        'application/pdf': 'pdf',
+        'video/mp4': 'mp4',
+        'video/webm': 'webm',
+        'audio/mpeg': 'mp3',
+        'audio/wav': 'wav',
+        'audio/ogg': 'ogg',
+    };
+    return mimeToExt[mimeType] || 'bin';
+}
+/**
+ * Validates the content type is allowed.
+ */
+function isValidContentType(contentType) {
+    return ALLOWED_MIME_TYPES.includes(contentType);
+}
+/**
+ * POST /media/upload-url - Get a presigned URL for direct S3 upload.
+ *
+ * Request body:
+ * - filename: Original filename
+ * - contentType: MIME type of the file
+ * - size: File size in bytes
+ *
+ * Response:
+ * - uploadUrl: Presigned PUT URL for direct upload
+ * - key: S3 object key (needed to create media record after upload)
+ * - expiresIn: URL expiration time in seconds
+ *
+ * @example
+ * POST /media/upload-url
+ * Body: { "filename": "photo.jpg", "contentType": "image/jpeg", "size": 1024000 }
+ */
+const getUploadUrl = async (event) => {
+    const body = (0, request_1.parseBody)(event);
+    // Validate required fields
+    if (!body.filename || !body.contentType || !body.size) {
+        return (0, response_1.badRequest)('Missing required fields: filename, contentType, size');
+    }
+    // Validate content type
+    if (!isValidContentType(body.contentType)) {
+        return (0, response_1.badRequest)(`Invalid content type: ${body.contentType}. Allowed types: ${ALLOWED_MIME_TYPES.join(', ')}`);
+    }
+    // Validate file size
+    if (body.size > MAX_FILE_SIZE) {
+        return (0, response_1.badRequest)(`File size ${body.size} exceeds maximum allowed size of ${MAX_FILE_SIZE} bytes`);
+    }
+    // Generate unique key with date-based path
+    const id = generateId();
+    const ext = getExtensionFromMimeType(body.contentType);
+    const datePath = new Date().toISOString().slice(0, 7); // YYYY-MM
+    const key = `uploads/${datePath}/${id}.${ext}`;
+    // Generate presigned URL
+    const command = new client_s3_1.PutObjectCommand({
+        Bucket: BUCKET_NAME,
+        Key: key,
+        ContentType: body.contentType,
+        ContentLength: body.size,
+        Metadata: {
+            'original-filename': encodeURIComponent(body.filename),
+        },
+    });
+    const uploadUrl = await (0, s3_request_presigner_1.getSignedUrl)(s3Client, command, {
+        expiresIn: PRESIGNED_URL_EXPIRES_IN,
+    });
+    return (0, response_1.success)({
+        uploadUrl,
+        key,
+        id,
+        expiresIn: PRESIGNED_URL_EXPIRES_IN,
+    });
+};
+exports.getUploadUrl = getUploadUrl;
+/**
+ * POST /media - Create a media record after successful S3 upload.
+ *
+ * Request body:
+ * - id: Media ID from upload-url response
+ * - key: S3 object key from upload-url response
+ * - filename: Original filename
+ * - mimeType: MIME type of the file
+ * - size: File size in bytes
+ *
+ * @example
+ * POST /media
+ * Body: { "id": "abc123", "key": "uploads/2024-01/abc123.jpg", "filename": "photo.jpg", "mimeType": "image/jpeg", "size": 1024000 }
+ */
+const create = async (event) => {
+    const body = (0, request_1.parseBody)(event);
+    // Validate required fields
+    if (!body.id || !body.key || !body.filename || !body.mimeType || !body.size) {
+        return (0, response_1.badRequest)('Missing required fields: id, key, filename, mimeType, size');
+    }
+    // TODO: Implement with DynamoDB in Phase 3
+    // const media = await db.create('MEDIA', {
+    //   id: body.id,
+    //   key: body.key,
+    //   filename: body.filename,
+    //   mimeType: body.mimeType,
+    //   size: body.size,
+    //   uploadedAt: new Date().toISOString(),
+    // });
+    // Construct the media URL
+    const url = MEDIA_BASE_URL
+        ? `${MEDIA_BASE_URL}/${body.key}`
+        : `https://${BUCKET_NAME}.s3.amazonaws.com/${body.key}`;
+    const media = {
+        id: body.id,
+        key: body.key,
+        filename: body.filename,
+        mimeType: body.mimeType,
+        size: body.size,
+        url,
+        uploadedAt: new Date().toISOString(),
+    };
+    return (0, response_1.created)(media);
+};
+exports.create = create;
+/**
+ * GET /media - List media items with pagination and filtering.
+ *
+ * Query parameters:
+ * - limit: Maximum items per page (default: 20)
+ * - cursor: Pagination cursor for next page
+ * - type: Filter by media type (image, video, audio, document)
+ *
+ * @example
+ * GET /media?limit=10&type=image
+ */
+const list = async (event) => {
+    const _limit = parseInt((0, request_1.getQueryParam)(event, 'limit', '20') ?? '20', 10);
+    const _cursor = (0, request_1.getQueryParam)(event, 'cursor');
+    const _type = (0, request_1.getQueryParam)(event, 'type');
+    // TODO: Implement with DynamoDB in Phase 3
+    // const typeFilter = type ? getTypeFilter(type) : undefined;
+    // const result = await db.query({
+    //   limit,
+    //   cursor,
+    //   indexName: 'GSI2',
+    //   filter: typeFilter,
+    // });
+    const items = [];
+    const response = {
+        items,
+        nextCursor: undefined,
+        total: 0,
+    };
+    return (0, response_1.success)(response);
+};
+exports.list = list;
+/**
+ * GET /media/:id - Get a single media item.
+ *
+ * @example
+ * GET /media/abc123
+ */
+const get = async (event) => {
+    const id = (0, request_1.requirePathParam)(event, 'id');
+    // TODO: Implement with DynamoDB in Phase 3
+    // const media = await db.get('MEDIA', id);
+    // if (!media) {
+    //   return notFound(`Media with id '${id}' not found`);
+    // }
+    // return success(media);
+    return (0, response_1.notFound)(`Media with id '${id}' not found`);
+};
+exports.get = get;
+/**
+ * DELETE /media/:id - Delete a media item from S3 and DynamoDB.
+ *
+ * @example
+ * DELETE /media/abc123
+ */
+const remove = async (event) => {
+    const id = (0, request_1.requirePathParam)(event, 'id');
+    // TODO: Implement with DynamoDB in Phase 3
+    // const media = await db.get('MEDIA', id);
+    // if (!media) {
+    //   return notFound(`Media with id '${id}' not found`);
+    // }
+    // For now, we'll demonstrate the S3 deletion pattern
+    // In production, you would:
+    // 1. Get the media record from DynamoDB
+    // 2. Delete from S3
+    // 3. Delete from DynamoDB
+    // Example S3 deletion (commented out until DynamoDB is implemented)
+    // const deleteCommand = new DeleteObjectCommand({
+    //   Bucket: BUCKET_NAME,
+    //   Key: media.key,
+    // });
+    // await s3Client.send(deleteCommand);
+    // await db.delete('MEDIA', id);
+    return (0, response_1.success)({ deleted: true, id });
+};
+exports.remove = remove;
+/**
+ * Helper to get MIME type filter for type category.
+ */
+function getTypeFilter(type) {
+    switch (type) {
+        case 'image':
+            return ['image/jpeg', 'image/png', 'image/gif', 'image/webp', 'image/svg+xml'];
+        case 'video':
+            return ['video/mp4', 'video/webm'];
+        case 'audio':
+            return ['audio/mpeg', 'audio/wav', 'audio/ogg'];
+        case 'document':
+            return ['application/pdf'];
+        default:
+            return [];
+    }
+}
+//# sourceMappingURL=media.js.map

package/lib/handlers/media.js.map

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