@picked/config 0.0.111-next.3 → 0.0.111

package/dist/cjs/index.js

@@ -1,5 +1,5 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let e=require("node:fs"),t=require("node:fs/promises"),n=require("node:path"),r=require("jiti"),i=require("node:crypto"),a=require("@picked/delivery-api-client");function o(e){return e}var s=`manifest.json`,c=`schema.json`,l=`schema-manifest.json`,u=`
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require("../config-BqUv-9JF.cjs");let t=require("node:fs"),n=require("node:fs/promises"),r=require("node:path"),i=require("jiti"),a=require("node:crypto"),o=require("@picked/delivery-api-client");var s=`manifest.json`,c=`schema.json`,l=`schema-manifest.json`,u=`
 # Picked codegen intermediates
 .picked/
-`;function d(e){let t=(0,n.join)(e,`.picked`);return{pickedDir:t,manifestPath:(0,n.join)(t,s),schemaPath:(0,n.join)(t,c),codegenManifestPath:(0,n.join)(t,l)}}function f(e){return(0,i.createHash)(`sha256`).update(e).digest(`hex`)}function p(e){return typeof e!=`object`||!e?!1:`schemaHash`in e&&typeof e.schemaHash==`string`}async function m(n){if(!(0,e.existsSync)(n))return null;let r=await(0,t.readFile)(n,`utf8`),i=JSON.parse(r);return p(i)?i:null}async function h(e){let n=d(e.projectRoot);await(0,t.mkdir)(n.pickedDir,{recursive:!0}),await(0,t.writeFile)(n.schemaPath,e.schemaJson,`utf8`),await(0,t.writeFile)(n.codegenManifestPath,`${JSON.stringify(e.manifest,null,2)}\n`,`utf8`)}async function g(r){let i=(0,n.join)(r,`.gitignore`);(0,e.existsSync)(i)?(await(0,t.readFile)(i,`utf8`)).includes(`.picked/`)||await(0,t.appendFile)(i,u,`utf8`):await(0,t.writeFile)(i,`.picked/
-`,`utf8`)}function _(e){let t;try{t=new URL(e)}catch{throw Error(`Invalid Picked API URL: ${e}`)}let n=t.hostname===`localhost`||t.hostname===`127.0.0.1`||t.hostname===`[::1]`;if(t.protocol!==`https:`&&!n)throw Error(`Refusing to use a non-HTTPS Picked API URL (${e}); tokens must not be sent over cleartext.`);return e}function v(e){return new URL(_(e)).origin}var y=`settings.json`,b=384;function x(e){return(0,n.join)(e,`.picked`,y)}function ee(e){return!(typeof e!=`object`||!e||!(`id`in e)||typeof e.id!=`string`||!(`name`in e)||typeof e.name!=`string`||!(`status`in e)||typeof e.status!=`string`||!(`source`in e)||e.source!==`published`&&e.source!==`preview`)}function te(e){return typeof e!=`object`||!e||!(`projectId`in e)||typeof e.projectId!=`string`?!1:!(`workspace`in e)||e.workspace===void 0||ee(e.workspace)}function ne(e){return typeof e!=`object`||!e?!1:Object.values(e).every(te)}async function S(n){let r=x(n);if(!(0,e.existsSync)(r))return{};try{let e=JSON.parse(await(0,t.readFile)(r,`utf8`));return ne(e)?e:{}}catch{return{}}}async function C(e,t){return(await S(e))[v(t)]??null}async function w(e,r,i){let a=x(e),o={...await S(e),[v(r)]:i};await(0,t.mkdir)((0,n.dirname)(a),{recursive:!0}),await g(e),await(0,t.writeFile)(a,`${JSON.stringify(o,null,2)}\n`,{encoding:`utf8`,mode:b}),await(0,t.chmod)(a,b)}var T=`https://api.picked.app`,E=`./src/picked-env.d.ts`,D=[`picked.config.ts`,`picked.config.js`,`picked.config.json`];function O(e){return typeof e==`object`&&!!e}function k(e){return O(e)&&typeof e.projectId==`string`&&e.projectId.length>0}function re(e){return e===`preview`?`preview`:`published`}var ie=new Set([`bundle`,`api`,`snapshot`]);function A(e){return typeof e==`string`&&ie.has(e)}function ae(e){let t=process.env.PICKED_DATA;if(t!==void 0&&t!==``){if(!A(t))throw Error(`PICKED_DATA is "${t}"; it takes 'bundle', 'api' or 'snapshot'.`);return t}if(e===void 0)return`bundle`;if(!A(e))throw Error(`picked.config \`data\` is ${JSON.stringify(e)}; it takes 'bundle', 'api' or 'snapshot'.`);return e}function j(e,t,r){let i=process.env.PICKED_PREVIEW_TOKEN??null,a=process.env.PICKED_PROJECT_ID,o={apiUrl:_(e.apiUrl??T),typesOutput:(0,n.resolve)(t,e.typesOutput??E),projectRoot:t,telemetry:e.telemetry??!1,data:ae(e.data)};if(r){let t=a??r.projectId;if(r.workspace?.source===`preview`){let n=i??r.workspace.previewToken??e.previewToken??null;return{...o,projectId:t,source:`preview`,previewToken:n}}return{...o,projectId:t,source:`published`,previewToken:null}}let s=re(e.source),c=s===`preview`?i??e.previewToken??null:null;return{...o,projectId:a??e.projectId,source:s,previewToken:c}}async function M(i=process.cwd()){for(let a of D){let o=(0,n.join)(i,a);if(!(0,e.existsSync)(o))continue;if(a.endsWith(`.json`)){let e=await(0,t.readFile)(o,`utf8`),n=JSON.parse(e);if(k(n))return n;throw Error(`Invalid picked.config.json at ${o}`)}let s=await(0,r.createJiti)({}.url,{interopDefault:!0}).import(o),c=O(s)&&`default`in s?s.default:s;if(k(c))return c;throw Error(`Invalid ${a} at ${o}`)}return null}function N(e,t){let n=e?.projectId??t?.projectId;return n===void 0||n.length===0?null:{...t,...e,projectId:n,apiUrl:e?.apiUrl??t?.apiUrl,data:e?.data??t?.data}}async function P(e=process.cwd(),t){let n=N(await M(e),t);return n?j(n,e,await C(e,n.apiUrl??T)):null}var F={VERCEL:`vercel`,NETLIFY:`netlify`,CF_PAGES:`cloudflare-pages`,GITHUB_ACTIONS:`github-actions`,GITLAB_CI:`gitlab-ci`,CIRCLECI:`circleci`,BITBUCKET_BUILD_NUMBER:`bitbucket-pipelines`};function I(){let e=!!process.env.CI;for(let[e,t]of Object.entries(F))if(process.env[e])return{provider:t,ci:!0};return{provider:e?`unknown`:`local`,ci:e}}var L=new Set([`1`,`true`]),R=new Set([`0`,`false`]);function z(e){let t=e?.trim().toLowerCase();if(t!==void 0){if(L.has(t))return!0;if(R.has(t))return!1}}function B(){return z(process.env.PICKED_TELEMETRY)===!1||z(process.env.DO_NOT_TRACK)===!0}function V(e,t){return B()?!1:t===void 0?z(process.env.PICKED_TELEMETRY)===!0||e.telemetry:t}var H=`picked.snapshot.json`,U=1,W="Run `picked pull` to write a fresh one.";function G(e){return(0,n.join)(e,H)}function K(e){let t=new Set;for(let n of e.steps)n.layoutContentId&&t.add(n.id);return t.size===0?[]:e.experiences.filter(e=>e.nodes.some(e=>e.type===`step`&&t.has(e.stepId))).map(e=>e.id)}function q(e,t){return e===t?0:e<t?-1:1}function J(e){let t={};for(let n of Object.keys(e.experiences).sort(q)){let r=e.experiences[n];r!==void 0&&(t[n]=r)}let n={snapshotVersion:e.snapshotVersion,projectId:e.projectId,workspaceId:e.workspaceId,projectVersionId:e.projectVersionId,source:e.source,schema:e.schema,projectConfig:e.projectConfig,experiences:t};return`${JSON.stringify(n,null,2)}\n`}function Y(e){return typeof e==`object`&&!!e}function oe(e){return Y(e)&&typeof e.id==`string`&&Array.isArray(e.features)&&Array.isArray(e.experiences)&&Array.isArray(e.steps)}function se(e){return Y(e)&&Object.values(e).every(e=>Y(e)&&typeof e.experienceId==`string`&&Array.isArray(e.content))}function ce(e){return Y(e)&&typeof e.snapshotVersion==`number`&&typeof e.projectId==`string`&&typeof e.workspaceId==`string`&&(typeof e.projectVersionId==`string`||e.projectVersionId===null)&&(e.source===`published`||e.source===`preview`)&&(0,a.isWorkspaceSchema)(e.schema)&&oe(e.projectConfig)&&se(e.experiences)}async function X(n){let r=G(n);if(!(0,e.existsSync)(r))return null;let i;try{i=JSON.parse(await(0,t.readFile)(r,`utf8`))}catch{throw Error(`${r} is not valid JSON. ${W}`)}if(Y(i)&&typeof i.snapshotVersion==`number`&&i.snapshotVersion!==1)throw Error(`${r} is in snapshot format ${i.snapshotVersion.toString()}, and this SDK reads format 1. ${W}`);if(!ce(i))throw Error(`${r} is not a Picked snapshot. ${W}`);return i}async function Z(e){let t=await X(e.projectRoot);if(!t)throw Error(`picked.config sets \`data: 'snapshot'\`, and there is no ${H} in ${e.projectRoot}. Run \`picked pull\` to write one.`);if(t.projectId!==e.projectId)throw Error(`${H} holds project "${t.projectId}", and the project in force is "${e.projectId}". ${W}`);return t}async function le(e,n){await(0,t.writeFile)(G(e),J(n),`utf8`)}async function Q(e,t){let n=[],r=await t(e=>{n.push(e)});if(r===null){let t=n.at(-1)??`no response`;throw Error(`Could not fetch ${e}: ${t}`)}return r}function $(e,t,n){if(e!==null&&t!==null&&t!==e)throw Error(`The workspace was published while pulling: the project config is at version ${e} and ${n} at ${t}. Run \`picked pull\` again.`)}async function ue(e){let{apiUrl:t,projectId:n,source:r,previewToken:i,headers:o}=e,s={previewToken:i,headers:o},c=await Q(`the workspace schema for "${n}" from ${t}`,e=>(0,a.fetchSchema)(t,n,{...s,onWarn:e})),l=await Q(`the project config for "${n}" from ${t}`,e=>(0,a.fetchProject)(t,n,{...s,onWarn:e})),u=l.versionId;$(u,c[`x-picked-version-id`],`the workspace schema`);let d=await Promise.all(K(l).map(async e=>[e,await Q(`content for experience "${e}"`,r=>(0,a.fetchExperienceContent)(t,n,e,{...s,onWarn:r}))])),f={};for(let[e,t]of d)$(u,t.versionId,`content for experience "${e}"`),f[e]=t;return{snapshotVersion:1,projectId:n,workspaceId:l.workspaceId,projectVersionId:u,source:r,schema:c,projectConfig:l,experiences:f}}exports.SNAPSHOT_FILENAME=H,exports.SNAPSHOT_VERSION=U,exports.appendPickedGitignore=g,exports.assertSecureApiUrl=_,exports.collectCmsExperienceIds=K,exports.defineConfig=o,exports.detectHostEnvironment=I,exports.fetchSnapshot=ue,exports.hashSchemaJson=f,exports.isTelemetryEnabled=V,exports.isTelemetryForcedOffByEnvironment=B,exports.loadPickedConfig=M,exports.loadResolvedPickedConfig=P,exports.normalizeApiUrl=v,exports.readActiveSelection=C,exports.readCodegenManifest=m,exports.readSnapshot=X,exports.requireSnapshot=Z,exports.resolvePickedConfig=j,exports.resolvePickedPaths=d,exports.resolveSettingsPath=x,exports.resolveSnapshotPath=G,exports.serializeSnapshot=J,exports.writeActiveSelection=w,exports.writeCodegenArtifacts=h,exports.writeSnapshot=le;
+`;function d(e){let t=(0,r.join)(e,`.picked`);return{pickedDir:t,manifestPath:(0,r.join)(t,s),schemaPath:(0,r.join)(t,c),codegenManifestPath:(0,r.join)(t,l)}}function f(e){return(0,a.createHash)(`sha256`).update(e).digest(`hex`)}function p(e){return typeof e!=`object`||!e?!1:`schemaHash`in e&&typeof e.schemaHash==`string`}async function m(e){if(!(0,t.existsSync)(e))return null;let r=await(0,n.readFile)(e,`utf8`),i=JSON.parse(r);return p(i)?i:null}async function ee(e){let t=d(e.projectRoot);await(0,n.mkdir)(t.pickedDir,{recursive:!0}),await(0,n.writeFile)(t.schemaPath,e.schemaJson,`utf8`),await(0,n.writeFile)(t.codegenManifestPath,`${JSON.stringify(e.manifest,null,2)}\n`,`utf8`)}async function h(e){let i=(0,r.join)(e,`.gitignore`);(0,t.existsSync)(i)?(await(0,n.readFile)(i,`utf8`)).includes(`.picked/`)||await(0,n.appendFile)(i,u,`utf8`):await(0,n.writeFile)(i,`.picked/
+`,`utf8`)}function g(e){let t;try{t=new URL(e)}catch{throw Error(`Invalid Picked API URL: ${e}`)}let n=t.hostname===`localhost`||t.hostname===`127.0.0.1`||t.hostname===`[::1]`;if(t.protocol!==`https:`&&!n)throw Error(`Refusing to use a non-HTTPS Picked API URL (${e}); tokens must not be sent over cleartext.`);return e}function _(e){return new URL(g(e)).origin}var te=`settings.json`,v=384;function y(e){return(0,r.join)(e,`.picked`,te)}function ne(e){return!(typeof e!=`object`||!e||!(`id`in e)||typeof e.id!=`string`||!(`name`in e)||typeof e.name!=`string`||!(`status`in e)||typeof e.status!=`string`||!(`source`in e)||e.source!==`published`&&e.source!==`preview`)}function re(e){return typeof e!=`object`||!e||!(`projectId`in e)||typeof e.projectId!=`string`?!1:!(`workspace`in e)||e.workspace===void 0||ne(e.workspace)}function b(e){return typeof e!=`object`||!e?!1:Object.values(e).every(re)}async function x(e){let r=y(e);if(!(0,t.existsSync)(r))return{};try{let e=JSON.parse(await(0,n.readFile)(r,`utf8`));return b(e)?e:{}}catch{return{}}}async function S(e,t){return(await x(e))[_(t)]??null}async function C(e,t,i){let a=y(e),o={...await x(e),[_(t)]:i};await(0,n.mkdir)((0,r.dirname)(a),{recursive:!0}),await h(e),await(0,n.writeFile)(a,`${JSON.stringify(o,null,2)}\n`,{encoding:`utf8`,mode:v}),await(0,n.chmod)(a,v)}var w=`https://api.picked.app`,T=`./src/picked-env.d.ts`,ie=[`picked.config.ts`,`picked.config.js`,`picked.config.json`];function E(e){return typeof e==`object`&&!!e}function D(e){return typeof e.projectId==`string`&&e.projectId!==``&&(e.app===void 0||k(e.app))}function O(e){return k(e.app)&&(e.projectId===void 0||typeof e.projectId==`string`&&e.projectId!==``)}function k(e){return E(e)&&!Array.isArray(e)&&typeof e.handle==`string`&&e.handle!==``&&typeof e.name==`string`&&e.name!==``}function ae(e,t){if(!E(e)||Array.isArray(e))throw Error(`${t}: \`app\` must be the app manifest, an object.`);if(typeof e.handle!=`string`||e.handle===``)throw Error(`${t}: \`app.handle\` must be a non-empty string.`);if(typeof e.name!=`string`||e.name===``)throw Error(`${t}: \`app.name\` must be a non-empty string.`)}function A(e,t){if(!E(e)||Array.isArray(e))throw Error(`${t}: export a config object.`);if(e.projectId===void 0&&e.app===void 0)throw Error(`${t}: it sets neither \`projectId\` (a project) nor \`app\` (an app). Set one or both.`);if(e.projectId!==void 0&&(typeof e.projectId!=`string`||e.projectId===``))throw Error(`${t}: \`projectId\` must be a non-empty string.`);if(e.app!==void 0&&ae(e.app,t),e.apiUrl!==void 0&&(typeof e.apiUrl!=`string`||e.apiUrl===``))throw Error(`${t}: \`apiUrl\` must be the Picked API origin.`);if(D(e)||O(e))return e;throw Error(`${t}: export a config object.`)}function oe(e){return e===`preview`?`preview`:`published`}var se=new Set([`bundle`,`api`,`snapshot`]);function j(e){return typeof e==`string`&&se.has(e)}function M(e){let t=process.env.PICKED_DATA;if(t!==void 0&&t!==``){if(!j(t))throw Error(`PICKED_DATA is "${t}"; it takes 'bundle', 'api' or 'snapshot'.`);return t}if(e===void 0)return`bundle`;if(!j(e))throw Error(`picked.config \`data\` is ${JSON.stringify(e)}; it takes 'bundle', 'api' or 'snapshot'.`);return e}function N(e,t,n){let i=process.env.PICKED_PREVIEW_TOKEN??null,a=process.env.PICKED_PROJECT_ID,o={apiUrl:g(e.apiUrl??w),typesOutput:(0,r.resolve)(t,e.typesOutput??T),projectRoot:t,telemetry:e.telemetry??!1,data:M(e.data)};if(n){let t=a??n.projectId;if(n.workspace?.source===`preview`){let r=i??n.workspace.previewToken??e.previewToken??null;return{...o,projectId:t,source:`preview`,previewToken:r}}return{...o,projectId:t,source:`published`,previewToken:null}}let s=oe(e.source),c=s===`preview`?i??e.previewToken??null:null;return{...o,projectId:a??e.projectId,source:s,previewToken:c}}async function P(e=process.cwd()){for(let a of ie){let o=(0,r.join)(e,a);if(!(0,t.existsSync)(o))continue;if(a.endsWith(`.json`)){let e=await(0,n.readFile)(o,`utf8`);return A(JSON.parse(e),`Invalid picked.config.json at ${o}`)}let s=await(0,i.createJiti)({}.url,{interopDefault:!0}).import(o);return A(E(s)&&`default`in s?s.default:s,`Invalid ${a} at ${o}`)}return null}function F(e,t){let n=e?.projectId??t?.projectId;return n===void 0||n.length===0?null:{...t,...e,projectId:n,apiUrl:e?.apiUrl??t?.apiUrl,data:e?.data??t?.data}}async function I(t=process.cwd(),n){let r=await P(t),i=F(r,n);if(!i){if(r&&!e.r(r))throw Error(`picked.config in ${t} names no project. Add \`projectId\` beside its \`app\` section.`);return null}return N(i,t,await S(t,i.apiUrl??w))}var L={VERCEL:`vercel`,NETLIFY:`netlify`,CF_PAGES:`cloudflare-pages`,GITHUB_ACTIONS:`github-actions`,GITLAB_CI:`gitlab-ci`,CIRCLECI:`circleci`,BITBUCKET_BUILD_NUMBER:`bitbucket-pipelines`};function R(){let e=!!process.env.CI;for(let[e,t]of Object.entries(L))if(process.env[e])return{provider:t,ci:!0};return{provider:e?`unknown`:`local`,ci:e}}var z=new Set([`1`,`true`]),B=new Set([`0`,`false`]);function V(e){let t=e?.trim().toLowerCase();if(t!==void 0){if(z.has(t))return!0;if(B.has(t))return!1}}function H(){return V(process.env.PICKED_TELEMETRY)===!1||V(process.env.DO_NOT_TRACK)===!0}function U(e,t){return H()?!1:t===void 0?V(process.env.PICKED_TELEMETRY)===!0||e.telemetry:t}var W=`picked.snapshot.json`,G=1,K="Run `picked pull` to write a fresh one.";function q(e){return(0,r.join)(e,W)}function J(e){let t=new Set;for(let n of e.steps)n.layoutContentId&&t.add(n.id);return t.size===0?[]:e.experiences.filter(e=>e.nodes.some(e=>e.type===`step`&&t.has(e.stepId))).map(e=>e.id)}function ce(e,t){return e===t?0:e<t?-1:1}function Y(e){let t={};for(let n of Object.keys(e.experiences).sort(ce)){let r=e.experiences[n];r!==void 0&&(t[n]=r)}let n={snapshotVersion:e.snapshotVersion,projectId:e.projectId,workspaceId:e.workspaceId,projectVersionId:e.projectVersionId,source:e.source,schema:e.schema,projectConfig:e.projectConfig,experiences:t};return`${JSON.stringify(n,null,2)}\n`}function X(e){return typeof e==`object`&&!!e}function le(e){return X(e)&&typeof e.id==`string`&&Array.isArray(e.features)&&Array.isArray(e.experiences)&&Array.isArray(e.steps)}function ue(e){return X(e)&&Object.values(e).every(e=>X(e)&&typeof e.experienceId==`string`&&Array.isArray(e.content))}function de(e){return X(e)&&typeof e.snapshotVersion==`number`&&typeof e.projectId==`string`&&typeof e.workspaceId==`string`&&(typeof e.projectVersionId==`string`||e.projectVersionId===null)&&(e.source===`published`||e.source===`preview`)&&(0,o.isWorkspaceSchema)(e.schema)&&le(e.projectConfig)&&ue(e.experiences)}async function Z(e){let r=q(e);if(!(0,t.existsSync)(r))return null;let i;try{i=JSON.parse(await(0,n.readFile)(r,`utf8`))}catch{throw Error(`${r} is not valid JSON. ${K}`)}if(X(i)&&typeof i.snapshotVersion==`number`&&i.snapshotVersion!==1)throw Error(`${r} is in snapshot format ${i.snapshotVersion.toString()}, and this SDK reads format 1. ${K}`);if(!de(i))throw Error(`${r} is not a Picked snapshot. ${K}`);return i}async function fe(e){let t=await Z(e.projectRoot);if(!t)throw Error(`picked.config sets \`data: 'snapshot'\`, and there is no ${W} in ${e.projectRoot}. Run \`picked pull\` to write one.`);if(t.projectId!==e.projectId)throw Error(`${W} holds project "${t.projectId}", and the project in force is "${e.projectId}". ${K}`);return t}async function pe(e,t){await(0,n.writeFile)(q(e),Y(t),`utf8`)}async function Q(e,t){let n=[],r=await t(e=>{n.push(e)});if(r===null){let t=n.at(-1)??`no response`;throw Error(`Could not fetch ${e}: ${t}`)}return r}function $(e,t,n){if(e!==null&&t!==null&&t!==e)throw Error(`The workspace was published while pulling: the project config is at version ${e} and ${n} at ${t}. Run \`picked pull\` again.`)}async function me(e){let{apiUrl:t,projectId:n,source:r,previewToken:i,headers:a}=e,s={previewToken:i,headers:a},c=await Q(`the workspace schema for "${n}" from ${t}`,e=>(0,o.fetchSchema)(t,n,{...s,onWarn:e})),l=await Q(`the project config for "${n}" from ${t}`,e=>(0,o.fetchProject)(t,n,{...s,onWarn:e})),u=l.versionId;$(u,c[`x-picked-version-id`],`the workspace schema`);let d=await Promise.all(J(l).map(async e=>[e,await Q(`content for experience "${e}"`,r=>(0,o.fetchExperienceContent)(t,n,e,{...s,onWarn:r}))])),f={};for(let[e,t]of d)$(u,t.versionId,`content for experience "${e}"`),f[e]=t;return{snapshotVersion:1,projectId:n,workspaceId:l.workspaceId,projectVersionId:u,source:r,schema:c,projectConfig:l,experiences:f}}exports.SNAPSHOT_FILENAME=W,exports.SNAPSHOT_VERSION=G,exports.appendPickedGitignore=h,exports.assertSecureApiUrl=g,exports.collectCmsExperienceIds=J,exports.defineConfig=e.t,exports.detectHostEnvironment=R,exports.fetchSnapshot=me,exports.hasApp=e.n,exports.hasProject=e.r,exports.hashSchemaJson=f,exports.isTelemetryEnabled=U,exports.isTelemetryForcedOffByEnvironment=H,exports.loadPickedConfig=P,exports.loadResolvedPickedConfig=I,exports.normalizeApiUrl=_,exports.readActiveSelection=S,exports.readCodegenManifest=m,exports.readSnapshot=Z,exports.requireSnapshot=fe,exports.resolvePickedConfig=N,exports.resolvePickedPaths=d,exports.resolveSettingsPath=y,exports.resolveSnapshotPath=q,exports.serializeSnapshot=Y,exports.writeActiveSelection=C,exports.writeCodegenArtifacts=ee,exports.writeSnapshot=pe;

