diff --git a/Makefile b/Makefile index c9600afb4c0..a6cdc86ac47 100644 --- a/Makefile +++ b/Makefile @@ -25,11 +25,8 @@ github.issues: github.repos: \ github.repos.supabase \ github.repos.realtime \ - github.repos.marketplace \ - github.repos.pg-api \ - github.repos.postgrest-js \ github.repos.postgres \ - github.repos.doctest-js + github.repos.pg-api github.repos.%: curl -sS https://api.github.com/repos/supabase/$* \ diff --git a/examples/todo-next-js/package-lock.json b/examples/todo-next-js/package-lock.json index e498c6ee404..f7d6f4b7517 100644 --- a/examples/todo-next-js/package-lock.json +++ b/examples/todo-next-js/package-lock.json @@ -1272,32 +1272,69 @@ } } }, - "@supabase/postgrest-js": { - "version": "0.17.0", - "resolved": "https://registry.npmjs.org/@supabase/postgrest-js/-/postgrest-js-0.17.0.tgz", - "integrity": "sha512-7Dt7ALli+bOQK51JMolraI08sJg2UweNuGFghr8MrX4nc3WoDwL5PP6fNZwy+j/7f7nvvM6s1OUtqNTvqiW+5Q==", + "@supabase/gotrue-js": { + "version": "1.5.10", + "resolved": "https://registry.npmjs.org/@supabase/gotrue-js/-/gotrue-js-1.5.10.tgz", + "integrity": "sha512-SAoT5znv6r/nasJQp35n72dYGkBMWgKsCHc45vrCu8M/XDNpU/9vN8TzzziK4M0tWg3LGKm7MbRkNOwLEk5a8A==", "requires": { - "superagent": "^5.2.1" + "cross-fetch": "^3.0.6" + }, + "dependencies": { + "cross-fetch": { + "version": "3.0.6", + "resolved": "https://registry.npmjs.org/cross-fetch/-/cross-fetch-3.0.6.tgz", + "integrity": "sha512-KBPUbqgFjzWlVcURG+Svp9TlhA5uliYtiNx/0r8nv0pdypeQCRJ9IaSIc3q/x3q8t3F75cHuwxVql1HFGHCNJQ==", + "requires": { + "node-fetch": "2.6.1" + } + }, + "node-fetch": { + "version": "2.6.1", + "resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-2.6.1.tgz", + "integrity": "sha512-V4aYg89jEoVRxRb2fJdAg8FHvI7cEyYdVAh94HH0UIK8oJxUfkjlDQN9RbMx+bEjP7+ggMiFRprSti032Oipxw==" + } + } + }, + "@supabase/postgrest-js": { + "version": "0.21.0", + "resolved": "https://registry.npmjs.org/@supabase/postgrest-js/-/postgrest-js-0.21.0.tgz", + "integrity": "sha512-2MxPodIf1Ij+iR2RYVxziZpBv/9j6zT2d2UWSvdu2GT8yODo1hO2oXXT4cFJqvxmVX6A+z4J39wBqutt9vlttQ==", + "requires": { + "cross-fetch": "^3.0.6" + }, + "dependencies": { + "cross-fetch": { + "version": "3.0.6", + "resolved": "https://registry.npmjs.org/cross-fetch/-/cross-fetch-3.0.6.tgz", + "integrity": "sha512-KBPUbqgFjzWlVcURG+Svp9TlhA5uliYtiNx/0r8nv0pdypeQCRJ9IaSIc3q/x3q8t3F75cHuwxVql1HFGHCNJQ==", + "requires": { + "node-fetch": "2.6.1" + } + }, + "node-fetch": { + "version": "2.6.1", + "resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-2.6.1.tgz", + "integrity": "sha512-V4aYg89jEoVRxRb2fJdAg8FHvI7cEyYdVAh94HH0UIK8oJxUfkjlDQN9RbMx+bEjP7+ggMiFRprSti032Oipxw==" + } } }, "@supabase/realtime-js": { - "version": "0.9.0", - "resolved": "https://registry.npmjs.org/@supabase/realtime-js/-/realtime-js-0.9.0.tgz", - "integrity": "sha512-aYkVsD2hNgD7QPPBV+LALJTexNf8pVhIh9qJC13NnOLYZpudtHbof+rg0dgq5+GIhYa8HzqUMdf+OwwlQVJgsw==", + "version": "1.0.6", + "resolved": "https://registry.npmjs.org/@supabase/realtime-js/-/realtime-js-1.0.6.tgz", + "integrity": "sha512-qzYYBzXteYsqQYlLzoYwee2OloWn3w8YzUFbDYFUPdkUwLs01OIqsm+lRCzKDivmyn2G0FJQjloWcF4BF5TyBg==", "requires": { - "@babel/runtime": "^7.9.2", + "@types/websocket": "^1.0.1", "query-string": "^6.12.1", "websocket": "^1.0.31" } }, "@supabase/supabase-js": { - "version": "0.36.5", - "resolved": "https://registry.npmjs.org/@supabase/supabase-js/-/supabase-js-0.36.5.tgz", - "integrity": "sha512-iiY5lDIrbhQjT8grRgXbUfIU5omD8CfNI4Iio3z/DHjsdrzYNf9o0/kRAzVVITPOuqlN9g0QhPt7bzRQKxLbwA==", + "version": "github:kiwicopple/supabase-js#6199fa765eee19a83befd755faff9c9dcb250a00", + "from": "github:kiwicopple/supabase-js#feature/migrate_to_typescript", "requires": { - "@supabase/postgrest-js": "^0.17.0", - "@supabase/realtime-js": "^0.9.0", - "superagent": "^5.2.1" + "@supabase/gotrue-js": "^1.5.10", + "@supabase/postgrest-js": "^0.21.0", + "@supabase/realtime-js": "^1.0.6" } }, "@types/json-schema": { @@ -1305,6 +1342,19 @@ "resolved": "https://registry.npmjs.org/@types/json-schema/-/json-schema-7.0.6.tgz", "integrity": "sha512-3c+yGKvVP5Y9TYBEibGNR+kLtijnj7mYrXRg+WpFb2X9xm04g/DXYkfg4hmzJQosc9snFNUPkbYIhu+KAm6jJw==" }, + "@types/node": { + "version": "14.14.0", + "resolved": "https://registry.npmjs.org/@types/node/-/node-14.14.0.tgz", + "integrity": "sha512-BfbIHP9IapdupGhq/hc+jT5dyiBVZ2DdeC5WwJWQWDb0GijQlzUFAeIQn/2GtvZcd2HVUU7An8felIICFTC2qg==" + }, + "@types/websocket": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/@types/websocket/-/websocket-1.0.1.tgz", + "integrity": "sha512-f5WLMpezwVxCLm1xQe/kdPpQIOmL0TXYx2O15VYfYzc7hTIdxiOoOvez+McSIw3b7z/1zGovew9YSL7+h4h7/Q==", + "requires": { + "@types/node": "*" + } + }, "@webassemblyjs/ast": { "version": "1.9.0", "resolved": "https://registry.npmjs.org/@webassemblyjs/ast/-/ast-1.9.0.tgz", @@ -1707,11 +1757,6 @@ "resolved": "https://registry.npmjs.org/async-each/-/async-each-1.0.3.tgz", "integrity": "sha512-z/WhQ5FPySLdvREByI2vZiTWwCnF0moMJ1hK9YQwDTHKh6I7/uSckMetoRGb5UBZPC1z0jlw+n/XCgjeH7y1AQ==" }, - "asynckit": { - "version": "0.4.0", - "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz", - "integrity": "sha1-x57Zf380y48robyXkLzDZkdLS3k=" - }, "atob": { "version": "2.1.2", "resolved": "https://registry.npmjs.org/atob/-/atob-2.1.2.tgz", @@ -2232,14 +2277,6 @@ "integrity": "sha512-puCDz0CzydiSYOrnXpz/PKd69zRrribezjtE9yd4zvytoRc8+RY/KJPvtPFKZS3E3wP6neGyMe0vOTlHO5L3Pw==", "dev": true }, - "combined-stream": { - "version": "1.0.8", - "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz", - "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==", - "requires": { - "delayed-stream": "~1.0.0" - } - }, "commander": { "version": "2.20.3", "resolved": "https://registry.npmjs.org/commander/-/commander-2.20.3.tgz", @@ -2297,11 +2334,6 @@ "safe-buffer": "~5.1.1" } }, - "cookiejar": { - "version": "2.1.2", - "resolved": "https://registry.npmjs.org/cookiejar/-/cookiejar-2.1.2.tgz", - "integrity": "sha512-Mw+adcfzPxcPeI+0WlvRrr/3lGVO0bD75SxX6811cxSh1Wbxx7xZBGK1eVtDf6si8rg2lhnUjsVLMFMfbRIuwA==" - }, "copy-concurrently": { "version": "1.0.5", "resolved": "https://registry.npmjs.org/copy-concurrently/-/copy-concurrently-1.0.5.tgz", @@ -2638,11 +2670,6 @@ "integrity": "sha1-yY2bzvdWdBiOEQlpFRGZ45sfppM=", "dev": true }, - "delayed-stream": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz", - "integrity": "sha1-3zrhmayt+31ECqrgsp4icrJOxhk=" - }, "des.js": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/des.js/-/des.js-1.0.1.tgz", @@ -3082,11 +3109,6 @@ "resolved": "https://registry.npmjs.org/fast-json-stable-stringify/-/fast-json-stable-stringify-2.1.0.tgz", "integrity": "sha512-lhd/wF+Lk98HZoTCtlVraHtfh5XYijIjalXck7saUtuanSDyLMxnHhSXEDJqHxD7msR8D0uCmqlkwjCV8xvwHw==" }, - "fast-safe-stringify": { - "version": "2.0.7", - "resolved": "https://registry.npmjs.org/fast-safe-stringify/-/fast-safe-stringify-2.0.7.tgz", - "integrity": "sha512-Utm6CdzT+6xsDk2m8S6uL8VHxNwI6Jub+e9NYTcAms28T84pTa25GJQV9j0CY0N1rM8hK4x6grpF2BQf+2qwVA==" - }, "figgy-pudding": { "version": "3.5.2", "resolved": "https://registry.npmjs.org/figgy-pudding/-/figgy-pudding-3.5.2.tgz", @@ -3158,21 +3180,6 @@ "resolved": "https://registry.npmjs.org/for-in/-/for-in-1.0.2.tgz", "integrity": "sha1-gQaNKVqBQuwKxybG4iAMMPttXoA=" }, - "form-data": { - "version": "3.0.0", - "resolved": "https://registry.npmjs.org/form-data/-/form-data-3.0.0.tgz", - "integrity": "sha512-CKMFDglpbMi6PyN+brwB9Q/GOw0eAnsrEZDgcsH5Krhz5Od/haKHAX0NmQfha2zPPz0JpWzA7GJHGSnvCRLWsg==", - "requires": { - "asynckit": "^0.4.0", - "combined-stream": "^1.0.8", - "mime-types": "^2.1.12" - } - }, - "formidable": { - "version": "1.2.2", - "resolved": "https://registry.npmjs.org/formidable/-/formidable-1.2.2.tgz", - "integrity": "sha512-V8gLm+41I/8kguQ4/o1D3RIHRmhYFG4pnNyonvua+40rqcEmT4+V71yaZ3B457xbbgCsCfjSPi65u/W6vK1U5Q==" - }, "fragment-cache": { "version": "0.2.1", "resolved": "https://registry.npmjs.org/fragment-cache/-/fragment-cache-0.2.1.tgz", @@ -3854,11 +3861,6 @@ "resolved": "https://registry.npmjs.org/merge-stream/-/merge-stream-2.0.0.tgz", "integrity": "sha512-abv/qOcuPfk3URPfDzmZU1LKmuw8kT+0nIHvKrKgFrwifol/doWcdA4ZqsWQ8ENrFKkd67Mfpo/LovbIUsbt3w==" }, - "methods": { - "version": "1.1.2", - "resolved": "https://registry.npmjs.org/methods/-/methods-1.1.2.tgz", - "integrity": "sha1-VSmk1nZUE07cxSZmVoNbD4Ua/O4=" - }, "micromatch": { "version": "3.1.10", "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-3.1.10.tgz", @@ -3895,24 +3897,6 @@ } } }, - "mime": { - "version": "2.4.6", - "resolved": "https://registry.npmjs.org/mime/-/mime-2.4.6.tgz", - "integrity": "sha512-RZKhC3EmpBchfTGBVb8fb+RL2cWyw/32lshnsETttkBAyAUXSGHxbEJWWRXc751DrIxG1q04b8QwMbAwkRPpUA==" - }, - "mime-db": { - "version": "1.44.0", - "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.44.0.tgz", - "integrity": "sha512-/NOTfLrsPBVeH7YtFPgsVWveuL+4SjjYxaQ1xtM1KMFj7HdxlBlxeyNLzhyJVx7r4rZGJAZ/6lkKCitSc/Nmpg==" - }, - "mime-types": { - "version": "2.1.27", - "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.27.tgz", - "integrity": "sha512-JIhqnCasI9yD+SsmkquHBxTSEuZdQX5BuQnS2Vc7puQQQ+8yiP5AY5uWhpdv4YL4VM5c6iliiYWPgJ/nJQLp7w==", - "requires": { - "mime-db": "1.44.0" - } - }, "minimalistic-assert": { "version": "1.0.1", "resolved": "https://registry.npmjs.org/minimalistic-assert/-/minimalistic-assert-1.0.1.tgz", @@ -5167,15 +5151,10 @@ } } }, - "qs": { - "version": "6.9.4", - "resolved": "https://registry.npmjs.org/qs/-/qs-6.9.4.tgz", - "integrity": "sha512-A1kFqHekCTM7cz0udomYUoYNWjBebHm/5wzU/XqrBRBNWectVH0QIiN+NEcZ0Dte5hvzHwbr8+XQmguPhJ6WdQ==" - }, "query-string": { - "version": "6.13.5", - "resolved": "https://registry.npmjs.org/query-string/-/query-string-6.13.5.tgz", - "integrity": "sha512-svk3xg9qHR39P3JlHuD7g3nRnyay5mHbrPctEBDUxUkHRifPHXJDhBUycdCC0NBjXoDf44Gb+IsOZL1Uwn8M/Q==", + "version": "6.13.6", + "resolved": "https://registry.npmjs.org/query-string/-/query-string-6.13.6.tgz", + "integrity": "sha512-/WWZ7d9na6s2wMEGdVCVgKWE9Rt7nYyNIf7k8xmHXcesPMlEzicWo3lbYwHyA4wBktI2KrXxxZeACLbE84hvSQ==", "requires": { "decode-uri-component": "^0.2.0", "split-on-first": "^1.0.0", @@ -6018,41 +5997,6 @@ "resolved": "https://registry.npmjs.org/stylis-rule-sheet/-/stylis-rule-sheet-0.0.10.tgz", "integrity": "sha512-nTbZoaqoBnmK+ptANthb10ZRZOGC+EmTLLUxeYIuHNkEKcmKgXX1XWKkUBT2Ac4es3NybooPe0SmvKdhKJZAuw==" }, - "superagent": { - "version": "5.3.1", - "resolved": "https://registry.npmjs.org/superagent/-/superagent-5.3.1.tgz", - "integrity": "sha512-wjJ/MoTid2/RuGCOFtlacyGNxN9QLMgcpYLDQlWFIhhdJ93kNscFonGvrpAHSCVjRVj++DGCglocF7Aej1KHvQ==", - "requires": { - "component-emitter": "^1.3.0", - "cookiejar": "^2.1.2", - "debug": "^4.1.1", - "fast-safe-stringify": "^2.0.7", - "form-data": "^3.0.0", - "formidable": "^1.2.2", - "methods": "^1.1.2", - "mime": "^2.4.6", - "qs": "^6.9.4", - "readable-stream": "^3.6.0", - "semver": "^7.3.2" - }, - "dependencies": { - "readable-stream": { - "version": "3.6.0", - "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.0.tgz", - "integrity": "sha512-BViHy7LKeTz4oNnkcLJ+lVSL6vpiFeX6/d3oSH8zCW7UxP2onchk+vTGB143xuFjHS3deTgkKoXXymXqymiIdA==", - "requires": { - "inherits": "^2.0.3", - "string_decoder": "^1.1.1", - "util-deprecate": "^1.0.1" - } - }, - "semver": { - "version": "7.3.2", - "resolved": "https://registry.npmjs.org/semver/-/semver-7.3.2.tgz", - "integrity": "sha512-OrOb32TeeambH6UrhtShmF7CRDqhL6/5XpPNp2DuRH6+9QLw/orhp72j87v8Qa1ScDkvrrBNpZcDejAirJmfXQ==" - } - } - }, "supports-color": { "version": "6.1.0", "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-6.1.0.tgz", diff --git a/examples/todo-next-js/package.json b/examples/todo-next-js/package.json index d975b7eb523..08615355505 100644 --- a/examples/todo-next-js/package.json +++ b/examples/todo-next-js/package.json @@ -7,7 +7,7 @@ "start": "next start" }, "dependencies": { - "@supabase/supabase-js": "^0.36.5", + "@supabase/supabase-js": "github:kiwicopple/supabase-js#feature/migrate_to_typescript", "next": "latest", "react": "^16.13.1", "react-dom": "^16.13.1" diff --git a/web/ReferenceGenerator.ts b/web/ReferenceGenerator.ts new file mode 100644 index 00000000000..5273f612c40 --- /dev/null +++ b/web/ReferenceGenerator.ts @@ -0,0 +1,244 @@ +/** + * Usage: + * ts-node docGen.ts -o {output_dir} {input}.yml + */ + +import Example from './spec/gen/components/Example' +import Page from './spec/gen/components/Page' +import Sidebar from './spec/gen/components/Sidebar' +import SidebarCategory from './spec/gen/components/SidebarCategory' +import Tab from './spec/gen/components/Tab' +import Tabs from './spec/gen/components/Tabs' +import { slugify, tsDocCommentToMdComment, writeToDisk } from './spec/gen/lib/helpers' +import { TsDoc, OpenRef } from './spec/gen/definitions' + +const yaml = require('js-yaml') +const fs = require('fs') + +const main = (fileNames, options) => { + try { + const outputDir = options.o || options.output || '' + fileNames.forEach((inputFileName) => { + gen(inputFileName, outputDir) + }) + return + } catch (e) { + console.log(e) + } +} + +async function gen(inputFileName, outputDir) { + const docSpec = yaml.safeLoad(fs.readFileSync(inputFileName, 'utf8')) + const defRef = fs.readFileSync(docSpec.info.definition, 'utf8') + if (!defRef) return + + const definition = JSON.parse(defRef) + const allLanguages = docSpec.info.libraries + const pages = Object.entries(docSpec.pages).map(([name, x]: [string, OpenRef.Page]) => ({ + ...x, + pageName: name, + })) + + // Sidebar + const inputFileNameToSnakeCase = inputFileName.replace('/', '_').replace('.yml', '') + const sidebarFileName = `sidebar_${inputFileNameToSnakeCase}.js` + const sidebar = generateSidebar(docSpec) + await writeToDisk(sidebarFileName, sidebar) + console.log('Sidebar created: ', sidebarFileName) + + // Index Page + const indexFilename = outputDir + `/index.mdx` + const index = generateDocsIndexPage(docSpec) + await writeToDisk(indexFilename, index) + console.log('The index was saved: ', indexFilename) + + // Generate Pages + pages.forEach(async (pageSpec: OpenRef.Page) => { + try { + const slug = slugify(pageSpec.pageName) + const hasTsRef = pageSpec['$ref'] || null + const tsDefinition = hasTsRef && extractTsDocNode(hasTsRef, definition) + if (hasTsRef && !tsDefinition) throw new Error('Definition not found: ' + hasTsRef) + + const description = + pageSpec.description || tsDocCommentToMdComment(getDescriptionFromDefintion(tsDefinition)) + + // Create page + const content = Page({ + slug, + id: slug, + title: pageSpec.title || pageSpec.pageName, + description, + parameters: hasTsRef ? generateParameters(tsDefinition) : '', + spotlight: generateSpotlight(pageSpec['examples'] || [], allLanguages), + examples: generateExamples(pageSpec['examples'] || [], allLanguages), + notes: pageSpec.notes, + }) + + // Write to disk + const dest = outputDir + `/${slug}.mdx` + await writeToDisk(dest, content) + console.log('Saved: ', dest) + } catch (error) { + console.error(error) + } + }) +} + +function generateParameters(tsDefinition: any) { + let functionDeclaration = null + if (tsDefinition.kindString == 'Method') { + functionDeclaration = tsDefinition + } else if (tsDefinition.kindString == 'Constructor') { + functionDeclaration = tsDefinition + } else functionDeclaration = tsDefinition?.type?.declaration + if (!functionDeclaration) return '' + + const paramDefinitions: TsDoc.TypeDefinition[] = functionDeclaration.signatures[0].parameters // PMC: seems flaky.. why the [0]? + if (!paramDefinitions) return '' + + // const paramsComments: TsDoc.CommentTag = tsDefinition.comment?.tags?.filter(x => x.tag == 'param') + let parameters = paramDefinitions.map((x) => recurseThroughParams(x)).join(`\n`) + return methodListGroup(parameters) +} + +function getDescriptionFromDefintion(tsDefinition) { + if (!tsDefinition) return null + if (['Method', 'Constructor', 'Constructor signature'].includes(tsDefinition.kindString)) + return tsDefinition?.signatures[0].comment + else return tsDefinition?.comment || '' +} + +function recurseThroughParams(paramDefinition: TsDoc.TypeDefinition) { + let children = paramDefinition.type?.declaration?.children + const labelParams = { + name: paramDefinition.name, + isOptional: !!paramDefinition.flags.isOptional, + type: extractParamTypeAsString(paramDefinition), + description: paramDefinition.comment ? tsDocCommentToMdComment(paramDefinition.comment) : null, + } + let subContent = '' + + if (!!children) { + let properties = children + .sort((a, b) => (a.flags?.isOptional ? 1 : -1)) // required params first + .map((x) => recurseThroughParams(x)) + let heading = `
Properties
` + subContent = methodListGroup([heading].concat(properties).join('\n')) + } + + return methodListItemLabel(labelParams, subContent) +} + +const methodListGroup = (items) => ` + +` + +const methodListItemLabel = ({ name, isOptional, type, description }, subContent) => ` +
  • +

    + + ${name} + + + ${isOptional ? 'optional' : 'required'} + + + ${type} + +

    +
    + +${description ? description : 'No description provided. '} + +
    + ${subContent} +
    • +` + +function generateExamples(specExamples: any, allLanguages: any) { + return specExamples.map((example) => { + let allTabs = Tabs(allLanguages, generateTabs(allLanguages, example)) + return Example({ name: example.name, description: example.description, tabs: allTabs }) + }) +} + +/** + * A spotlight is an example which appears at the top of the page. + */ +function generateSpotlight(specExamples: any, allLanguages: any) { + const spotlight = specExamples.find((x) => x.isSpotlight) || null + const spotlightContent = !spotlight + ? '' + : Tabs(allLanguages, generateTabs(allLanguages, spotlight)) + return spotlightContent +} + +function generateTabs(allLanguages: any, example: any) { + return allLanguages + .map((library) => { + let content = example[library.id] || notImplemented + return Tab(library.id, content) + }) + .join('\n') +} + +const notImplemented = ` +\`\`\` +Not yet implemented +\`\`\` +` + +function extractParamTypeAsString(paramDefinition) { + if (paramDefinition.type?.name) { + return paramDefinition.type.name + } + if (paramDefinition.type?.type == 'union') { + return paramDefinition.type.types.map((x) => x.value).join(' | ') + } else { + return 'object' + } +} + +/** + * Iterates through the definition to find the correct definition. + * You can pass it a deeply nested node using dot notation. eg: 'LoggedInUser.data.email' + */ +function extractTsDocNode(nodeToFind: string, definition: any) { + const nodePath = nodeToFind.split('.') + let i = 0 + let currentNode = definition + while (i < nodePath.length) { + currentNode = currentNode.children.find((x) => x.name == nodePath[i]) || null + if (currentNode == null) break + i++ + } + return currentNode +} + +function generateSidebar(docSpec: any) { + let path = docSpec.info.docs.path || '' + let categories = docSpec.info.docs.sidebar.map((x) => { + const items = x.items.map((item) => { + let slug = slugify(item) + return `'${path}${slug}'` + }) + return SidebarCategory(x.name, items) + }) + return Sidebar(categories) +} + +function generateDocsIndexPage(docSpec: any) { + return Page({ + slug: slugify(docSpec.info.title), + id: 'index', + title: docSpec.info.title, + description: docSpec.info.description, + }) +} + +// Run everything +const argv = require('minimist')(process.argv.slice(2)) +main(argv['_'], argv) diff --git a/web/blog/2020-07-09-postgresql-templates.md b/web/blog/2020-07-09-postgresql-templates.md index ad0f758f0d6..ba6910f735c 100644 --- a/web/blog/2020-07-09-postgresql-templates.md +++ b/web/blog/2020-07-09-postgresql-templates.md @@ -14,7 +14,7 @@ Whenever you create a new database in Postgres, you are actually [basing it off -This database, `template1`, and another, called `template0`, are standard system databases that exist in every newly created database cluster. Don't believe me? Why not quickly [spin up a database](/docs/postgres/postgres-intro) and see it for yourself with this query: +This database, `template1`, and another, called `template0`, are standard system databases that exist in every newly created database cluster. Don't believe me? Why not quickly [spin up a database](/docs/postgres/server/about) and see it for yourself with this query: ```sql SELECT * FROM pg_database; ``` diff --git a/web/blog/2020-08-05-supabase-auth.mdx b/web/blog/2020-08-05-supabase-auth.mdx index ea80140f310..33cd05c5c6a 100644 --- a/web/blog/2020-08-05-supabase-auth.mdx +++ b/web/blog/2020-08-05-supabase-auth.mdx @@ -35,7 +35,7 @@ Supabase Auth provides all the backend services you need to authenticate and aut ### User management -Supabase makes it simple to onboard your users with our new `supabase.auth.signup()` and `supabase.auth.login()` [functions](/docs/library/user-management). +Supabase makes it simple to onboard your users with our new `supabase.auth.signup()` and `supabase.auth.login()` [functions](/docs/guides/auth).