gipity 1.1.39 → 1.1.41

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.
@@ -0,0 +1,113 @@
1
+ /**
2
+ * Offline verification of a Gipity passkey approval: exactly the checks a
3
+ * device outside Gipity makes before it runs an approved action. Nothing here
4
+ * trusts the server: the payload hash and challenge are recomputed locally and
5
+ * the signature is checked against a key the caller pinned at enrollment.
6
+ *
7
+ * Rules (the app-approvals skill documents the same):
8
+ * payloadHash = hex sha256 of the canonical JSON of the payload (RFC 8785:
9
+ * keys sorted, no whitespace, JSON.stringify scalars)
10
+ * challenge = sha256("gipity-approval:v1|" + id + "|" + payloadHash + "|" + expiresAt)
11
+ * clientDataJSON.type == "webauthn.get", .challenge == base64url(challenge), .origin == expected origin
12
+ * authenticatorData: rpIdHash == sha256(rpId), flags UP (0x01) and UV (0x04) set
13
+ * signature over authenticatorData || sha256(clientDataJSON), verified with the pinned key
14
+ * expiresAt in the future
15
+ */
16
+ import { createHash, createPublicKey, verify } from 'node:crypto';
17
+ const CHALLENGE_PREFIX = 'gipity-approval:v1|';
18
+ /** RFC 8785 canonical JSON. Throws on values JSON can't represent exactly. */
19
+ export function canonicalJson(value) {
20
+ if (value === null)
21
+ return 'null';
22
+ switch (typeof value) {
23
+ case 'boolean':
24
+ case 'string':
25
+ return JSON.stringify(value);
26
+ case 'number':
27
+ if (!Number.isFinite(value))
28
+ throw new Error('payload contains a non-finite number');
29
+ return JSON.stringify(value);
30
+ case 'object': {
31
+ if (Array.isArray(value))
32
+ return `[${value.map(canonicalJson).join(',')}]`;
33
+ const obj = value;
34
+ return `{${Object.keys(obj).sort().map((k) => {
35
+ if (obj[k] === undefined)
36
+ throw new Error(`payload field '${k}' is undefined`);
37
+ return `${JSON.stringify(k)}:${canonicalJson(obj[k])}`;
38
+ }).join(',')}}`;
39
+ }
40
+ default:
41
+ throw new Error(`payload contains a value JSON can't represent (${typeof value})`);
42
+ }
43
+ }
44
+ const sha256 = (data) => createHash('sha256').update(data).digest();
45
+ export function payloadHash(payload) {
46
+ return sha256(canonicalJson(payload)).toString('hex');
47
+ }
48
+ export function approvalChallenge(id, hash, expiresAt) {
49
+ return sha256(`${CHALLENGE_PREFIX}${id}|${hash}|${expiresAt}`).toString('base64url');
50
+ }
51
+ function sameKey(a, b) {
52
+ if (a.kty !== b.kty)
53
+ return false;
54
+ if (a.kty === 'EC')
55
+ return a.crv === b.crv && a.x === b.x && a.y === b.y;
56
+ if (a.kty === 'OKP')
57
+ return a.crv === b.crv && a.x === b.x;
58
+ if (a.kty === 'RSA')
59
+ return a.n === b.n && a.e === b.e;
60
+ return false;
61
+ }
62
+ function verifySignature(jwk, data, signature) {
63
+ const key = createPublicKey({ key: { kty: jwk.kty, crv: jwk.crv, x: jwk.x, y: jwk.y, n: jwk.n, e: jwk.e }, format: 'jwk' });
64
+ // ES256 and RS256 hash with SHA-256 (ECDSA signatures are DER, as WebAuthn
65
+ // sends them); Ed25519 signs the message itself.
66
+ return verify(jwk.kty === 'OKP' ? null : 'sha256', data, key, signature);
67
+ }
68
+ export function verifyApproval(approval, opts) {
69
+ const checks = [];
70
+ const add = (check, ok, detail) => checks.push(detail ? { check, ok, detail } : { check, ok });
71
+ const proof = approval.proof;
72
+ if (!proof) {
73
+ add('proof present', false, `approval is ${approval.status}; there is no passkey proof`);
74
+ return { ok: false, pinned: !!opts.pinnedJwk, checks };
75
+ }
76
+ const expectedRpId = new URL(opts.expectedOrigin).hostname;
77
+ const hash = payloadHash(opts.payload);
78
+ add('payload hash matches', hash === approval.payloadHash, hash === approval.payloadHash ? undefined : `local ${hash}`);
79
+ const challenge = approvalChallenge(approval.id, hash, approval.expiresAt);
80
+ let clientData = {};
81
+ const clientDataBytes = Buffer.from(proof.clientDataJSON, 'base64url');
82
+ try {
83
+ clientData = JSON.parse(clientDataBytes.toString('utf8'));
84
+ }
85
+ catch {
86
+ add('clientDataJSON parses', false);
87
+ }
88
+ add('clientData type is webauthn.get', clientData.type === 'webauthn.get');
89
+ add('clientData challenge matches', clientData.challenge === challenge);
90
+ add('clientData origin matches', clientData.origin === opts.expectedOrigin, clientData.origin === opts.expectedOrigin ? undefined : `got ${String(clientData.origin)}`);
91
+ const authData = Buffer.from(proof.authenticatorData, 'base64url');
92
+ const rpIdOk = authData.length >= 37 && authData.subarray(0, 32).equals(sha256(expectedRpId));
93
+ add('rpIdHash matches', rpIdOk);
94
+ const flags = authData.length >= 37 ? authData[32] : 0;
95
+ add('user present (UP)', (flags & 0x01) !== 0);
96
+ add('user verified (UV)', (flags & 0x04) !== 0);
97
+ const key = opts.pinnedJwk ?? proof.publicKeyJwk;
98
+ if (opts.pinnedJwk)
99
+ add('proof key is the pinned key', sameKey(opts.pinnedJwk, proof.publicKeyJwk));
100
+ let sigOk = false;
101
+ try {
102
+ sigOk = verifySignature(key, Buffer.concat([authData, sha256(clientDataBytes)]), Buffer.from(proof.signature, 'base64url'));
103
+ }
104
+ catch {
105
+ sigOk = false;
106
+ }
107
+ add('signature verifies', sigOk);
108
+ const expiresMs = Date.parse(approval.expiresAt);
109
+ const notExpired = Number.isFinite(expiresMs) && expiresMs > (opts.now ?? Date.now());
110
+ add('not expired', notExpired, notExpired ? undefined : `expired at ${approval.expiresAt}`);
111
+ return { ok: checks.every((c) => c.ok), pinned: !!opts.pinnedJwk, checks };
112
+ }
113
+ //# sourceMappingURL=approval-verify.js.map
@@ -1,6 +1,8 @@
1
+ import { readFileSync } from 'node:fs';
1
2
  import { Command, Option } from 'commander';