package/dist/config-BHuvJukH.js

@@ -0,0 +1,12 @@
+//#region src/config.ts
+function e(e) {
+	return e.projectId !== void 0;
+}
+function t(e) {
+	return e.app !== void 0;
+}
+function n(e) {
+	return e;
+}
+//#endregion
+export { t as n, e as r, n as t };

package/dist/config-BqUv-9JF.cjs

@@ -0,0 +1 @@
+function e(e){return e.projectId!==void 0}function t(e){return e.app!==void 0}function n(e){return e}Object.defineProperty(exports,"n",{enumerable:!0,get:function(){return t}}),Object.defineProperty(exports,"r",{enumerable:!0,get:function(){return e}}),Object.defineProperty(exports,"t",{enumerable:!0,get:function(){return n}});

package/dist/esm/define.js

@@ -0,0 +1 @@
+export { t as defineConfig, n as hasApp, r as hasProject } from "../config-BHuvJukH.js";

package/dist/esm/index.js

@@ -1,43 +1,39 @@
-import { existsSync as e } from "node:fs";
-import { appendFile as t, chmod as n, mkdir as r, readFile as i, writeFile as a } from "node:fs/promises";
-import { dirname as o, join as s, resolve as c } from "node:path";
-import { createJiti as l } from "jiti";
-import { createHash as u } from "node:crypto";
-import { fetchExperienceContent as ee, fetchProject as te, fetchSchema as d, isWorkspaceSchema as f } from "@picked/delivery-api-client";
-//#region src/config.ts
-function ne(e) {
-	return e;
-}
-//#endregion
+import { n as e, r as t, t as n } from "../config-BHuvJukH.js";
+import { existsSync as r } from "node:fs";
+import { appendFile as i, chmod as a, mkdir as o, readFile as s, writeFile as c } from "node:fs/promises";
+import { dirname as l, join as u, resolve as d } from "node:path";
+import { createJiti as ee } from "jiti";
+import { createHash as te } from "node:crypto";
+import { fetchExperienceContent as ne, fetchProject as re, fetchSchema as ie, isWorkspaceSchema as ae } from "@picked/delivery-api-client";
 //#region src/manifest.ts
