json-rest-api 0.1.1 → 1.0.1

package/test-examples/test-file-upload.js

@@ -0,0 +1,132 @@
+import { Api } from 'hooked-api';
+import { RestApiPlugin, FileHandlingPlugin, ExpressPlugin } from 'json-rest-api';
+import { LocalStorage } from 'json-rest-api';
+import express from 'express';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+import fs from 'fs/promises';
+import path from 'path';
+
+const execAsync = promisify(exec);
+
+const api = new Api({
+  name: 'my-library-api',
+  version: '1.0.0'
+});
+
+// Create a storage adapter
+const coverStorage = new LocalStorage({
+  directory: './uploads/covers',
+  baseUrl: 'http://localhost:3000/uploads/covers'
+});
+
+// Add plugins (ORDER MATTERS!)
+api.use(RestApiPlugin);
+api.use(FileHandlingPlugin);  // Must come after RestApiPlugin
+api.use(ExpressPlugin);       // Must come after FileHandlingPlugin
+
+// Update the books schema to include a cover image
+api.addResource('books', {
+  schema: {
+    title: { type: 'string', required: true },
+    author: { type: 'string', required: true },
+    year: { type: 'number' },
+    isbn: { type: 'string' },
+    cover: {
+      type: 'file',
+      storage: coverStorage,
+      accepts: ['image/jpeg', 'image/png', 'image/gif'],
+      maxSize: '5mb'
+    }
+  }
+});
+
+// Add dataPost helper to handle the cover URL
+api.customize({
+  vars: {
+    helpers: {
+      dataPost: async ({ scopeName, inputRecord }) => {
+        const newBook = {
+          id: String(Date.now()),
+          ...inputRecord.data.attributes
+        };
+        
+        // The file has already been uploaded and replaced with a URL
+        console.log('Book cover URL:', newBook.cover);
+        
+        return {
+          data: {
+            type: 'books',
+            id: newBook.id,
+            attributes: {
+              title: newBook.title,
+              author: newBook.author,
+              year: newBook.year,
+              cover: newBook.cover  // This is now a URL!
+            }
+          }
+        };
+      },
+      
+      dataQuery: async () => ({ data: [] })
+    }
+  }
+});
+
+// Wait for async plugin initialization
+await new Promise(resolve => setTimeout(resolve, 100));
+
+// Create Express app
+const app = express();
+
+// Serve uploaded files
+app.use('/uploads', express.static('./uploads'));
+
+// Mount the API
+app.use(api.http.express.router);
+
+const server = app.listen(3000, async () => {
+  console.log('✓ File upload API running at http://localhost:3000/api');
+  
+  // Create a test image file
+  const testImagePath = './test-cover.png';
+  await fs.writeFile(testImagePath, Buffer.from('PNG_TEST_DATA'));
+  
+  try {
+    // Test file upload with curl
+    console.log('\nTesting file upload with multipart/form-data...\n');
+    
+    const { stdout, stderr } = await execAsync(`curl -s -X POST http://localhost:3000/api/books \
+      -F "title=The Hobbit" \
+      -F "author=J.R.R. Tolkien" \
+      -F "year=1937" \
+      -F "cover=@${testImagePath}"`);
+    
+    if (stderr) {
+      console.error('Curl error:', stderr);
+    } else {
+      console.log('Response:', stdout);
+      
+      // Parse response to check if it worked
+      try {
+        const response = JSON.parse(stdout);
+        if (response.data && response.data.attributes && response.data.attributes.cover) {
+          console.log('\n✓ File upload successful!');
+          console.log('  Book ID:', response.data.id);
+          console.log('  Cover URL:', response.data.attributes.cover);
+        } else if (response.errors) {
+          console.log('\n✗ File upload failed with errors:', response.errors);
+        }
+      } catch (e) {
+        console.log('\n✗ Could not parse response');
+      }
+    }
+  } catch (error) {
+    console.error('Test failed:', error.message);
+  } finally {
+    // Cleanup
+    await fs.unlink(testImagePath).catch(() => {});
+    server.close();
+    process.exit(0);
+  }
+});

package/test-examples/test-http-plugin.js