2
- import { get, post } from '../api.js';
3
+ import { get, post, del, getBaseUrl } from '../api.js';
3
4
  import { muted, success } from '../colors.js';
5
+ import { verifyApproval } from '../approval-verify.js';
4
6
  import { run, printList, printResult } from '../helpers/index.js';
5
7
  function timeAgo(dateStr) {
6
8
  const diffMs = Date.now() - new Date(dateStr).getTime();
@@ -29,7 +31,7 @@ approvalCommand
29
31
  .option('--json', 'Output as JSON')
30
32
  .action((opts) => run('List', async () => {
31
33
  const res = await get(`/approvals?status=${encodeURIComponent(opts.status)}`);
32
- printList(res.data, opts, 'No approvals.', a => `${a.guid} ${a.title} ${muted(`[${a.status}] ${timeAgo(a.created_at)}`)}`);
34
+ printList(res.data, opts, 'No approvals.', a => `${a.guid} ${a.title} ${muted(`[${a.status}${a.kind === 'passkey' ? ', passkey' : ''}] ${timeAgo(a.created_at)}`)}`);
33
35
  }));
34
36
  approvalCommand
35
37
  .command('create <title...>')
@@ -124,4 +126,85 @@ approvalCommand
124
126
  await post(`/approvals/${guid}/cancel`, {});
125
127
  printResult(success(`Cancelled ${guid}.`), opts, { guid, cancelled: true });
126
128
  }));
