api-facebook

v2017.11.6

Published

2 years ago

this zero-dependency package will provide a javascript-client for facebook's web-apis, with a working web-demo

Downloads

0High
0Medium
0Low

kaizhu

facebook-graph

swgg-facebook

this zero-dependency package will provide a javascript-client for facebook's web-apis, with a working web-demo

live web demo

https://kaizhu256.github.io/node-swgg-facebook/build..beta..travis-ci.org/app/

cdn download

documentation

cli help

api doc

https://kaizhu256.github.io/node-swgg-facebook/build..beta..travis-ci.org/apidoc.html

todo

continue adding extra facebook web-api's
none

changelog for v2017.11.6

npm publish 2017.11.6
revert from 2-space-indent to 4-space-indent
add api DELETE /{facebook_graph_version}/{test-user-id}#requireTestUserId
add api POST /{facebook_graph_version}/{test-user-id}#requireTestUserId
add api POST /{facebook_graph_version}/{achievement-id}#requireAchievementId
add api GET /{facebook_graph_version}/{user-id}/achievements
none

this package requires

darwin or linux os

quickstart standalone app

to run this example, follow the instruction in the script below

assets.app.js

# example.sh

# this shell script will download and run a web-demo of swgg-facebook as a standalone app

# 1. download standalone app
curl -O https://kaizhu256.github.io/node-swgg-facebook/build..beta..travis-ci.org/app/assets.app.js
# 2. run standalone app
node ./assets.app.js
# 3. open a browser to http://127.0.0.1:8081 and play with the web-demo
# 4. edit file assets.app.js to suit your needs

output from browser

output from shell

quickstart example.js

to run this example, follow the instruction in the script below

example.js

/*
example.js

this script will run a web-demo of swgg-facebook

instruction
    1. save this script as example.js
    2. run the shell command:
        $ npm install swgg-facebook && PORT=8081 node example.js
    3. open a browser to http://127.0.0.1:8081 and play with the web-demo
    4. edit this script to suit your needs
*/



