firstly 0.10.8 → 0.12.0

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # firstly
 
+## 0.12.0
+
+### Minor Changes
+
+- [#419](https://github.com/jycouet/firstly/pull/419) [`16cfc80`](https://github.com/jycouet/firstly/commit/16cfc808e55e7cdb275020052c6207a16b12ab66) Thanks [@jycouet](https://github.com/jycouet)! - `FF_Grid`: first sort click is `desc` for Date/Number columns (`asc` otherwise), override per cell with `firstSort`. On landing, the header arrow also reflects the entity `defaultOrderBy`.
+
+- [#405](https://github.com/jycouet/firstly/pull/405) [`5324a64`](https://github.com/jycouet/firstly/commit/5324a6471fb20fdca6a6fb16970d2235192e0431) Thanks [@jycouet](https://github.com/jycouet)! - Add experimental `queryRepo` (`firstly/svelte/query`): `$derived(await queryRepo(E).find())` with API rules on SSR, no query on hydration, and plain `repo(E)` writes refreshing it.
+
+- [#406](https://github.com/jycouet/firstly/pull/406) [`b2f1664`](https://github.com/jycouet/firstly/commit/b2f1664429490ebb989e4dbd8c0002b0cf6e2b37) Thanks [@jycouet](https://github.com/jycouet)! - New `reloadOnStaleChunk()` for `hooks.client`: a failed lazy import in a component reloads when a new version is deployed.
+
+- [#406](https://github.com/jycouet/firstly/pull/406) [`dac5a18`](https://github.com/jycouet/firstly/commit/dac5a18c2164bb5bedd7bd729ba74cabee57fa26) Thanks [@jycouet](https://github.com/jycouet)! - SvelteKit 3 only (Node 22.17+), stay on `0.11.x` for Kit 2. `SP` navigates with `replace: true, reset: false`: `keepFocus` and `noScroll` in `gotoOpts` now throw, use `reset`. `firstly()` sets legacy decorators and nullifies `$app/env/private` on the client. `withStaleDeployReload` reads Kit 3's `handleError` input and skips preloads.
+
+### Patch Changes
+
+- [#425](https://github.com/jycouet/firstly/pull/425) [`59d01d6`](https://github.com/jycouet/firstly/commit/59d01d6f6e862b24b50853820bdac782b2dad64d) Thanks [@jycouet](https://github.com/jycouet)! - `SP.computing` stays `true` until the navigation lands, not just until `goto` is called.
+
+## 0.11.0
+
+### Minor Changes
+
+- [#402](https://github.com/jycouet/firstly/pull/402) [`c19f427`](https://github.com/jycouet/firstly/commit/c19f427e24e5b9618bc1e8943ee0bc3f6b20aae1) Thanks [@jycouet](https://github.com/jycouet)! - sqlAdmin: `<SqlAdmin queries={{ ... }} />` merges app preset queries over the built-ins by title: same title overrides, new title adds a button, `false` removes one.
+
 ## 0.10.8
 
 ### Patch Changes

package/esm/changeLog/index.d.ts

@@ -36,6 +36,7 @@ export declare const withChangeLog: <entityType>(options?: EntityOptions<entityT
     backendPreprocessFilter?: ((filter: import("remult").EntityFilter<entityType>, event: import("remult").PreprocessFilterEvent<entityType>) => import("remult").EntityFilter<entityType> | Promise<import("remult").EntityFilter<entityType>>) | undefined;
     backendPrefilter?: import("remult").EntityFilter<entityType> | (() => import("remult").EntityFilter<entityType> | Promise<import("remult").EntityFilter<entityType>>) | undefined;
     defaultOrderBy?: import("remult").EntityOrderBy<entityType> | undefined;
+    bulkInsert?: boolean;
     saving?: ((entity: entityType, event: LifecycleEvent<entityType>) => Promise<any> | any) | undefined;
     deleting?: ((entity: entityType, e: LifecycleEvent<entityType>) => Promise<any> | any) | undefined;
     validation?: ((entity: entityType, ref: LifecycleEvent<entityType>) => Promise<any> | any) | undefined;

package/esm/changeLog/server/index.d.ts

@@ -11,7 +11,7 @@ declare module 'remult' {
  *
  * @example
  * ```ts
- * import { withChangeLog } from '..'
+ * import { withChangeLog } from 'firstly/changeLog'
  *
  * \@Entity('users', withChangeLog({
  *   // ...
@@ -27,7 +27,7 @@ declare module 'remult' {
  * // APP_Entity.ts example
  * import { Entity, isBackend, type EntityOptions } from 'remult'
  *
- * import { withChangeLog } from '..'
+ * import { withChangeLog } from 'firstly/changeLog'
  *
  * export function APP_Entity<entityType>(
  * 	key: string,

package/esm/changeLog/server/index.js

@@ -6,7 +6,7 @@ import { ChangeLog } from '../changeLogEntities';
  *
  * @example
  * ```ts
- * import { withChangeLog } from '..'
+ * import { withChangeLog } from 'firstly/changeLog'
  *
  * \@Entity('users', withChangeLog({
  *   // ...
@@ -22,7 +22,7 @@ import { ChangeLog } from '../changeLogEntities';
  * // APP_Entity.ts example
  * import { Entity, isBackend, type EntityOptions } from 'remult'
  *
- * import { withChangeLog } from '..'
+ * import { withChangeLog } from 'firstly/changeLog'
  *
  * export function APP_Entity<entityType>(
  * 	key: string,

package/esm/core/FF_Allow.d.ts

@@ -16,7 +16,7 @@ export declare const FF_Allow: {
      * @example
      * Owner-only update / delete (typed):
      * ```ts
-     * import { FF_Entity, FF_Allow } from '..'
+     * import { FF_Entity, FF_Allow } from 'firstly'
      *
      * \@FF_Entity<Task>('tasks', {
      *   allowApiUpdate: FF_Allow.owner<Task>('userId'), // typed: 'userId' must be a key of Task
@@ -38,8 +38,8 @@ export declare const FF_Allow: {
      * @example
      * Admin OR owner (typed):
      * ```ts
-     * import { FF_Entity, FF_Allow } from '..'
-     * import { Roles } from '../roles'
+     * import { FF_Entity, FF_Allow } from 'firstly'
+     * import { Roles } from '../roles.js'
      *
      * \@FF_Entity<Task>('tasks', {
      *   allowApiUpdate: FF_Allow.ownerOr<Task>({ roles: [Roles.Admin] }),

package/esm/core/FF_Allow.js

@@ -17,7 +17,7 @@ export const FF_Allow = {
      * @example
      * Owner-only update / delete (typed):
      * ```ts
-     * import { FF_Entity, FF_Allow } from '..'
+     * import { FF_Entity, FF_Allow } from 'firstly'
      *
      * \@FF_Entity<Task>('tasks', {
      *   allowApiUpdate: FF_Allow.owner<Task>('userId'), // typed: 'userId' must be a key of Task
@@ -39,8 +39,8 @@ export const FF_Allow = {
      * @example
      * Admin OR owner (typed):
      * ```ts
-     * import { FF_Entity, FF_Allow } from '..'
-     * import { Roles } from '../roles'
+     * import { FF_Entity, FF_Allow } from 'firstly'
+     * import { Roles } from '../roles.js'
      *
      * \@FF_Entity<Task>('tasks', {
      *   allowApiUpdate: FF_Allow.ownerOr<Task>({ roles: [Roles.Admin] }),

package/esm/core/FF_Filter.d.ts

@@ -19,7 +19,7 @@ export declare const FF_Filter: {
      * @example
      * Owner-only prefilter (typed):
      * ```ts
-     * import { FF_Entity, FF_Filter } from '..'
+     * import { FF_Entity, FF_Filter } from 'firstly'
      *
      * \@FF_Entity<Task>('tasks', {
      *   apiPrefilter: () => FF_Filter.owner<Task>('userId'),
@@ -41,8 +41,8 @@ export declare const FF_Filter: {
      * @example
      * Admin sees all, others only their own (typed):
      * ```ts
-     * import { FF_Entity, FF_Filter } from '..'
-     * import { Roles } from '../roles'
+     * import { FF_Entity, FF_Filter } from 'firstly'
+     * import { Roles } from '../roles.js'
      *
      * \@FF_Entity<Task>('tasks', {
      *   apiPrefilter: () => FF_Filter.ownerOr<Task>({ roles: [Roles.Admin] }),

package/esm/core/FF_Filter.js

@@ -21,7 +21,7 @@ export const FF_Filter = {
      * @example
      * Owner-only prefilter (typed):
      * ```ts
-     * import { FF_Entity, FF_Filter } from '..'
+     * import { FF_Entity, FF_Filter } from 'firstly'
      *
      * \@FF_Entity<Task>('tasks', {
      *   apiPrefilter: () => FF_Filter.owner<Task>('userId'),
@@ -43,8 +43,8 @@ export const FF_Filter = {
      * @example
      * Admin sees all, others only their own (typed):
      * ```ts
-     * import { FF_Entity, FF_Filter } from '..'
-     * import { Roles } from '../roles'
+     * import { FF_Entity, FF_Filter } from 'firstly'
+     * import { Roles } from '../roles.js'
      *
      * \@FF_Entity<Task>('tasks', {
      *   apiPrefilter: () => FF_Filter.ownerOr<Task>({ roles: [Roles.Admin] }),

package/esm/core/FF_Validators.d.ts

@@ -30,8 +30,8 @@ export declare const resolveMessage: (m: LocalizedMessage) => string;
  * locale resolution:
  *
  * ```ts
- * import { createValidators } from '..'
- * import * as m from '../paraglide/messages'
+ * import { createValidators } from 'firstly'
+ * import * as m from '../paraglide/messages.js'
  *
  * export const App_Validators = createValidators({
  *   email: {

package/esm/core/FF_Validators.js

@@ -36,8 +36,8 @@ export const resolveMessage = (m) => (typeof m === 'function' ? m() : m);
  * locale resolution:
  *
  * ```ts
- * import { createValidators } from '..'
- * import * as m from '../paraglide/messages'
+ * import { createValidators } from 'firstly'
+ * import * as m from '../paraglide/messages.js'
  *
  * export const App_Validators = createValidators({
  *   email: {

package/esm/core/index.d.ts

@@ -0,0 +1 @@
+export {};

package/esm/core/index.js

@@ -1,4 +1,4 @@
-"use strict";
+export {};
 // Files under lib/core/ are the pure-TS, frontend-safe primitives.
 // They are re-exported from lib/index.ts (the `firstly` root export).
 // Keep this barrel empty — import sources directly from ./BaseEnum,

package/esm/cron/server/index.d.ts

@@ -63,7 +63,7 @@ export type CronJobParams = {
  * usage:
  *
  * ```ts
- * import { cron, cronTime } from '..'
+ * import { cron, cronTime } from 'firstly/cron'
  *
  * export const api = firstly({
  *   modules: [

package/esm/cron/server/index.js

@@ -36,7 +36,7 @@ const fmtDuration = (ms) => (ms < 1000 ? `${ms}ms` : `${(ms / 1000).toFixed(1)}s
  * usage:
  *
  * ```ts
- * import { cron, cronTime } from '..'
+ * import { cron, cronTime } from 'firstly/cron'
  *
  * export const api = firstly({
  *   modules: [

package/esm/mail/ui/WriteMail.svelte

@@ -1,7 +1,7 @@
 <script lang="ts">
 	import { remult } from 'remult'
-	import { errorMessage } from '../..'
 
+	import { errorMessage } from '../../index.js'
 	import { MailController } from '../MailController'
 	import { Roles_Mail } from '../Roles_Mail'
 

package/esm/sqlAdmin/index.d.ts

@@ -1,5 +1,6 @@
 import { Log } from '@kitql/helpers';
 export { Roles_SqlAdmin } from './Roles_SqlAdmin';
+export { builtInPresetQueries, type SqlPresetQueries } from './presetQueries';
 export { SqlAdminController, type SqlResult, type SqlTokensOptions } from './SqlAdminController';
 export { SqlDriftController, type SqlDriftFlag } from './SqlDriftController';
 export { SQL_CAPABILITIES, SQL_TOKEN_TTLS, SqlToken, SqlTokenCall, type SqlCapability, type SqlTokenTtl, } from './sqlTokenEntities';

package/esm/sqlAdmin/index.js

@@ -1,5 +1,6 @@
 import { Log } from '@kitql/helpers';
 export { Roles_SqlAdmin } from './Roles_SqlAdmin';
+export { builtInPresetQueries } from './presetQueries';
 export { SqlAdminController } from './SqlAdminController';
 export { SqlDriftController } from './SqlDriftController';
 export { SQL_CAPABILITIES, SQL_TOKEN_TTLS, SqlToken, SqlTokenCall, } from './sqlTokenEntities';

package/esm/sqlAdmin/presetQueries.d.ts

@@ -0,0 +1,8 @@
+/** Title -> SQL. A built-in title overrides it, `false` removes it, a new title adds a button. */
+export type SqlPresetQueries = Record<string, string | false>;
+export declare const builtInPresetQueries: Record<string, string>;
+/** Built-ins first (in their order), then added titles in insertion order. */
+export declare function mergePresetQueries(queries?: SqlPresetQueries): {
+    title: string;
+    sql: string;
+}[];

package/esm/sqlAdmin/presetQueries.js

@@ -0,0 +1,26 @@
+export const builtInPresetQueries = {
+    Default: `SELECT *
+FROM "public"."users"
+LIMIT 10`,
+    'Tables & Sizes': `SELECT
+  table_schema,
+  table_name,
+  pg_size_pretty(pg_total_relation_size(quote_ident(table_schema) || '.' || quote_ident(table_name))) as total_size,
+  pg_size_pretty(pg_table_size(quote_ident(table_schema) || '.' || quote_ident(table_name))) as data_size,
+  pg_size_pretty(pg_indexes_size(quote_ident(table_schema) || '.' || quote_ident(table_name))) as index_size
+FROM information_schema.tables
+WHERE table_schema IN ('public', 'ff_auth')
+ORDER BY pg_total_relation_size(quote_ident(table_schema) || '.' || quote_ident(table_name)) DESC;`,
+    Indexes: `SELECT *
+FROM pg_indexes
+WHERE schemaname = 'public'
+ORDER BY tablename, indexname`,
+    'Database Size': `SELECT
+  current_database() as database_name,
+  pg_size_pretty(pg_database_size(current_database())) as database_size`,
+};
+/** Built-ins first (in their order), then added titles in insertion order. */
+export function mergePresetQueries(queries = {}) {
+    const merged = { ...builtInPresetQueries, ...queries };
+    return Object.entries(merged).flatMap(([title, sql]) => (sql === false ? [] : [{ title, sql }]));
+}

package/esm/sqlAdmin/server/index.d.ts

@@ -65,7 +65,7 @@ export type SqlAdminOptions = {
  * @example
  * ```ts
  * import { remultApi } from 'remult/remult-sveltekit'
- * import { sqlAdmin } from './'
+ * import { sqlAdmin } from 'firstly/sqlAdmin/server'
  *
  * export const api = remultApi({
  *   modules: [sqlAdmin({ tokens: { capabilities: ['read'] } })],
@@ -75,7 +75,7 @@ export type SqlAdminOptions = {
  * Then on any admin route:
  * ```svelte
  * <script>
- *   import { SqlAdmin, SqlTokens } from '..'
+ *   import { SqlAdmin, SqlTokens } from 'firstly/sqlAdmin'
  * </script>
  * <SqlAdmin />
  * <SqlTokens />

package/esm/sqlAdmin/server/index.js

@@ -59,7 +59,7 @@ async function resolveReadPool(opt = 'auto') {
  * @example
  * ```ts
  * import { remultApi } from 'remult/remult-sveltekit'
- * import { sqlAdmin } from './'
+ * import { sqlAdmin } from 'firstly/sqlAdmin/server'
  *
  * export const api = remultApi({
  *   modules: [sqlAdmin({ tokens: { capabilities: ['read'] } })],
@@ -69,7 +69,7 @@ async function resolveReadPool(opt = 'auto') {
  * Then on any admin route:
  * ```svelte
  * <script>
- *   import { SqlAdmin, SqlTokens } from '..'
+ *   import { SqlAdmin, SqlTokens } from 'firstly/sqlAdmin'
  * </script>
  * <SqlAdmin />
  * <SqlTokens />

package/esm/sqlAdmin/ui/SqlAdmin.svelte

@@ -11,55 +11,27 @@
 	 * can read them with `list_console_messages`.
 	 */
 	import { log } from '../index'
+	import { mergePresetQueries, type SqlPresetQueries } from '../presetQueries'
 	import { SqlAdminController, type SqlResult } from '../SqlAdminController'
 	import { decodeSqlWire, encodeSqlWire } from '../sqlWire'
 
-	const defaultQuery = `SELECT *
-FROM "public"."users"
-LIMIT 10`
+	let { queries = {} }: { queries?: SqlPresetQueries } = $props()
 
-	let sqlInput = $state(defaultQuery)
+	const presets = $derived(mergePresetQueries(queries))
+
+	// Seeded once: later prop changes must not clobber what the user typed.
+	const initialPresets = mergePresetQueries(queries)
+	let sqlInput = $state(
+		(initialPresets.find((q) => q.title === 'Default') ?? initialPresets[0])?.sql ?? '',
+	)
 	let result: SqlResult | undefined = $state()
 	let error = $state('')
 	let isLoading = $state(false)
 	let allowWrites = $state(false)
 	let copied = $state(false)
 
-	const queries = {
-		default: { label: 'Default', sql: defaultQuery },
-		tables: {
-			label: 'Tables & Sizes',
-			sql: `SELECT
-  table_schema,
-  table_name,
-  pg_size_pretty(pg_total_relation_size(quote_ident(table_schema) || '.' || quote_ident(table_name))) as total_size,
-  pg_size_pretty(pg_table_size(quote_ident(table_schema) || '.' || quote_ident(table_name))) as data_size,
-  pg_size_pretty(pg_indexes_size(quote_ident(table_schema) || '.' || quote_ident(table_name))) as index_size
-FROM information_schema.tables
-WHERE table_schema IN ('public', 'ff_auth')
-ORDER BY pg_total_relation_size(quote_ident(table_schema) || '.' || quote_ident(table_name)) DESC;`,
-		},
-		indexes: {
-			label: 'Indexes',
-			sql: `SELECT *
-FROM pg_indexes
-WHERE schemaname = 'public'
-ORDER BY tablename, indexname`,
-		},
-		dbSize: {
-			label: 'Database Size',
-			sql: `SELECT
-  current_database() as database_name,
-  pg_size_pretty(pg_database_size(current_database())) as database_size`,
-		},
-	} as const
-
 	log.info('AI Hint: results are also logged as "for AI:" JSON after each query.')
 
-	function setPresetQuery(queryId: keyof typeof queries) {
-		sqlInput = queries[queryId].sql
-	}
-
 	async function handleSubmit(e: Event) {
 		e.preventDefault()
 		try {
@@ -131,11 +103,11 @@ ORDER BY tablename, indexname`,
 
 	<div class="flex flex-col gap-4 p-5">
 		<div class="flex flex-wrap gap-2">
-			{#each Object.entries(queries) as [id, query] (id)}
+			{#each presets as preset (preset.title)}
 				<button
 					type="button"
 					class="border border-border bg-secondary px-3 py-1.5 text-sm font-medium text-secondary-foreground hover:bg-accent hover:text-accent-foreground disabled:opacity-50"
-					onclick={() => setPresetQuery(id as keyof typeof queries)}>{query.label}</button
+					onclick={() => (sqlInput = preset.sql)}>{preset.title}</button
 				>
 			{/each}
 		</div>
@@ -144,8 +116,7 @@ ORDER BY tablename, indexname`,
 				bind:value={sqlInput}
 				class="h-52 w-full border border-input bg-background p-3 font-mono text-sm text-foreground placeholder-muted-foreground focus:border-ring focus:outline-none disabled:opacity-50"
 				placeholder="Enter SQL command..."
-				disabled={isLoading}
-			></textarea>
+				disabled={isLoading}></textarea>
 			<div class="flex flex-wrap items-center gap-4">
 				<button
 					type="submit"

package/esm/sqlAdmin/ui/SqlAdmin.svelte.d.ts

@@ -1,3 +1,7 @@
-declare const SqlAdmin: import("svelte").Component<Record<string, never>, {}, "">;
+import { type SqlPresetQueries } from '../presetQueries';
+type $$ComponentProps = {
+    queries?: SqlPresetQueries;
+};
+declare const SqlAdmin: import("svelte").Component<$$ComponentProps, {}, "">;
 type SqlAdmin = ReturnType<typeof SqlAdmin>;
 export default SqlAdmin;