129
+ function requireGuid(guid) {
130
+ if (!guid.startsWith('ap_'))
131
+ throw new Error('Expected approval guid like ap_xxxxxxxx');
132
+ }
133
+ approvalCommand
134
+ .command('show <guid>')
135
+ .description('Show one approval (for a passkey approval: status, payload hash, expiry and whether it carries a signed proof)')
136
+ .option('--json', 'Output as JSON')
137
+ .action((guid, opts) => run('Show', async () => {
138
+ requireGuid(guid);
139
+ const { data } = await get(`/approvals/${guid}`);
140
+ const lines = [`${data.guid} ${data.title}`];
141
+ if (data.description)
142
+ lines.push(muted(data.description));
143
+ if (data.passkey) {
144
+ const p = data.passkey;
145
+ lines.push(`Status: ${p.status} (passkey)`, `Approver: ${p.approver}`, `Payload hash: ${p.payloadHash}`, `Expires: ${p.expiresAt}`, `Resolved: ${p.resolvedAt ?? '-'}`, `Consumed: ${p.consumedAt ?? '-'}`, `Proof: ${p.proof ? `signed by passkey ${p.proof.credentialId}` : 'none'}`);
146
+ }
147
+ else {
148
+ lines.push(`Status: ${data.status}`);
149
+ }
150
+ printResult(lines.join('\n'), opts, data);
151
+ }));
152
+ approvalCommand
153
+ .command('passkeys')
154
+ .description('List the passkeys you approve with (add them in the browser at the printed link)')
155
+ .option('--remove <id>', 'Remove one of your passkeys by id')
156
+ .option('--json', 'Output as JSON')
157
+ .action((opts) => run('Passkeys', async () => {
158
+ if (opts.remove) {
159
+ await del(`/approvals/passkeys/credentials/${encodeURIComponent(opts.remove)}`);
160
+ printResult(success(`Removed ${opts.remove}.`), opts, { id: opts.remove, removed: true });
161
+ return;
162
+ }
163
+ const { data } = await get('/approvals/passkeys/credentials');
164
+ const manageUrl = `${getBaseUrl()}/approvals/passkeys`;
165
+ if (opts.json) {
166
+ console.log(JSON.stringify({ passkeys: data, manageUrl }));
167
+ return;
168
+ }
169
+ console.log(data.length
170
+ ? data.map(k => `${k.id} ${k.label ?? 'Passkey'} ${muted(`added ${k.createdAt.slice(0, 10)}${k.lastUsedAt ? `, last used ${k.lastUsedAt.slice(0, 10)}` : ''}`)}`).join('\n')
171
+ : 'No passkeys yet.');
172
+ console.log(muted(`Add or remove passkeys in the browser: ${manageUrl}`));
173
+ }));
174
+ approvalCommand
175
+ .command('verify <guid>')
176
+ .description('Verify a passkey approval offline, as a device does: recompute the payload hash and challenge and check the passkey signature')
177
+ .requiredOption('--payload <file>', 'JSON file with the exact payload the approval is for')
178
+ .option('--key <file>', "The approver's public key (JWK JSON) pinned at enrollment; without it the proof's own key is used and the result says so")
179
+ .option('--origin <url>', 'Relying-party origin the passkey signed for (default: the API base)')
180
+ .option('--json', 'Output as JSON')
181
+ .action((guid, opts) => run('Verify', async () => {
182
+ requireGuid(guid);
183
+ const payload = JSON.parse(readFileSync(opts.payload, 'utf8'));
184
+ const pinnedJwk = opts.key ? JSON.parse(readFileSync(opts.key, 'utf8')) : undefined;
185
+ const { data } = await get(`/approvals/${guid}`);
186
+ if (!data.passkey)
187
+ throw new Error(`${guid} is not a passkey approval`);
188
+ const expectedOrigin = new URL(opts.origin ?? getBaseUrl()).origin;
189
+ const result = verifyApproval(data.passkey, { payload, pinnedJwk, expectedOrigin });
190
+ if (opts.json) {
191
+ console.log(JSON.stringify({ id: guid, status: data.passkey.status, ...result }));
192
+ }
193
+ else {
194
+ for (const c of result.checks)
195
+ console.log(`${c.ok ? 'ok ' : 'FAIL'} ${c.check}${c.detail ? muted(` (${c.detail})`) : ''}`);
196
+ if (!result.pinned)
197
+ console.log(muted('Key not pinned: checked against the key in the proof. Pass --key with the approver key you pinned.'));
198
+ if (result.ok && data.passkey.status !== 'approved')
199
+ console.log(muted(`Signature is valid, but the approval is ${data.passkey.status}.`));
200
+ }
201
+ if (!result.ok) {
202
+ // --json already printed the failing checks; exit non-zero without a second JSON line.
203
+ if (opts.json) {
204
+ process.exitCode = 1;
205
+ return;
206
+ }
207
+ throw new Error('verification failed');
208
+ }
209
+ }));
127
210
  //# sourceMappingURL=approval.js.map
@@ -50,7 +50,7 @@ export const deployCommand = new Command('deploy')
50
50
  .option('--yes-destructive', 'Allow pending prod migrations that destroy data (DROP TABLE/COLUMN, TRUNCATE, DELETE without WHERE, column type changes)')
51
51
  .option('--plan', 'Show the pending migrations this deploy would run (and where each already ran), without deploying')
52
52
  .option('--source-dir <dir>', 'Source directory to deploy from')
53
- .option('--only <phases>', 'Run only specific phases, comma-separated, matched by gipity.yaml phase name or type: files/static, database/sql, functions, workflows, services, jobs, records, realtime, env, auth_branding, auth')
53
+ .option('--only <phases>', 'Run only specific phases, comma-separated, matched by gipity.yaml phase name or type: files/static, database/sql, functions, workflows, services, jobs, records, realtime, env, auth_branding, auth, access')
54
54
  .option('--force', 'Re-run all phases (ignore checksums) and bypass the sync bulk-deletion guard')
55
55
  .option('--no-sync', 'Skip sync-up before deploy')
56
56
  .option('--optimize', 'Bundle and minify the JS/CSS with Vite (off by default: files upload as-is, so prod serves what you verified). Only bundles <script type="module"> references, and page eval import() of an app module then loads a separate copy')
@@ -90,7 +90,6 @@ export const deployCommand = new Command('deploy')
90
90
  ? await doDeploy()
91
91
  : await withSpinner(env ? `Deploying to ${env}...` : 'Deploying...', doDeploy, { done: null });
92
92
  const d = res.data;
93
- const where = d.env ?? d.target;
94
93
  // Deploy + verify in one command: after a successful deploy, run the
95
94
  // same inspect pipeline `page inspect` uses against the live URL. An
96
95
  // inspect failure is reported but never turns a successful deploy into
@@ -131,7 +130,7 @@ export const deployCommand = new Command('deploy')
131
130
  }