@@ -0,0 +1,159 @@
+import { Api } from 'hooked-api';
+import { RestApiPlugin, FileHandlingPlugin, HttpPlugin } from 'json-rest-api';
+
+const api = new Api({
+  name: 'my-library-api',
+  version: '1.0.0'
+});
+
+// Add plugins
+api.use(RestApiPlugin);
+api.use(FileHandlingPlugin);
+api.use(HttpPlugin, {
+  port: 3000,                // Server port (default: 3000)
+  basePath: '/api',          // API base path (default: '/api')
+  strictContentType: true,   // Enforce JSON content types (default: true)
+  requestSizeLimit: '10mb'   // Max request body size (default: '1mb')
+});
+
+// Add your books resource
+api.addResource('books', {
+  schema: {
+    title: { type: 'string', required: true },
+    author: { type: 'string', required: true },
+    year: { type: 'number' },
+    isbn: { type: 'string' }
+  }
+});
+
+// Add simple data helpers
+api.customize({
+  vars: {
+    helpers: {
+      dataQuery: async ({ scopeName, queryParams }) => {
+        const fakeBooks = [
+          { id: '1', title: 'The Great Gatsby', author: 'F. Scott Fitzgerald', year: 1925 },
+          { id: '2', title: '1984', author: 'George Orwell', year: 1949 },
+          { id: '3', title: 'To Kill a Mockingbird', author: 'Harper Lee', year: 1960 }
+        ];
+        
+        return {
+          data: fakeBooks.map(book => ({
+            type: 'books',
+            id: book.id,
+            attributes: {
+              title: book.title,
+              author: book.author,
+              year: book.year
+            }
+          }))
+        };
+      },
+      
+      dataGet: async ({ scopeName, id }) => {
+        const book = { id, title: 'Example Book', author: 'Example Author', year: 2024 };
+        
+        return {
+          data: {
+            type: 'books',
+            id: book.id,
+            attributes: {
+              title: book.title,
+              author: book.author,
+              year: book.year
+            }
+          }
+        };
+      },
+      
+      dataPost: async ({ scopeName, inputRecord }) => {
+        const newBook = {
+          id: String(Date.now()),
+          ...inputRecord.data.attributes
+        };
+        
+        return {
+          data: {
+            type: 'books',
+            id: newBook.id,
+            attributes: {
+              title: newBook.title,
+              author: newBook.author,
+              year: newBook.year
+            }
+          }
+        };
+      },
+      
+      dataPut: async ({ scopeName, id, inputRecord }) => {
+        return {
+          data: {
+            type: 'books',
+            id: id,
+            attributes: inputRecord.data.attributes
+          }
+        };
+      },
+      
+      dataPatch: async ({ scopeName, id, inputRecord }) => {
+        return {
+          data: {
+            type: 'books',
+            id: id,
+            attributes: inputRecord.data.attributes
+          }
+        };
+      },
+      
+      dataDelete: async ({ scopeName, id }) => {
+        return { success: true };
+      }
+    }
+  }
+});
+
+// Wait for async plugin installation to complete
+await new Promise(resolve => setTimeout(resolve, 100));
+
+// Start the HTTP server - multiple options:
+console.log('Testing HTTP plugin options...\n');
+
+// Check if api.http namespace exists
+console.log('api.http exists?', !!api.http);
+console.log('api.http.startServer exists?', typeof api.http?.startServer);
+
+// Option 1: Start on configured port (3000 by default)
+api.http.startServer();
+
+console.log('✓ HTTP server started successfully!');
+console.log('  API running at http://localhost:3000/api');
+
+// Test with curl commands after a short delay
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+
+setTimeout(async () => {
+  try {
+    console.log('\nTesting endpoints...\n');
+    
+    // Test GET all books
+    console.log('1. Testing GET /api/books:');
+    const { stdout: getAll } = await execAsync('curl -s http://localhost:3000/api/books');
+    console.log('✓ Response:', getAll.substring(0, 100) + '...');
+    
+    // Test GET single book
+    console.log('\n2. Testing GET /api/books/1:');
+    const { stdout: getOne } = await execAsync('curl -s http://localhost:3000/api/books/1');
+    console.log('✓ Response:', getOne.substring(0, 100) + '...');
+    
+    // Close server
+    console.log('\nClosing server...');
+    api.http.server.close();
+    process.exit(0);
+    
+  } catch (error) {
+    console.error('Test error:', error.message);
+    process.exit(1);
+  }
+}, 500);

package/test-examples/test-programmatic-api.js