/* istanbul instrument in package swgg_facebook */
/*jslint
    bitwise: true,
    browser: true,
    maxerr: 8,
    maxlen: 100,
    node: true,
    nomen: true,
    regexp: true,
    stupid: true
*/
(function () {
    'use strict';
    var local;



    // run shared js-env code - init-before
    (function () {
        // init local
        local = {};
        // init modeJs
        local.modeJs = (function () {
            try {
                return typeof navigator.userAgent === 'string' &&
                    typeof document.querySelector('body') === 'object' &&
                    typeof XMLHttpRequest.prototype.open === 'function' &&
                    'browser';
            } catch (errorCaughtBrowser) {
                return module.exports &&
                    typeof process.versions.node === 'string' &&
                    typeof require('http').createServer === 'function' &&
                    'node';
            }
        }());
        // init global
        local.global = local.modeJs === 'browser'
            ? window
            : global;
        // init utility2_rollup
        local = local.global.utility2_rollup || (local.modeJs === 'browser'
            ? local.global.utility2_swgg_facebook
            : require('swgg-facebook'));
        // init exports
        local.global.local = local;
        // init assets
        local.assetsDict['/assets.index.template.html'] = local.assetsDict['/assets.swgg.html'];
    }());
    switch (local.modeJs) {



    // run browser js-env code - init-test
    /* istanbul ignore next */
    case 'browser':
        break;



    // run node js-env code - init-test
    /* istanbul ignore next */
    case 'node':
        // init exports
        module.exports = local;
        // require builtins
        Object.keys(process.binding('natives')).forEach(function (key) {
            if (!local[key] && !(/\/|^_|^sys$/).test(key)) {
                local[key] = require(key);
            }
        });
        // init assets
        local.assetsDict = local.assetsDict || {};
        [
            'assets.index.css',
            'assets.index.template.html',
            'assets.swgg.swagger.json',
            'assets.swgg.swagger.server.json'
        ].forEach(function (file) {
            file = '/' + file;
            local.assetsDict[file] = local.assetsDict[file] || '';
            if (local.fs.existsSync(local.__dirname + file)) {
                local.assetsDict[file] = local.fs.readFileSync(
                    local.__dirname + file,
                    'utf8'
                );
            }
        });
        local.assetsDict['/'] =
            local.assetsDict['/assets.example.html'] =
            local.assetsDict['/assets.index.template.html']
            .replace((/\{\{env\.(\w+?)\}\}/g), function (match0, match1) {
                // jslint-hack
                String(match0);
                switch (match1) {
                case 'npm_package_description':
                    return 'the greatest app in the world!';
                case 'npm_package_name':
                    return 'swgg-facebook';
                case 'npm_package_nameLib':
                    return 'swgg_facebook';
                case 'npm_package_version':
                    return '0.0.1';
                default:
                    return match0;
                }
            });
        // init cli
        if (module !== require.main || local.global.utility2_rollup) {
            break;
        }
        local.assetsDict['/assets.example.js'] =
            local.assetsDict['/assets.example.js'] ||
            local.fs.readFileSync(__filename, 'utf8');
        // bug-workaround - long $npm_package_buildCustomOrg
        /* jslint-ignore-begin */
        local.assetsDict['/assets.swgg_facebook.js'] =
            local.assetsDict['/assets.swgg_facebook.js'] ||
            local.fs.readFileSync(
                local.__dirname + '/lib.swgg_facebook.js',
                'utf8'
            ).replace((/^#!/), '//');
        /* jslint-ignore-end */
        local.assetsDict['/favicon.ico'] = local.assetsDict['/favicon.ico'] || '';
        // if $npm_config_timeout_exit exists,
        // then exit this process after $npm_config_timeout_exit ms
        if (Number(process.env.npm_config_timeout_exit)) {
            setTimeout(process.exit, Number(process.env.npm_config_timeout_exit));
        }
        // start server
        if (local.global.utility2_serverHttp1) {
            break;
        }
        process.env.PORT = process.env.PORT || '8081';
        console.error('server starting on port ' + process.env.PORT);
        local.http.createServer(function (request, response) {
            request.urlParsed = local.url.parse(request.url);
            if (local.assetsDict[request.urlParsed.pathname] !== undefined) {
                response.end(local.assetsDict[request.urlParsed.pathname]);
                return;
            }
            response.statusCode = 404;
            response.end();
        }).listen(process.env.PORT);
        break;
    }
}());

output from browser

output from shell

extra screenshots

package.json

{
    "author": "kai zhu <[email protected]>",
    "description": "this zero-dependency package will provide a javascript-client for facebook's web-apis, with a working web-demo",
    "devDependencies": {
        "electron-lite": "kaizhu256/node-electron-lite#alpha",
        "utility2": "kaizhu256/node-utility2#alpha"
    },
    "engines": {
        "node": ">=4.0"
    },
    "homepage": "https://github.com/kaizhu256/node-swgg-facebook",
    "keywords": [
        "facebook-graph"
    ],
    "license": "MIT",
    "main": "lib.swgg_facebook.js",
    "name": "swgg-facebook",
    "nameAliasPublish": "api-facebook",
    "nameLib": "swgg_facebook",
    "nameOriginal": "swgg-facebook",
    "os": [
        "darwin",
        "linux"
    ],
    "repository": {
        "type": "git",
        "url": "https://github.com/kaizhu256/node-swgg-facebook.git"
    },
    "scripts": {
        "build-ci": "utility2 shReadmeTest build_ci.sh",
        "env": "env",
        "heroku-postbuild": "npm uninstall utility2 2>/dev/null; npm install kaizhu256/node-utility2#alpha && utility2 shDeployHeroku",
        "postinstall": "[ ! -f npm_scripts.sh ] || ./npm_scripts.sh postinstall",
        "start": "PORT=${PORT:-8080} utility2 start test.js",
        "test": "PORT=$(utility2 shServerPortRandom) utility2 test test.js"
    },
    "version": "2017.11.6"
}

changelog of last 50 commits

internal build script

build_ci.sh

# build_ci.sh

# this shell script will run the build for this package

shBuildCiAfter() {(set -e
    shDeployGithub
    shDeployHeroku
    shReadmeTest example.sh
)}

shBuildCiBefore() {(set -e
    shNpmTestPublished
    shReadmeTest example.js
)}

# run shBuildCi
eval $(utility2 source)
shBuildCi

misc

this package was created with utility2

Published

Vulnerabilities

Links

Maintainers

Keywords

Readme

swgg-facebook

live web demo

table of contents

cdn download

documentation

cli help

api doc

todo

changelog for v2017.11.6

this package requires

quickstart standalone app

to run this example, follow the instruction in the script below

output from browser

output from shell

quickstart example.js

to run this example, follow the instruction in the script below

output from browser

output from shell

extra screenshots

package.json

changelog of last 50 commits

internal build script

misc