132
131
  // Format output
133
132
  const batchLabel = d.batch ? muted(` (batch ${d.batch})`) : '';
134
- console.log(brand(bold(`Deploy to ${where}`)) + batchLabel + (d.created ? muted(' (new environment)') : ''));
133
+ console.log(brand(bold(`Deploy to ${d.env}`)) + batchLabel + (d.created ? muted(' (new environment)') : ''));
135
134
  console.log(muted('─'.repeat(40)));
136
135
  if (d.phases && d.phases.length > 0) {
137
136
  for (const phase of d.phases) {
@@ -178,12 +177,14 @@ export const deployCommand = new Command('deploy')
178
177
  process.exit(1);
179
178
  }
180
179
  else {
181
- console.log(success(`✓ Deployed to ${where}`) + muted(` (${d.elapsedMs}ms)`));
180
+ console.log(success(`✓ Deployed to ${d.env}`) + muted(` (${d.elapsedMs}ms)`));
182
181
  // The live URL is the one thing the caller (often an agent) needs next
183
182
  // - to open it, inspect it, or report it. Always surface it so nobody
184
183
  // has to reconstruct the URL convention or guess a subdomain.
185
184
  if (d.url)
186
185
  console.log(`${muted('Live:')} ${brand(d.url)}`);
186
+ if (d.pageAccess && d.pageAccess !== 'public')
187
+ console.log(`${muted('Pages:')} ${pageAccessLabel(d.pageAccess)}`);
187
188
  // Functions are served from the API host, NOT the static Live URL -
188
189
  // for an API-only app the endpoint address IS the deliverable, so name
189
190
  // it instead of leaving it to be inferred from a template comment.
@@ -192,9 +193,9 @@ export const deployCommand = new Command('deploy')
192
193
  // --api-base flag and GIPITY_API_BASE env), not the raw stored
193
194
  // config.apiBase - otherwise on any override we'd advertise a host we
194
195
  // didn't deploy to and send the caller probing the wrong instance.
195
- console.log(`${muted('Functions:')} POST ${brand(`${resolveApiBase()}/api/${d.appGuid ?? config.projectGuid}/fn/<name>`)}`);
196
+ console.log(`${muted('Functions:')} POST ${brand(`${resolveApiBase()}/api/${d.appGuid}/fn/<name>`)}`);
196
197
  // Each environment has its own functions at its own address.
197
- const envFlag = d.env && d.env !== 'prod' ? ` --env ${d.env}` : '';
198
+ const envFlag = d.env !== 'prod' ? ` --env ${d.env}` : '';
198
199
  console.log(muted(` (names: gipity fn list${envFlag}; verify the public path: gipity fn call <name>${envFlag} --anon)`));
199
200
  }
200
201
  for (const hint of d.hints ?? [])
@@ -202,4 +203,10 @@ export const deployCommand = new Command('deploy')
202
203
  await inspectAfter();
203
204
  }
204
205
  }));
206
+ /** How a private site's pages are gated, for deploy and status output. */
207
+ export function pageAccessLabel(mode) {
208
+ return mode === 'members'
209
+ ? 'private: only you and project members (Gipity sign-in)'
210
+ : "private: only the app's signed-in users";
211
+ }
205
212
  //# sourceMappingURL=deploy.js.map
@@ -1,14 +1,15 @@
1
1
  import { Command } from 'commander';
2
- import { get, post } from '../api.js';
2
+ import { readFileSync } from 'fs';
3
+ import { get, post, put, del } from '../api.js';
3
4
  import { resolveProjectContext } from '../config.js';
4
5
  import { bold, muted, success, warning } from '../colors.js';
5
6
  import { run } from '../helpers/index.js';
6
7
  export const notifyCommand = new Command('notify')
7
- .description('Web push notifications')
8
- .addHelpText('after', '\nGipity Notify: send a test notification or inspect subscriptions.');
8
+ .description('Push notifications (web and native iOS)')
9
+ .addHelpText('after', '\nGipity Notify: send a test notification, inspect subscriptions, or set up iOS push (notify apns).');
9
10
  notifyCommand
10
11
  .command('test')
11
- .description('Send a test push notification to yourself, a user, or everyone')
12
+ .description('Send a test push notification (web and iOS devices) to a user or everyone')
12
13
  .option('--to <who>', "Recipient: a user guid, comma-separated guids, or 'all'", 'all')
13
14
  .option('--title <text>', 'Notification title', 'Test notification')
14
15
  .option('--body <text>', 'Notification body', 'Hello from Gipity Notify 👋')
@@ -26,15 +27,25 @@ notifyCommand
26
27
  console.log(JSON.stringify(res.data));
27
28
  return;
28
29
  }