@@ -0,0 +1,188 @@
+import { Api } from 'hooked-api';
+import { RestApiPlugin } from 'json-rest-api';
+
+const api = new Api({
+  name: 'my-library-api',
+  version: '1.0.0'
+});
+
+// Use the REST API plugin
+api.use(RestApiPlugin);
+
+// Define a books resource
+api.addResource('books', {
+  schema: {
+    title: { type: 'string', required: true },
+    author: { type: 'string', required: true },
+    year: { type: 'number' },
+    isbn: { type: 'string' }
+  }
+});
+
+// Add simple data helpers
+api.customize({
+  vars: {
+    helpers: {
+      dataQuery: async ({ scopeName, queryParams }) => {
+        const fakeBooks = [
+          { id: '1', title: 'The Great Gatsby', author: 'F. Scott Fitzgerald', year: 1925 },
+          { id: '2', title: '1984', author: 'George Orwell', year: 1949 },
+          { id: '3', title: 'To Kill a Mockingbird', author: 'Harper Lee', year: 1960 }
+        ];
+        
+        return {
+          data: fakeBooks.map(book => ({
+            type: 'books',
+            id: book.id,
+            attributes: {
+              title: book.title,
+              author: book.author,
+              year: book.year
+            }
+          }))
+        };
+      },
+      
+      dataGet: async ({ scopeName, id }) => {
+        const book = { id, title: 'Example Book', author: 'Example Author', year: 2024 };
+        
+        return {
+          data: {
+            type: 'books',
+            id: book.id,
+            attributes: {
+              title: book.title,
+              author: book.author,
+              year: book.year
+            }
+          }
+        };
+      },
+      
+      dataPost: async ({ scopeName, inputRecord }) => {
+        const newBook = {
+          id: String(Date.now()),
+          ...inputRecord.data.attributes
+        };
+        
+        return {
+          data: {
+            type: 'books',
+            id: newBook.id,
+            attributes: {
+              title: newBook.title,
+              author: newBook.author,
+              year: newBook.year
+            }
+          }
+        };
+      },
+      
+      dataPut: async ({ scopeName, id, inputRecord }) => {
+        return {
+          data: {
+            type: 'books',
+            id: id,
+            attributes: inputRecord.data.attributes
+          }
+        };
+      },
+      
+      dataPatch: async ({ scopeName, id, inputRecord }) => {
+        return {
+          data: {
+            type: 'books',
+            id: id,
+            attributes: inputRecord.data.attributes
+          }
+        };
+      },
+      
+      dataDelete: async ({ scopeName, id }) => {
+        return { success: true };
+      }
+    }
+  }
+});
+
+// Test programmatic API usage
+console.log('Testing programmatic API usage...\n');
+
+// First check what methods are available
+console.log('Available methods on api.resources.books:');
+if (api.resources && api.resources.books) {
+  const methods = Object.keys(api.resources.books).filter(k => typeof api.resources.books[k] === 'function');
+  console.log('  Methods:', methods.join(', '));
+} else {
+  console.log('  ERROR: api.resources.books is not available');
+}
+
+try {
+  // Query all books
+  console.log('\n1. Testing query():');
+  const allBooks = await api.resources.books.query({});
+  console.log('✓ Query successful:', JSON.stringify(allBooks, null, 2));
+  
+  // Get a single book
+  console.log('\n2. Testing get():');
+  const book = await api.resources.books.get({ id: '1' });
+  console.log('✓ Get successful:', JSON.stringify(book, null, 2));
+  
+  // Create a new book
+  console.log('\n3. Testing post():');
+  const newBook = await api.resources.books.post({
+    inputRecord: {
+      data: {
+        type: 'books',
+        attributes: {
+          title: 'New Book',
+          author: 'New Author',
+          year: 2024
+        }
+      }
+    }
+  });
+  console.log('✓ Post successful:', JSON.stringify(newBook, null, 2));
+  
+  // Update a book (replace all fields)
+  console.log('\n4. Testing put():');
+  const updatedBook = await api.resources.books.put({
+    id: '1',
+    inputRecord: {
+      data: {
+        type: 'books',
+        attributes: {
+          title: 'Updated Title',
+          author: 'Updated Author',
+          year: 2024
+        }
+      }
+    }
+  });
+  console.log('✓ Put successful:', JSON.stringify(updatedBook, null, 2));
+  
+  // Partially update a book
+  console.log('\n5. Testing patch():');
+  const patchedBook = await api.resources.books.patch({
+    id: '1',
+    inputRecord: {
+      data: {
+        type: 'books',
+        attributes: {
+          title: 'New Title Only'
+        }
+      }
+    }
+  });
+  console.log('✓ Patch successful:', JSON.stringify(patchedBook, null, 2));
+  
+  // Delete a book
+  console.log('\n6. Testing delete():');
+  const deleteResult = await api.resources.books.delete({ id: '1' });
+  console.log('✓ Delete successful:', JSON.stringify(deleteResult, null, 2));
+  
+  console.log('\n✅ All programmatic API tests passed!');
+} catch (error) {
+  console.error('❌ Error:', error.message);
+  console.error(error.stack);
+}

