@raybase/create 0.0.1 → 0.3.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/THIRD_PARTY_NOTICES.md +38 -0
- package/assets/apple-touch-icons/0.png +0 -0
- package/assets/apple-touch-icons/1.png +0 -0
- package/assets/apple-touch-icons/2.png +0 -0
- package/assets/apple-touch-icons/3.png +0 -0
- package/assets/apple-touch-icons/4.png +0 -0
- package/assets/apple-touch-icons/5.png +0 -0
- package/assets/apple-touch-icons/6.png +0 -0
- package/assets/apple-touch-icons/7.png +0 -0
- package/assets/apple-touch-icons/8.png +0 -0
- package/assets/apple-touch-icons/9.png +0 -0
- package/assets/apple-touch-icons/A.png +0 -0
- package/assets/apple-touch-icons/B.png +0 -0
- package/assets/apple-touch-icons/C.png +0 -0
- package/assets/apple-touch-icons/D.png +0 -0
- package/assets/apple-touch-icons/E.png +0 -0
- package/assets/apple-touch-icons/F.png +0 -0
- package/assets/apple-touch-icons/G.png +0 -0
- package/assets/apple-touch-icons/H.png +0 -0
- package/assets/apple-touch-icons/I.png +0 -0
- package/assets/apple-touch-icons/J.png +0 -0
- package/assets/apple-touch-icons/K.png +0 -0
- package/assets/apple-touch-icons/L.png +0 -0
- package/assets/apple-touch-icons/M.png +0 -0
- package/assets/apple-touch-icons/N.png +0 -0
- package/assets/apple-touch-icons/O.png +0 -0
- package/assets/apple-touch-icons/P.png +0 -0
- package/assets/apple-touch-icons/Q.png +0 -0
- package/assets/apple-touch-icons/R.png +0 -0
- package/assets/apple-touch-icons/S.png +0 -0
- package/assets/apple-touch-icons/T.png +0 -0
- package/assets/apple-touch-icons/U.png +0 -0
- package/assets/apple-touch-icons/V.png +0 -0
- package/assets/apple-touch-icons/W.png +0 -0
- package/assets/apple-touch-icons/X.png +0 -0
- package/assets/apple-touch-icons/Y.png +0 -0
- package/assets/apple-touch-icons/Z.png +0 -0
- package/assets/apple-touch-icons/default.png +0 -0
- package/dist/.source-hash +1 -0
- package/dist/index.d.ts +56 -0
- package/dist/index.d.ts.map +1 -0
- package/dist/index.js +2351 -0
- package/dist/index.js.map +1 -0
- package/dist/raybase-package-ranges.d.ts +11 -0
- package/dist/raybase-package-ranges.d.ts.map +1 -0
- package/dist/raybase-package-ranges.js +11 -0
- package/dist/raybase-package-ranges.js.map +1 -0
- package/dist/source-fetch.d.ts +91 -0
- package/dist/source-fetch.d.ts.map +1 -0
- package/dist/source-fetch.js +325 -0
- package/dist/source-fetch.js.map +1 -0
- package/dist/source-hash.d.ts +2 -0
- package/dist/source-hash.d.ts.map +1 -0
- package/dist/source-hash.js +23 -0
- package/dist/source-hash.js.map +1 -0
- package/dist/starter-description.d.ts +44 -0
- package/dist/starter-description.d.ts.map +1 -0
- package/dist/starter-description.js +273 -0
- package/dist/starter-description.js.map +1 -0
- package/dist/starter-source.d.ts +43 -0
- package/dist/starter-source.d.ts.map +1 -0
- package/dist/starter-source.js +156 -0
- package/dist/starter-source.js.map +1 -0
- package/dist/store-app-apply.d.ts +27 -0
- package/dist/store-app-apply.d.ts.map +1 -0
- package/dist/store-app-apply.js +100 -0
- package/dist/store-app-apply.js.map +1 -0
- package/dist/store-app-manifest.d.ts +86 -0
- package/dist/store-app-manifest.d.ts.map +1 -0
- package/dist/store-app-manifest.js +110 -0
- package/dist/store-app-manifest.js.map +1 -0
- package/dist/store-app-registry.d.ts +30 -0
- package/dist/store-app-registry.d.ts.map +1 -0
- package/dist/store-app-registry.js +232 -0
- package/dist/store-app-registry.js.map +1 -0
- package/models/recommended.json +42 -0
- package/modules/api/templates/react-router/app/api/operations.ts +8 -0
- package/modules/api/templates/tanstack-start/src/api/operations.ts +15 -0
- package/modules/docs/templates/astro-emdash/content/docs/getting-started.mdx +13 -0
- package/modules/docs/templates/astro-emdash/content/docs/index.mdx +13 -0
- package/modules/docs/templates/astro-emdash/content/docs/mcp.mdx +11 -0
- package/modules/docs/templates/astro-emdash/content/docs/meta.json +4 -0
- package/modules/docs/templates/astro-emdash/site/content/docs/getting-started.mdx +12 -0
- package/modules/docs/templates/astro-emdash/site/content/docs/index.mdx +12 -0
- package/modules/docs/templates/astro-emdash/site/content/docs/mcp.mdx +10 -0
- package/modules/docs/templates/astro-emdash/site/content/docs/meta.json +4 -0
- package/modules/docs/templates/astro-emdash/site/source.config.ts +10 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-assets.ts +1 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-client.tsx +22 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-data.ts +24 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-handler.tsx +105 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-layout.tsx +56 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-mdx.tsx +79 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-page-actions.tsx +146 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/docs-page.tsx +70 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/llm-text.ts +61 -0
- package/modules/docs/templates/astro-emdash/site/src/docs/source.ts +7 -0
- package/modules/docs/templates/astro-emdash/site/src/pages/docs/[...slug].ts +6 -0
- package/modules/docs/templates/astro-emdash/site/src/pages/docs/api/markdown.ts +4 -0
- package/modules/docs/templates/astro-emdash/site/src/pages/docs/api/search.ts +4 -0
- package/modules/docs/templates/astro-emdash/site/src/pages/llms.txt.ts +8 -0
- package/modules/docs/templates/astro-emdash/site/src/styles-docs.css +3 -0
- package/modules/docs/templates/astro-emdash/source.config.ts +10 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-assets.ts +1 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-client.tsx +22 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-data.ts +24 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-handler.tsx +105 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-layout.tsx +56 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-mdx.tsx +79 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-page-actions.tsx +146 -0
- package/modules/docs/templates/astro-emdash/src/docs/docs-page.tsx +70 -0
- package/modules/docs/templates/astro-emdash/src/docs/llm-text.ts +61 -0
- package/modules/docs/templates/astro-emdash/src/docs/source.ts +7 -0
- package/modules/docs/templates/astro-emdash/src/routes/docs/$.tsx +22 -0
- package/modules/docs/templates/astro-emdash/src/routes/docs/api/markdown.ts +12 -0
- package/modules/docs/templates/astro-emdash/src/routes/docs/api/search.ts +12 -0
- package/modules/docs/templates/astro-emdash/src/routes/docs.index.tsx +22 -0
- package/modules/docs/templates/astro-emdash/src/routes/docs.tsx +22 -0
- package/modules/docs/templates/astro-emdash/src/styles-docs.css +3 -0
- package/modules/docs/templates/react-router/app/components/mdx.tsx +79 -0
- package/modules/docs/templates/react-router/app/lib/layout.shared.tsx +54 -0
- package/modules/docs/templates/react-router/app/lib/source.ts +7 -0
- package/modules/docs/templates/react-router/app/routes/docs.$.tsx +49 -0
- package/modules/docs/templates/react-router/app/routes/docs.api.search.ts +10 -0
- package/modules/docs/templates/react-router/app/routes/docs.tsx +13 -0
- package/modules/docs/templates/react-router/content/docs/getting-started.mdx +8 -0
- package/modules/docs/templates/react-router/content/docs/index.mdx +8 -0
- package/modules/docs/templates/react-router/content/docs/mcp.mdx +121 -0
- package/modules/docs/templates/react-router/content/docs/meta.json +4 -0
- package/modules/docs/templates/react-router/source.config.ts +5 -0
- package/modules/docs/templates/tanstack-start/content/docs/getting-started.mdx +10 -0
- package/modules/docs/templates/tanstack-start/content/docs/index.mdx +8 -0
- package/modules/docs/templates/tanstack-start/content/docs/mcp.mdx +121 -0
- package/modules/docs/templates/tanstack-start/content/docs/meta.json +4 -0
- package/modules/docs/templates/tanstack-start/source.config.ts +10 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-assets.ts +1 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-client.tsx +22 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-data.ts +24 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-handler.tsx +105 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-layout.tsx +56 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-mdx.tsx +79 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-page-actions.tsx +146 -0
- package/modules/docs/templates/tanstack-start/src/docs/docs-page.tsx +70 -0
- package/modules/docs/templates/tanstack-start/src/docs/llm-text.ts +61 -0
- package/modules/docs/templates/tanstack-start/src/docs/source.ts +7 -0
- package/modules/docs/templates/tanstack-start/src/routes/docs/$.tsx +22 -0
- package/modules/docs/templates/tanstack-start/src/routes/docs/api/markdown.ts +12 -0
- package/modules/docs/templates/tanstack-start/src/routes/docs/api/search.ts +12 -0
- package/modules/docs/templates/tanstack-start/src/routes/docs.index.tsx +22 -0
- package/modules/docs/templates/tanstack-start/src/routes/docs.tsx +22 -0
- package/modules/docs/templates/tanstack-start/src/styles-docs.css +3 -0
- package/modules/guide/templates/astro-emdash/content/guide/capability-map.md +17 -0
- package/modules/guide/templates/astro-emdash/src/components/guide-widget.tsx +41 -0
- package/modules/guide/templates/astro-emdash/src/guide/actions.ts +8 -0
- package/modules/guide/templates/astro-emdash/src/guide/config.ts +21 -0
- package/modules/guide/templates/astro-emdash/src/guide/corpus.gen.ts +4 -0
- package/modules/guide/templates/astro-emdash/src/guide/corpus.manifest.json +72 -0
- package/modules/guide/templates/astro-emdash/src/guide/corpus.ts +4 -0
- package/modules/guide/templates/astro-emdash/src/guide/resources.json +4 -0
- package/modules/guide/templates/react-router/app/components/guide-widget.tsx +29 -0
- package/modules/guide/templates/react-router/app/guide/actions.ts +3 -0
- package/modules/guide/templates/react-router/app/guide/config.ts +21 -0
- package/modules/guide/templates/react-router/app/guide/corpus.gen.ts +4 -0
- package/modules/guide/templates/react-router/app/guide/corpus.manifest.json +22 -0
- package/modules/guide/templates/react-router/app/guide/corpus.ts +4 -0
- package/modules/guide/templates/react-router/app/guide/resources.json +4 -0
- package/modules/guide/templates/react-router/content/guide/capability-map.md +13 -0
- package/modules/guide/templates/tanstack-start/content/guide/capability-map.md +17 -0
- package/modules/guide/templates/tanstack-start/src/components/guide-widget.tsx +41 -0
- package/modules/guide/templates/tanstack-start/src/guide/actions.ts +17 -0
- package/modules/guide/templates/tanstack-start/src/guide/config.ts +21 -0
- package/modules/guide/templates/tanstack-start/src/guide/corpus.gen.ts +4 -0
- package/modules/guide/templates/tanstack-start/src/guide/corpus.manifest.json +22 -0
- package/modules/guide/templates/tanstack-start/src/guide/corpus.ts +4 -0
- package/modules/guide/templates/tanstack-start/src/guide/resources.json +4 -0
- package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
- package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
- package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
- package/modules/openai-subscription/templates/astro-emdash/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
- package/modules/openai-subscription/templates/astro-emdash/src/openai-subscription.ts +11 -0
- package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
- package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
- package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
- package/modules/openai-subscription/templates/react-router/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
- package/modules/openai-subscription/templates/react-router/app/openai-subscription.ts +11 -0
- package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/SKILL.md +57 -0
- package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/compatibility-and-testing.md +129 -0
- package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/module-contract.md +133 -0
- package/modules/openai-subscription/templates/tanstack-start/.agents/skills/raybase-openai-subscription/references/structured-outputs.md +159 -0
- package/modules/openai-subscription/templates/tanstack-start/src/openai-subscription.ts +11 -0
- package/package.json +34 -8
- package/skills/README.md +122 -0
- package/skills/raybase-actions/SKILL.md +223 -0
- package/skills/raybase-actions/references/action-patterns.md +190 -0
- package/skills/raybase-actions/references/adapting-actions.md +93 -0
- package/skills/raybase-actions/references/testing-actions.md +48 -0
- package/skills/raybase-agent-debugging/SKILL.md +230 -0
- package/skills/raybase-ai/SKILL.md +1310 -0
- package/skills/raybase-api/SKILL.md +45 -0
- package/skills/raybase-astro-emdash/SKILL.md +143 -0
- package/skills/raybase-astro-emdash-content-model/SKILL.md +217 -0
- package/skills/raybase-astro-emdash-content-model/references/LICENSE-emdash +9 -0
- package/skills/raybase-astro-emdash-content-model/references/emdash-collections.md +265 -0
- package/skills/raybase-astro-emdash-design/LICENSE-impeccable +60 -0
- package/skills/raybase-astro-emdash-design/SKILL.md +170 -0
- package/skills/raybase-astro-emdash-design/reference/color.md +91 -0
- package/skills/raybase-astro-emdash-design/reference/copy.md +73 -0
- package/skills/raybase-astro-emdash-design/reference/direction.md +115 -0
- package/skills/raybase-astro-emdash-design/reference/imagery.md +84 -0
- package/skills/raybase-astro-emdash-design/reference/layout.md +69 -0
- package/skills/raybase-astro-emdash-design/reference/motion.md +75 -0
- package/skills/raybase-astro-emdash-design/reference/polish.md +75 -0
- package/skills/raybase-astro-emdash-design/reference/typography.md +72 -0
- package/skills/raybase-astro-emdash-galley/SKILL.md +265 -0
- package/skills/raybase-astro-emdash-migration/SKILL.md +218 -0
- package/skills/raybase-astro-emdash-migration/references/inventory-and-conversion.md +242 -0
- package/skills/raybase-astro-emdash-security-review/SKILL.md +68 -0
- package/skills/raybase-astro-emdash-theme-selection/SKILL.md +216 -0
- package/skills/raybase-auth/SKILL.md +358 -0
- package/skills/raybase-background-jobs/SKILL.md +774 -0
- package/skills/raybase-building/SKILL.md +409 -0
- package/skills/raybase-building/references/interview-and-spec.md +87 -0
- package/skills/raybase-building/references/planning-docs.md +26 -0
- package/skills/raybase-building/references/schema-and-config.md +70 -0
- package/skills/raybase-changing-a-live-app/SKILL.md +119 -0
- package/skills/raybase-data-and-policies/SKILL.md +377 -0
- package/skills/raybase-deploy/SKILL.md +136 -0
- package/skills/raybase-docs-writing/SKILL.md +119 -0
- package/skills/raybase-guide/SKILL.md +235 -0
- package/skills/raybase-mcp/SKILL.md +309 -0
- package/skills/raybase-mcp/agents/openai.yaml +4 -0
- package/skills/raybase-notifications/SKILL.md +138 -0
- package/skills/raybase-pro-migration/SKILL.md +28 -0
- package/skills/raybase-react-router/SKILL.md +241 -0
- package/skills/raybase-react-router-design/LICENSE-impeccable +60 -0
- package/skills/raybase-react-router-design/SKILL.md +135 -0
- package/skills/raybase-react-router-design/reference/color.md +87 -0
- package/skills/raybase-react-router-design/reference/copy.md +83 -0
- package/skills/raybase-react-router-design/reference/delight.md +48 -0
- package/skills/raybase-react-router-design/reference/interaction.md +91 -0
- package/skills/raybase-react-router-design/reference/layout.md +82 -0
- package/skills/raybase-react-router-design/reference/motion.md +86 -0
- package/skills/raybase-react-router-design/reference/polish.md +79 -0
- package/skills/raybase-react-router-design/reference/typography.md +71 -0
- package/skills/raybase-react-router-security-review/LICENSE +22 -0
- package/skills/raybase-react-router-security-review/SKILL.md +190 -0
- package/skills/raybase-react-router-security-review/agents/openai.yaml +4 -0
- package/skills/raybase-react-router-security-review/references/api-security.md +519 -0
- package/skills/raybase-react-router-security-review/references/authentication.md +353 -0
- package/skills/raybase-react-router-security-review/references/authorization.md +372 -0
- package/skills/raybase-react-router-security-review/references/business-logic.md +443 -0
- package/skills/raybase-react-router-security-review/references/cryptography.md +329 -0
- package/skills/raybase-react-router-security-review/references/csrf.md +398 -0
- package/skills/raybase-react-router-security-review/references/data-protection.md +378 -0
- package/skills/raybase-react-router-security-review/references/deserialization.md +410 -0
- package/skills/raybase-react-router-security-review/references/error-handling.md +436 -0
- package/skills/raybase-react-router-security-review/references/file-security.md +457 -0
- package/skills/raybase-react-router-security-review/references/injection.md +259 -0
- package/skills/raybase-react-router-security-review/references/logging.md +433 -0
- package/skills/raybase-react-router-security-review/references/misconfiguration.md +435 -0
- package/skills/raybase-react-router-security-review/references/modern-threats.md +475 -0
- package/skills/raybase-react-router-security-review/references/raybase-react-router-security.md +235 -0
- package/skills/raybase-react-router-security-review/references/ssrf.md +413 -0
- package/skills/raybase-react-router-security-review/references/supply-chain.md +405 -0
- package/skills/raybase-react-router-security-review/references/xss.md +336 -0
- package/skills/raybase-realtime/SKILL.md +158 -0
- package/skills/raybase-realtime/agents/openai.yaml +4 -0
- package/skills/raybase-schema/SKILL.md +209 -0
- package/skills/raybase-search/SKILL.md +137 -0
- package/skills/raybase-search/agents/openai.yaml +4 -0
- package/skills/raybase-settings/SKILL.md +139 -0
- package/skills/raybase-settings/agents/openai.yaml +4 -0
- package/skills/raybase-tanstack-start/SKILL.md +166 -0
- package/skills/raybase-tanstack-start-design/LICENSE-impeccable +60 -0
- package/skills/raybase-tanstack-start-design/SKILL.md +140 -0
- package/skills/raybase-tanstack-start-design/reference/color.md +80 -0
- package/skills/raybase-tanstack-start-design/reference/copy.md +83 -0
- package/skills/raybase-tanstack-start-design/reference/delight.md +48 -0
- package/skills/raybase-tanstack-start-design/reference/interaction.md +91 -0
- package/skills/raybase-tanstack-start-design/reference/layout.md +82 -0
- package/skills/raybase-tanstack-start-design/reference/motion.md +86 -0
- package/skills/raybase-tanstack-start-design/reference/polish.md +79 -0
- package/skills/raybase-tanstack-start-design/reference/typography.md +71 -0
- package/skills/raybase-tanstack-start-security-review/LICENSE +22 -0
- package/skills/raybase-tanstack-start-security-review/SKILL.md +194 -0
- package/skills/raybase-tanstack-start-security-review/agents/openai.yaml +4 -0
- package/skills/raybase-tanstack-start-security-review/references/api-security.md +519 -0
- package/skills/raybase-tanstack-start-security-review/references/authentication.md +353 -0
- package/skills/raybase-tanstack-start-security-review/references/authorization.md +372 -0
- package/skills/raybase-tanstack-start-security-review/references/business-logic.md +443 -0
- package/skills/raybase-tanstack-start-security-review/references/cryptography.md +329 -0
- package/skills/raybase-tanstack-start-security-review/references/csrf.md +398 -0
- package/skills/raybase-tanstack-start-security-review/references/data-protection.md +378 -0
- package/skills/raybase-tanstack-start-security-review/references/deserialization.md +410 -0
- package/skills/raybase-tanstack-start-security-review/references/error-handling.md +436 -0
- package/skills/raybase-tanstack-start-security-review/references/file-security.md +457 -0
- package/skills/raybase-tanstack-start-security-review/references/injection.md +259 -0
- package/skills/raybase-tanstack-start-security-review/references/logging.md +433 -0
- package/skills/raybase-tanstack-start-security-review/references/misconfiguration.md +435 -0
- package/skills/raybase-tanstack-start-security-review/references/modern-threats.md +475 -0
- package/skills/raybase-tanstack-start-security-review/references/raybase-tanstack-security.md +208 -0
- package/skills/raybase-tanstack-start-security-review/references/ssrf.md +413 -0
- package/skills/raybase-tanstack-start-security-review/references/supply-chain.md +405 -0
- package/skills/raybase-tanstack-start-security-review/references/xss.md +336 -0
- package/skills-manifest.json +41 -0
- package/templates/astro-emdash/.dev.vars.example +7 -0
- package/templates/astro-emdash/AGENTS.md +122 -0
- package/templates/astro-emdash/DESIGN.md +90 -0
- package/templates/astro-emdash/components.json +21 -0
- package/templates/astro-emdash/content/docs/getting-started.mdx +20 -0
- package/templates/astro-emdash/content/docs/index.mdx +13 -0
- package/templates/astro-emdash/content/docs/mcp.mdx +11 -0
- package/templates/astro-emdash/content/docs/meta.json +4 -0
- package/templates/astro-emdash/content/docs/site-templates.mdx +62 -0
- package/templates/astro-emdash/dev/CODEBASE-MAP.md +46 -0
- package/templates/astro-emdash/dev/SPEC-OVERVIEW.md +15 -0
- package/templates/astro-emdash/dev/SPEC.md +84 -0
- package/templates/astro-emdash/dev/features/archive/.gitkeep +1 -0
- package/templates/astro-emdash/docs/theme-previews/base.svg +24 -0
- package/templates/astro-emdash/docs/theme-previews/steel.svg +24 -0
- package/templates/astro-emdash/docs/theme-previews/zen.svg +24 -0
- package/templates/astro-emdash/docs/themes.md +106 -0
- package/templates/astro-emdash/drizzle.config.ts +5 -0
- package/templates/astro-emdash/gitignore +11 -0
- package/templates/astro-emdash/migrations/app/meta/_journal.json +5 -0
- package/templates/astro-emdash/package.json +79 -0
- package/templates/astro-emdash/pnpm-workspace.yaml +71 -0
- package/templates/astro-emdash/public/_headers +4 -0
- package/templates/astro-emdash/site/astro.config.mjs +120 -0
- package/templates/astro-emdash/site/demo/README.md +72 -0
- package/templates/astro-emdash/site/demo/content/collection.json +43 -0
- package/templates/astro-emdash/site/demo/content/entries.json +120 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-card/manifest.json +51 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-card/sample-content.json +5 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-card/template.liquid +48 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-page/host.json +9 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-page/manifest.json +38 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-page/sample-content.json +34 -0
- package/templates/astro-emdash/site/demo/templates/demo-article-page/template.liquid +84 -0
- package/templates/astro-emdash/site/demo/templates/demo-articles-index/manifest.json +64 -0
- package/templates/astro-emdash/site/demo/templates/demo-articles-index/page.json +7 -0
- package/templates/astro-emdash/site/demo/templates/demo-articles-index/sample-content.json +24 -0
- package/templates/astro-emdash/site/demo/templates/demo-articles-index/template.liquid +100 -0
- package/templates/astro-emdash/site/demo/templates/demo-menu-nav/manifest.json +51 -0
- package/templates/astro-emdash/site/demo/templates/demo-menu-nav/sample-content.json +5 -0
- package/templates/astro-emdash/site/demo/templates/demo-menu-nav/template.liquid +70 -0
- package/templates/astro-emdash/site/gitignore +1 -0
- package/templates/astro-emdash/site/package.json +56 -0
- package/templates/astro-emdash/site/scripts/apply-site-templates.mjs +560 -0
- package/templates/astro-emdash/site/scripts/galley-demo.mjs +298 -0
- package/templates/astro-emdash/site/scripts/seed-galley-starter.mjs +360 -0
- package/templates/astro-emdash/site/scripts/site-origin.mjs +45 -0
- package/templates/astro-emdash/site/seed/seed.json +154 -0
- package/templates/astro-emdash/site/seed/templates/.gitkeep +1 -0
- package/templates/astro-emdash/site/src/components/RaybaseSignedInMenu.astro +163 -0
- package/templates/astro-emdash/site/src/components/blocks/RaybaseActionIsland.astro +41 -0
- package/templates/astro-emdash/site/src/content-door/raybase-routes.ts +738 -0
- package/templates/astro-emdash/site/src/content-door/resolve-page.ts +142 -0
- package/templates/astro-emdash/site/src/content-door/seed.ts +85 -0
- package/templates/astro-emdash/site/src/env.d.ts +12 -0
- package/templates/astro-emdash/site/src/layouts/SiteLayout.astro +68 -0
- package/templates/astro-emdash/site/src/lib/palettes.gen.ts +7 -0
- package/templates/astro-emdash/site/src/lib/site-motion.ts +169 -0
- package/templates/astro-emdash/site/src/lib/site-shell.ts +294 -0
- package/templates/astro-emdash/site/src/live.config.ts +8 -0
- package/templates/astro-emdash/site/src/middleware.ts +20 -0
- package/templates/astro-emdash/site/src/pages/[...slug].astro +113 -0
- package/templates/astro-emdash/site/src/pages/_raybase/handoff/consume.ts +6 -0
- package/templates/astro-emdash/site/src/pages/_raybase/islands/action.ts +8 -0
- package/templates/astro-emdash/site/src/pages/_raybase/sign-out/index.ts +6 -0
- package/templates/astro-emdash/site/src/styles/palette-fonts.gen.css +1 -0
- package/templates/astro-emdash/site/src/styles/palettes.gen.css +3 -0
- package/templates/astro-emdash/site/src/styles.css +607 -0
- package/templates/astro-emdash/site/tsconfig.json +12 -0
- package/templates/astro-emdash/site/wrangler.jsonc +34 -0
- package/templates/astro-emdash/source.config.ts +10 -0
- package/templates/astro-emdash/src/actions.ts +58 -0
- package/templates/astro-emdash/src/ai/agents.ts +20 -0
- package/templates/astro-emdash/src/ai/retrieval.ts +36 -0
- package/templates/astro-emdash/src/auth-door.ts +18 -0
- package/templates/astro-emdash/src/client.tsx +25 -0
- package/templates/astro-emdash/src/components/.gitkeep +1 -0
- package/templates/astro-emdash/src/components/account-menu.tsx +91 -0
- package/templates/astro-emdash/src/components/auth-shell.tsx +69 -0
- package/templates/astro-emdash/src/components/mode-toggle.tsx +32 -0
- package/templates/astro-emdash/src/components/search-command-palette.tsx +107 -0
- package/templates/astro-emdash/src/components/setup-token-page.tsx +196 -0
- package/templates/astro-emdash/src/components/ui/avatar.tsx +107 -0
- package/templates/astro-emdash/src/components/ui/badge.tsx +52 -0
- package/templates/astro-emdash/src/components/ui/button.tsx +69 -0
- package/templates/astro-emdash/src/components/ui/checkbox.tsx +29 -0
- package/templates/astro-emdash/src/components/ui/dialog.tsx +158 -0
- package/templates/astro-emdash/src/components/ui/dropdown-menu.tsx +303 -0
- package/templates/astro-emdash/src/components/ui/input.tsx +20 -0
- package/templates/astro-emdash/src/components/ui/label.tsx +20 -0
- package/templates/astro-emdash/src/components/ui/scroll-area.tsx +53 -0
- package/templates/astro-emdash/src/components/ui/select.tsx +215 -0
- package/templates/astro-emdash/src/components/ui/separator.tsx +23 -0
- package/templates/astro-emdash/src/components/ui/sheet.tsx +138 -0
- package/templates/astro-emdash/src/components/ui/sidebar.tsx +728 -0
- package/templates/astro-emdash/src/components/ui/skeleton.tsx +13 -0
- package/templates/astro-emdash/src/components/ui/textarea.tsx +18 -0
- package/templates/astro-emdash/src/components/ui/tooltip.tsx +66 -0
- package/templates/astro-emdash/src/db/migrations.gen.ts +6 -0
- package/templates/astro-emdash/src/db/schema.ts +6 -0
- package/templates/astro-emdash/src/db/seed.ts +16 -0
- package/templates/astro-emdash/src/db/storage.ts +32 -0
- package/templates/astro-emdash/src/docs/docs-assets.ts +1 -0
- package/templates/astro-emdash/src/docs/docs-client.tsx +22 -0
- package/templates/astro-emdash/src/docs/docs-data.ts +24 -0
- package/templates/astro-emdash/src/docs/docs-handler.tsx +105 -0
- package/templates/astro-emdash/src/docs/docs-layout.tsx +56 -0
- package/templates/astro-emdash/src/docs/docs-mdx.tsx +79 -0
- package/templates/astro-emdash/src/docs/docs-page-actions.tsx +146 -0
- package/templates/astro-emdash/src/docs/docs-page.tsx +70 -0
- package/templates/astro-emdash/src/docs/llm-text.ts +61 -0
- package/templates/astro-emdash/src/docs/source.ts +7 -0
- package/templates/astro-emdash/src/guide/corpus.gen.ts +4 -0
- package/templates/astro-emdash/src/guide/corpus.manifest.json +72 -0
- package/templates/astro-emdash/src/hooks/use-mobile.ts +19 -0
- package/templates/astro-emdash/src/jobs.example.ts +48 -0
- package/templates/astro-emdash/src/lib/account.ts +12 -0
- package/templates/astro-emdash/src/lib/auth-client.ts +181 -0
- package/templates/astro-emdash/src/lib/utils.ts +6 -0
- package/templates/astro-emdash/src/mcp-app.ts +57 -0
- package/templates/astro-emdash/src/notifications.example.ts +37 -0
- package/templates/astro-emdash/src/raybase.auth.ts +70 -0
- package/templates/astro-emdash/src/raybase.config.ts +49 -0
- package/templates/astro-emdash/src/raybase.server.ts +56 -0
- package/templates/astro-emdash/src/realtime.example.ts +18 -0
- package/templates/astro-emdash/src/router.tsx +19 -0
- package/templates/astro-emdash/src/routes/__root.tsx +56 -0
- package/templates/astro-emdash/src/routes/_app/admin.tsx +13 -0
- package/templates/astro-emdash/src/routes/_app/forgot-password.tsx +97 -0
- package/templates/astro-emdash/src/routes/_app/index.tsx +169 -0
- package/templates/astro-emdash/src/routes/_app/invite.$token.tsx +11 -0
- package/templates/astro-emdash/src/routes/_app/login.tsx +193 -0
- package/templates/astro-emdash/src/routes/_app/profile.tsx +98 -0
- package/templates/astro-emdash/src/routes/_app/reset-password.$token.tsx +15 -0
- package/templates/astro-emdash/src/routes/_app/reset-password.tsx +115 -0
- package/templates/astro-emdash/src/routes/_app/setup.$token.tsx +11 -0
- package/templates/astro-emdash/src/routes/_app/signup.tsx +141 -0
- package/templates/astro-emdash/src/routes/_app/verify-email.$token.tsx +15 -0
- package/templates/astro-emdash/src/routes/_app/verify-email.tsx +154 -0
- package/templates/astro-emdash/src/routes/_app.tsx +33 -0
- package/templates/astro-emdash/src/routes/admin/$.ts +20 -0
- package/templates/astro-emdash/src/routes/api/$.ts +19 -0
- package/templates/astro-emdash/src/routes/docs/$.tsx +22 -0
- package/templates/astro-emdash/src/routes/docs/api/markdown.ts +12 -0
- package/templates/astro-emdash/src/routes/docs/api/search.ts +12 -0
- package/templates/astro-emdash/src/routes/docs.index.tsx +22 -0
- package/templates/astro-emdash/src/routes/docs.tsx +22 -0
- package/templates/astro-emdash/src/search.ts +6 -0
- package/templates/astro-emdash/src/settings.ts +12 -0
- package/templates/astro-emdash/src/styles-docs.css +3 -0
- package/templates/astro-emdash/src/styles.css +101 -0
- package/templates/astro-emdash/src/themes/base.css +76 -0
- package/templates/astro-emdash/src/themes/carbon.css +76 -0
- package/templates/astro-emdash/src/themes/fonts.css +25 -0
- package/templates/astro-emdash/src/themes/sage.css +76 -0
- package/templates/astro-emdash/src/themes/sand.css +76 -0
- package/templates/astro-emdash/src/themes/slate.css +81 -0
- package/templates/astro-emdash/src/themes/ultra.css +76 -0
- package/templates/astro-emdash/src/themes/zen.css +76 -0
- package/templates/astro-emdash/src/worker-entry.ts +31 -0
- package/templates/astro-emdash/tests/raybase-patterns.test.ts +29 -0
- package/templates/astro-emdash/tsconfig.json +36 -0
- package/templates/astro-emdash/vite.config.ts +130 -0
- package/templates/astro-emdash/vitest.config.ts +8 -0
- package/templates/astro-emdash/wrangler.jsonc +112 -0
- package/templates/react-router/.dev.vars.example +5 -0
- package/templates/react-router/.editorconfig +15 -0
- package/templates/react-router/AGENTS.md +54 -0
- package/templates/react-router/README.md +52 -0
- package/templates/react-router/app/app.css +44 -0
- package/templates/react-router/app/components/mdx.tsx +79 -0
- package/templates/react-router/app/components/ui/button.tsx +45 -0
- package/templates/react-router/app/components/ui/card.tsx +87 -0
- package/templates/react-router/app/components/ui/separator.tsx +22 -0
- package/templates/react-router/app/db/migrations.gen.ts +6 -0
- package/templates/react-router/app/db/schema.ts +56 -0
- package/templates/react-router/app/db/seed.ts +14 -0
- package/templates/react-router/app/entry.server.tsx +41 -0
- package/templates/react-router/app/globals.d.ts +1 -0
- package/templates/react-router/app/lib/layout.shared.tsx +52 -0
- package/templates/react-router/app/lib/source.ts +7 -0
- package/templates/react-router/app/lib/utils.ts +6 -0
- package/templates/react-router/app/raybase.server.ts +65 -0
- package/templates/react-router/app/root.tsx +23 -0
- package/templates/react-router/app/routes/_index.tsx +53 -0
- package/templates/react-router/app/routes/docs.$.tsx +49 -0
- package/templates/react-router/app/routes/docs.api.search.ts +10 -0
- package/templates/react-router/app/routes/docs.tsx +13 -0
- package/templates/react-router/app/routes.ts +3 -0
- package/templates/react-router/components.json +22 -0
- package/templates/react-router/content/docs/getting-started.mdx +15 -0
- package/templates/react-router/content/docs/index.mdx +8 -0
- package/templates/react-router/content/docs/mcp.mdx +121 -0
- package/templates/react-router/content/docs/meta.json +4 -0
- package/templates/react-router/dev/CODEBASE-MAP.md +48 -0
- package/templates/react-router/dev/SPEC-OVERVIEW.md +35 -0
- package/templates/react-router/dev/SPEC.md +93 -0
- package/templates/react-router/dev/features/archive/.gitkeep +1 -0
- package/templates/react-router/drizzle.config.ts +5 -0
- package/templates/react-router/env.d.ts +53 -0
- package/templates/react-router/gitignore +23 -0
- package/templates/react-router/migrations/app/meta/_journal.json +1 -0
- package/templates/react-router/package.json +70 -0
- package/templates/react-router/public/_headers +4 -0
- package/templates/react-router/public/favicon.ico +0 -0
- package/templates/react-router/react-router.config.ts +9 -0
- package/templates/react-router/source.config.ts +5 -0
- package/templates/react-router/tests/raybase-patterns.test.ts +23 -0
- package/templates/react-router/tsconfig.json +27 -0
- package/templates/react-router/vite.config.ts +59 -0
- package/templates/react-router/vitest.config.ts +8 -0
- package/templates/react-router/workers/app.ts +40 -0
- package/templates/react-router/wrangler.jsonc +111 -0
- package/templates/tanstack-start/.dev.vars.example +5 -0
- package/templates/tanstack-start/AGENTS.md +95 -0
- package/templates/tanstack-start/DESIGN.md +65 -0
- package/templates/tanstack-start/components.json +21 -0
- package/templates/tanstack-start/content/docs/getting-started.mdx +65 -0
- package/templates/tanstack-start/content/docs/index.mdx +10 -0
- package/templates/tanstack-start/content/docs/mcp.mdx +122 -0
- package/templates/tanstack-start/content/docs/meta.json +4 -0
- package/templates/tanstack-start/dev/CODEBASE-MAP.md +84 -0
- package/templates/tanstack-start/dev/SPEC-OVERVIEW.md +46 -0
- package/templates/tanstack-start/dev/SPEC.md +213 -0
- package/templates/tanstack-start/dev/features/archive/.gitkeep +1 -0
- package/templates/tanstack-start/docs/theme-previews/base.svg +24 -0
- package/templates/tanstack-start/docs/theme-previews/steel.svg +24 -0
- package/templates/tanstack-start/docs/theme-previews/zen.svg +24 -0
- package/templates/tanstack-start/docs/themes.md +116 -0
- package/templates/tanstack-start/drizzle.config.ts +5 -0
- package/templates/tanstack-start/gitignore +11 -0
- package/templates/tanstack-start/migrations/app/0000_low_karen_page.sql +26 -0
- package/templates/tanstack-start/migrations/app/meta/0000_snapshot.json +196 -0
- package/templates/tanstack-start/migrations/app/meta/_journal.json +13 -0
- package/templates/tanstack-start/package.json +77 -0
- package/templates/tanstack-start/public/_headers +8 -0
- package/templates/tanstack-start/public/icons/app-icon-maskable.svg +1 -0
- package/templates/tanstack-start/public/icons/app-icon.svg +1 -0
- package/templates/tanstack-start/public/icons/apple-touch-icon.png +0 -0
- package/templates/tanstack-start/public/manifest.webmanifest +14 -0
- package/templates/tanstack-start/public/raybase-push-sw.js +32 -0
- package/templates/tanstack-start/source.config.ts +10 -0
- package/templates/tanstack-start/src/actions.ts +560 -0
- package/templates/tanstack-start/src/ai/agents.ts +78 -0
- package/templates/tanstack-start/src/ai/retrieval.ts +36 -0
- package/templates/tanstack-start/src/auth-door.ts +18 -0
- package/templates/tanstack-start/src/client.tsx +25 -0
- package/templates/tanstack-start/src/components/.gitkeep +1 -0
- package/templates/tanstack-start/src/components/account-menu.tsx +127 -0
- package/templates/tanstack-start/src/components/auth-shell.tsx +69 -0
- package/templates/tanstack-start/src/components/install-app.tsx +35 -0
- package/templates/tanstack-start/src/components/mode-toggle.tsx +32 -0
- package/templates/tanstack-start/src/components/search-command-palette.tsx +107 -0
- package/templates/tanstack-start/src/components/setup-token-page.tsx +197 -0
- package/templates/tanstack-start/src/components/ui/avatar.tsx +107 -0
- package/templates/tanstack-start/src/components/ui/badge.tsx +52 -0
- package/templates/tanstack-start/src/components/ui/button.tsx +69 -0
- package/templates/tanstack-start/src/components/ui/checkbox.tsx +29 -0
- package/templates/tanstack-start/src/components/ui/dialog.tsx +158 -0
- package/templates/tanstack-start/src/components/ui/dropdown-menu.tsx +303 -0
- package/templates/tanstack-start/src/components/ui/input.tsx +20 -0
- package/templates/tanstack-start/src/components/ui/label.tsx +20 -0
- package/templates/tanstack-start/src/components/ui/scroll-area.tsx +53 -0
- package/templates/tanstack-start/src/components/ui/select.tsx +215 -0
- package/templates/tanstack-start/src/components/ui/separator.tsx +23 -0
- package/templates/tanstack-start/src/components/ui/sheet.tsx +138 -0
- package/templates/tanstack-start/src/components/ui/sidebar.tsx +728 -0
- package/templates/tanstack-start/src/components/ui/skeleton.tsx +13 -0
- package/templates/tanstack-start/src/components/ui/textarea.tsx +18 -0
- package/templates/tanstack-start/src/components/ui/tooltip.tsx +66 -0
- package/templates/tanstack-start/src/db/migrations.gen.ts +6 -0
- package/templates/tanstack-start/src/db/schema.ts +90 -0
- package/templates/tanstack-start/src/db/seed.ts +106 -0
- package/templates/tanstack-start/src/db/storage.ts +32 -0
- package/templates/tanstack-start/src/docs/docs-assets.ts +1 -0
- package/templates/tanstack-start/src/docs/docs-client.tsx +22 -0
- package/templates/tanstack-start/src/docs/docs-data.ts +24 -0
- package/templates/tanstack-start/src/docs/docs-handler.tsx +105 -0
- package/templates/tanstack-start/src/docs/docs-layout.tsx +56 -0
- package/templates/tanstack-start/src/docs/docs-mdx.tsx +79 -0
- package/templates/tanstack-start/src/docs/docs-page-actions.tsx +146 -0
- package/templates/tanstack-start/src/docs/docs-page.tsx +70 -0
- package/templates/tanstack-start/src/docs/llm-text.ts +61 -0
- package/templates/tanstack-start/src/docs/source.ts +7 -0
- package/templates/tanstack-start/src/hooks/use-mobile.ts +19 -0
- package/templates/tanstack-start/src/hooks/use-pwa-install.ts +77 -0
- package/templates/tanstack-start/src/jobs.example.ts +56 -0
- package/templates/tanstack-start/src/lib/account.ts +13 -0
- package/templates/tanstack-start/src/lib/auth-client.ts +187 -0
- package/templates/tanstack-start/src/lib/push-client.ts +98 -0
- package/templates/tanstack-start/src/lib/utils.ts +6 -0
- package/templates/tanstack-start/src/mcp-app.ts +74 -0
- package/templates/tanstack-start/src/notifications.example.ts +37 -0
- package/templates/tanstack-start/src/raybase.auth.ts +86 -0
- package/templates/tanstack-start/src/raybase.config.ts +86 -0
- package/templates/tanstack-start/src/raybase.server.ts +155 -0
- package/templates/tanstack-start/src/realtime.example.ts +46 -0
- package/templates/tanstack-start/src/router.tsx +19 -0
- package/templates/tanstack-start/src/routes/__root.tsx +73 -0
- package/templates/tanstack-start/src/routes/_app/admin.tsx +13 -0
- package/templates/tanstack-start/src/routes/_app/forgot-password.tsx +97 -0
- package/templates/tanstack-start/src/routes/_app/index.tsx +1316 -0
- package/templates/tanstack-start/src/routes/_app/invite.$token.tsx +11 -0
- package/templates/tanstack-start/src/routes/_app/login.tsx +193 -0
- package/templates/tanstack-start/src/routes/_app/profile.tsx +98 -0
- package/templates/tanstack-start/src/routes/_app/reset-password.$token.tsx +16 -0
- package/templates/tanstack-start/src/routes/_app/reset-password.tsx +115 -0
- package/templates/tanstack-start/src/routes/_app/setup.$token.tsx +11 -0
- package/templates/tanstack-start/src/routes/_app/signup.tsx +141 -0
- package/templates/tanstack-start/src/routes/_app/verify-email.$token.tsx +15 -0
- package/templates/tanstack-start/src/routes/_app/verify-email.tsx +154 -0
- package/templates/tanstack-start/src/routes/_app.tsx +33 -0
- package/templates/tanstack-start/src/routes/admin/$.ts +20 -0
- package/templates/tanstack-start/src/routes/api/$.ts +19 -0
- package/templates/tanstack-start/src/routes/docs/$.tsx +22 -0
- package/templates/tanstack-start/src/routes/docs/api/markdown.ts +12 -0
- package/templates/tanstack-start/src/routes/docs/api/search.ts +12 -0
- package/templates/tanstack-start/src/routes/docs.index.tsx +22 -0
- package/templates/tanstack-start/src/routes/docs.tsx +22 -0
- package/templates/tanstack-start/src/search.ts +26 -0
- package/templates/tanstack-start/src/settings.ts +12 -0
- package/templates/tanstack-start/src/styles-docs.css +3 -0
- package/templates/tanstack-start/src/styles.css +73 -0
- package/templates/tanstack-start/src/themes/base.css +76 -0
- package/templates/tanstack-start/src/themes/carbon.css +76 -0
- package/templates/tanstack-start/src/themes/fonts.css +18 -0
- package/templates/tanstack-start/src/themes/sage.css +76 -0
- package/templates/tanstack-start/src/themes/sand.css +76 -0
- package/templates/tanstack-start/src/themes/slate.css +76 -0
- package/templates/tanstack-start/src/themes/ultra.css +76 -0
- package/templates/tanstack-start/src/themes/zen.css +76 -0
- package/templates/tanstack-start/src/worker-entry.ts +30 -0
- package/templates/tanstack-start/tests/raybase-patterns.test.ts +247 -0
- package/templates/tanstack-start/tsconfig.json +33 -0
- package/templates/tanstack-start/vite.config.ts +132 -0
- package/templates/tanstack-start/vitest.config.ts +8 -0
- package/templates/tanstack-start/wrangler.jsonc +112 -0
- package/README.md +0 -3
|
@@ -0,0 +1,519 @@
|
|
|
1
|
+
# API Security Reference
|
|
2
|
+
|
|
3
|
+
## Overview
|
|
4
|
+
|
|
5
|
+
APIs expose application functionality and data, making them prime targets for attackers. This reference covers security for REST APIs, GraphQL, and general API patterns.
|
|
6
|
+
|
|
7
|
+
## Authentication
|
|
8
|
+
|
|
9
|
+
### Token-Based Authentication
|
|
10
|
+
|
|
11
|
+
```python
|
|
12
|
+
# JWT Best Practices
|
|
13
|
+
# 1. Use strong signing algorithms
|
|
14
|
+
# VULNERABLE: None algorithm
|
|
15
|
+
jwt.decode(token, algorithms=['none'])
|
|
16
|
+
|
|
17
|
+
# SAFE: Explicit algorithm
|
|
18
|
+
jwt.decode(token, secret_key, algorithms=['HS256'])
|
|
19
|
+
|
|
20
|
+
# 2. Validate standard claims
|
|
21
|
+
def validate_jwt(token):
|
|
22
|
+
payload = jwt.decode(token, SECRET_KEY, algorithms=['HS256'])
|
|
23
|
+
|
|
24
|
+
# Validate issuer
|
|
25
|
+
if payload.get('iss') != EXPECTED_ISSUER:
|
|
26
|
+
raise ValueError("Invalid issuer")
|
|
27
|
+
|
|
28
|
+
# Validate audience
|
|
29
|
+
if payload.get('aud') != EXPECTED_AUDIENCE:
|
|
30
|
+
raise ValueError("Invalid audience")
|
|
31
|
+
|
|
32
|
+
# Validate expiration (jwt library does this automatically)
|
|
33
|
+
# Validate not-before (jwt library does this automatically)
|
|
34
|
+
|
|
35
|
+
return payload
|
|
36
|
+
```
|
|
37
|
+
|
|
38
|
+
### API Key Security
|
|
39
|
+
|
|
40
|
+
```python
|
|
41
|
+
# VULNERABLE: API key in URL (logged, cached, visible)
|
|
42
|
+
GET /api/users?api_key=secret123
|
|
43
|
+
|
|
44
|
+
# SAFE: API key in header
|
|
45
|
+
GET /api/users
|
|
46
|
+
Authorization: Bearer api_key_here
|
|
47
|
+
# Or
|
|
48
|
+
X-API-Key: api_key_here
|
|
49
|
+
|
|
50
|
+
# Server-side validation
|
|
51
|
+
def require_api_key(f):
|
|
52
|
+
@wraps(f)
|
|
53
|
+
def decorated(*args, **kwargs):
|
|
54
|
+
api_key = request.headers.get('X-API-Key')
|
|
55
|
+
if not api_key or not validate_api_key(api_key):
|
|
56
|
+
return jsonify({'error': 'Invalid API key'}), 401
|
|
57
|
+
|
|
58
|
+
# Rate limit by API key
|
|
59
|
+
if is_rate_limited(api_key):
|
|
60
|
+
return jsonify({'error': 'Rate limit exceeded'}), 429
|
|
61
|
+
|
|
62
|
+
return f(*args, **kwargs)
|
|
63
|
+
return decorated
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
---
|
|
67
|
+
|
|
68
|
+
## Authorization
|
|
69
|
+
|
|
70
|
+
### Endpoint-Level Authorization
|
|
71
|
+
|
|
72
|
+
```python
|
|
73
|
+
# VULNERABLE: No authorization check
|
|
74
|
+
@app.route('/api/users/<user_id>', methods=['GET'])
|
|
75
|
+
def get_user(user_id):
|
|
76
|
+
return User.query.get(user_id).to_dict()
|
|
77
|
+
|
|
78
|
+
# SAFE: Authorization check
|
|
79
|
+
@app.route('/api/users/<user_id>', methods=['GET'])
|
|
80
|
+
@require_auth
|
|
81
|
+
def get_user(user_id):
|
|
82
|
+
if not current_user.can_access_user(user_id):
|
|
83
|
+
return jsonify({'error': 'Forbidden'}), 403
|
|
84
|
+
return User.query.get(user_id).to_dict()
|
|
85
|
+
```
|
|
86
|
+
|
|
87
|
+
### Field-Level Authorization
|
|
88
|
+
|
|
89
|
+
```python
|
|
90
|
+
# VULNERABLE: All fields returned
|
|
91
|
+
@app.route('/api/users/<user_id>')
|
|
92
|
+
def get_user(user_id):
|
|
93
|
+
user = User.query.get(user_id)
|
|
94
|
+
return jsonify({
|
|
95
|
+
'id': user.id,
|
|
96
|
+
'email': user.email,
|
|
97
|
+
'ssn': user.ssn, # Sensitive!
|
|
98
|
+
'is_admin': user.is_admin, # Internal!
|
|
99
|
+
'password_hash': user.password_hash # NEVER expose!
|
|
100
|
+
})
|
|
101
|
+
|
|
102
|
+
# SAFE: Filtered response based on permissions
|
|
103
|
+
@app.route('/api/users/<user_id>')
|
|
104
|
+
@require_auth
|
|
105
|
+
def get_user(user_id):
|
|
106
|
+
user = User.query.get(user_id)
|
|
107
|
+
|
|
108
|
+
response = {
|
|
109
|
+
'id': user.id,
|
|
110
|
+
'name': user.name,
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
# Add fields based on permissions
|
|
114
|
+
if current_user.id == user_id or current_user.is_admin:
|
|
115
|
+
response['email'] = user.email
|
|
116
|
+
|
|
117
|
+
if current_user.is_admin:
|
|
118
|
+
response['is_admin'] = user.is_admin
|
|
119
|
+
|
|
120
|
+
return jsonify(response)
|
|
121
|
+
```
|
|
122
|
+
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
## Input Validation
|
|
126
|
+
|
|
127
|
+
### Request Validation
|
|
128
|
+
|
|
129
|
+
```python
|
|
130
|
+
from pydantic import BaseModel, validator, Field
|
|
131
|
+
from typing import Optional
|
|
132
|
+
|
|
133
|
+
class CreateUserRequest(BaseModel):
|
|
134
|
+
name: str = Field(..., min_length=1, max_length=100)
|
|
135
|
+
email: str = Field(..., regex=r'^[\w\.-]+@[\w\.-]+\.\w+$')
|
|
136
|
+
age: Optional[int] = Field(None, ge=0, le=150)
|
|
137
|
+
|
|
138
|
+
@validator('name')
|
|
139
|
+
def name_must_not_be_empty(cls, v):
|
|
140
|
+
if not v.strip():
|
|
141
|
+
raise ValueError('Name cannot be empty')
|
|
142
|
+
return v.strip()
|
|
143
|
+
|
|
144
|
+
@app.route('/api/users', methods=['POST'])
|
|
145
|
+
def create_user():
|
|
146
|
+
try:
|
|
147
|
+
data = CreateUserRequest(**request.json)
|
|
148
|
+
except ValidationError as e:
|
|
149
|
+
return jsonify({'error': e.errors()}), 400
|
|
150
|
+
|
|
151
|
+
# Process validated data
|
|
152
|
+
return create_user_from_data(data)
|
|
153
|
+
```
|
|
154
|
+
|
|
155
|
+
### Content-Type Validation
|
|
156
|
+
|
|
157
|
+
```python
|
|
158
|
+
# VULNERABLE: Accept any content type
|
|
159
|
+
@app.route('/api/data', methods=['POST'])
|
|
160
|
+
def process_data():
|
|
161
|
+
data = request.get_json() # May fail silently
|
|
162
|
+
|
|
163
|
+
# SAFE: Validate content type
|
|
164
|
+
@app.route('/api/data', methods=['POST'])
|
|
165
|
+
def process_data():
|
|
166
|
+
if request.content_type != 'application/json':
|
|
167
|
+
return jsonify({'error': 'Content-Type must be application/json'}), 415
|
|
168
|
+
|
|
169
|
+
data = request.get_json()
|
|
170
|
+
if data is None:
|
|
171
|
+
return jsonify({'error': 'Invalid JSON'}), 400
|
|
172
|
+
|
|
173
|
+
return process(data)
|
|
174
|
+
```
|
|
175
|
+
|
|
176
|
+
### Request Size Limits
|
|
177
|
+
|
|
178
|
+
```python
|
|
179
|
+
# Flask
|
|
180
|
+
app.config['MAX_CONTENT_LENGTH'] = 16 * 1024 * 1024 # 16MB max
|
|
181
|
+
|
|
182
|
+
# Express
|
|
183
|
+
app.use(express.json({ limit: '10mb' }))
|
|
184
|
+
|
|
185
|
+
# Handle large request errors
|
|
186
|
+
@app.errorhandler(413)
|
|
187
|
+
def request_too_large(e):
|
|
188
|
+
return jsonify({'error': 'Request too large'}), 413
|
|
189
|
+
```
|
|
190
|
+
|
|
191
|
+
---
|
|
192
|
+
|
|
193
|
+
## Rate Limiting
|
|
194
|
+
|
|
195
|
+
### Implementation
|
|
196
|
+
|
|
197
|
+
```python
|
|
198
|
+
from flask_limiter import Limiter
|
|
199
|
+
from flask_limiter.util import get_remote_address
|
|
200
|
+
|
|
201
|
+
limiter = Limiter(
|
|
202
|
+
app,
|
|
203
|
+
key_func=get_remote_address,
|
|
204
|
+
default_limits=["200 per day", "50 per hour"]
|
|
205
|
+
)
|
|
206
|
+
|
|
207
|
+
# Endpoint-specific limits
|
|
208
|
+
@app.route('/api/login', methods=['POST'])
|
|
209
|
+
@limiter.limit("5 per minute") # Prevent brute force
|
|
210
|
+
def login():
|
|
211
|
+
pass
|
|
212
|
+
|
|
213
|
+
@app.route('/api/password-reset', methods=['POST'])
|
|
214
|
+
@limiter.limit("3 per hour") # Prevent enumeration
|
|
215
|
+
def password_reset():
|
|
216
|
+
pass
|
|
217
|
+
|
|
218
|
+
# Return proper headers
|
|
219
|
+
# X-RateLimit-Limit: 50
|
|
220
|
+
# X-RateLimit-Remaining: 45
|
|
221
|
+
# X-RateLimit-Reset: 1623456789
|
|
222
|
+
# Retry-After: 3600 (when limited)
|
|
223
|
+
```
|
|
224
|
+
|
|
225
|
+
### Rate Limit by API Key
|
|
226
|
+
|
|
227
|
+
```python
|
|
228
|
+
def get_rate_limit_key():
|
|
229
|
+
# Prefer API key over IP for authenticated requests
|
|
230
|
+
api_key = request.headers.get('X-API-Key')
|
|
231
|
+
if api_key:
|
|
232
|
+
return f"api_key:{api_key}"
|
|
233
|
+
return f"ip:{get_remote_address()}"
|
|
234
|
+
|
|
235
|
+
limiter = Limiter(key_func=get_rate_limit_key)
|
|
236
|
+
```
|
|
237
|
+
|
|
238
|
+
---
|
|
239
|
+
|
|
240
|
+
## Mass Assignment Prevention
|
|
241
|
+
|
|
242
|
+
```python
|
|
243
|
+
# VULNERABLE: Accepting all fields
|
|
244
|
+
@app.route('/api/users/<id>', methods=['PATCH'])
|
|
245
|
+
def update_user(id):
|
|
246
|
+
user = User.query.get(id)
|
|
247
|
+
user.update(**request.json) # Attacker sets is_admin=True
|
|
248
|
+
return user.to_dict()
|
|
249
|
+
|
|
250
|
+
# SAFE: Allowlist of fields
|
|
251
|
+
ALLOWED_USER_FIELDS = {'name', 'email', 'bio'}
|
|
252
|
+
|
|
253
|
+
@app.route('/api/users/<id>', methods=['PATCH'])
|
|
254
|
+
def update_user(id):
|
|
255
|
+
user = User.query.get(id)
|
|
256
|
+
data = {k: v for k, v in request.json.items() if k in ALLOWED_USER_FIELDS}
|
|
257
|
+
user.update(**data)
|
|
258
|
+
return user.to_dict()
|
|
259
|
+
|
|
260
|
+
# BETTER: Use DTOs
|
|
261
|
+
class UserUpdateDTO(BaseModel):
|
|
262
|
+
name: Optional[str]
|
|
263
|
+
email: Optional[str]
|
|
264
|
+
bio: Optional[str]
|
|
265
|
+
# is_admin NOT included - can't be set
|
|
266
|
+
|
|
267
|
+
@app.route('/api/users/<id>', methods=['PATCH'])
|
|
268
|
+
def update_user(id):
|
|
269
|
+
dto = UserUpdateDTO(**request.json)
|
|
270
|
+
user = User.query.get(id)
|
|
271
|
+
user.update(**dto.dict(exclude_unset=True))
|
|
272
|
+
return user.to_dict()
|
|
273
|
+
```
|
|
274
|
+
|
|
275
|
+
---
|
|
276
|
+
|
|
277
|
+
## GraphQL Security
|
|
278
|
+
|
|
279
|
+
### Query Depth Limiting
|
|
280
|
+
|
|
281
|
+
```python
|
|
282
|
+
# VULNERABLE: Unbounded depth
|
|
283
|
+
# query { user { friends { friends { friends { ... } } } } }
|
|
284
|
+
|
|
285
|
+
# SAFE: Limit query depth
|
|
286
|
+
from graphql import validate
|
|
287
|
+
from graphql_core import depth_limit_validator
|
|
288
|
+
|
|
289
|
+
schema = build_schema(...)
|
|
290
|
+
|
|
291
|
+
def execute_query(query):
|
|
292
|
+
errors = validate(
|
|
293
|
+
schema,
|
|
294
|
+
parse(query),
|
|
295
|
+
[depth_limit_validator(max_depth=5)]
|
|
296
|
+
)
|
|
297
|
+
if errors:
|
|
298
|
+
return {'errors': [str(e) for e in errors]}
|
|
299
|
+
return graphql_sync(schema, query)
|
|
300
|
+
```
|
|
301
|
+
|
|
302
|
+
### Query Cost Analysis
|
|
303
|
+
|
|
304
|
+
```python
|
|
305
|
+
# Assign costs to fields and limit total cost
|
|
306
|
+
from graphene import ObjectType, Field, Int
|
|
307
|
+
|
|
308
|
+
class Query(ObjectType):
|
|
309
|
+
user = Field(User, cost=1)
|
|
310
|
+
users = Field(List(User), cost=lambda info, **args: args.get('limit', 10))
|
|
311
|
+
expensive_query = Field(Report, cost=100)
|
|
312
|
+
|
|
313
|
+
# Reject queries exceeding cost threshold
|
|
314
|
+
MAX_QUERY_COST = 1000
|
|
315
|
+
```
|
|
316
|
+
|
|
317
|
+
### Disable Introspection in Production
|
|
318
|
+
|
|
319
|
+
```python
|
|
320
|
+
# VULNERABLE: Introspection enabled
|
|
321
|
+
# Attackers can discover entire schema
|
|
322
|
+
|
|
323
|
+
# SAFE: Disable introspection
|
|
324
|
+
from graphql import GraphQLSchema
|
|
325
|
+
|
|
326
|
+
class NoIntrospectionMiddleware:
|
|
327
|
+
def resolve(self, next, root, info, **args):
|
|
328
|
+
if info.field_name in ('__schema', '__type'):
|
|
329
|
+
return None
|
|
330
|
+
return next(root, info, **args)
|
|
331
|
+
|
|
332
|
+
# Or in configuration
|
|
333
|
+
app.config['GRAPHQL_INTROSPECTION'] = False
|
|
334
|
+
```
|
|
335
|
+
|
|
336
|
+
### Batching Attack Prevention
|
|
337
|
+
|
|
338
|
+
```python
|
|
339
|
+
# VULNERABLE: Allows unlimited batched mutations
|
|
340
|
+
# [
|
|
341
|
+
# { "query": "mutation { login(user: 'a', pass: 'a') }" },
|
|
342
|
+
# { "query": "mutation { login(user: 'a', pass: 'b') }" },
|
|
343
|
+
# ...
|
|
344
|
+
# ]
|
|
345
|
+
|
|
346
|
+
# SAFE: Limit batch size
|
|
347
|
+
MAX_BATCH_SIZE = 10
|
|
348
|
+
|
|
349
|
+
@app.route('/graphql', methods=['POST'])
|
|
350
|
+
def graphql_endpoint():
|
|
351
|
+
data = request.json
|
|
352
|
+
|
|
353
|
+
if isinstance(data, list):
|
|
354
|
+
if len(data) > MAX_BATCH_SIZE:
|
|
355
|
+
return jsonify({'error': 'Batch size exceeded'}), 400
|
|
356
|
+
```
|
|
357
|
+
|
|
358
|
+
---
|
|
359
|
+
|
|
360
|
+
## Error Handling
|
|
361
|
+
|
|
362
|
+
### Generic Error Responses
|
|
363
|
+
|
|
364
|
+
```python
|
|
365
|
+
# VULNERABLE: Detailed errors
|
|
366
|
+
@app.errorhandler(Exception)
|
|
367
|
+
def handle_error(e):
|
|
368
|
+
return jsonify({
|
|
369
|
+
'error': str(e),
|
|
370
|
+
'traceback': traceback.format_exc(),
|
|
371
|
+
'query': last_query
|
|
372
|
+
}), 500
|
|
373
|
+
|
|
374
|
+
# SAFE: Generic errors
|
|
375
|
+
@app.errorhandler(Exception)
|
|
376
|
+
def handle_error(e):
|
|
377
|
+
# Log full details server-side
|
|
378
|
+
app.logger.error(f"Error: {e}", exc_info=True)
|
|
379
|
+
|
|
380
|
+
# Return generic message
|
|
381
|
+
return jsonify({'error': 'An unexpected error occurred'}), 500
|
|
382
|
+
|
|
383
|
+
# Use RFC 7807 Problem Details
|
|
384
|
+
@app.errorhandler(404)
|
|
385
|
+
def not_found(e):
|
|
386
|
+
return jsonify({
|
|
387
|
+
'type': 'https://example.com/problems/not-found',
|
|
388
|
+
'title': 'Resource Not Found',
|
|
389
|
+
'status': 404,
|
|
390
|
+
'detail': 'The requested resource was not found'
|
|
391
|
+
}), 404
|
|
392
|
+
```
|
|
393
|
+
|
|
394
|
+
---
|
|
395
|
+
|
|
396
|
+
## Security Headers
|
|
397
|
+
|
|
398
|
+
```python
|
|
399
|
+
@app.after_request
|
|
400
|
+
def add_security_headers(response):
|
|
401
|
+
# Prevent caching of sensitive data
|
|
402
|
+
if request.endpoint in SENSITIVE_ENDPOINTS:
|
|
403
|
+
response.headers['Cache-Control'] = 'no-store'
|
|
404
|
+
|
|
405
|
+
response.headers['X-Content-Type-Options'] = 'nosniff'
|
|
406
|
+
response.headers['X-Frame-Options'] = 'DENY'
|
|
407
|
+
response.headers['Content-Security-Policy'] = "default-src 'none'"
|
|
408
|
+
|
|
409
|
+
return response
|
|
410
|
+
```
|
|
411
|
+
|
|
412
|
+
---
|
|
413
|
+
|
|
414
|
+
## CORS Configuration
|
|
415
|
+
|
|
416
|
+
```python
|
|
417
|
+
# VULNERABLE: Allow all origins
|
|
418
|
+
CORS(app, origins='*')
|
|
419
|
+
|
|
420
|
+
# VULNERABLE: Reflect origin header
|
|
421
|
+
@app.after_request
|
|
422
|
+
def add_cors(response):
|
|
423
|
+
response.headers['Access-Control-Allow-Origin'] = request.headers.get('Origin')
|
|
424
|
+
return response
|
|
425
|
+
|
|
426
|
+
# SAFE: Explicit allowlist
|
|
427
|
+
CORS(app, origins=[
|
|
428
|
+
'https://app.example.com',
|
|
429
|
+
'https://admin.example.com'
|
|
430
|
+
], supports_credentials=True)
|
|
431
|
+
|
|
432
|
+
# SAFE: Dynamic with validation
|
|
433
|
+
ALLOWED_ORIGINS = {'https://app.example.com', 'https://admin.example.com'}
|
|
434
|
+
|
|
435
|
+
@app.after_request
|
|
436
|
+
def add_cors(response):
|
|
437
|
+
origin = request.headers.get('Origin')
|
|
438
|
+
if origin in ALLOWED_ORIGINS:
|
|
439
|
+
response.headers['Access-Control-Allow-Origin'] = origin
|
|
440
|
+
response.headers['Access-Control-Allow-Credentials'] = 'true'
|
|
441
|
+
return response
|
|
442
|
+
```
|
|
443
|
+
|
|
444
|
+
---
|
|
445
|
+
|
|
446
|
+
## HTTP Methods
|
|
447
|
+
|
|
448
|
+
```python
|
|
449
|
+
# VULNERABLE: Method not enforced
|
|
450
|
+
@app.route('/api/users', methods=['GET', 'POST', 'PUT', 'DELETE'])
|
|
451
|
+
def users():
|
|
452
|
+
pass
|
|
453
|
+
|
|
454
|
+
# SAFE: Explicit method handling
|
|
455
|
+
@app.route('/api/users', methods=['GET'])
|
|
456
|
+
def list_users():
|
|
457
|
+
pass
|
|
458
|
+
|
|
459
|
+
@app.route('/api/users', methods=['POST'])
|
|
460
|
+
@require_auth
|
|
461
|
+
def create_user():
|
|
462
|
+
pass
|
|
463
|
+
|
|
464
|
+
# Return 405 for unsupported methods
|
|
465
|
+
@app.errorhandler(405)
|
|
466
|
+
def method_not_allowed(e):
|
|
467
|
+
return jsonify({'error': 'Method not allowed'}), 405
|
|
468
|
+
```
|
|
469
|
+
|
|
470
|
+
---
|
|
471
|
+
|
|
472
|
+
## Grep Patterns for Detection
|
|
473
|
+
|
|
474
|
+
```bash
|
|
475
|
+
# Missing authentication
|
|
476
|
+
grep -rn "@app\.route\|@router\." --include="*.py" | grep -v "@require_auth\|@login_required"
|
|
477
|
+
|
|
478
|
+
# Returning all fields
|
|
479
|
+
grep -rn "to_dict()\|__dict__\|serialize" --include="*.py"
|
|
480
|
+
|
|
481
|
+
# Mass assignment
|
|
482
|
+
grep -rn "\*\*request\.\|update(\*\*\|create(\*\*" --include="*.py"
|
|
483
|
+
|
|
484
|
+
# Missing rate limiting
|
|
485
|
+
grep -rn "login\|password\|reset" --include="*.py" | grep "route" | grep -v "limiter\|rate"
|
|
486
|
+
|
|
487
|
+
# GraphQL introspection
|
|
488
|
+
grep -rn "__schema\|introspection" --include="*.py"
|
|
489
|
+
|
|
490
|
+
# CORS wildcards
|
|
491
|
+
grep -rn "origins.*\*\|Access-Control-Allow-Origin.*\*" --include="*.py"
|
|
492
|
+
```
|
|
493
|
+
|
|
494
|
+
---
|
|
495
|
+
|
|
496
|
+
## Testing Checklist
|
|
497
|
+
|
|
498
|
+
- [ ] All endpoints require authentication (except public ones)
|
|
499
|
+
- [ ] Authorization checked for every request
|
|
500
|
+
- [ ] Input validation on all parameters
|
|
501
|
+
- [ ] Response filtering (no sensitive data exposure)
|
|
502
|
+
- [ ] Rate limiting on authentication endpoints
|
|
503
|
+
- [ ] Rate limiting on resource-intensive endpoints
|
|
504
|
+
- [ ] Mass assignment prevented (field allowlists)
|
|
505
|
+
- [ ] Proper error handling (no information leakage)
|
|
506
|
+
- [ ] Security headers configured
|
|
507
|
+
- [ ] CORS properly configured
|
|
508
|
+
- [ ] HTTP methods restricted
|
|
509
|
+
- [ ] GraphQL depth/cost limiting (if applicable)
|
|
510
|
+
- [ ] GraphQL introspection disabled in production
|
|
511
|
+
|
|
512
|
+
---
|
|
513
|
+
|
|
514
|
+
## References
|
|
515
|
+
|
|
516
|
+
- [OWASP REST Security Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/REST_Security_Cheat_Sheet.html)
|
|
517
|
+
- [OWASP GraphQL Cheat Sheet](https://cheatsheetseries.owasp.org/cheatsheets/GraphQL_Cheat_Sheet.html)
|
|
518
|
+
- [OWASP API Security Top 10](https://owasp.org/www-project-api-security/)
|
|
519
|
+
- [CWE-285: Improper Authorization](https://cwe.mitre.org/data/definitions/285.html)
|