29
- const { sent, failed, pruned } = res.data;
30
- if (sent > 0)
31
- console.log(success(`✓ Sent to ${sent} device${sent === 1 ? '' : 's'}.`));
32
- else
30
+ const { sent, failed, pruned, results } = res.data;
31
+ if (sent > 0) {
32
+ const ios = results.filter(r => r.transport === 'apns' && r.status === 'sent').length;
33
+ const web = sent - ios;
34
+ const split = ios > 0 ? ` (${web} web, ${ios} iOS)` : '';
35
+ console.log(success(`✓ Sent to ${sent} device${sent === 1 ? '' : 's'}${split}.`));
36
+ }
37
+ else {
33
38
  console.log(warning('No devices received it: has anyone enabled notifications in the app yet? (gipity notify subs)'));
39
+ }
34
40
  if (pruned)
35
41
  console.log(muted(` pruned ${pruned} expired subscription${pruned === 1 ? '' : 's'}`));
36
- if (failed)
42
+ if (failed) {
37
43
  console.log(muted(` ${failed} delivery failure${failed === 1 ? '' : 's'}`));
44
+ for (const r of results) {
45
+ if (r.status === 'failed' && r.transport === 'apns')
46
+ console.log(muted(` iOS device ...${r.device}: ${r.reason ?? 'failed'}`));
47
+ }
48
+ }
38
49
  }));
39
50
  notifyCommand
40
51
  .command('subs')
@@ -50,12 +61,14 @@ notifyCommand
50
61
  }
51
62
  const { total, byUser } = res.data;
52
63
  console.log(bold(`${total} subscription${total === 1 ? '' : 's'} across ${byUser.length} user${byUser.length === 1 ? '' : 's'}`));
53
- for (const r of byUser)
54
- console.log(` ${r.user_guid} ${muted(`${r.count} device${r.count === 1 ? '' : 's'}`)}`);
64
+ for (const r of byUser) {
65
+ const split = r.ios > 0 ? ` (${r.web} web, ${r.ios} iOS)` : '';
66
+ console.log(` ${r.user_guid} ${muted(`${r.count} device${r.count === 1 ? '' : 's'}${split}`)}`);
67
+ }
55
68
  }));
56
69
  notifyCommand
57
70
  .command('rm')
58
- .description("Remove a user's push subscriptions (e.g. on account deletion)")
71
+ .description("Remove a user's push subscriptions and iOS devices (e.g. on account deletion)")
59
72
  .requiredOption('--user <guid>', 'User guid whose subscriptions to remove')
60
73
  .option('--project <guid-or-slug>', 'Target a specific project instead of cwd / Home')
61
74
  .option('--json', 'Output raw JSON')
@@ -68,4 +81,84 @@ notifyCommand
68
81
  }
69
82
  console.log(success(`Removed ${res.data.removed} subscription${res.data.removed === 1 ? '' : 's'} for ${opts.user}.`));
70
83
  }));
84
+ function printApns(c) {
85
+ if (!c.configured) {
86
+ console.log(warning('iOS push is not set up. Run: gipity notify apns set --team-id <id> --key-id <id> --p8 <AuthKey.p8> --bundle-id <id>'));
87
+ return;
88
+ }
89
+ console.log(` Team ID: ${c.teamId}`);
90
+ console.log(` Key ID: ${c.keyId}`);
91
+ console.log(` Bundle ID: ${c.bundleId}`);
92
+ console.log(` Default: ${c.defaultEnvironment} ${muted('(for devices that register without an environment)')}`);
93
+ }
94
+ export const apnsCommand = new Command('apns')
95
+ .description('Set up push notifications for a native iOS app (your own Apple key)')
96
+ .addHelpText('after', `
97
+ Create an APNs key in your Apple Developer account (Certificates, Identifiers
98
+ & Profiles > Keys > + > Apple Push Notifications service), download the
99
+ AuthKey_<KEYID>.p8 file, then:
100
+
101
+ gipity notify apns set --team-id ABCDE12345 --key-id KEY1234567 \\
102
+ --p8 ./AuthKey_KEY1234567.p8 --bundle-id com.example.myapp
103
+
104
+ The key is stored encrypted and never shown again. Your app registers each
105
+ device with POST /api/<app-guid>/notify/devices; notify() then reaches it.`);
106
+ apnsCommand
107
+ .command('set')
108
+ .description('Store the APNs key for this app (all environments use it)')
109
+ .requiredOption('--team-id <id>', 'Your 10-character Apple Team ID')
110
+ .requiredOption('--key-id <id>', 'The 10-character Key ID of the APNs key')
111
+ .requiredOption('--p8 <file>', 'Path to the AuthKey_<KEYID>.p8 file')
112
+ .requiredOption('--bundle-id <id>', 'Your app bundle id, e.g. com.example.myapp')
113
+ .option('--sandbox', 'Devices that register without an environment use the sandbox (development builds)')
114
+ .option('--project <guid-or-slug>', 'Target a specific project instead of cwd / Home')
115
+ .option('--json', 'Output raw JSON')
116
+ .action((opts) => run('Notify', async () => {
117
+ const { config } = await resolveProjectContext({ projectOverride: opts.project });
118
+ let p8;
119
+ try {
120
+ p8 = readFileSync(opts.p8, 'utf-8');
121
+ }
122
+ catch {
123
+ throw new Error(`Can't read ${opts.p8}. Pass the path to the AuthKey_<KEYID>.p8 file from Apple.`);
124
+ }
125
+ const res = await put(`/api/${config.projectGuid}/services/notify/apns`, {
126
+ team_id: opts.teamId, key_id: opts.keyId, bundle_id: opts.bundleId, p8, sandbox: !!opts.sandbox,
127
+ });
128
+ if (opts.json) {
129
+ console.log(JSON.stringify(res.data));
130
+ return;
131
+ }
132
+ console.log(success('✓ iOS push is set up.'));
133
+ printApns(res.data);
134
+ }));
135
+ apnsCommand
136
+ .command('show')
137
+ .description('Show the APNs setup for this app (never the key itself)')
138
+ .option('--project <guid-or-slug>', 'Target a specific project instead of cwd / Home')
139
+ .option('--json', 'Output raw JSON')
140
+ .action((opts) => run('Notify', async () => {
141
+ const { config } = await resolveProjectContext({ projectOverride: opts.project });
142
+ const res = await get(`/api/${config.projectGuid}/services/notify/apns`);
143
+ if (opts.json) {
144
+ console.log(JSON.stringify(res.data));
145
+ return;
146
+ }
147
+ printApns(res.data);
148
+ }));
149
+ apnsCommand
150
+ .command('rm')
151
+ .description('Remove the APNs key (iOS devices stop receiving notifications)')
152
+ .option('--project <guid-or-slug>', 'Target a specific project instead of cwd / Home')
153
+ .option('--json', 'Output raw JSON')
154
+ .action((opts) => run('Notify', async () => {
155
+ const { config } = await resolveProjectContext({ projectOverride: opts.project });
156
+ const res = await del(`/api/${config.projectGuid}/services/notify/apns`);
157
+ if (opts.json) {
158
+ console.log(JSON.stringify(res.data));
159
+ return;
160
+ }
161
+ console.log(res.data.removed ? success('✓ APNs key removed.') : warning('No APNs key was set.'));
162
+ }));
163
+ notifyCommand.addCommand(apnsCommand);
71
164
  //# sourceMappingURL=notify.js.map