package/test-examples/test-rest-api-plugin.js

@@ -0,0 +1,13 @@
+import { Api } from 'hooked-api';
+import { RestApiPlugin } from 'json-rest-api';
+
+const api = new Api({
+  name: 'my-library-api',
+  version: '1.0.0'
+});
+
+// Use the REST API plugin
+api.use(RestApiPlugin);
+
+console.log('✓ REST API Plugin loaded successfully!');
+console.log('  Plugin registered:', api.plugins.has(RestApiPlugin));

package/.jshintrc

@@ -1,48 +0,0 @@
-{
-    "browser"       : false,
-    "curly"         : false,
-    "devel"         : false,
-    "eqeqeq"        : true,
-    "eqnull"        : true,
-    "esnext"        : true,
-    "expr"          : true,
-    "forin"         : false,
-    "immed"         : false,
-    "indent"        : 4,
-    "latedef"       : false,
-    "laxcomma"      : true,
-    "maxcomplexity" : 39,
-    "maxdepth"      : 5,
-    "maxlen"        : 110,
-    "maxparams"     : 6,
-    "maxstatements" : 100,
-    "multistr"      : true,
-    "newcap"        : true,
-    "noarg"         : true,
-    "noempty"       : true,
-    "nonew"         : false,
-    "node"          : true,
-    "onevar"        : false,
-    "plusplus"      : false,
-    "quotmark"      : "single",
-    "regexp"        : false,
-    "undef"         : true,
-    "unused"        : true,
-    "strict"        : true,
-    "sub"           : true,
-    "trailing"      : true,
-    "undef"         : true,
-    "unused"        : true,
-    "white"         : false,
-    "validthis"     : true,
-
-    "globals" : {
-      "console"   : true,
-      "describe"  : true,
-      "it"        : true,
-      "before"    : true,
-      "beforeEach": true,
-      "expect"    : true,
-      "after"     : true
-    }
-}

package/.npmignore

@@ -1,15 +0,0 @@
-lib-cov
-*.seed
-*.log
-*.csv
-*.dat
-*.out
-*.pid
-*.gz
-
-pids
-logs
-results
-
-npm-debug.log
-node_modules

package/examples/client.js

@@ -1,18 +0,0 @@
-'use strict';
-var request = require('request');
-var inspect = require('util').inspect;
-var debug = require('debug')('json-rest-api:example:client');
-var assert = require('assert');
-
-
-request({json:true, uri: 'http://localhost:8000/ping'}, function(err, res, json) {
-  if (err) {
-    debug('Error: '+inspect(err));
-    return;
-  }
-  debug('typeof json: '+typeof json);
-  debug('json: '+inspect(json));
-  assert.ok(json.success === true);
-  assert.ok(json.pong === 'pong');
-  console.log('Success!');
-});

package/examples/client2.js

@@ -1,27 +0,0 @@
-'use strict';
-var request = require('request');
-var inspect = require('util').inspect;
-var debug = require('debug')('json-rest-api:example:client');
-var assert = require('assert');
-
-var data = {
-    field1: 'Edmond',
-    field2: 100,
-    field3: {
-        alpha: true,
-        beta: [ 0, 1, 2 ],
-        gamma: 999
-    }
-};
-
-request({method:'POST', json:data, uri: 'http://localhost:8000/postData'}, function(err, res, json) {
-    if (err) {
-        debug('Error: '+inspect(err));
-        return;
-    }
-    debug('typeof json: '+typeof json);
-    debug('json: '+inspect(json));
-    assert.ok(json.success === true);
-    assert.ok(json.pong === 'pong');
-    console.log('Success!');
-});

package/examples/server.js

@@ -1,23 +0,0 @@
-'use strict';
-var JsonRestApi = require('../index');
-var inspect = require('util').inspect;
-var debug = require('debug')('json-rest-api:example:server');
-
-var RestApi = new JsonRestApi({port: 8000}, function(err) {
-    if (err) {
-        debug('/ping error: '+inspect(err));
-        return;
-    }
-    console.log('Listening on port 8000.');
-
-    // add a route
-    RestApi.addRoute('get', '/ping', function(req, res) {
-        res.json({success: true, pong: 'pong'});
-    });
-
-    RestApi.addRoute('post', '/postData', function(req, res, json) {
-        console.log(req.body);
-        console.log(json);
-        res.json({success: true, pong: 'pong'});
-    });
-});