-var re = "manifest.json", ie = "schema.json", ae = "schema-manifest.json", oe = "\n# Picked codegen intermediates\n.picked/\n";
-function p(e) {
-	let t = s(e, ".picked");
+var f = "manifest.json", p = "schema.json", m = "schema-manifest.json", h = "\n# Picked codegen intermediates\n.picked/\n";
+function g(e) {
+	let t = u(e, ".picked");
 	return {
 		pickedDir: t,
-		manifestPath: s(t, re),
-		schemaPath: s(t, ie),
-		codegenManifestPath: s(t, ae)
+		manifestPath: u(t, f),
+		schemaPath: u(t, p),
+		codegenManifestPath: u(t, m)
 	};
 }
-function m(e) {
-	return u("sha256").update(e).digest("hex");
+function _(e) {
+	return te("sha256").update(e).digest("hex");
 }
-function h(e) {
+function oe(e) {
 	return typeof e != "object" || !e ? !1 : "schemaHash" in e && typeof e.schemaHash == "string";
 }
-async function g(t) {
-	if (!e(t)) return null;
-	let n = await i(t, "utf8"), r = JSON.parse(n);
-	return h(r) ? r : null;
+async function se(e) {
+	if (!r(e)) return null;
+	let t = await s(e, "utf8"), n = JSON.parse(t);
+	return oe(n) ? n : null;
 }
-async function _(e) {
-	let t = p(e.projectRoot);
-	await r(t.pickedDir, { recursive: !0 }), await a(t.schemaPath, e.schemaJson, "utf8"), await a(t.codegenManifestPath, `${JSON.stringify(e.manifest, null, 2)}\n`, "utf8");
+async function ce(e) {
+	let t = g(e.projectRoot);
+	await o(t.pickedDir, { recursive: !0 }), await c(t.schemaPath, e.schemaJson, "utf8"), await c(t.codegenManifestPath, `${JSON.stringify(e.manifest, null, 2)}\n`, "utf8");
 }
-async function v(n) {
-	let r = s(n, ".gitignore");
-	e(r) ? (await i(r, "utf8")).includes(".picked/") || await t(r, oe, "utf8") : await a(r, ".picked/\n", "utf8");
+async function v(e) {
+	let t = u(e, ".gitignore");
+	r(t) ? (await s(t, "utf8")).includes(".picked/") || await i(t, h, "utf8") : await c(t, ".picked/\n", "utf8");
 }
 //#endregion
 //#region src/url-safety.ts
@@ -57,83 +53,102 @@ function b(e) {
 }
 //#endregion
 //#region src/settings.ts
-var se = "settings.json", x = 384;
-function S(e) {
-	return s(e, ".picked", se);
-}
-function ce(e) {
-	return !(typeof e != "object" || !e || !("id" in e) || typeof e.id != "string" || !("name" in e) || typeof e.name != "string" || !("status" in e) || typeof e.status != "string" || !("source" in e) || e.source !== "published" && e.source !== "preview");
+var x = "settings.json", S = 384;
+function C(e) {
+	return u(e, ".picked", x);
 }
 function le(e) {
-	return typeof e != "object" || !e || !("projectId" in e) || typeof e.projectId != "string" ? !1 : !("workspace" in e) || e.workspace === void 0 || ce(e.workspace);
+	return !(typeof e != "object" || !e || !("id" in e) || typeof e.id != "string" || !("name" in e) || typeof e.name != "string" || !("status" in e) || typeof e.status != "string" || !("source" in e) || e.source !== "published" && e.source !== "preview");
 }
 function ue(e) {
-	return typeof e != "object" || !e ? !1 : Object.values(e).every(le);
+	return typeof e != "object" || !e || !("projectId" in e) || typeof e.projectId != "string" ? !1 : !("workspace" in e) || e.workspace === void 0 || le(e.workspace);
 }
-async function C(t) {
-	let n = S(t);
-	if (!e(n)) return {};
+function de(e) {
+	return typeof e != "object" || !e ? !1 : Object.values(e).every(ue);
+}
+async function w(e) {
+	let t = C(e);
+	if (!r(t)) return {};
 	try {
-		let e = JSON.parse(await i(n, "utf8"));
-		return ue(e) ? e : {};
+		let e = JSON.parse(await s(t, "utf8"));
+		return de(e) ? e : {};
 	} catch {
 		return {};
 	}
 }
-async function w(e, t) {
-	return (await C(e))[b(t)] ?? null;
+async function T(e, t) {
+	return (await w(e))[b(t)] ?? null;
 }
-async function de(e, t, i) {
-	let s = S(e), c = {
-		...await C(e),
-		[b(t)]: i
+async function fe(e, t, n) {
+	let r = C(e), i = {
+		...await w(e),
+		[b(t)]: n
 	};
-	await r(o(s), { recursive: !0 }), await v(e), await a(s, `${JSON.stringify(c, null, 2)}\n`, {
+	await o(l(r), { recursive: !0 }), await v(e), await c(r, `${JSON.stringify(i, null, 2)}\n`, {
 		encoding: "utf8",
-		mode: x
-	}), await n(s, x);
+		mode: S
+	}), await a(r, S);
 }
 //#endregion
 //#region src/load-config.ts
-var T = "https://api.picked.app", E = "./src/picked-env.d.ts", D = [
+var E = "https://api.picked.app", D = "./src/picked-env.d.ts", O = [
 	"picked.config.ts",
 	"picked.config.js",
 	"picked.config.json"
 ];
-function O(e) {
-	return typeof e == "object" && !!e;
-}
 function k(e) {
-	return O(e) && typeof e.projectId == "string" && e.projectId.length > 0;
+	return typeof e == "object" && !!e;
 }
 function A(e) {
+	return typeof e.projectId == "string" && e.projectId !== "" && (e.app === void 0 || M(e.app));
+}
+function j(e) {
+	return M(e.app) && (e.projectId === void 0 || typeof e.projectId == "string" && e.projectId !== "");
+}
+function M(e) {
+	return k(e) && !Array.isArray(e) && typeof e.handle == "string" && e.handle !== "" && typeof e.name == "string" && e.name !== "";
+}
+function N(e, t) {
+	if (!k(e) || Array.isArray(e)) throw Error(`${t}: \`app\` must be the app manifest, an object.`);
+	if (typeof e.handle != "string" || e.handle === "") throw Error(`${t}: \`app.handle\` must be a non-empty string.`);
+	if (typeof e.name != "string" || e.name === "") throw Error(`${t}: \`app.name\` must be a non-empty string.`);
+}
+function P(e, t) {
+	if (!k(e) || Array.isArray(e)) throw Error(`${t}: export a config object.`);
+	if (e.projectId === void 0 && e.app === void 0) throw Error(`${t}: it sets neither \`projectId\` (a project) nor \`app\` (an app). Set one or both.`);
+	if (e.projectId !== void 0 && (typeof e.projectId != "string" || e.projectId === "")) throw Error(`${t}: \`projectId\` must be a non-empty string.`);
+	if (e.app !== void 0 && N(e.app, t), e.apiUrl !== void 0 && (typeof e.apiUrl != "string" || e.apiUrl === "")) throw Error(`${t}: \`apiUrl\` must be the Picked API origin.`);
+	if (A(e) || j(e)) return e;
+	throw Error(`${t}: export a config object.`);
+}
+function F(e) {
 	return e === "preview" ? "preview" : "published";
 }
-var j = /* @__PURE__ */ new Set([
+var I = /* @__PURE__ */ new Set([
 	"bundle",
 	"api",
 	"snapshot"
 ]);
-function M(e) {
-	return typeof e == "string" && j.has(e);
+function L(e) {
+	return typeof e == "string" && I.has(e);
 }
-function N(e) {
+function R(e) {
 	let t = process.env.PICKED_DATA;
 	if (t !== void 0 && t !== "") {
-		if (!M(t)) throw Error(`PICKED_DATA is "${t}"; it takes 'bundle', 'api' or 'snapshot'.`);
+		if (!L(t)) throw Error(`PICKED_DATA is "${t}"; it takes 'bundle', 'api' or 'snapshot'.`);
 		return t;
 	}
 	if (e === void 0) return "bundle";
-	if (!M(e)) throw Error(`picked.config \`data\` is ${JSON.stringify(e)}; it takes 'bundle', 'api' or 'snapshot'.`);
+	if (!L(e)) throw Error(`picked.config \`data\` is ${JSON.stringify(e)}; it takes 'bundle', 'api' or 'snapshot'.`);
 	return e;
 }
-function P(e, t, n) {
+function z(e, t, n) {
 	let r = process.env.PICKED_PREVIEW_TOKEN ?? null, i = process.env.PICKED_PROJECT_ID, a = {
-		apiUrl: y(e.apiUrl ?? T),
-		typesOutput: c(t, e.typesOutput ?? E),
+		apiUrl: y(e.apiUrl ?? E),
+		typesOutput: d(t, e.typesOutput ?? D),
 		projectRoot: t,
 		telemetry: e.telemetry ?? !1,
-		data: N(e.data)
+		data: R(e.data)
 	};
 	if (n) {
 		let t = i ?? n.projectId;
@@ -153,7 +168,7 @@ function P(e, t, n) {
 			previewToken: null
 		};
 	}
-	let o = A(e.source), s = o === "preview" ? r ?? e.previewToken ?? null : null;
+	let o = F(e.source), s = o === "preview" ? r ?? e.previewToken ?? null : null;
 	return {
 		...a,
 		projectId: i ?? e.projectId,
@@ -161,22 +176,20 @@ function P(e, t, n) {
 		previewToken: s
 	};
 }
-async function F(t = process.cwd()) {
-	for (let n of D) {
-		let r = s(t, n);
-		if (!e(r)) continue;
-		if (n.endsWith(".json")) {
-			let e = await i(r, "utf8"), t = JSON.parse(e);
-			if (k(t)) return t;
-			throw Error(`Invalid picked.config.json at ${r}`);
+async function B(e = process.cwd()) {
+	for (let t of O) {
+		let n = u(e, t);
+		if (!r(n)) continue;
+		if (t.endsWith(".json")) {
+			let e = await s(n, "utf8");
+			return P(JSON.parse(e), `Invalid picked.config.json at ${n}`);
 		}
-		let a = await l(import.meta.url, { interopDefault: !0 }).import(r), o = O(a) && "default" in a ? a.default : a;
-		if (k(o)) return o;
-		throw Error(`Invalid ${n} at ${r}`);
+		let i = await ee(import.meta.url, { interopDefault: !0 }).import(n);
+		return P(k(i) && "default" in i ? i.default : i, `Invalid ${t} at ${n}`);
 	}
 	return null;
 }
-function I(e, t) {
+function V(e, t) {
 	let n = e?.projectId ?? t?.projectId;
 	return n === void 0 || n.length === 0 ? null : {
 		...t,
@@ -186,13 +199,17 @@ function I(e, t) {
 		data: e?.data ?? t?.data
 	};
 }
-async function L(e = process.cwd(), t) {
-	let n = I(await F(e), t);
-	return n ? P(n, e, await w(e, n.apiUrl ?? T)) : null;
+async function H(e = process.cwd(), n) {
+	let r = await B(e), i = V(r, n);
+	if (!i) {
+		if (r && !t(r)) throw Error(`picked.config in ${e} names no project. Add \`projectId\` beside its \`app\` section.`);
+		return null;
+	}
+	return z(i, e, await T(e, i.apiUrl ?? E));
 }
 //#endregion
 //#region src/host-environment.ts
-var R = {
+var pe = {
 	VERCEL: "vercel",
 	NETLIFY: "netlify",
 	CF_PAGES: "cloudflare-pages",
@@ -201,9 +218,9 @@ var R = {
 	CIRCLECI: "circleci",
 	BITBUCKET_BUILD_NUMBER: "bitbucket-pipelines"
 };
-function z() {
+function me() {
 	let e = !!process.env.CI;
-	for (let [e, t] of Object.entries(R)) if (process.env[e]) return {
+	for (let [e, t] of Object.entries(pe)) if (process.env[e]) return {
 		provider: t,
 		ci: !0
 	};
@@ -214,37 +231,37 @@ function z() {
 }
 //#endregion
 //#region src/telemetry-config.ts
-var B = /* @__PURE__ */ new Set(["1", "true"]), V = /* @__PURE__ */ new Set(["0", "false"]);
-function H(e) {
+var he = /* @__PURE__ */ new Set(["1", "true"]), ge = /* @__PURE__ */ new Set(["0", "false"]);
+function U(e) {
 	let t = e?.trim().toLowerCase();
 	if (t !== void 0) {
-		if (B.has(t)) return !0;
-		if (V.has(t)) return !1;
+		if (he.has(t)) return !0;
+		if (ge.has(t)) return !1;
 	}
 }
-function U() {
-	return H(process.env.PICKED_TELEMETRY) === !1 || H(process.env.DO_NOT_TRACK) === !0;
+function W() {
+	return U(process.env.PICKED_TELEMETRY) === !1 || U(process.env.DO_NOT_TRACK) === !0;
 }
-function fe(e, t) {
-	return U() ? !1 : t === void 0 ? H(process.env.PICKED_TELEMETRY) === !0 || e.telemetry : t;
+function _e(e, t) {
+	return W() ? !1 : t === void 0 ? U(process.env.PICKED_TELEMETRY) === !0 || e.telemetry : t;
 }
 //#endregion
 //#region src/snapshot.ts
-var W = "picked.snapshot.json", pe = 1, G = "Run `picked pull` to write a fresh one.";
-function K(e) {
-	return s(e, W);
-}
+var G = "picked.snapshot.json", ve = 1, K = "Run `picked pull` to write a fresh one.";
 function q(e) {
+	return u(e, G);
+}
+function J(e) {
 	let t = /* @__PURE__ */ new Set();
 	for (let n of e.steps) n.layoutContentId && t.add(n.id);
 	return t.size === 0 ? [] : e.experiences.filter((e) => e.nodes.some((e) => e.type === "step" && t.has(e.stepId))).map((e) => e.id);
 }
-function me(e, t) {
+function ye(e, t) {
 	return e === t ? 0 : e < t ? -1 : 1;
 }
-function J(e) {
+function Y(e) {
 	let t = {};
-	for (let n of Object.keys(e.experiences).sort(me)) {
+	for (let n of Object.keys(e.experiences).sort(ye)) {
 		let r = e.experiences[n];
 		r !== void 0 && (t[n] = r);
 	}
@@ -260,39 +277,39 @@ function J(e) {
 	};
 	return `${JSON.stringify(n, null, 2)}\n`;
 }
-function Y(e) {
+function X(e) {
 	return typeof e == "object" && !!e;
 }
-function he(e) {
-	return Y(e) && typeof e.id == "string" && Array.isArray(e.features) && Array.isArray(e.experiences) && Array.isArray(e.steps);
+function be(e) {
+	return X(e) && typeof e.id == "string" && Array.isArray(e.features) && Array.isArray(e.experiences) && Array.isArray(e.steps);
 }
-function ge(e) {
-	return Y(e) && Object.values(e).every((e) => Y(e) && typeof e.experienceId == "string" && Array.isArray(e.content));
+function xe(e) {
+	return X(e) && Object.values(e).every((e) => X(e) && typeof e.experienceId == "string" && Array.isArray(e.content));
 }
-function _e(e) {
-	return Y(e) && typeof e.snapshotVersion == "number" && typeof e.projectId == "string" && typeof e.workspaceId == "string" && (typeof e.projectVersionId == "string" || e.projectVersionId === null) && (e.source === "published" || e.source === "preview") && f(e.schema) && he(e.projectConfig) && ge(e.experiences);
+function Se(e) {
+	return X(e) && typeof e.snapshotVersion == "number" && typeof e.projectId == "string" && typeof e.workspaceId == "string" && (typeof e.projectVersionId == "string" || e.projectVersionId === null) && (e.source === "published" || e.source === "preview") && ae(e.schema) && be(e.projectConfig) && xe(e.experiences);
 }
-async function X(t) {
-	let n = K(t);
-	if (!e(n)) return null;
-	let r;
+async function Z(e) {
+	let t = q(e);
+	if (!r(t)) return null;
+	let n;
 	try {
-		r = JSON.parse(await i(n, "utf8"));
+		n = JSON.parse(await s(t, "utf8"));
 	} catch {
-		throw Error(`${n} is not valid JSON. ${G}`);
+		throw Error(`${t} is not valid JSON. ${K}`);
 	}
-	if (Y(r) && typeof r.snapshotVersion == "number" && r.snapshotVersion !== 1) throw Error(`${n} is in snapshot format ${r.snapshotVersion.toString()}, and this SDK reads format 1. ${G}`);
-	if (!_e(r)) throw Error(`${n} is not a Picked snapshot. ${G}`);
-	return r;
-}
-async function ve(e) {
-	let t = await X(e.projectRoot);
-	if (!t) throw Error(`picked.config sets \`data: 'snapshot'\`, and there is no ${W} in ${e.projectRoot}. Run \`picked pull\` to write one.`);
-	if (t.projectId !== e.projectId) throw Error(`${W} holds project "${t.projectId}", and the project in force is "${e.projectId}". ${G}`);
+	if (X(n) && typeof n.snapshotVersion == "number" && n.snapshotVersion !== 1) throw Error(`${t} is in snapshot format ${n.snapshotVersion.toString()}, and this SDK reads format 1. ${K}`);
+	if (!Se(n)) throw Error(`${t} is not a Picked snapshot. ${K}`);
+	return n;
+}
+async function Ce(e) {
+	let t = await Z(e.projectRoot);
+	if (!t) throw Error(`picked.config sets \`data: 'snapshot'\`, and there is no ${G} in ${e.projectRoot}. Run \`picked pull\` to write one.`);
+	if (t.projectId !== e.projectId) throw Error(`${G} holds project "${t.projectId}", and the project in force is "${e.projectId}". ${K}`);
 	return t;
 }
-async function Z(e, t) {
-	await a(K(e), J(t), "utf8");
+async function we(e, t) {
+	await c(q(e), Y(t), "utf8");
 }
 async function Q(e, t) {
 	let n = [], r = await t((e) => {
@@ -307,23 +324,23 @@ async function Q(e, t) {
 function $(e, t, n) {
 	if (e !== null && t !== null && t !== e) throw Error(`The workspace was published while pulling: the project config is at version ${e} and ${n} at ${t}. Run \`picked pull\` again.`);
 }
-async function ye(e) {
+async function Te(e) {
 	let { apiUrl: t, projectId: n, source: r, previewToken: i, headers: a } = e, o = {
 		previewToken: i,
 		headers: a
-	}, s = await Q(`the workspace schema for "${n}" from ${t}`, (e) => d(t, n, {
+	}, s = await Q(`the workspace schema for "${n}" from ${t}`, (e) => ie(t, n, {
 		...o,
 		onWarn: e
-	})), c = await Q(`the project config for "${n}" from ${t}`, (e) => te(t, n, {
+	})), c = await Q(`the project config for "${n}" from ${t}`, (e) => re(t, n, {
 		...o,
 		onWarn: e
 	})), l = c.versionId;
 	$(l, s["x-picked-version-id"], "the workspace schema");
-	let u = await Promise.all(q(c).map(async (e) => [e, await Q(`content for experience "${e}"`, (r) => ee(t, n, e, {
+	let u = await Promise.all(J(c).map(async (e) => [e, await Q(`content for experience "${e}"`, (r) => ne(t, n, e, {
 		...o,
 		onWarn: r
-	}))])), f = {};
-	for (let [e, t] of u) $(l, t.versionId, `content for experience "${e}"`), f[e] = t;
+	}))])), d = {};
+	for (let [e, t] of u) $(l, t.versionId, `content for experience "${e}"`), d[e] = t;
 	return {
 		snapshotVersion: 1,
 		projectId: n,
@@ -332,8 +349,8 @@ async function ye(e) {
 		source: r,
 		schema: s,
 		projectConfig: c,
-		experiences: f
+		experiences: d
 	};
 }
 //#endregion
-export { W as SNAPSHOT_FILENAME, pe as SNAPSHOT_VERSION, v as appendPickedGitignore, y as assertSecureApiUrl, q as collectCmsExperienceIds, ne as defineConfig, z as detectHostEnvironment, ye as fetchSnapshot, m as hashSchemaJson, fe as isTelemetryEnabled, U as isTelemetryForcedOffByEnvironment, F as loadPickedConfig, L as loadResolvedPickedConfig, b as normalizeApiUrl, w as readActiveSelection, g as readCodegenManifest, X as readSnapshot, ve as requireSnapshot, P as resolvePickedConfig, p as resolvePickedPaths, S as resolveSettingsPath, K as resolveSnapshotPath, J as serializeSnapshot, de as writeActiveSelection, _ as writeCodegenArtifacts, Z as writeSnapshot };
+export { G as SNAPSHOT_FILENAME, ve as SNAPSHOT_VERSION, v as appendPickedGitignore, y as assertSecureApiUrl, J as collectCmsExperienceIds, n as defineConfig, me as detectHostEnvironment, Te as fetchSnapshot, e as hasApp, t as hasProject, _ as hashSchemaJson, _e as isTelemetryEnabled, W as isTelemetryForcedOffByEnvironment, B as loadPickedConfig, H as loadResolvedPickedConfig, b as normalizeApiUrl, T as readActiveSelection, se as readCodegenManifest, Z as readSnapshot, Ce as requireSnapshot, z as resolvePickedConfig, g as resolvePickedPaths, C as resolveSettingsPath, q as resolveSnapshotPath, Y as serializeSnapshot, fe as writeActiveSelection, ce as writeCodegenArtifacts, we as writeSnapshot };

package/dist/types/config.d.ts

@@ -1,4 +1,5 @@
 /** @file Configuration types for Picked tooling. */
+import type { AppManifest } from '@picked/app-kit';
 /** Schema source for codegen — published or live preview. */
 export type PickedConfigSource = 'published' | 'preview';
 /**
@@ -7,11 +8,9 @@ export type PickedConfigSource = 'published' | 'preview';
  * `'snapshot'` embeds the committed `picked.snapshot.json` and fetches nothing.
  */
 export type PickedDataMode = 'bundle' | 'api' | 'snapshot';
-/** User-facing picked.config shape. */
-export interface PickedConfig {
-    /** Picked project that schema and content are read from. */
-    projectId: string;
-    /** Origin of the Picked API to call. Defaults to production. */
+/** The `picked.config` fields a project config and an app config share. */
+interface PickedConfigFields {
+    /** Origin of the Picked API to call. Defaults to production; `PICKED_API_URL` overrides it. */
     apiUrl?: string;
     /** Path the generated type declarations are written to. */
     typesOutput?: string;
@@ -36,6 +35,52 @@ export interface PickedConfig {
      */
     data?: PickedDataMode;
 }
+/**
+ * A `picked.config` that names a project: the shape `picked generate types`, `picked pull` and
+ * the Vite plugin read. It may also hold an `app`.
+ */
+export type PickedProjectConfig = PickedConfigFields & {
+    /** Picked project that schema and content are read from. */
+    projectId: string;
+    /**
+     * The app manifest `picked app deploy` and `picked app dev` deploy, exactly as Picked receives
+     * it and the app serves it at `/manifest.json`. It holds no secrets.
+     */
+    app?: AppManifest;
+};
+/**
+ * A `picked.config` that holds an app: the shape `picked app deploy` and `picked app dev` read.
+ * It may also name a project.
+ */
+export type PickedAppConfig = PickedConfigFields & {
+    /** Picked project that schema and content are read from. */
+    projectId?: string;
+    /**
+     * The app manifest `picked app deploy` and `picked app dev` deploy, exactly as Picked receives
+     * it and the app serves it at `/manifest.json`. It holds no secrets.
+     */
+    app: AppManifest;
+};
+/** User-facing `picked.config` shape: it names a project, holds an app, or both. */
+export type PickedConfig = PickedProjectConfig | PickedAppConfig;
+/**
+ * Returns whether a config names a project.
+ *
+ * @param {PickedConfig} config - A loaded config.
+ * @returns {boolean} Whether `config` has a `projectId`.
+ * @example
+ * if (hasProject(config)) console.log(config.projectId)
+ */
+export declare function hasProject(config: PickedConfig): config is PickedProjectConfig;
+/**
+ * Returns whether a config holds an app.
+ *
+ * @param {PickedConfig} config - A loaded config.
+ * @returns {boolean} Whether `config` has an `app` manifest.
+ * @example
+ * if (hasApp(config)) console.log(config.app.handle)
+ */
+export declare function hasApp(config: PickedConfig): config is PickedAppConfig;
 /** Fully resolved configuration with defaults applied. */
 export interface ResolvedPickedConfig {
     /** Picked project that schema and content are read from. */
@@ -73,12 +118,14 @@ export interface PickedCodegenManifest {
     emitFormatVersion?: number;
 }
 /**
- * Helper for authoring `picked.config.ts` with full type inference.
+ * Helper for authoring `picked.config.ts` with full type inference. It returns the config it is
+ * given.
  *
- * @param {PickedConfig} config - Consumer configuration object.
+ * @param {PickedConfig} config - A project's configuration, an app's, or both in one.
  * @returns {PickedConfig} The same configuration object.
  * @example
- * export default defineConfig({ projectId: 'abc', typesOutput: './src/picked-env.d.ts' })
+ * export default defineConfig({ projectId: 'abc', app: { handle: 'acme', name: 'Acme' } })
  */
 export declare function defineConfig(config: PickedConfig): PickedConfig;
+export {};
 //# sourceMappingURL=config.d.ts.map

package/dist/types/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,oDAAoD;AAEpD,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,SAAS,CAAA;AAExD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,CAAA;AAE1D,uCAAuC;AACvC,MAAM,WAAW,YAAY;IAC3B,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAA;IACjB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sEAAsE;IACtE,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,cAAc,CAAA;CACtB;AAED,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAA;IACjB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAA;IACnB,sEAAsE;IACtE,MAAM,EAAE,kBAAkB,CAAA;IAC1B,8EAA8E;IAC9E,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,wFAAwF;IACxF,WAAW,EAAE,MAAM,CAAA;IACnB,6EAA6E;IAC7E,SAAS,EAAE,OAAO,CAAA;IAClB,qFAAqF;IACrF,IAAI,EAAE,cAAc,CAAA;CACrB;AAED,8DAA8D;AAC9D,MAAM,WAAW,qBAAqB;IACpC,oFAAoF;IACpF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAA;IACjB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAA;IACjB,oEAAoE;IACpE,MAAM,EAAE,kBAAkB,CAAA;IAC1B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAE/D"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD,6DAA6D;AAC7D,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,SAAS,CAAA;AAExD;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,KAAK,GAAG,UAAU,CAAA;AAE1D,2EAA2E;AAC3E,UAAU,kBAAkB;IAC1B,+FAA+F;IAC/F,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,2DAA2D;IAC3D,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,sEAAsE;IACtE,MAAM,CAAC,EAAE,kBAAkB,CAAA;IAC3B;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB;;;OAGG;IACH,IAAI,CAAC,EAAE,cAAc,CAAA;CACtB;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,kBAAkB,GAAG;IACrD,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,GAAG,CAAC,EAAE,WAAW,CAAA;CAClB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,eAAe,GAAG,kBAAkB,GAAG;IACjD,4DAA4D;IAC5D,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB;;;OAGG;IACH,GAAG,EAAE,WAAW,CAAA;CACjB,CAAA;AAED,oFAAoF;AACpF,MAAM,MAAM,YAAY,GAAG,mBAAmB,GAAG,eAAe,CAAA;AAEhE;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,IAAI,mBAAmB,CAE9E;AAED;;;;;;;GAOG;AACH,wBAAgB,MAAM,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,IAAI,eAAe,CAEtE;AAED,0DAA0D;AAC1D,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAA;IACjB,wCAAwC;IACxC,MAAM,EAAE,MAAM,CAAA;IACd,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAA;IACnB,sEAAsE;IACtE,MAAM,EAAE,kBAAkB,CAAA;IAC1B,8EAA8E;IAC9E,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,wFAAwF;IACxF,WAAW,EAAE,MAAM,CAAA;IACnB,6EAA6E;IAC7E,SAAS,EAAE,OAAO,CAAA;IAClB,qFAAqF;IACrF,IAAI,EAAE,cAAc,CAAA;CACrB;AAED,8DAA8D;AAC9D,MAAM,WAAW,qBAAqB;IACpC,oFAAoF;IACpF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAA;IAClB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAA;IACjB,0CAA0C;IAC1C,SAAS,EAAE,MAAM,CAAA;IACjB,oEAAoE;IACpE,MAAM,EAAE,kBAAkB,CAAA;IAC1B;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAE/D"}

package/dist/types/define.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @file `@picked/config/define`: `defineConfig`, `hasApp`, `hasProject` and the config types. Nothing
+ * it imports reads files or loads a Node built-in.
+ */
+export { defineConfig, hasApp, hasProject } from './config';
+export type { PickedAppConfig, PickedConfig, PickedConfigSource, PickedDataMode, PickedProjectConfig, } from './config';
+//# sourceMappingURL=define.d.ts.map