@@ -47,12 +47,13 @@ const SETUP_STEPS = {
47
47
  'gipity project auth provider google --client-id <id> --client-secret <secret>',
48
48
  ],
49
49
  apple: r => [
50
- 'Apple Developer > Certificates, Identifiers & Profiles > Identifiers > add a Services ID.',
51
- ' Its identifier is your client ID.',
52
- `Enable Sign in with Apple on it, register your domain and the return URL: ${r}`,
53
- 'Keys > add a key with Sign in with Apple enabled. Note its Key ID and download the .p8 file (only once).',
54
- 'Your Team ID is on the Membership details page.',
55
- 'gipity project auth provider apple --client-id <services-id> --team-id <team> --key-id <key> --private-key-file AuthKey_XXXX.p8',
50
+ 'Apple Developer > Certificates, Identifiers & Profiles > Keys > add a key with Sign in with Apple enabled.',
51
+ ' Note its Key ID and download the .p8 file (only once). Your Team ID is on the Membership details page.',
52
+ 'Web sign-in (the hosted sign-in page): Identifiers > add a Services ID. Its identifier is your client ID.',
53
+ ` Enable Sign in with Apple on it, register your domain and the return URL: ${r}`,
54
+ 'iOS app (native, POST /api/<guid>/auth/apple): enable Sign in with Apple on your App ID; its bundle ID is what you pass as --bundle-id.',
55
+ 'gipity project auth provider apple --team-id <team> --key-id <key> --private-key-file AuthKey_XXXX.p8 [--client-id <services-id>] [--bundle-id <bundle-id> ...] [--require-nonce]',
56
+ ' Pass every flag each time: this replaces the app\'s whole Apple setup.',
56
57
  ],
57
58
  discord: r => [
58
59
  'Discord Developer Portal > Applications > your application > OAuth2.',
@@ -68,6 +69,9 @@ function formatProvider(p) {
68
69
  ];
69
70
  if (p.note)
70
71
  lines.push(muted(p.note));
72
+ if (p.provider === 'apple' && p.bundle_ids) {
73
+ lines.push(`iOS bundle ids: ${p.bundle_ids.length ? p.bundle_ids.join(', ') : 'none'}${p.require_nonce ? ' (nonce required)' : ''}`);
74
+ }
71
75
  lines.push('', `Redirect URI: ${p.redirect_uri}`, '', 'Use your own credentials:');
72
76
  let n = 0;
73
77
  for (const step of SETUP_STEPS[p.provider](p.redirect_uri)) {
@@ -92,13 +96,15 @@ Modes:
92
96
  gipity Sign in with Gipity only (default)
93
97
  app Users sign in to this app alone, without a Gipity account:
94
98
  Google, Apple, Discord and email codes for web apps (the hosted sign-in
95
- page / Gipity.auth.signIn), Steam (POST /api/<guid>/auth/steam) and guest
96
- devices (POST /api/<guid>/auth/guest) for games
99
+ page / Gipity.auth.signIn); native apps sign in over HTTPS with Steam
100
+ (POST /api/<guid>/auth/steam), guest devices (/auth/guest), Sign in with
101
+ Apple from iOS (/auth/apple) or email codes, and renew with /auth/refresh
97
102
  both Either
98
103
 
99
104
  Sign-in providers:
100
105
  gipity project auth provider <google|apple|discord> show setup steps and the redirect URI
101
- Google and Discord work at once on Gipity's shared credentials; Apple needs your own.
106
+ Google and Discord work at once on Gipity's shared credentials; Apple needs your own
107
+ (a web Services ID, iOS bundle ids with --bundle-id, or both).
102
108
  Manage the app's users: gipity project users
103
109
 
104
110
  --unique-names on|off
@@ -156,7 +162,9 @@ See: gipity skill read steam-game`)
156
162
  auth
157
163
  .command('provider <name>')
158
164
  .description('Show setup for a sign-in provider (google, apple, discord), set your own credentials, or go back to shared')
159
- .option('--client-id <id>', 'OAuth client ID (Apple: the Services ID)')
165
+ .option('--client-id <id>', 'OAuth client ID (Apple: the web Services ID)')
166
+ .option('--bundle-id <id>', 'Apple: an iOS bundle ID allowed to sign in natively (repeat for several)', (v, prev = []) => [...prev, v])
167
+ .option('--require-nonce', 'Apple: native sign-in must send a nonce')
160
168
  .option('--client-secret <secret>', 'OAuth client secret (Google, Discord)')
161
169
  .option('--team-id <id>', 'Apple Team ID')
162
170
  .option('--key-id <id>', 'Apple Sign in with Apple key ID')
@@ -170,7 +178,7 @@ See: gipity skill read steam-game`)
170
178
  const config = requireConfig();
171
179
  const base = `/projects/${config.projectGuid}/auth/providers/${provider}`;
172
180
  const label = PROVIDER_LABEL[provider];
173
- const credFlags = ['clientId', 'clientSecret', 'teamId', 'keyId', 'privateKeyFile'].filter(k => opts[k] !== undefined);
181
+ const credFlags = ['clientId', 'clientSecret', 'teamId', 'keyId', 'privateKeyFile', 'bundleId', 'requireNonce'].filter(k => opts[k] !== undefined);
174
182
  if (opts.shared) {
175
183
  if (credFlags.length)
176
184
  fail('--shared cannot be combined with credential flags.');
@@ -191,10 +199,12 @@ See: gipity skill read steam-game`)
191
199
  }
192
200
  let body;
193
201
  if (provider === 'apple') {
194
- const missing = [['clientId', '--client-id'], ['teamId', '--team-id'], ['keyId', '--key-id'], ['privateKeyFile', '--private-key-file']]
202
+ const missing = [['teamId', '--team-id'], ['keyId', '--key-id'], ['privateKeyFile', '--private-key-file']]
195
203
  .filter(([k]) => !opts[k]).map(([, f]) => f);
196
204
  if (missing.length)
197
205
  fail(`Apple needs ${missing.join(', ')}. See: gipity project auth provider apple`);
206
+ if (!opts.clientId && !opts.bundleId)
207
+ fail('Apple needs --client-id (web Services ID), --bundle-id (iOS app), or both. See: gipity project auth provider apple');
198
208
  if (opts.clientSecret)
199
209
  fail('Apple takes --team-id, --key-id and --private-key-file, not --client-secret.');
200
210
  let privateKey;
@@ -206,22 +216,30 @@ See: gipity skill read steam-game`)
206
216
  }
207
217
  if (!privateKey.includes('PRIVATE KEY'))
208
218
  fail(`${opts.privateKeyFile} does not look like a .p8 private key.`);
209
- body = { client_id: opts.clientId, team_id: opts.teamId, key_id: opts.keyId, private_key: privateKey };
219
+ body = {
220
+ ...(opts.clientId ? { client_id: opts.clientId } : {}),
221
+ ...(opts.bundleId ? { bundle_ids: opts.bundleId } : {}),
222
+ ...(opts.requireNonce ? { require_nonce: true } : {}),
223
+ team_id: opts.teamId, key_id: opts.keyId, private_key: privateKey,
224
+ };
210
225
  }
211
226
  else {
212
227
  const missing = [['clientId', '--client-id'], ['clientSecret', '--client-secret']]
213
228
  .filter(([k]) => !opts[k]).map(([, f]) => f);
214
229
  if (missing.length)
215
230
  fail(`${label} needs ${missing.join(' and ')}. See: gipity project auth provider ${provider}`);
216
- const extra = ['teamId', 'keyId', 'privateKeyFile'].filter(k => opts[k] !== undefined);
231
+ const extra = ['teamId', 'keyId', 'privateKeyFile', 'bundleId', 'requireNonce'].filter(k => opts[k] !== undefined);
217
232
  if (extra.length)
218
- fail(`--team-id, --key-id and --private-key-file are for Apple only.`);
233
+ fail(`--team-id, --key-id, --private-key-file, --bundle-id and --require-nonce are for Apple only.`);
219
234
  body = { client_id: opts.clientId, client_secret: opts.clientSecret };
220
235
  }
221
236
  const res = await put(base, body);
222
237
  const lines = [success(`${label} sign-in now uses your own credentials.`)];
223
238
  if (provider === 'google')
224
239
  lines.push(muted('Existing Google users keep their accounts.'));
240
+ if (provider === 'apple' && opts.bundleId) {
241
+ lines.push(muted(`iOS apps (${opts.bundleId.join(', ')}) can sign in with POST /api/<guid>/auth/apple. See: gipity skill read app-users`));
242
+ }
225
243
  printResult(lines.join('\n'), opts, res.data);
226
244
  }));
227
245
  }
@@ -49,7 +49,7 @@ email code, Steam or a guest device. They belong to the app, not to Gipity.
49
49
  gipity project users --search ann find users by name or email
50
50
  gipity project users export -o users.csv every user, as CSV (or --format json)
51
51
  gipity project users delete <guid> erase a user (runs the app's user_deleted hooks)
52
- gipity project users signout <guid> end all of a user's web sessions`);
52
+ gipity project users signout <guid> sign a user out everywhere (web and native apps)`);
53
53
  users
54
54
  .command('list', { isDefault: true })
55
55
  .description("List the app's users")
@@ -119,7 +119,7 @@ email code, Steam or a guest device. They belong to the app, not to Gipity.
119
119
  }));
120
120
  users
121
121
  .command('signout <userGuid>')
122
- .description("Sign a user out everywhere (revoke all of the user's web sessions)")
122
+ .description("Sign a user out everywhere: end their web sessions, revoke their native apps' refresh tokens, and void their access tokens")
123
123
  .option('--json', 'Output as JSON')
124
124
  .action((userGuid, opts) => run('Sign out', async () => {
125
125
  const res = await post(`/projects/${requireConfig().projectGuid}/app-users/${encodeURIComponent(userGuid)}/signout`);
@@ -8,6 +8,14 @@ import { getConfig, liveUrl, resolveApiBase } from '../config.js';
8
8
  import { brand, success, warning, muted, error as clrError } from '../colors.js';
9
9
  import { GIPITY_PLUGIN_ID, GIPITY_MARKETPLACE_NAME, setupClaudeHooks, ensureGipityPlugin, ensureGipityPluginInstalled, userScopeInstallState } from '../setup.js';
10
10
  import { flushBugQueue } from '../bug-queue.js';
11
+ import { pageAccessLabel } from './deploy.js';
12
+ /** Who may load this project's deployed pages, or null when it can't be read
13
+ * right now (not logged in, API slow or unreachable). Capped like probeAuth. */
14
+ async function probePageAccess(projectGuid) {
15
+ const timeout = new Promise(res => setTimeout(() => res(null), 5000).unref?.());
16
+ const call = get(`/projects/${projectGuid}`).then((res) => res.data?.page_access ?? null, () => null);
17
+ return Promise.race([call, timeout]);
18
+ }
11
19
  /** Hooks ship in the Gipity Claude Code plugin now. "Installed" means three
12
20
  * things must all hold: the user-scope settings register the marketplace and
13
21
  * enable the plugin (declarative), AND Claude Code actually has a user-scope
@@ -75,7 +83,10 @@ export const statusCommand = new Command('status')
75
83
  // now go out. Skipped entirely (existsSync short-circuit) when the queue
76
84
  // is empty, which is the common case, so this stays a no-op most runs.
77
85
  const queueDelivered = (auth && !sessionExpired()) ? await flushBugQueue().catch(() => 0) : 0;
78
- const probe = await probeAuth(!!auth);
86
+ const [probe, pageAccess] = await Promise.all([
87
+ probeAuth(!!auth),
88
+ config && (auth || usingEnvToken()) ? probePageAccess(config.projectGuid) : Promise.resolve(null),
89
+ ]);
79
90
  // RBAC lets a project be shared to a collaborator whose own account
80
91
  // legitimately differs from the project owner's - so this is advisory,
81
92
  // never a hard error. Only meaningful once a live 'ok' call has actually
@@ -92,6 +103,7 @@ export const statusCommand = new Command('status')
92
103
  apiBaseInUse,
93
104
  url: liveUrl(config),
94
105
  ...(config.env ? { env: config.env.name } : {}),
106
+ ...(pageAccess ? { pageAccess } : {}),
95
107
  } : null,
96
108
  // `valid` reflects the refresh token (the real session) - access
97
109
  // tokens auto-renew, so their expiry must not read as "invalid".
@@ -119,6 +131,8 @@ export const statusCommand = new Command('status')
119
131
  if (config.env)
120
132
  console.log(`${muted('Env:')} ${config.env.name}`);
121
133
  console.log(`${muted('Live:')} ${liveUrl(config)}`);
134
+ if (pageAccess && pageAccess !== 'public')
135
+ console.log(`${muted('Pages:')} ${pageAccessLabel(pageAccess)}`);
122
136
  console.log(`${muted('API:')} ${config.apiBase}`);
123
137
  // apiBase is only what THIS project recorded - resolveApiBase() is what
124
138
  // every real request actually uses (it can diverge via GIPITY_API_BASE,